PlainText

Définition : PlainText est un composant de saisie de texte brut de l’éditeur WordPress. Il convient aux valeurs éditables qui ne doivent pas conserver de formatage riche ou de balises HTML.

Comprendre et utiliser

À quoi cela sert ?

Il fournit une interaction de texte simple. C’est un choix utile pour les noms techniques, identifiants ou résumés sans enrichissement typographique.

Comment cela fonctionne ?

La valeur courante est transmise au composant et ses changements remontent via onChange. Le traitement de l’attribut et son rendu restent sous la responsabilité du bloc.

Dans quel contexte l’utiliser ?

À choisir lorsqu’un champ ne doit pas accepter de gras, liens ou balises, afin de réduire les ambiguïtés de stockage.

Cas concret : ATOOLPHA

Une carte ATOOLPHA demande au rédacteur un intitulé court de procédure à afficher dans un en-tête HTML.

Exemple de code commenté

Extrait documentaire : le contexte WordPress du plugin/éditeur et les dépendances décrites sont nécessaires ; ne pas coller dans le contenu d’une page.

const { PlainText } = wp.blockEditor;
const { createElement: h } = wp.element;
function EditLabel( { attributes, setAttributes } ) {
    return h( PlainText, {
        value: attributes.label || '',
        onChange: ( label ) => setAttributes( { label } ),
        placeholder: 'Nom de la procédure',
    } );
}

Décryptage de l’exemple

Le callback transmet une chaîne dépourvue de formatage riche. Le code d’affichage devra intégrer ce champ dans un élément de sortie choisi, en respectant l’échappement nécessaire.

Résultat attendu

L’éditeur permet de modifier le libellé ; sa présence dans la page dépend ensuite de l’implémentation de save ou du rendu dynamique.

Atelier pratique de vérification

Saisir dans PlainText un identifiant contenant espaces et caractères particuliers, puis contrôler la chaîne obtenue. Tester sa transformation en balise publique par le code de rendu et vérifier l’échappement. Comparer ensuite RichText sur la même valeur afin de comprendre pourquoi le formatage riche n’est pas souhaitable ici.

Précautions et limites

PlainText ne remplace pas la validation métier d’un identifiant. Si des contraintes sont attendues, il faut les vérifier explicitement lors du traitement serveur.

Contrôle avant intégration dans un plugin

Vérifier la longueur maximale éventuelle du libellé et l’échappement de sa sortie. Un texte brut n’est pas automatiquement une valeur autorisée pour une URL, une clé de métadonnée ou un identifiant technique.