acf_get_field_type_prop()


Advanced Custom Fields (ACF)のacf_get_field_type_prop()関数は、特定のフィールドタイプに関連するプロパティを取得するために使用されます。

構文

acf_get_field_type_prop( string $field_type, string $property );

引数の説明

  • $field_type (string) — フィールドのタイプ(例: 'text', 'select')。
  • $property (string) — 取得したいプロパティ名(例: 'label', 'category')。

例 1: フィールドタイプのラベルを取得

以下のコードは、特定のフィールドタイプのラベルを取得します。

<?php
$field_label = acf_get_field_type_prop( 'text', 'label' );
echo $field_label;
?>

例 2: フィールドタイプのカテゴリを取得

指定したフィールドタイプのカテゴリ情報を取得します。

<?php
$field_category = acf_get_field_type_prop( 'image', 'category' );
echo $field_category;
?>

例 3: 存在しないプロパティのチェック

存在しないプロパティを指定した場合にエラーを回避するコードです。

<?php
$property = acf_get_field_type_prop( 'text', 'nonexistent_property' );
if ( $property ) {
    echo $property;
} else {
    echo 'プロパティが見つかりません。';
}
?>

例 4: フィールド情報をループで表示

すべての利用可能なフィールドタイプをループしてプロパティを取得します。

<?php
$field_types = ['text', 'image', 'select'];
foreach ( $field_types as $type ) {
    echo acf_get_field_type_prop( $type, 'label' ) . '<br>';
}
?>

例 5: カスタムロジックでプロパティを利用

特定の条件に基づいて異なるプロパティを取得します。

<?php
$field_type = 'text';
$property = 'label';
if ( $field_type === 'image' ) {
    $property = 'category';
}
echo acf_get_field_type_prop( $field_type, $property );
?>

注意事項

  • 不正なフィールドタイプやプロパティを指定すると、nullが返される場合があります。