7. get_sub_field() und the_sub_field() | Field Forge - Benutzerdefinierte Felder, gebaut für Geschwindigkeit

Ruft einen Sub-Feldwert innerhalb einer have_rows()-Schleife ab oder gibt ihn aus. Diese Funktionen funktionieren nur im Kontext einer while ( have_rows() ) : the_row();-Schleife.

`get_sub_field( $selector )`

Parameter:

Parameter	Typ	Standard	Beschreibung
`$selector`	`string`	—	Sub-Feldname

Gibt zurück: mixed — der Sub-Feldwert.

`the_sub_field( $selector )`

Parameter:

Parameter	Typ	Standard	Beschreibung
`$selector`	`string`	—	Sub-Feldname

Gibt zurück: void (gibt direkt aus).

if ( have_rows( 'features' ) ) :
    echo '<ul>';
    while ( have_rows( 'features' ) ) : the_row();
        echo '<li>';
        echo '<strong>' . esc_html( get_sub_field( 'title' ) ) . '</strong>: ';
        the_sub_field( 'description' );
        echo '</li>';
    endwhile;
    echo '</ul>';
endif;

`get_sub_field_object( $selector )`

Erhält die vollständige Felddefinition eines Sub-Feldes innerhalb einer Zeilen-Schleife.

Parameter:

Parameter	Typ	Standard	Beschreibung
`$selector`	`string`	—	Sub-Feldname

Gibt zurück: array|false — Felddefinitions-Array mit value, oder false, wenn nicht gefunden.

if ( have_rows( 'settings' ) ) :
    while ( have_rows( 'settings' ) ) : the_row();
        $obj = get_sub_field_object( 'color_scheme' );
        // $obj = ['name' => 'color_scheme', 'type' => 'select', 'choices' => [...], 'value' => 'dark']
        echo '<p>Current: ' . esc_html( $obj['value'] ) . '</p>';
        echo '<p>Choices: ' . implode( ', ', $obj['choices'] ) . '</p>';
    endwhile;
endif;

—