Sélecteur d’élément
Lorsque vous travaillez avec des assistants de programmation basés sur l’IA, vous devez souvent leur indiquer quel fichier de modèle génère un élément précis de la page. Le sélecteur d’élément affiche un curseur en forme de réticule et copie en un seul geste des informations détaillées sur l’élément dans le presse-papiers.
Activation
Le sélecteur d’élément est protégé par un paramètre de requête. Ajoutez ?blockstudio-devtools à n’importe quelle URL du site public pour l’activer :
https://example.com/?blockstudio-devtools
https://example.com/?p=123&blockstudio-devtools
Sans le paramètre de requête, aucun script ni attribut de données n’est chargé.
Paramètres
Activez le sélecteur d’élément dans le fichier blockstudio.json de votre thème :
{
"dev": {
"grab": {
"enabled": true
}
}
}
| Propriété | Type | Par défaut | Description |
|---|---|---|---|
enabled |
boolean |
false |
Activer le sélecteur d’élément. |
Le réglage est également disponible sous forme de filtre :
add_filter('blockstudio/settings/dev/grab/enabled', '__return_true');
Utilisation
- Consultez n’importe quelle page du site public avec
?blockstudio-devtoolsen étant connecté en tant qu’utilisateur disposant de la capacitéedit_posts. - Maintenez Cmd+C (Mac) ou Ctrl+C (Windows) pendant 100ms pour activer le sélecteur.
- Un curseur en forme de réticule apparaît avec une superposition de canevas qui met en évidence les blocs Blockstudio au survol.
- Deux libellés apparaissent : l’un affiche le chemin du fichier de modèle du bloc, l’autre le nom de balise de l’élément HTML.
- Cliquez sur un élément pour copier son contexte dans le presse-papiers.
- Collez le résultat dans votre outil de programmation IA.
Appuyez de nouveau sur Escape ou Cmd+C pour désactiver sans copier. Si vous relâchez Cmd+C avant 100ms, le comportement normal de copie est préservé.
Format du presse-papiers
Cliquer sur un élément copie une chaîne de contexte détaillée conçue pour les assistants de programmation IA :
@<div>
<div class="my-block">
Hello world
</div>
in theme-name/blockstudio/blocks/my-block/index.php
Elle inclut le nom de la balise de l’élément, un aperçu HTML avec les attributs et le contenu, ainsi que le chemin du fichier de modèle.
Fonctionnement interne
Blockstudio ajoute un attribut data-blockstudio-path à chaque élément conteneur de bloc qui utilise useBlockProps sur le frontend. Cet attribut contient le chemin absolu du fichier de modèle qui génère le bloc.
Un module léger TypeScript vanilla (sans dépendance React ni WordPress) est chargé sur le frontend pour les éditeurs connectés. Il utilise document.elementsFromPoint() pour détecter l’élément HTML précis sous le curseur et son bloc parent Blockstudio, puis les met en évidence séparément.
Sécurité
L’attribut data-blockstudio-path et le script de sélection ne sont générés que si toutes les conditions sont réunies :
- Le paramètre de requête
?blockstudio-devtoolsest présent. - Le réglage
dev.grab.enabledesttrue. - L’utilisateur actuel dispose de la capacité
edit_posts.
Les visiteurs publics ne voient jamais les chemins des fichiers ni le script de sélection.