Fonctions avancées · Leçon 17/20 · 15 min

Ajouter un style de bloc réutilisable

Ajouter un style de bloc réutilisable.

Durée indicative : 15 minutes.

Transformer une personnalisation en choix visible

Logo WordPress
Logo officiel de WordPress.

Au module 1, vous avez ajouté une classe manuellement à un Groupe.

Vous pouvez aussi enregistrer un style de bloc. Il devient alors sélectionnable dans les réglages du bloc, ce qui facilite sa réutilisation par une personne qui ne souhaite pas saisir de classe CSS.

Fonction concrète 3 : un style « Encadré conseil »

Créez un snippet :

T1PP | Style de Groupe Encadré conseil

Ajoutez :

// Ajoute un style sélectionnable aux blocs Groupe.
function t1pp_declarer_style_conseil() {
    register_block_style(
        'core/group',
        array(
            'name'  => 't1pp-conseil',
            'label' => 'Encadré conseil',
            'inline_style' => '
                .wp-block-group.is-style-t1pp-conseil {
                    background-color: #eff6ff;
                    border-left: 4px solid #1e3a8a;
                    padding: 20px;
                }
            ',
        )
    );
}

add_action( 'init', 't1pp_declarer_style_conseil' );

register_block_style() enregistre un style pour un type de bloc. Ici :

  • core/group désigne le bloc Groupe ;
  • name donne l’identifiant technique ;
  • label donne le nom affiché ;
  • inline_style contient le CSS associé.

WordPress préfixe le nom du style avec is-style- pour former la classe appliquée au bloc. Le nom déclaré reste donc t1pp-conseil, tandis que le CSS cible is-style-t1pp-conseil.

Appliquer le style

  1. Activez le snippet en exécution générale.
  2. Rechargez l’éditeur.
  3. Ajoutez un nouveau bloc Groupe.
  4. Placez un titre et un paragraphe à l’intérieur.
  5. Sélectionnez le Groupe.
  6. Ouvrez ses styles et choisissez « Encadré conseil ».
  7. Enregistrez et consultez la page côté visiteur.

Pour ce premier test, n’appliquez pas de fond ou d’espacement manuel au Groupe : ces réglages pourraient entrer en conflit avec le style proposé.

Éditeur d’une page avec deux encadrés de conseils fictifs ; le bloc Groupe est sélectionné et le style « Encadré conseil » est actif dans le panneau Styles.
Bloc Groupe sélectionné dans l’éditeur : le style « Encadré conseil » est actif dans le panneau Styles, avec l’aperçu de l’encadré.

Vérifier la réutilisation

Créez un second Groupe et appliquez le même style.

Les deux encadrés doivent utiliser la même présentation. Si vous modifiez ensuite le CSS du snippet, cette modification concernera les blocs utilisant ce style.

Vérifiez :

  • l’affichage dans l’éditeur ;
  • l’affichage public ;
  • le résultat sur mobile ;
  • la lisibilité du contenu ;
  • l’absence de changement sur les Groupes sans ce style.

Prévoir le retrait

Pour retirer proprement cette fonctionnalité :

  1. Repassez les Groupes concernés sur leur style par défaut.
  2. Enregistrez les contenus.
  3. Désactivez le snippet.
  4. Contrôlez les pages.

Désactiver le snippet ne retire pas automatiquement les classes déjà enregistrées dans les contenus. Il faut distinguer l’enregistrement du style, ses règles CSS et les blocs qui l’utilisent.

À vous de jouer

Choisissez un nom compréhensible par vos futurs utilisateurs.

Évitez « Style 2 ». Préférez un intitulé qui décrit un usage ou un aspect : « Encadré conseil », « Note discrète » ou « Mise en avant ».

À retenir

Un style de bloc réutilisable évite de répéter le même CSS et garde une présentation cohérente.

Toutes les formations

Formations connexes

Nos autres formations

Toutes les formations