Uses
Uses | Description |
---|---|
wp-includes/rest-api.php: rest_validate_value_from_schema() | Validate a value based on a schema. |
wp-includes/load.php: is_wp_error() | Check whether variable is a WordPress Error. |
Validates attributes against the current block schema, populating defaulted and missing values.
(array) (Required) Original block attributes.
(array) Prepared block attributes.
File: wp-includes/class-wp-block-type.php
public function prepare_attributes_for_render( $attributes ) { // If there are no attribute definitions for the block type, skip // processing and return vebatim. 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 ); 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; }
Version | Description |
---|---|
5.0.0 | Introduced. |
© 2003–2019 WordPress Foundation
Licensed under the GNU GPLv2+ License.
https://developer.wordpress.org/reference/classes/wp_block_type/prepare_attributes_for_render