Descrição
O wpforms_field_properties
é ativado no carregamento do formulário para apresentar 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, tais como etiquetas, sub-rótulos e descrição.
- $campo
- (matriz) Dados de campo higienizados.
- $form_data
- (matriz) Definições/dados de formulários processados, preparados para serem utilizados posteriormente.
Fonte
wpforms/includes/fields/class-base.php
Mais informações
O filtro é aplicado a uma matriz para propriedades específicas do campo do formulário. A utilização deste filtro irá alterar todos os campos do formulário.
Cada campo de formulário terá o seu próprio nome de filtro exclusivo. Consulte a secção abaixo para obter uma lista completa de exemplos documentados. Por exemplo, se apenas pretender alterar o campo Correio eletrónico campo de formulário, usaria wpforms_field_properties_email
.
Exemplos
No exemplo abaixo, a função fará com que o campo Descrição seja apresentado por cima do próprio campo, mas apenas 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 sub-rótulos do campo E-mail
- Como processar etiquetas inteligentes em campos HTML
- Como alterar os sub-rótulos do campo Nome
- Como alterar os sub-rótulos do campo de endereço
- Como alterar os sub-rótulos do campo Palavra-passe
- Como alterar o atributo Nome de um campo oculto