mirror of
https://github.com/gohugoio/hugo.git
synced 2024-11-14 20:37:55 -05:00
30 lines
894 B
Markdown
30 lines
894 B
Markdown
|
---
|
||
|
title: "complement"
|
||
|
description: "`collections.Complement` (alias `complement`) gives the elements of a collection that are not in any of the others."
|
||
|
date: 2018-11-07
|
||
|
categories: [functions]
|
||
|
menu:
|
||
|
docs:
|
||
|
parent: "functions"
|
||
|
keywords: [collections,intersect,union]
|
||
|
signature: ["COLLECTION | complement COLLECTION [COLLECTION]..." ]
|
||
|
hugoversion: "0.51"
|
||
|
aliases: []
|
||
|
---
|
||
|
|
||
|
Example:
|
||
|
|
||
|
```go-html-template
|
||
|
{{ $pages := .Site.RegularPages | first 50 }}
|
||
|
{{ $news := where $pages "Type" "news" | first 5 }}
|
||
|
{{ $blog := where $pages "Type" "blog" | first 5 }}
|
||
|
{{ $other := $pages | complement $news $blog | first 10 }}
|
||
|
```
|
||
|
|
||
|
The above is an imaginary use case for the home page where you want to display different page listings in sections/boxes on different places on the page: 5 from `news`, 5 from the `blog` and then 10 of the pages not shown in the other listings, to _complement_ them.
|
||
|
|
||
|
|
||
|
|
||
|
|
||
|
|