acf_get_block_fields()


WordPressのacf_get_block_fields()関数は、ACF(Advanced Custom Fields)ブロックに関連付けられたフィールドを取得するために使用されます。この関数は、ブロックエディタ内でカスタムフィールドを操作する際に役立ちます。

構文

acf_get_block_fields( array $block );
  • $block(array) — ACFブロックの設定を含む配列。通常、acf_register_block()で登録されたブロックの情報が含まれます。

例1: ブロックフィールドの取得

この例では、現在のブロックに関連付けられたフィールドを取得します。

$fields = acf_get_block_fields( $block );

例2: フィールド値の表示

取得したフィールドの値を表示します。

$fields = acf_get_block_fields( $block ); echo $fields['field_name'];

例3: フィールドのループ処理

取得したフィールドをループして処理します。

$fields = acf_get_block_fields( $block ); foreach( $fields as $field ) { echo $field; }

例4: 条件付きフィールド表示

特定のフィールドが存在する場合にのみ表示します。

$fields = acf_get_block_fields( $block ); if( isset( $fields['field_name'] ) ) { echo $fields['field_name']; }

例5: フィールドのJSON出力

取得したフィールドをJSON形式で出力します。

$fields = acf_get_block_fields( $block ); echo json_encode( $fields );

注意点

  • acf_get_block_fields()は、ACFブロックが正しく登録されている場合にのみ機能します。
  • ブロックが登録されていない場合、この関数は空の配列を返します。