TheCloud/hugoDocs
1
0
Fork 0
mirror of https://github.com/gohugoio/hugoDocs.git synced 2025-09-16 17:24:36 -04:00
Code Issues Packages Projects Releases Wiki Activity

Update partials.md

Browse Source
This commit is contained in:
Bjørn Erik Pedersen 2019-04-17 23:58:20 +02:00 committed by GitHub
parent 7b207a404d
commit 3778ce6890
No known key found for this signature in database
GPG Key ID: 4AEE18F83AFDEB23
1 changed files with 4 additions and 4 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

8
content/en/templates/partials.md
View File

@ -77,11 +77,11 @@ The second argument in a partial call is the variable being passed down. The abo
This means the partial will *only* be able to access those variables. The partial is isolated and *has no access to the outer scope*. From within the partial, `$.Var` is equivalent to `.Var`. This means the partial will *only* be able to access those variables. The partial is isolated and *has no access to the outer scope*. From within the partial, `$.Var` is equivalent to `.Var`.
### Returning a value ## Returning a value from a Partial
In addition to outputting markup, partials can be used to return a value of any type. In order to return a value, a partial must include a lone `return` statement. In addition to outputting markup, partials can be used to return a value of any type. In order to return a value, a partial must include a lone `return` statement.
#### Example GetFeatured ### Example GetFeatured
```go-html-template ```go-html-template
{{/* layouts/partials/GetFeatured.html */}} {{/* layouts/partials/GetFeatured.html */}}
{{ return first . (where site.RegularPages ".Params.featured" true) }} {{ return first . (where site.RegularPages ".Params.featured" true) }}
@ -93,7 +93,7 @@ In addition to outputting markup, partials can be used to return a value of any
[...] [...]
{{ end }} {{ end }}
``` ```
#### Example GetImage ### Example GetImage
```go-html-template ```go-html-template
{{/* layouts/partials/GetImage.html */}} {{/* layouts/partials/GetImage.html */}}
{{ $image := false }} {{ $image := false }}
@ -117,7 +117,7 @@ In addition to outputting markup, partials can be used to return a value of any
Only one `return` statement is allowed per partial file. Only one `return` statement is allowed per partial file.
{{% /note %}} {{% /note %}}
### Cached Partials ## Cached Partials
The [`partialCached` template function][partialcached] can offer significant performance gains for complex templates that don't need to be re-rendered on every invocation. The simplest usage is as follows: The [`partialCached` template function][partialcached] can offer significant performance gains for complex templates that don't need to be re-rendered on every invocation. The simplest usage is as follows: