Textarea - GeekPress/WP-Custom-Fields GitHub Wiki

Le champ Textarea permet de créer une zone de texte multiligne :

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

<?php
$fields[] = array(
                'name'      => '_mission', // Attribut "name" de la balise "input" - il doit être unique
                'label'     => 'Mission', // Balise "label" du champ
                'type'      => 'textarea' // Permet de créer une balise <textarea>
);
?>

Modifier les dimensions des textarea

Les attributs HTML cols et rows permettent de modifier les dimensions. cols permet de définir le nombre de caractères affichés par ligne tandis que rows permet de déterminer le nombre de lignes visibles dans la zone de texte :

Pour cela, il faut ajouter les clés 'cols' et 'rows' et leur valeur dans l'array assigné à la variable $fields comme ci-dessous :

<?php
$fields[] = array(
                'name'      => '_mission', // Attribut "name" de la balise "input" - il doit être unique
                'label'     => 'Mission', // Balise "label" du champ
                'type'      => 'textarea', // Permet de créer une balise <textarea>
                'cols'      => 35, // Nombre de colonnes de texte affichées
                'rows'      => 2 // Nombre de lignes de texte affichées
);
?>

Valeurs par défaut

  • cols : 80
  • rows : 5

Ajouter tinyMCE

Pour faciliter la mise en page du texte, il est possible transformer le textarea en WYSIWYG avec tinyMCE :

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

<?php
$fields[] = array(
                'name'      => '_mission', // Attribut "name" de la balise "input" - il doit être unique
                'label'     => 'Mission', // Balise "label" du champ
                'type'      => 'textarea', // Permet de créer une balise <textarea>
                'tinyMCE'   => true // Permet d'utiliser l'éditeur tinyMCE
);
?>

REMARQUE

L'éditeur tinyMCE est ajouté à l'aide de la fonction wp_editor(). Il est donc possible de paramétrer l'éditeur avec les mêmes arguments que la fonction.

Par exemple, pour désactiver le bouton des médias, voici le code correspondant :

<?php
$fields[] = array(
                'name'      => '_mission', // Attribut "name" de la balise "input" - il doit être unique
                'label'     => 'Mission', // Balise "label" du champ
                'type'      => 'textarea', // Permet de créer une balise <textarea>
                'tinyMCE'   => true, // Permet d'utiliser l'éditeur tinyMCE
                'media_buttons' => false // On désactive le bouton de média
                
);
?>
⚠️ **GitHub.com Fallback** ⚠️