Saltar al contenido

Selector de elementos

Al trabajar con asistentes de programación basados en IA, a menudo necesita indicarles qué archivo de plantilla genera un elemento específico de la página. El selector de elementos ofrece un selector en forma de punto de mira que copia al portapapeles el contexto detallado del elemento con un solo gesto.

Activación

El selector de elementos se activa mediante un parámetro de consulta. Añada ?blockstudio-devtools a cualquier URL de la interfaz pública para activarlo:

Código
https://example.com/?blockstudio-devtools
https://example.com/?p=123&blockstudio-devtools

Sin el parámetro de consulta, no se carga ningún script ni atributo de datos.

Ajustes

Active el selector de elementos en blockstudio.json de su tema:

JSON
{
  "dev": {
    "grab": {
      "enabled": true
    }
  }
}
Propiedad Tipo Valor predeterminado Descripción
enabled boolean false Activar el selector de elementos.

El ajuste también está disponible como filtro:

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

Uso

  1. Visite cualquier página de la interfaz pública con ?blockstudio-devtools mientras tenga iniciada sesión como usuario con la capacidad edit_posts.
  2. Mantenga pulsadas Cmd+C (Mac) o Ctrl+C (Windows) durante 100ms para activar el selector.
  3. Se activa un selector en forma de punto de mira con una superposición de lienzo que resalta los bloques Blockstudio al pasar el cursor por encima.
  4. Aparecen dos etiquetas: una muestra la ruta del archivo de plantilla del bloque y la otra, el nombre de la etiqueta del elemento HTML.
  5. Haga clic en un elemento para copiar su contexto al portapapeles.
  6. Pegue el resultado en su herramienta de programación con IA.

Pulsa Escape o Cmd+C de nuevo para desactivar sin copiar. Si sueltas Cmd+C antes de 100ms, se conserva el comportamiento de copia normal.

Formato del portapapeles

Al hacer clic en un elemento, se copia una cadena de contexto enriquecida diseñada para asistentes de programación con IA:

Código
@<div>

<div class="my-block">
  Hello world
</div>
  in theme-name/blockstudio/blocks/my-block/index.php

Incluye el nombre de la etiqueta del elemento, una vista previa de HTML con atributos y contenido, y la ruta del archivo de plantilla.

Funcionamiento interno

Blockstudio añade un atributo data-blockstudio-path a cada elemento contenedor de bloque que usa useBlockProps en el frontend. Este atributo contiene la ruta absoluta al archivo de plantilla que representa el bloque.

Se encola en el frontend para los editores que han iniciado sesión un módulo ligero de TypeScript puro (sin dependencias de React ni de WordPress). Usa document.elementsFromPoint() para detectar tanto el elemento HTML específico bajo el cursor como su bloque Blockstudio padre, y resalta cada uno por separado.

Seguridad

El atributo data-blockstudio-path y el script de selección solo se muestran cuando se cumplen todas estas condiciones:

  • Está presente el parámetro de consulta ?blockstudio-devtools.
  • La opción dev.grab.enabled está true.
  • El usuario actual tiene la capacidad edit_posts.

Los visitantes públicos nunca ven las rutas de los archivos ni el script de selección.