update_sub_row()

WordPressのupdate_sub_row()関数は、Advanced Custom Fields (ACF)の繰り返しフィールド内の行の値を更新するために使用されます。

構文

update_sub_row( string $row_key, int $index, array $values );

引数の説明:

• $row_key (string) — 更新するサブ行のキー。
• $index (int) — 更新するサブ行のインデックス。
• $values (array) — 更新する値の配列。

例1: 特定の行の更新

特定の繰り返しフィールド内のサブ行を更新する基本的なコード例です。

update_sub_row( 'row_key', 1, array( 'field_1' => '新しい値' ) );

例2: 行のインデックスを使用して更新

インデックスを使って特定のサブ行を更新する例です。

update_sub_row( 'row_key', 2, array( 'field_2' => '更新された値' ) );

例3: 複数のフィールドを同時に更新

複数のフィールドを一度に更新する方法の例です。

update_sub_row( 'row_key', 3, array( 'field_1' => '値1', 'field_2' => '値2' ) );

例4: ループ内で行を更新

繰り返しフィールドのすべての行を更新する場合のコード例です。

for ( $i = 0; $i < count( get_field( 'row_key' ) ); $i++ ) {
    update_sub_row( 'row_key', $i, array( 'field_1' => '新しい値' ) );
}

例5: 条件に基づいて行を更新

特定の条件に基づいて行を更新する例です。

if ( get_field( 'field_1' ) == '条件' ) {
    update_sub_row( 'row_key', 1, array( 'field_2' => '条件に基づいた更新' ) );
}

警告:

• サブ行のインデックスはゼロから始まるため、正しいインデックスを指定する必要があります。
• 配列の形式で値を渡す必要があります。