get_block_wrapper_attributes()

WordPressのget_block_wrapper_attributes()関数は、ブロックのラッパー要素に必要なHTML属性を生成するために使用されます。Gutenbergブロック開発において、クラスやスタイルなどの属性を簡単に追加できます。

構文

get_block_wrapper_attributes( array $extra_attributes = array() );

• $extra_attributes (array) — 追加したい属性を連想配列で指定

例1: 基本的な使用法

ブロックのラッパーにデフォルトのクラスと属性を追加します。

<div <?php echo get_block_wrapper_attributes(); ?>>コンテンツ</div>

例2: カスタムクラスの追加

追加のクラスを指定してラッパー属性を生成します。

<div <?php echo get_block_wrapper_attributes(array('class' => 'custom-class')); ?>>コンテンツ</div>

例3: インラインスタイルの追加

スタイル属性を追加してラッパー要素に適用します。

<div <?php echo get_block_wrapper_attributes(array('style' => 'color: red;')); ?>>コンテンツ</div>

例4: データ属性の追加

カスタムデータ属性をラッパー要素に追加します。

<div <?php echo get_block_wrapper_attributes(array('data-id' => '123')); ?>>コンテンツ</div>

例5: 複数の属性を同時に追加

クラス、スタイル、データ属性をまとめて追加します。

<div <?php echo get_block_wrapper_attributes(array('class' => 'custom-class', 'style' => 'background: blue;', 'data-test' => 'value')); ?>>コンテンツ</div>

例6: 動的なクラス名の追加

条件に応じてクラス名を動的に追加します。

<div <?php echo get_block_wrapper_attributes(array('class' => is_front_page() ? 'home-class' : 'normal-class')); ?>>コンテンツ</div>

例7: ARIA属性の追加

アクセシビリティ向上のためにARIA属性を追加します。

<div <?php echo get_block_wrapper_attributes(array('aria-label' => 'メインコンテンツ')); ?>>コンテンツ</div>

注意点:

• この関数はGutenbergブロックエディタ環境でのみ動作します
• 属性値は適切にエスケープされますが、信頼できないソースからの入力には注意が必要です
• 配列のキーは有効なHTML属性名である必要があります