acf_is_field_key()


WordPressの関数acf_is_field_key()は、指定された文字列がACF（Advanced Custom Fields）のフィールドキーかどうかを判定するために使用されます。

構文

acf_is_field_key( string $key );
  • $key (string) — ACFフィールドキーかどうかを判定するための文字列。

例1: フィールドキーの確認

この例では、指定された文字列がACFフィールドキーかどうかを確認します。

<?php if ( acf_is_field_key('field_1234567890abc') ) { echo 'これはACFフィールドキーです。'; } else { echo 'これはACFフィールドキーではありません。'; } ?>

例2: カスタムフィールドのキーを動的に確認

この例では、動的に取得したフィールドキーがACFフィールドキーかどうかを確認します。

<?php $field_key = get_field_key('custom_field_name'); if ( acf_is_field_key($field_key) ) { echo '動的に取得したキーはACFフィールドキーです。'; } ?>

例3: ループ内でのフィールドキーの確認

この例では、ループ内で各フィールドのキーがACFフィールドキーかどうかを確認します。

<?php if ( have_rows('repeater_field') ) { while ( have_rows('repeater_field') ) { the_row(); $sub_field_key = get_sub_field('sub_field_key'); if ( acf_is_field_key($sub_field_key) ) { echo 'サブフィールドキーはACFフィールドキーです。'; } } } ?>

例4: フィールドキーのバリデーション

この例では、ユーザー入力がACFフィールドキーかどうかをバリデーションします。

<?php $user_input = $_POST['field_key']; if ( acf_is_field_key($user_input) ) { echo '有効なACFフィールドキーです。'; } else { echo '無効なACFフィールドキーです。'; } ?>

例5: フィールドキーの存在確認

この例では、フィールドキーが存在するかどうかを確認します。

<?php $field_key = 'field_1234567890abc'; if ( acf_is_field_key($field_key) && get_field($field_key) ) { echo 'フィールドが存在します。'; } ?>

例6: フィールドキーの比較

この例では、2つのフィールドキーが同じかどうかを比較します。

<?php $field_key_1 = 'field_1234567890abc'; $field_key_2 = 'field_0987654321xyz'; if ( acf_is_field_key($field_key_1) && acf_is_field_key($field_key_2) && $field_key_1 === $field_key_2 ) { echo 'フィールドキーは同じです。'; } ?>

例7: フィールドキーの配列確認

この例では、配列内の各要素がACFフィールドキーかどうかを確認します。

<?php $field_keys = array('field_1234567890abc', 'field_0987654321xyz'); foreach ( $field_keys as $key ) { if ( acf_is_field_key($key) ) { echo $key . 'はACFフィールドキーです。'; } } ?>

例8: フィールドキーのログ出力

この例では、フィールドキーがACFフィールドキーかどうかを確認し、結果をログに出力します。

<?php $field_key = 'field_1234567890abc'; if ( acf_is_field_key($field_key) ) { error_log($field_key . 'はACFフィールドキーです。'); } ?>

注意点

  • この関数は、文字列がACFフィールドキーの形式に一致するかどうかを確認するだけで、実際にそのフィールドが存在するかどうかは確認しません。
  • フィールドキーは通常、field_で始まる一意の文字列です。

関連機能：