요소 탐색기
AI 코딩 도우미를 사용할 때 페이지의 특정 요소를 어떤 템플릿 파일이 렌더링하는지 알려줘야 하는 경우가 많습니다. 요소 탐색기는 십자선 형태의 요소 선택기로, 한 번의 동작으로 요소의 상세 컨텍스트를 클립보드에 복사합니다.
활성화
요소 탐색기는 쿼리 매개변수로 제어됩니다. 프런트엔드 URL에 ?blockstudio-devtools를 추가해 활성화하세요:
https://example.com/?blockstudio-devtools
https://example.com/?p=123&blockstudio-devtools
쿼리 매개변수가 없으면 스크립트나 데이터 속성이 로드되지 않습니다.
설정
테마의 blockstudio.json에서 요소 탐색기를 활성화하세요:
{
"dev": {
"grab": {
"enabled": true
}
}
}
| 속성 | 유형 | 기본값 | 설명 |
|---|---|---|---|
enabled |
boolean |
false |
요소 탐색기를 활성화합니다. |
이 설정은 필터로도 사용할 수 있습니다:
add_filter('blockstudio/settings/dev/grab/enabled', '__return_true');
사용법
edit_posts권한이 있는 사용자로 로그인한 상태에서?blockstudio-devtools를 포함해 프런트엔드 페이지를 방문합니다.- Cmd+C(Mac) 또는 Ctrl+C(Windows)를 100ms 동안 눌러 탐색기를 활성화합니다.
- 십자선 선택기가 활성화되고, 캔버스 오버레이가 마우스를 올릴 때 Blockstudio 블록을 강조 표시합니다.
- 레이블 두 개가 나타납니다. 하나는 블록의 템플릿 파일 경로를 표시하고 다른 하나는 HTML 요소 태그 이름을 표시합니다.
- 요소를 클릭해 해당 컨텍스트를 클립보드에 복사합니다.
- 결과를 AI 코딩 도구에 붙여 넣습니다.
복사하지 않고 비활성화하려면 Escape 또는 Cmd+C를 다시 누르세요. 100ms가 지나기 전에 Cmd+C에서 손을 떼면 일반 복사 동작이 유지됩니다.
클립보드 형식
요소를 클릭하면 AI 코딩 도우미에 맞게 구성된 상세 컨텍스트 문자열이 복사됩니다:
@<div>
<div class="my-block">
Hello world
</div>
in theme-name/blockstudio/blocks/my-block/index.php
여기에는 요소 태그 이름, 속성과 콘텐츠가 포함된 HTML 미리 보기, 템플릿 파일 경로가 포함됩니다.
내부 구조
Blockstudio는 프런트엔드에서 useBlockProps를 사용하는 모든 블록 래퍼 요소에 data-blockstudio-path 속성을 추가합니다. 이 속성에는 블록을 렌더링하는 템플릿 파일의 절대 경로가 포함됩니다.
가벼운 순수 TypeScript 모듈(React 없음, WordPress 종속성 없음)이 로그인한 편집자를 위해 프런트엔드에 등록됩니다. document.elementsFromPoint()를 사용해 커서 아래의 특정 HTML 요소와 상위 Blockstudio 블록을 모두 감지하고 각각 별도의 강조 표시를 그립니다.
보안
data-blockstudio-path 속성과 그랩 스크립트는 다음 조건을 모두 충족할 때만 렌더링됩니다.
?blockstudio-devtools쿼리 매개변수가 있습니다.dev.grab.enabled설정이true입니다.- 현재 사용자에게
edit_posts기능이 있습니다.
일반 방문자에게는 파일 경로나 그랩 스크립트가 표시되지 않습니다.