mirror of
https://github.com/gohugoio/hugo.git
synced 2024-12-01 18:22:58 -05:00
5fd1e74903
``` git subtree add --prefix=docs/ https://github.com/gohugoio/hugoDocs.git master --squash ``` Closes #11925
37 lines
761 B
Markdown
37 lines
761 B
Markdown
---
|
|
title: collections.First
|
|
description: Returns the given collection, limited to the first N elements.
|
|
categories: []
|
|
keywords: []
|
|
action:
|
|
aliases: [first]
|
|
related:
|
|
- functions/collections/After
|
|
- functions/collections/Last
|
|
- methods/pages/Limit
|
|
returnType: any
|
|
signatures: [collections.First N COLLECTION]
|
|
aliases: [/functions/first]
|
|
---
|
|
|
|
```go-html-template
|
|
{{ range first 5 .Pages }}
|
|
{{ .Render "summary" }}
|
|
{{ end }}
|
|
```
|
|
|
|
Set `N` to zero to return an empty collection.
|
|
|
|
```go-html-template
|
|
{{ $emptyPageCollection := first 0 .Pages}}
|
|
```
|
|
|
|
Use `first` and [`where`] together.
|
|
|
|
```go-html-template
|
|
{{ range where .Pages "Section" "articles" | first 5 }}
|
|
{{ .Render "summary" }}
|
|
{{ end }}
|
|
```
|
|
|
|
[`where`]: /functions/collections/where
|