get_row_sub_field()

WordPressの関数get_row_sub_field()は、Advanced Custom Fields (ACF) プラグインを使用して、リピーターフィールド内のサブフィールドの値を取得するために使用されます。

構文

get_row_sub_field( string $selector );

• $selector (string) — サブフィールドの名前またはキー。これにより、リピーターフィールド内の特定のサブフィールドを識別します。

使用例 1: サブフィールドの値を取得する

リピーターフィールド内の特定のサブフィールドの値を取得します。

<?php $value = get_row_sub_field('sub_field_name'); ?>

使用例 2: サブフィールドをループで表示する

リピーターフィールド内のすべてのサブフィールドの値を表示するためのループを使用します。

<?php if( have_rows('repeater_field_name') ): ?>
  <?php while( have_rows('repeater_field_name') ): the_row(); ?>
    <p><?php the_sub_field('sub_field_name'); ?></p>
  <?php endwhile; ?>
<?php endif; ?>

使用例 3: サブフィールドの値を条件に基づいて表示する

特定の条件に基づいてサブフィールドの値を表示します。

<?php if( get_row_sub_field('sub_field_name') == '特定の値' ): ?>
  <p>条件に一致しました</p>
<?php endif; ?>

使用例 4: サブフィールドの値を変数に格納して使用する

サブフィールドの値を変数に格納し、後で利用します。

<?php $sub_field_value = get_row_sub_field('sub_field_name'); ?>
<p>サブフィールドの値: <?php echo $sub_field_value; ?></p>

使用例 5: サブフィールドの値を数値として扱う

サブフィールドの値を数値として扱い、計算を行います。

<?php $num_value = get_row_sub_field('sub_field_name'); ?>
<p>計算結果: <?php echo $num_value * 2; ?></p>

使用例 6: サブフィールドの値をエラーチェックする

サブフィールドが空でないかチェックし、空であればデフォルト値を表示します。

<?php $sub_field_value = get_row_sub_field('sub_field_name'); ?>
<p><?php echo ($sub_field_value) ? $sub_field_value : 'デフォルト値'; ?></p>

注意点

• リピーターフィールドを使用する際には、必ずhave_rows()とthe_row()を使って、リピーター内の各行にアクセスする必要があります。
• 引数$selectorには、サブフィールドの名前またはキーを指定することが必要です。
• サブフィールドが存在しない場合、この関数は空の値を返しますので、その場合の処理を適切に行う必要があります。