Aller au contenu

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 :

Code
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 :

JSON
{
  "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 :

PHP
add_filter('blockstudio/settings/dev/grab/enabled', '__return_true');

Utilisation

  1. Consultez n’importe quelle page du site public avec ?blockstudio-devtools en étant connecté en tant qu’utilisateur disposant de la capacité edit_posts.
  2. Maintenez Cmd+C (Mac) ou Ctrl+C (Windows) pendant 100ms pour activer le sélecteur.
  3. Un curseur en forme de réticule apparaît avec une superposition de canevas qui met en évidence les blocs Blockstudio au survol.
  4. 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.
  5. Cliquez sur un élément pour copier son contexte dans le presse-papiers.
  6. 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 :

Code
@<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-devtools est présent.
  • Le réglage dev.grab.enabled est true.
  • 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.