Pular para o conteúdo

Seletor de elementos

Ao trabalhar com assistentes de programação com IA, muitas vezes você precisa dizer a eles qual arquivo de template renderiza um elemento específico da página. O seletor de elementos oferece um seletor em forma de mira que copia um contexto detalhado do elemento para a área de transferência com um único gesto.

Ativação

O seletor de elementos é habilitado por um parâmetro de consulta. Adicione ?blockstudio-devtools a qualquer URL do frontend para ativá-lo:

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

Sem o parâmetro de consulta, nenhum script nem atributo de dados é carregado.

Configurações

Ative o seletor de elementos no blockstudio.json do seu tema:

JSON
{
  "dev": {
    "grab": {
      "enabled": true
    }
  }
}
Propriedade Tipo Padrão Descrição
enabled boolean false Ativa o seletor de elementos.

A configuração também está disponível como filtro:

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

Uso

  1. Acesse qualquer página do frontend com ?blockstudio-devtools enquanto estiver conectado como usuário com a capacidade edit_posts.
  2. Mantenha pressionado Cmd+C (Mac) ou Ctrl+C (Windows) por 100ms para ativar o seletor.
  3. Um seletor em forma de mira é ativado com uma sobreposição de canvas que destaca blocos Blockstudio ao passar o cursor.
  4. Aparecem dois rótulos: um mostra o caminho do arquivo de template do bloco e o outro, o nome da tag do elemento HTML.
  5. Clique em um elemento para copiar seu contexto para a área de transferência.
  6. Cole o resultado na sua ferramenta de programação com IA.

Pressione Escape ou Cmd+C novamente para desativar sem copiar. Se soltar Cmd+C antes de 100ms, o comportamento normal de cópia será mantido.

Formato da área de transferência

Clicar em um elemento copia uma string de contexto detalhada, criada para assistentes de programação com IA:

Código
@<div>

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

Ela inclui o nome da tag do elemento, uma pré-visualização HTML com atributos e conteúdo, além do caminho do arquivo de template.

Funcionamento interno

Blockstudio adiciona um atributo data-blockstudio-path a cada elemento wrapper de bloco que usa useBlockProps no frontend. Esse atributo contém o caminho absoluto para o arquivo de template que renderiza o bloco.

Um módulo TypeScript vanilla leve (sem dependências de React nem de WordPress) é enfileirado no frontend para editores conectados. Ele usa document.elementsFromPoint() para detectar tanto o elemento HTML específico sob o cursor quanto o bloco pai Blockstudio, exibindo realces separados para cada um.

Segurança

O atributo data-blockstudio-path e o script grabber só são renderizados quando todas as condições são atendidas:

  • O parâmetro de consulta ?blockstudio-devtools está presente.
  • A configuração dev.grab.enabled está true.
  • O usuário atual tem a capacidade edit_posts.

Visitantes públicos nunca veem caminhos de arquivos nem o script grabber.