acf_render_field_wrap() │ ACF 5.0.0

Render the wrapping element for a given field.

Хуков нет.

Возвращает

boolean. True if the field was rendered, false if acf/prepare_field removed it.

Использование

acf_render_field_wrap( $field, $element, $instruction, $field_setting );
$field(массив) (обязательный)
The field array.
$element(строка)
The wrapping element type.
По умолчанию: 'div'
$instruction(строка)
The instruction render position (label|field).
По умолчанию: 'label'
$field_setting(true|false)
If a field setting is being rendered.
По умолчанию: false

Список изменений

С версии 5.0.0 Введена.
С версии 6.8.11 Returns whether the field was rendered.

Код acf_render_field_wrap() ACF 6.8.11

function acf_render_field_wrap( $field, $element = 'div', $instruction = 'label', $field_setting = false ) {

	// Ensure field is complete (adds all settings).
	$field = acf_validate_field( $field );

	// The top-level key is read from the field before acf/prepare_field, which can change the key of clone sub fields.
	$unprepared = $field;

	// Prepare field for input (modifies settings).
	$field = acf_prepare_field( $field );

	// Allow filters to cancel render.
	if ( ! $field ) {
		return false;
	}

	$is_outer = _acf_in_field_render(
		false,
		function () use ( $field, $element, $instruction, $field_setting ) {
			_acf_render_field_wrap_html( $field, $element, $instruction, $field_setting );
		}
	);

	// A field rendered outside acf_render_fields() lists its own key, if it is submitted under acf[].
	$root_key = $is_outer ? acf_get_field_root_key( $unprepared ) : '';
	if ( '' !== $root_key ) {
		_acf_render_field_list( array( $root_key ), acf_get_current_render_id(), '_acf_fields' );
	}

	return true;
}