lib/block-supports/aria-label.php - trunk - githubmirror/gutenberg

lib/block-supports/aria-label.php

66 строк2 KB

Aki Hamano

Block Support: Allow serialization skipping for ariaLabel (#75192)

04 фев 2026, 15:29

04 фев 2026, 15:29a1aadf6

<?php
/**
 * Aria label block support flag.
 *
 * @package gutenberg
 */

/**
 * Registers the aria-label block attribute for block types that support it.
 *
 * @param WP_Block_Type $block_type Block Type.
 */
function gutenberg_register_aria_label_support( $block_type ) {
	$has_aria_label_support = block_has_support( $block_type, array( 'ariaLabel' ), false );

	if ( ! $has_aria_label_support ) {
		return;
	}

	if ( ! $block_type->attributes ) {
		$block_type->attributes = array();
	}

	if ( ! array_key_exists( 'ariaLabel', $block_type->attributes ) ) {
		$block_type->attributes['ariaLabel'] = array(
			'type' => 'string',
		);
	}
}

/**
 * Add the aria-label to the output.
 *
 * @param WP_Block_Type $block_type Block Type.
 * @param array         $block_attributes Block attributes.
 *
 * @return array Block aria-label.
 */
function gutenberg_apply_aria_label_support( $block_type, $block_attributes ) {
	if ( ! $block_attributes ) {
		return array();
	}

	$has_aria_label_support = block_has_support( $block_type, array( 'ariaLabel' ), false );
	if (
		! $has_aria_label_support ||
		wp_should_skip_block_supports_serialization( $block_type, 'ariaLabel' )
	) {
		return array();
	}

	$has_aria_label = array_key_exists( 'ariaLabel', $block_attributes );
	if ( ! $has_aria_label ) {
		return array();
	}
	return array( 'aria-label' => $block_attributes['ariaLabel'] );
}

// Register the block support.
WP_Block_Supports::get_instance()->register(
	'aria-label',
	array(
		'register_attribute' => 'gutenberg_register_aria_label_support',
		'apply'              => 'gutenberg_apply_aria_label_support',
	)
);