WP_Block_Type::prepare_attributes_for_render( array $attributes ): array

In this article

Validates attributes against the current block schema, populating defaulted and missing values.

Parameters

$attributesarrayrequired
Original block attributes.

Return

array Prepared block attributes.

Source

public function prepare_attributes_for_render( $attributes ) {
	// If there are no attribute definitions for the block type, skip
	// processing and return verbatim.
	if ( ! isset( $this->attributes ) ) {
		return $attributes;
	}

	foreach ( $attributes as $attribute_name => $value ) {
		// If the attribute is not defined by the block type, it cannot be
		// validated.
		if ( ! isset( $this->attributes[ $attribute_name ] ) ) {
			continue;
		}

		$schema = $this->attributes[ $attribute_name ];

		// Validate value by JSON schema. An invalid value should revert to
		// its default, if one exists. This occurs by virtue of the missing
		// attributes loop immediately following. If there is not a default
		// assigned, the attribute value should remain unset.
		$is_valid = rest_validate_value_from_schema( $value, $schema, $attribute_name );
		if ( is_wp_error( $is_valid ) ) {
			unset( $attributes[ $attribute_name ] );
		}
	}

	// Populate values of any missing attributes for which the block type
	// defines a default.
	$missing_schema_attributes = array_diff_key( $this->attributes, $attributes );
	foreach ( $missing_schema_attributes as $attribute_name => $schema ) {
		if ( isset( $schema['default'] ) ) {
			$attributes[ $attribute_name ] = $schema['default'];
		}
	}

	return $attributes;
}

Changelog

VersionDescription
5.0.0Introduced.

User Contributed Notes

You must log in before being able to contribute a note or feedback.