Description
Le wpforms_field_properties
se déclenche au chargement du formulaire pour afficher les propriétés du champ, telles que les étiquettes, les sous-étiquettes et les descriptions, au-dessus du champ du formulaire.
Paramètres
- Propriétés
- (tableau) Un tableau de propriétés de champ telles que les étiquettes, les sous-étiquettes et la description.
- champ
- (tableau) Données de terrain assainies.
- $form_data
- (tableau) Paramètres/données de formulaire traités, préparés pour être utilisés ultérieurement.
Source
wpforms/includes/fields/class-base.php
Plus d'informations
Le filtre est appliqué à un tableau de propriétés de champs de formulaire spécifiques. L'utilisation de ce filtre modifiera tous les champs du formulaire.
Chaque champ de formulaire aura son propre nom de filtre. Voir la section ci-dessous pour une liste complète d'exemples documentés. Par exemple, si vous souhaitez uniquement modifier le champ Courriel vous utiliserez wpforms_field_properties_email
.
Exemples
Dans l'exemple ci-dessous, la fonction affichera la description du champ au-dessus du champ lui-même, mais uniquement pour le formulaire ID 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 );
Articles de référence
- Comment positionner la description du champ au-dessus du champ du formulaire ?
- Comment modifier les sous-étiquettes du champ Email ?
- Comment traiter les balises intelligentes dans les champs HTML
- Comment modifier les sous-étiquettes du champ Nom
- Comment modifier les sous-étiquettes du champ d'adresse ?
- Comment modifier les sous-étiquettes du champ Mot de passe
- Comment modifier l'attribut Name d'un champ caché ?