Atenção!

Este artigo contém código PHP e destina-se a programadores. Oferecemos este código como cortesia, mas não prestamos suporte para personalizações de código ou desenvolvimento de terceiros.

Para orientação adicional, consulte o tutorial da WPBeginner sobre como adicionar código personalizado.

Ignorar

Descrição

A ação wpforms_display_field_after é executada antes de o formulário ser exibido para determinar a posição de certos elementos do formulário, como os rótulos.

Parâmetros

$fields
(array) Valores/propriedades do campo de entrada higienizados.
$form_data
(array) Definições/dados do formulário.

Origem

wpforms/src/Frontend/Frontend.php

Mais Informações

A ação é executada antes de o formulário ser exibido. Esta ação pode ser usada para mover atributos do formulário, como os rótulos dos campos do formulário.

Exemplos

É importante notar que, ao usar esta ação para reposicionar o rótulo do campo abaixo do campo do formulário, deve primeiro usar também a ação wpforms_display_field_before para remover primeiro o rótulo da exibição antes do campo do formulário, de modo que possa chamar a ação para reposicionar o rótulo após o campo do formulário.

/**
 * Action fires before the form is displayed to determine position of certain form elements such as labels.
 *
 * @link   https://wpforms.com/developers/wpforms_display_field_after/
 * 
 * @param  array    $fields      Sanitized entry field values/properties.
 * @param  array    $form_data   Form settings/data.
 * @return array
 */


/* First remove the label from appearing above the form field for form 1289 */

function wpf_dev_display_field_before( $field, $form_data ) {
 
    if ( absint( $form_data[ 'id' ] ) !== 1289 ) {
        return;
    }

    remove_action( 'wpforms_display_field_before', array( wpforms()->frontend, 'field_label' ), 15 );
}
 
add_action( 'wpforms_display_field_before', 'wpf_dev_display_field_before', 10, 2 );



/* Now position the label to appear below the form field for form 1289 */

function wpf_dev_display_field_after( $field, $form_data ) {

    if ( absint( $form_data[ 'id' ] ) !== 1289 ) {
        return;
    }
 
    wpforms()->frontend->field_label( $field, $form_data );
}
 
add_action( 'wpforms_display_field_after', 'wpf_dev_display_field_after', 1, 2 );


Artigos de Referência

Ação de Referência

wpforms_display_field_before