$pages->filterBy()

$pages->filterBy(mixed ...$args = null): Kirby\Cms\Pages

// fetch children with a field 'draft', which has the value 'yes'
$items = $page->children()->filterBy('draft', 'yes');

// fetch children with a date in the past
$items = $page->children()->filter(
    fn ($child) => $child->date()->toDate() < time()
);

// fetch children with a date in the future
$items = $page->children()->filter(
    fn ($child) => $child->date()->toDate() > time()
);

// fetch any page with a project template
$items = $site->index()->filterBy('template', 'project');

// fetch any page with either an article or project template
$items = $site->index()->filterBy('template', 'in', ['article', 'project']);

// fetch children that have the tag 'development'
$items = $page->children()->filterBy('tag', 'development', ',');

// fetch children that have the tag 'development' from a tags field with separator ';'
$items = $page->children()->filterBy('tag', 'development', ';');