apply_filters( 'wpforms_field_properties', array $properties, array $field, array $form_data)

Description

Le filtre 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.

$field

(tableau) Données du champ nettoyées.

$form_data

(array) Paramètres/données du formulaire traités, préparés pour une utilisation ultérieure.

Source

wpforms/includes/fields/class-base.php

Plus d'informations

Le filtre est appliqué à un tableau pour des propriétés spécifiques de champ de formulaire. L'utilisation de ce filtre modifiera tous les champs du formulaire.

Chaque champ de formulaire aura son propre nom de filtre unique. Voir la section ci-dessous pour une liste complète d'exemples documentés. Par exemple, si vous ne vouliez modifier que le champ de formulaire Email, vous utiliseriez 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 l'ID de formulaire 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 changer les sous-étiquettes pour le champ Email
• Comment traiter les balises intelligentes dans les champs HTML
• Comment changer les sous-libellés pour le champ Nom
• Comment modifier les sous-libellés du champ Adresse
• Comment modifier les sous-libellés du champ Mot de passe
• Comment modifier l'attribut Name d'un champ masqué