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:
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:
{
"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:
add_filter('blockstudio/settings/dev/grab/enabled', '__return_true');
Uso
- Acesse qualquer página do frontend com
?blockstudio-devtoolsenquanto estiver conectado como usuário com a capacidadeedit_posts. - Mantenha pressionado Cmd+C (Mac) ou Ctrl+C (Windows) por 100ms para ativar o seletor.
- Um seletor em forma de mira é ativado com uma sobreposição de canvas que destaca blocos Blockstudio ao passar o cursor.
- Aparecem dois rótulos: um mostra o caminho do arquivo de template do bloco e o outro, o nome da tag do elemento HTML.
- Clique em um elemento para copiar seu contexto para a área de transferência.
- 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:
@<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-devtoolsestá presente. - A configuração
dev.grab.enabledestátrue. - O usuário atual tem a capacidade
edit_posts.
Visitantes públicos nunca veem caminhos de arquivos nem o script grabber.