acf_render_field_wrap()
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 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;
}