serialize_block_attributes() の説明と使用例

WordPressのserialize_block_attributes()関数は、ブロックの属性をシリアライズ（文字列に変換）するために使用されます。Gutenbergブロックエディターでブロック属性を保存する際に利用されます。

構文

serialize_block_attributes( array $block_attributes );

単純な配列をシリアライズします。

$attributes = array('color' => 'blue', 'size' => 'large'); echo serialize_block_attributes($attributes);

ネストされた配列もシリアライズ可能です。

$attrs = array('style' => array('color' => 'red')); echo serialize_block_attributes($attrs);

真偽値属性を正しく処理します。

$attrs = array('active' => true); echo serialize_block_attributes($attrs);

数値型の属性を変換します。

$attrs = array('width' => 100); echo serialize_block_attributes($attrs);

空の配列をシリアライズすると空のJSONオブジェクトが返されます。

echo serialize_block_attributes(array());

複雑な多次元配列も処理可能です。

$attrs = array('settings' => array('showTitle' => false)); echo serialize_block_attributes($attrs);

実際のブロック登録時に使用する例。

register_block_type('my/block', array('attributes' => serialize_block_attributes($custom_attrs)));