функция
since 5.6.0
get_block_wrapper_attributes()
Проверено на WordPress 6.9, обновлено Источник: WordPress Developer Resources.
Сигнатура
get_block_wrapper_attributes( string[] $extra_attributes = array() ): string
Описание
Формирует строку атрибутов, применяя к текущему отрисовываемому блоку все поддерживаемые им возможности.
Параметры
$extra_attributes
string[]
необязательный
= array()
Массив дополнительных атрибутов для отрисовки в обёртке блока.
Возвращаемое значение
string
Исходный код
wp-includes/class-wp-block-supports.php:175
function get_block_wrapper_attributes( $extra_attributes = array() ) {
$new_attributes = WP_Block_Supports::get_instance()->apply_block_supports();
if ( empty( $new_attributes ) && empty( $extra_attributes ) ) {
return '';
}
// Attribute values are concatenated or overridden depending on the attribute type.
// This is hardcoded on purpose, as we only support a fixed list of attributes.
$attribute_merge_callbacks = array(
'style' => static function ( $new_attribute, $extra_attribute ) {
$styles = array_filter(
array(
rtrim( trim( $new_attribute ), ';' ),
rtrim( trim( $extra_attribute ), ';' ),
)
);
return safecss_filter_attr( implode( ';', array_filter( $styles ) ) );
},
'class' => static function ( $new_attribute, $extra_attribute ) {
$classes = array_merge(
(array) preg_split( '/\s+/', $extra_attribute, -1, PREG_SPLIT_NO_EMPTY ),
(array) preg_split( '/\s+/', $new_attribute, -1, PREG_SPLIT_NO_EMPTY )
);
$classes = array_unique( array_filter( $classes ) );
return implode( ' ', $classes );
},
'id' => static function ( $new_attribute, $extra_attribute ) {
return '' !== $extra_attribute ? $extra_attribute : $new_attribute;
},
'aria-label' => static function ( $new_attribute, $extra_attribute ) {
return '' !== $extra_attribute ? $extra_attribute : $new_attribute;
},
);
$attributes = array();
foreach ( $attribute_merge_callbacks as $attribute_name => $merge_callback ) {
$new_attribute = $new_attributes[ $attribute_name ] ?? '';
$extra_attribute = $extra_attributes[ $attribute_name ] ?? '';
$new_attribute = is_string( $new_attribute ) ? $new_attribute : '';
$extra_attribute = is_string( $extra_attribute ) ? $extra_attribute : '';
if ( '' === $new_attribute && '' === $extra_attribute ) {
continue;
}
$attributes[ $attribute_name ] = $merge_callback( $new_attribute, $extra_attribute );
}
foreach ( $extra_attributes as $attribute_name => $value ) {
if ( ! isset( $attribute_merge_callbacks[ $attribute_name ] ) ) {
$attributes[ $attribute_name ] = $value;
}
}
if ( empty( $attributes ) ) {
return '';
}
$normalized_attributes = array();
foreach ( $attributes as $key => $value ) {
$normalized_attributes[] = $key . '="' . esc_attr( $value ) . '"';
}
return implode( ' ', $normalized_attributes );
}
История изменений
| Версия | Описание |
|---|---|
| 5.6.0 | Introduced. |

