Descrição
O wpforms_field_properties é acionado no carregamento do formulário para exibir as propriedades do campo, como rótulos, subrótulos e descrições, acima do campo do formulário.
Parâmetros
- $propriedades
- (matriz) Uma matriz de propriedades de campo, como rótulos, subrótulos e descrição.
- $campo
- (matriz) Dados de campo higienizados.
- $form_data
- (array) Configurações/dados de formulários processados, preparados para serem usados posteriormente.
Fonte
wpforms/includes/fields/class-base.php
Mais informações
O filtro é aplicado a uma matriz para propriedades específicas do campo de formulário. O uso desse filtro alterará todos os campos do formulário.
Cada campo de formulário terá seu próprio nome de filtro exclusivo. Consulte a seção abaixo para obter uma lista completa de exemplos documentados. Por exemplo, se você quiser alterar apenas o campo E-mail campo de formulário, você usaria wpforms_field_properties_email.
Exemplos
No exemplo abaixo, a função fará com que o campo Description (Descrição ) seja exibido acima do próprio campo, mas somente para o ID de formulário 225.
/**
* Move the field description above the form field.
*
* @link https://wpforms.com/developers/wpforms_field_properties/
*
* @param array $properties Field properties.
* @param array $field Field settings.
* @param array $form_data Form data and settings.
*
* @return array
*/
function wpf_dev_field_properties( $properties, $field, $form_data ) {
// Only process this snippet on the form ID 225
if ( absint( $form_data[ 'id' ] ) !== 225 ) {
return $properties;
}
// move the field description from under the form field to above the form field
$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
- Como alterar os subtítulos do campo E-mail
- Como processar tags inteligentes em campos HTML
- Como alterar os subtítulos do campo Name
- Como alterar os subtítulos do campo de endereço
- Como alterar os subtítulos do campo Senha
- Como alterar o atributo Name de um campo oculto