get_sub_field_object()

WordPressの関数get_sub_field_object()は、Advanced Custom Fields（ACF）プラグインを使用している場合にサブフィールドの情報を取得するために使用されます。

構文

get_sub_field_object( string $selector );

• $selector (string) — サブフィールドの名前またはキー。必要。

戻り値

この関数は、サブフィールドのデータを含む配列を返します。データには、フィールドのラベル、タイプ、値などが含まれます。

例1: サブフィールドのラベルを取得

次のコードは、指定されたサブフィールドのラベルを取得します。

<?php
$field = get_sub_field_object('field_name');
echo $field['label'];
?>

例2: サブフィールドの値を取得

特定のサブフィールドの値を取得して表示するコードです。

<?php
$field = get_sub_field_object('field_name');
echo $field['value'];
?>

例3: サブフィールドのタイプを確認

サブフィールドのタイプを確認して、特定の処理を実行するコードです。

<?php
$field = get_sub_field_object('field_name');
if ($field['type'] === 'text') {
    echo 'This is a text field.';
}
?>

例4: サブフィールドのプレースホルダーを表示

プレースホルダーを取得して表示するコードです。

<?php
$field = get_sub_field_object('field_name');
echo $field['placeholder'];
?>

例5: サブフィールドの値を条件付きで表示

サブフィールドの値が特定の条件を満たす場合にのみ表示します。

<?php
$field = get_sub_field_object('field_name');
if ($field['value'] === 'example') {
    echo 'The value is example.';
}
?>

注意事項

get_sub_field_object()はACFプラグインが必要です。この関数を使用する前に、ACFが正しくインストールされていることを確認してください。また、サブフィールドが繰り返しフィールドやフレキシブルコンテンツ内に存在する場合にのみ機能します。