$pages->filter()
Filters elements by one of the predefined filter methods, by a custom filter function or an array of filters
$pages->filter(Closure|array|string $field): Kirby\Cms\Pages
Parameters
Name | Type | Default |
---|---|---|
$fieldrequired | Closure orarray orstring |
no default value |
Return type
This method does not modify the existing $pages
object but returns a new object with the changes applied. Learn more →
Parent class
Kirby\Cms\Pages
inherited from Kirby\Toolkit\Collection
Examples
// fetch children with a title starting with 'Project'
$items = $page->children()->filter(
fn ($child) => Str::startsWith($child->title(), 'Project')
);
// fetch children with more than 2 images
$items = $page->children()->filter(
fn ($child) => $child->images()->count() > 2
);
// fetch visible children which have visible children
$items = $page->children()->listed()->filter(
fn ($child) => $child->hasListedChildren()
);