get_block_wrapper_attributes() – Function

Generates a string of attributes by applying to the current block being rendered all of the features that the block supports.

Parameters

$extra_attributesstring[]optional: Array of extra attributes to render on the block wrapper.
Default:array()

Return

string String of HTML attributes.

Source

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 '';
	}

	// This is hardcoded on purpose.
	// We only support a fixed list of attributes.
	$attributes_to_merge = array( 'style', 'class', 'id', 'aria-label' );
	$attributes          = array();
	foreach ( $attributes_to_merge as $attribute_name ) {
		if ( empty( $new_attributes[ $attribute_name ] ) && empty( $extra_attributes[ $attribute_name ] ) ) {
			continue;
		}

		if ( empty( $new_attributes[ $attribute_name ] ) ) {
			$attributes[ $attribute_name ] = $extra_attributes[ $attribute_name ];
			continue;
		}

		if ( empty( $extra_attributes[ $attribute_name ] ) ) {
			$attributes[ $attribute_name ] = $new_attributes[ $attribute_name ];
			continue;
		}

		$attributes[ $attribute_name ] = $extra_attributes[ $attribute_name ] . ' ' . $new_attributes[ $attribute_name ];
	}

	foreach ( $extra_attributes as $attribute_name => $value ) {
		if ( ! in_array( $attribute_name, $attributes_to_merge, true ) ) {
			$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 );
}

View all references View on Trac View on GitHub

Changelog

Version	Description
5.6.0	Introduced.

User Contributed Notes

Skip to note 3 content

Lovro Hrust 2 years ago

You must log in to vote on the helpfulness of this noteVote results for this note: 3You must log in to vote on the helpfulness of this note

Regarding Fabian Kägy’s comment, in WordPress 6.1.1 other attributes work too, even custom attribute like data-settings.

Log in to add feedback
Skip to note 4 content

Fabian Kägy 3 years ago

You must log in to vote on the helpfulness of this noteVote results for this note: 2You must log in to vote on the helpfulness of this note
At the time of WordPress 6.0 the get_block_wrapper_attributes function accepts two keys via the $extra_attributes. class and style.
```
$wrapper_attributes = get_block_wrapper_attributes(
	[
		'class' => 'custom-class',
		'style' => 'color: #333',
	]
);
```
In order to output the wrapper attributes, you need to add them inside your outermost HTML element in your block markup.
```
$wrapper_attributes = get_block_wrapper_attributes(
	[
		'class' => 'custom-class',
		'style' => 'color: #333',
	]
);

return sprintf( '<section %s>...</section>', $wrapper_attributes );
```
Log in to add feedback

get_block_wrapper_attributes( string[] $extra_attributes = array() ): string

In this article

Parameters

Return

Source

Changelog

User Contributed Notes