acf_get_sub_field() │ ACF 5.7.10

acf_get_sub_field

Searches a field for sub fields matching the given selector.

Returns

(Array|false).

Usage

acf_get_sub_field( $id, $field );

$id((int|string)) (required)

The field ID, key or name.

$field(array) (required)

The parent field array.

Changelog

acf_get_sub_field() acf get sub field code ^{ACF 6.0.4}

function acf_get_sub_field( $id, $field ) {

	// Vars.
	$sub_field = false;

	// Search sub fields.
	if ( isset( $field['sub_fields'] ) ) {
		$sub_field = acf_search_fields( $id, $field['sub_fields'] );
	}

	/**
	 * Filters the $sub_field found.
	 *
	 * @date    12/02/2014
	 * @since   5.0.0
	 *
	 * @param   array $sub_field The found sub field array.
	 * @param   string $selector The selector used to search.
	 * @param   array $field The parent field array.
	 */
	$sub_field = apply_filters( 'acf/get_sub_field', $sub_field, $id, $field );

	// return
	return $sub_field;

}