collections.First
Syntax
collections.First LIMIT COLLECTION ⟼ any
Alias
first
first
works in a similar manner to the limit
keyword in
SQL. It reduces the array to only the first N
elements. It takes the array and number of elements as input.
first
takes two arguments:
number of elements
array
orslice of maps or structs
layout/_default/section.html
{{ range first 10 .Pages }}
{{ .Render "summary" }}
{{ end }}
Note: Exclusive to first
, LIMIT can be ‘0’ to return an empty array.
first
and where
Together
Using first
and where
together can be very
powerful. Below snippet gets a list of posts only from main
sections, sorts it by the title
parameter, and then
ranges through only the first 5 posts in that list:
first-and-where-together.html
{{ range first 5 (where site.RegularPages "Type" "in" site.Params.mainSections).ByTitle }}
{{ .Content }}
{{ end }}