acf_get_raw_field()

WordPressのacf_get_raw_field()関数は、Advanced Custom Fields（ACF）プラグインで使用される関数で、指定されたフィールドの生データを取得します。この関数は、フィールドキーを使用してフィールドの設定を取得するために使用されます。

構文

acf_get_raw_field( $selector, $post_id = false, $format_value = true, $load_value = true );

引数の説明:

• $selector (string|array) — フィールド名、フィールドキー、またはフィールドオブジェクト。
• $post_id (int|string) — ポストIDまたはオプション名（デフォルトは現在のポスト）。
• $format_value (bool) — 値をフォーマットするかどうか（デフォルトはtrue）。
• $load_value (bool) — フィールドの値をロードするかどうか（デフォルトはtrue）。

例1: フィールドキーを使用してフィールドの生データを取得

フィールドキーを使用してフィールドの生データを取得する例です。

$field = acf_get_raw_field('field_1234567890abc'); echo $field['label'];

例2: ポストIDを指定してフィールドの生データを取得

特定のポストIDを指定してフィールドの生データを取得する例です。

$field = acf_get_raw_field('custom_field_name', get_the_ID()); echo $field['label'];

例3: フォーマットされた値を無効にしてフィールドデータを取得

フォーマットされた値を無効にしてフィールドデータを取得する例です。

$field = acf_get_raw_field('custom_field_name', false, false); print_r($field);

例4: フィールドの値をロードせずに設定のみを取得

フィールドの値をロードせずに設定のみを取得する例です。

$field = acf_get_raw_field('custom_field_name', false, true, false); print_r($field);

例5: フィールドオブジェクトを使用して生データを取得

フィールドオブジェクトを使用して生データを取得する例です。

$field_object = get_field_object('custom_field_name'); $raw_field = acf_get_raw_field($field_object); echo $raw_field['label'];

例6: オプションページのフィールドデータを取得

オプションページのフィールドデータを取得する例です。

$field = acf_get_raw_field('option_field_name', 'option'); echo $field['label'];

例7: フィールドのデフォルト値を取得

フィールドのデフォルト値を取得する例です。

$field = acf_get_raw_field('custom_field_name'); echo $field['default_value'];

例8: フィールドのタイプを確認

フィールドのタイプを確認する例です。

$field = acf_get_raw_field('custom_field_name'); echo $field['type'];

注意点

• フィールドキーが正しく指定されていない場合、関数はfalseを返します。
• フィールドが存在しない場合や、ポストIDが無効な場合もfalseを返します。
• フォーマットされた値を無効にすると、生のデータが返されますが、表示用に適していない場合があります。