Attributs de bloc
Les variables $attributes ou $a ne donnent accès qu’aux données enregistrées dans la propriété blockstudio. Pour accéder aux données de bloc WordPress standard, comme l’alignement ou la typographie, utilisez les variables $block ou $b.
Rendu
PHP
<h1>The block is aligned: <?php echo $block['align']; ?></h1>
<h1>The block is aligned: <?php echo $b['align']; ?></h1>
Twig
<h1>The block is aligned: {{ block.align }}</h1>
<h1>The block is aligned: {{ b.align }}</h1>
Définir les valeurs par défaut
Identifiants de champ réservés
Les attributs appartenant à WordPress ne doivent pas être déclarés comme champs Blockstudio avec le même identifiant de premier niveau. anchor, className, style, lock et metadata sont réservés, tout comme les attributs internes blockstudio, __BLOCKSTUDIO_KEY et blockEditingMode de Blockstudio.
Les fonctionnalités WordPress activées réservent également leurs noms d’attributs : align, backgroundColor, textColor, gradient, fontSize, fontFamily, layout, borderColor, shadow et ariaLabel, selon le cas. Une déclaration native de l’un de ces attributs réserve également son nom. Cela évite de remplacer, par exemple, la chaîne align du cœur par l’objet d’option d’un champ de sélection.
Les champs en conflit sont ignorés lors de l’enregistrement et consignés dans blockstudio/error/logged (ainsi que dans le journal de débogage WordPress, s’il est activé), avec le nom du bloc et du champ. Leurs contrôles dans l’éditeur, gestionnaires de stockage et définitions de rendu ne sont pas enregistrés. Renommez le champ en headingAlign ou placez-le dans un groupe nommé comme presentation pour produire presentation_align. Les champs des lignes de répéteur se trouvent dans leur ligne et ne provoquent pas de conflit au niveau supérieur. Un champ align ordinaire reste valide lorsque la prise en charge de l’alignement est désactivée et qu’aucun attribut natif align n’existe.
Lors de la mise à niveau d’un bloc existant présentant un conflit, renommez son champ et migrez toutes les valeurs enregistrées vers le nouvel identifiant. Blockstudio ne renomme pas silencieusement le contenu enregistré et ne supprime pas la prise en charge de WordPress.
Valeurs par défaut des attributs natifs
Pour définir une valeur par défaut pour les propriétés WordPress, comme align, ajoutez une clé default dans la clé attributes :
{
"$schema": "https://blockstudio.dev/schema/block",
"name": "blockstudio/block",
"title": "Native Block",
"icon": "star-filled",
"description": "Native Block.",
"supports": {
"align": ["left", "center", "right"]
},
"attributes": {
"align": {
"type": "string",
"default": "center"
}
},
"blockstudio": true
}
Données de bloc disponibles
La variable $block / $b contient :
| Propriété | Description |
|---|---|
name |
Nom du bloc (e.g, my-theme/my-block) |
title |
Titre du bloc |
dir |
Chemin du répertoire du bloc |
url |
URL du répertoire du bloc |
align |
Valeur d’alignement (si supports.align est activé) |
className |
Classe CSS personnalisée (si supports.customClassName est activé) |
anchor |
Ancre/ID HTML (si supports.anchor est activé) |
Prise en charge de WordPress
Activez les fonctionnalités de bloc WordPress via la propriété supports :
{
"supports": {
"align": true,
"anchor": true,
"customClassName": true,
"color": {
"background": true,
"text": true
},
"spacing": {
"margin": true,
"padding": true
},
"typography": {
"fontSize": true,
"lineHeight": true
}
}
}
Consultez la documentation sur la prise en charge des blocs WordPress pour connaître toutes les options disponibles.