Skip to content

Kirby 5.0.0

$blocks->findBy()

Find a single element by an attribute and its value

$blocks->findBy(string $attribute, $value): Kirby\Cms\Block|null

Parameters

Name Type Default
$attributerequired string no default value
$valuerequired mixed no default value

Return types

Kirby\Cms\Blockornull

Parent class

Kirby\Cms\Blocks inherited from Kirby\Cms\Collection

Examples

Find blocks by attribute, e.g. type:

$textBlock = $page->text()->toBlocks()->findBy('type', 'image');

Returns the first block of type image if it exists.