15. Campos Repetidores | Field Forge - Campos personalizados, diseñados para la velocidad

Los campos repetidores almacenan filas ordenadas de subcampos. Cada fila contiene el mismo conjunto de subcampos. Esta es una característica PRO ideal para listas estructuradas como miembros del equipo, elementos de preguntas frecuentes, niveles de precios, especificaciones y cualquier otro patrón de datos repetitivos.

Bucle Repetidor Básico

<?php if ( have_rows( 'team_members' ) ) : ?>
    <div class="team-grid">
        <?php while ( have_rows( 'team_members' ) ) : the_row(); ?>
            <div class="team-card">
                <?php $photo = get_sub_field( 'photo' ); ?>
                <?php if ( $photo ) : ?>
                    <img src="<?php echo esc_url( $photo['url'] ); ?>"
                         alt="<?php echo esc_attr( $photo['alt'] ); ?>"
                         class="team-card__photo">
                <?php endif; ?>
                <h3><?php the_sub_field( 'name' ); ?></h3>
                <p class="position"><?php the_sub_field( 'position' ); ?></p>
                <p class="bio"><?php the_sub_field( 'bio' ); ?></p>
            </div>
        <?php endwhile; ?>
    </div>
<?php else : ?>
    <p>No team members found.</p>
<?php endif; ?>

Diseño de Tabla

<?php if ( have_rows( 'specifications' ) ) : ?>
    <table class="specs-table">
        <thead><tr><th>Property</th><th>Value</th><th>Unit</th></tr></thead>
        <tbody>
            <?php while ( have_rows( 'specifications' ) ) : the_row(); ?>
                <tr>
                    <td><?php the_sub_field( 'label' ); ?></td>
                    <td><?php the_sub_field( 'value' ); ?></td>
                    <td><?php the_sub_field( 'unit' ); ?></td>
                </tr>
            <?php endwhile; ?>
        </tbody>
    </table>
<?php endif; ?>

Repetidores Anidados

Los repetidores pueden contener otros repetidores. La llamada interna de have_rows() está automáticamente limitada a la fila exterior actual.

<?php
// A "departments" repeater with a nested "employees" repeater
if ( have_rows( 'departments' ) ) :
    while ( have_rows( 'departments' ) ) : the_row(); ?>
        <section class="department">
            <h2><?php the_sub_field( 'department_name' ); ?></h2>
            <?php if ( have_rows( 'employees' ) ) : ?>
                <div class="employee-grid">
                    <?php while ( have_rows( 'employees' ) ) : the_row(); ?>
                        <div class="employee-card">
                            <h4><?php the_sub_field( 'employee_name' ); ?></h4>
                            <span class="role"><?php the_sub_field( 'role' ); ?></span>
                        </div>
                    <?php endwhile; ?>
                </div>
            <?php endif; ?>
        </section>
    <?php endwhile;
endif;
?>

Patrón de Acordeón/Preguntas Frecuentes

<?php if ( have_rows( 'faq_items' ) ) : ?>
    <div class="faq-accordion" itemscope itemtype="https://schema.org/FAQPage">
        <?php while ( have_rows( 'faq_items' ) ) : the_row();
            $id = 'faq-' . get_row_index();
        ?>
            <div class="faq-item" itemscope itemprop="mainEntity" itemtype="https://schema.org/Question">
                <h3 class="faq-question" itemprop="name">
                    <button aria-expanded="false" aria-controls="<?php echo $id; ?>">
                        <?php the_sub_field( 'question' ); ?>
                    </button>
                </h3>
                <div class="faq-answer" id="<?php echo $id; ?>" itemscope itemprop="acceptedAnswer" itemtype="https://schema.org/Answer">
                    <div itemprop="text"><?php the_sub_field( 'answer' ); ?></div>
                </div>
            </div>
        <?php endwhile; ?>
    </div>
<?php endif; ?>

Actualizaciones de Fila Programáticas

// Add a new row to a repeater
$members = get_field( 'team_members', 42 );
if ( ! is_array( $members ) ) {
    $members = [];
}
$members[] = [
    'name'     => 'Jane Doe',
    'position' => 'CTO',
    'bio'      => 'Experienced technology leader.',
];

$field_def = FIELDFORGE_Field_Groups::instance()->find_field( 'team_members', 42 );
FIELDFORGE_Field_Values::instance()->save_compound_field(
    'team_members',
    $members,
    42,
    $field_def
);

// Remove a specific row
$members = get_field( 'team_members', 42 );
array_splice( $members, 2, 1 ); // Remove the 3rd row (index 2)
$field_def = FIELDFORGE_Field_Groups::instance()->find_field( 'team_members', 42 );
FIELDFORGE_Field_Values::instance()->save_compound_field(
    'team_members',
    $members,
    42,
    $field_def
);

Contando Filas

$team = get_field( 'team_members' );
$count = $team ? count( $team ) : 0;
echo '<p>Team size: ' . $count . ' members</p>';

// Show "empty state" when no rows exist
if ( ! have_rows( 'testimonials' ) ) {
    echo '<div class="empty-state"><p>No testimonials yet.</p></div>';
}

—