브라우저의 포커스 표시와 더블클릭

프로토타입을 써 보다가 나온 두 가지를 정리한다. “캔버스 전체에 파란 굵은 선이 생긴다”와 “접힌 칸을 더블클릭해도 안 펴진다”이다.

한 줄 요약

  • 포커스는 “지금 키보드 입력을 받는 요소”이고, 브라우저는 키보드로 조작할 때 그 요소 둘레에 선을 그려 준다. 캔버스처럼 큰 요소에는 이 선이 “전체 선택”처럼 보여서, 우리는 선을 없애고 “고른 블록의 테두리”로 대신했다.
  • 더블클릭은 브라우저가 “같은 요소를 두 번 눌렀다”고 판단해야 알려 준다. 첫 클릭에서 화면을 통째로 다시 그리면 눌린 요소가 새 요소로 바뀌어서, 더블클릭 신호가 엉뚱한 곳으로 간다.

백엔드로 비유하면

포커스

터미널 창 여러 개를 띄워 놓았을 때, 키보드 입력은 활성 창 하나로만 간다. 운영체제는 활성 창의 제목 표시줄 색을 바꿔서 어느 창인지 알려 준다.

웹 페이지 안에서도 같다. 버튼, 입력 칸, 캔버스 가운데 하나만 키 입력을 받고, 브라우저가 그 요소에 선(focus ring)을 둘러 표시한다. 마우스로 누를 때는 어디를 눌렀는지 알기 때문에 선을 그리지 않고, 키보드로 조작하기 시작하면 선을 그린다. 그래서 방향키를 누르는 순간 캔버스 둘레에 파란 선이 나타났다.

이 선은 마우스를 쓰지 않는 사람에게 꼭 필요하다. 없애려면 “지금 어디에 있는지”를 다른 방법으로 보여 줘야 한다. 우리는 캔버스에 들어오면 첫 블록을 자동으로 고르게 해서, 고른 블록의 테두리가 그 역할을 하게 했다. → R-EDIT-03

더블클릭

요청마다 객체를 새로 만드는 서버를 생각하면 된다. 클라이언트가 “방금 그 객체에 한 번 더”라고 요청했는데, 서버가 첫 요청을 처리하면서 그 객체를 버리고 똑같이 생긴 새 객체를 만들었다면, 두 번째 요청은 가리킬 대상이 없다.

프로토타입은 클릭할 때마다 선택 테두리를 그리려고 그림 전체(SVG 요소 수백 개)를 지우고 새로 만든다. 사람 눈에는 같은 칸이지만 브라우저에게는 다른 요소다. 그래서 브라우저가 보내는 더블클릭 이벤트(dblclick)를 믿을 수 없었다.

고친 방법은 “더블클릭 이벤트를 기다리지 않는다”이다. 마우스를 누르는 이벤트(mousedown)에는 “연달아 몇 번째 누름인지”(detail)가 들어 있다. 이 값이 2이면 그 자리에서 더블클릭으로 처리한다. 두 번째 누름의 대상은 방금 새로 그린 요소라서 정확하다.

AriadneNSD에서 어디에 쓰나

  • 키보드 전용 조작(R-NFR-05): 포커스가 어디 있는지 늘 보여야 한다. 프로토타입은 “캔버스에 들어오면 첫 블록을 고른다”였지만, 지금 규칙은 다르다. 화면을 열거나 캔버스에 들어와도 블록을 고르지 않고 캔버스 안쪽에 포커스 테두리를 보이며, 이동 키를 누르면 그때 첫 블록(헤더가 있으면 헤더)을 고른다 → 키보드로 이동하고 삽입하기, OP1
  • 화면 다시 그리기: MVP(2026-11-01)도 바뀐 부분만 고치지 않는다. 편집할 때마다 그림(문서 레이어)의 SVG를 통째로 바꿔 넣는다. 다만 선택 · 호버 같은 표시는 그 위의 오버레이 레이어에 따로 그려서, 선택만 바뀌면 문서 레이어를 건드리지 않는다. 그리고 더블클릭은 바뀌지 않는 캔버스 요소에서 받는다. 그래서 클릭이 눌린 요소를 없애지 않는다 → 1.2 다시 렌더링. UI 프레임워크(React)는 메뉴 · 툴바 같은 주변 UI에만 쓴다(ADR-0010). 그래도 “클릭 처리 중에 눌린 요소를 없애면 뒤따르는 이벤트가 길을 잃는다”는 것은 기억해 둘 만하다.

더 읽을거리

  • MDN: :focus-visible (브라우저가 언제 포커스 선을 그리는지)
  • MDN: UIEvent.detail (연달아 누른 횟수)