버튼의 아이콘을 누를 때만 클릭 처리가 빠지는 경우

자료 목록의 ‘가이드 고정’ 버튼에서 글자 옆의 별을 누르면 처리가 빠질 수 있습니다. 목록에 리스너를 붙이고 event.target.matches('button')만 검사했다면, 클릭 대상이 버튼 안의 span일 때 조건이 실패합니다. 이 경우에는 클릭 지점에서 실제로 눌린 버튼을 찾고, 그 버튼을 어느 목록이 처리해야 하는지 확인하세요.

리스너가 호출됐는지 먼저 확인합니다

증상 확인할 위치 고칠 부분
버튼의 일부를 눌렀을 때만 처리가 안 됨 목록 리스너 안의 event.target 목록까지 이벤트가 왔다면 클릭 지점에서 closest()로 버튼을 찾습니다.
처음 있던 버튼만 동작함 추가된 버튼의 조상에 같은 리스너가 남아 있는지 교체되지 않는 목록에 리스너를 두고, 나중에 추가된 버튼도 같은 규칙으로 처리합니다.
중첩 목록의 클릭이 바깥 목록에서도 처리됨 버튼에서 가장 가까운 목록 버튼이 현재 리스너의 목록에 속하는 경우에만 실행합니다.
목록 리스너 자체가 호출되지 않음 이벤트가 올라오는 경로와 리스너를 붙인 요소 목록 자체를 교체했는지, 중간에서 전파를 중단했는지 확인합니다.

별 아이콘과 나중에 추가한 버튼을 같은 규칙으로 처리합니다

아래를 delegation.html로 저장해 브라우저에서 엽니다. 별과 버튼 글자를 각각 누른 뒤, ‘자료 추가’를 눌러 생긴 버튼도 눌러 보세요. 예제는 실제 자료를 고정하는 대신 처리 횟수를 화면에 표시합니다.

<!doctype html>
<html lang="ko">
<meta charset="utf-8">
<title>자료 목록의 클릭 처리</title>
<section id="list" data-action-list>
  <button type="button" data-action="pin">
    <span aria-hidden="true">★</span> <span>가이드 고정</span>
  </button>
  <button type="button" data-action="pin" disabled>잠긴 항목</button>
  <p id="empty">목록 안내</p>
  <section data-action-list>
    <button type="button" data-action="pin">다른 목록의 고정</button>
  </section>
</section>
<button id="add" type="button">자료 추가</button>
<p id="status" role="status">고정 처리 0회</p>
<script>
  const list = document.querySelector('#list');
  const status = document.querySelector('#status');
  let count = 0;

  list.addEventListener('click', (event) => {
    const { target, currentTarget } = event;
    if (!(target instanceof Element)) return;

    const button = target.closest('button[data-action="pin"]');
    if (!button || button.closest('[data-action-list]') !== currentTarget) return;
    if (button.matches(':disabled')) return;

    count += 1;
    status.textContent = '고정 처리 ' + count + '회';
  });

  document.querySelector('#add').addEventListener('click', () => {
    const button = document.createElement('button');
    button.type = 'button';
    button.dataset.action = 'pin';
    button.textContent = '추가 자료 고정';
    list.append(button);
  });
</script>
</html>

target은 이 예제에서 클릭이 시작된 요소이고, currentTarget은 이벤트를 받는 리스너가 붙은 목록입니다. closest()는 클릭된 요소 자신부터 조상을 확인해 선택자와 맞는 첫 요소를 반환합니다. 버튼을 찾은 뒤에도 그 버튼의 가장 가까운 [data-action-list]가 현재 목록인지 확인합니다. 단순히 목록이 버튼을 포함하는지만 확인하면 목록 안에 중첩된 다른 목록도 포함됩니다.

Chrome에서 클릭 대상과 처리 횟수를 비교했습니다

2026년 11월 17일 Chrome 157.0.8103.78 헤드리스에서 로컬 예제를 열고 다음 순서로 조작했습니다.

조작 관찰 누적 횟수
별 아이콘 클릭 대상은 SPAN, 리스너는 #list였습니다. 대상의 버튼 직접 비교는 실패했고, 상위 버튼을 찾은 뒤 처리했습니다. 1
버튼 글자 클릭 글자를 감싼 요소에서 버튼을 찾아 처리했습니다. 2
버튼에 초점을 두고 Enter 대상은 BUTTON이었고 처리했습니다. 3
안내 문구, 중첩 목록의 버튼, 비활성 버튼을 차례로 클릭 바깥 목록의 처리 횟수는 세 조건 모두 그대로였습니다. 3
자료 추가 후 새 버튼 클릭 새 버튼에 리스너를 따로 달지 않아도 처리했습니다. 4

검증 범위는 일반 DOM의 로컬 버튼과 Chrome입니다. 사용 중인 프레임워크가 목록 전체를 바꾸거나 웹 컴포넌트의 Shadow DOM을 통과한다면 그 구조에서 이벤트 대상과 전달 경로를 확인하세요.

실제 화면에서 빠지는 조작을 찾습니다

  1. 목록 리스너에 중단점을 두고 버튼 가운데, 글자, 아이콘을 각각 누릅니다. target과 currentTarget을 같은 이벤트에서 확인하세요.
  2. 기존 항목 하나와 동적으로 추가된 항목 하나를 비교합니다. 버튼을 찾고도 빠지면 가장 가까운 목록과 비활성 상태를 확인합니다. 중첩 목록이 있다면 안쪽 클릭이 바깥 동작을 실행하지 않는지 같이 봅니다.
  3. Tab으로 버튼에 도달한 뒤 Enter나 Space로 실행해 봅니다. 기본 button을 쓰면 클릭 처리로 키보드 활성화도 받을 수 있습니다. 비동기 작업에서 목록이 필요하면 이벤트 처리기 안에서 currentTarget을 변수에 담으세요.