acf_is_empty()

WordPressのacf_is_empty()関数は、Advanced Custom Fields（ACF）プラグインで使用される関数で、指定された値が空かどうかをチェックします。この関数は、フィールドの値が空かどうかを確認する際に役立ちます。

構文

acf_is_empty( mixed $value );

• $value(mixed) — チェックする値。文字列、配列、オブジェクトなどが指定可能です。

例1: 基本的な使用例

この例では、フィールドの値が空かどうかをチェックします。

<?php if ( acf_is_empty( get_field('my_field') ) ) { echo 'フィールドは空です。'; } else { echo 'フィールドは空ではありません。'; } ?>

例2: 配列のチェック

配列が空かどうかをチェックする例です。

<?php $array = array(); if ( acf_is_empty( $array ) ) { echo '配列は空です。'; } ?>

例3: 文字列のチェック

文字列が空かどうかをチェックする例です。

<?php $string = ''; if ( acf_is_empty( $string ) ) { echo '文字列は空です。'; } ?>

例4: オブジェクトのチェック

オブジェクトが空かどうかをチェックする例です。

<?php $object = new stdClass(); if ( acf_is_empty( $object ) ) { echo 'オブジェクトは空です。'; } ?>

例5: カスタムフィールドのチェック

カスタムフィールドの値が空かどうかをチェックする例です。

<?php $field_value = get_field('custom_field'); if ( acf_is_empty( $field_value ) ) { echo 'カスタムフィールドは空です。'; } ?>

例6: 条件分岐での使用

条件分岐でacf_is_empty()を使用する例です。

<?php if ( !acf_is_empty( get_field('my_field') ) ) { the_field('my_field'); } ?>

例7: ループ内での使用

ループ内でフィールドの値が空かどうかをチェックする例です。

<?php while ( have_posts() ) : the_post(); if ( !acf_is_empty( get_field('my_field') ) ) { the_field('my_field'); } endwhile; ?>

例8: 複数のフィールドをチェック

複数のフィールドが空かどうかをチェックする例です。

<?php if ( acf_is_empty( get_field('field_1') ) && acf_is_empty( get_field('field_2') ) ) { echo '両方のフィールドは空です。'; } ?>

注意点

• acf_is_empty()は、値が空かどうかを厳密にチェックします。空文字列、空の配列、空のオブジェクトなどが該当します。
• この関数はACFプラグインが有効になっている場合にのみ使用可能です。