Text - GeekPress/WP-Custom-Fields GitHub Wiki

Le champ Text permet de créer zone de texte dans une ligne :

Pour créer ce champ, il faut assigner un array à la variable $fields avec la valeur 'text' à la clé 'type' comme ci-dessous :

<?php
$fields[] = array(
    'name'  => '_voiture', // Attribut "name" de la balise "input" - il doit être unique
    'label' => 'Voiture', // Balise "label" du champ
    'type'  => 'text' // Attribut "type" de la balise "input"
);
?>

---

Nombre de caractères maximum pour la saisie

L'attribut HTML maxlength permet de définir la taille maximale de la chaîne de caractère que le champ peut contenir. Pour l'ajouter, il faut ajouter la clé 'placeholder' et sa valeur dans l'array assigné à la variable $fields comme ci-dessous :

<?php
$fields[] = array(
    'name'      => '_voiture', // Attribut "name" de la balise "input" - il doit être unique
    'label'     => 'Voiture', // Balise "label" du champ
    'type'      => 'text', // Attribut "type" de la balise "input"
    'maxlength' => 15 // Taille maximal de la chaîne de caractère saisie dans le champ
);
?>

---

Placeholder

Un placeholder est un attribut qui permet de renseigner un texte indicatif par défaut dans un champ de formulaire. C'est une valeur qui s'efface dès que l'utilisateur active le champ de formulaire.

Pour cela, il faut ajouter la clé 'placeholder' et sa valeur dans l'array assigné à la variable $fields comme ci-dessous :

<?php
$fields[] = array(
    'name'        => '_voiture', // Attribut "name" de la balise "input" - il doit être unique
    'label'       => 'Voiture', // Balise "label" du champ
    'type'        => 'text', // Attribut "type" de la balise "input"
    'placeholder' => 'Saissisez la marque de la voiture' // texte afficher à l'aide du Placeholder
);
?>

---

Nombre de caractères minimum pour la valeur

Il est possible de définir un nombre de caractères minimum pour la valeur du champ. Pour cela, il faut ajouter la clé 'validation' comme ci-dessous :

<?php
$fields[] = array(
    'name'       => '_voiture', // Attribut "name" de la balise "input" - il doit être unique
    'label'      => 'Voiture', // Balise "label" du champ
    'type'       => 'text', // Attribut "type" de la balise "input"
    'validation' => array( 'min_size' => 5 ) // La valeur du champ sera de minimum 5 caractères
);
?>

En cas d'erreur, une bulle info sera affichée pour prévenir que la valeur ne contient pas le nombre de caractères minimum autorisés :

---

Nombre de caractères maximum pour la valeur

Il est possible de définir un nombre de caractères maximum pour la valeur du champ. Pour cela, il faut ajouter la clé 'validation' comme ci-dessous :

<?php
$fields[] = array(
    'name'        => '_voiture', // Attribut "name" de la balise "input" - il doit être unique
    'label'       => 'Voiture', // Balise "label" du champ
    'type'        => 'text', // Attribut "type" de la balise "input"
    'validation'  => array( 'max_size' => 5 ) // La valeur du champ sera de maximum 15 caractères
);
?>

En cas d'erreur, une bulle info sera affichée pour prévenir que la valeur ne contient pas le nombre de caractères maximum autorisés a été dépassé :