### [wpforms_field_properties](https://wpforms.com/developers/wpforms_field_properties/) **Publicado:** 17 de fevereiro de 2021 **Autor:** David Ozokoye **Excerto:** O filtro wpforms_field_properties é acionado no carregamento do formulário para exibir as propriedades do campo, como rótulos, sub-rótulos e descrições. **Conteúdo:** ## Descrição O filtro `wpforms_field_properties` é acionado no carregamento do formulário para exibir as propriedades do campo, como rótulos, sub-rótulos e descrições acima do campo do formulário. ## Parâmetros $properties*(array)* Uma matriz de propriedades de campo, como rótulos, sub-rótulos e descrição.$field*(array)* Dados do campo sanitizados.$form\_data*(array)* Configurações/dados do formulário processados, preparados para serem usados posteriormente.## Origem `wpforms/includes/fields/class-base.php` ## Mais Informações O filtro é aplicado a uma matriz para propriedades específicas do campo do formulário. Usar este filtro alterará todos os campos do formulário. Cada campo do formulário terá seu próprio nome de filtro exclusivo. Veja a seção abaixo para uma lista completa de exemplos documentados. Por exemplo, se você quisesse alterar apenas o campo do formulário **Email**, você usaria `wpforms_field_properties_email`. ## Exemplos No exemplo abaixo, a função terá a **Descrição** do campo exibida acima do próprio campo, mas apenas para o ID do formulário **225**. ```php /** * Move a descrição do campo acima do campo do formulário. * * @link https://wpforms.com/developers/wpforms_field_properties/ * * @param array $properties Propriedades do campo. * @param array $field Configurações do campo. * @param array $form_data Dados e configurações do formulário. * * @return array */ function wpf_dev_field_properties( $properties, $field, $form_data ) { // Processa este trecho apenas no ID do formulário 225 if ( absint( $form_data[ 'id' ] ) !== 225 ) { return $properties; } // move a descrição do campo de baixo do campo do formulário para cima do campo do formulário $properties[ 'description' ][ 'position' ] = 'before'; return $properties; } add_filter( 'wpforms_field_properties', 'wpf_dev_field_properties', 10, 3 ); ``` ## Artigos de Referência - [Como Posicionar a Descrição do Campo Acima do Campo do Formulário](https://wpforms.com/developers/how-to-position-the-field-description-above-the-form-field/ "Como Posicionar a Descrição do Campo Acima do Campo do Formulário") - [Como Alterar Sub-rótulos para o Campo de Email](https://wpforms.com/developers/how-to-change-sublabels-for-the-email-field/ "Como Alterar Sub-rótulos para o Campo de Email") - [Como Processar Smart Tags em Campos HTML](https://wpforms.com/developers/how-to-process-smart-tags-in-html-fields/ "Como Processar Smart Tags em Campos HTML") - [Como Alterar Sub-rótulos para o Campo de Nome](https://wpforms.com/developers/how-to-change-sublabels-for-the-name-field/ "Como Alterar Sub-rótulos para o Campo de Nome") - [Como Alterar os Sub-rótulos do Campo de Endereço](https://wpforms.com/developers/how-to-change-the-address-field-sublabels/ "Como Alterar os Sub-rótulos do Campo de Endereço") - [Como Alterar os Sub-rótulos do Campo de Senha](https://wpforms.com/developers/how-to-change-the-password-field-sublabels/ "Como Alterar os Sub-rótulos do Campo de Senha") - [Como Alterar o Atributo Name de um Campo Oculto](https://wpforms.com/developers/how-to-change-the-name-attribute-of-a-hidden-field/ "Como Alterar o Atributo Name de um Campo Oculto") **Categorias:** Filtros Hooks **Tags:** PHP ---