아코디언(Accordion) 자가진단 — ViewCheck 5분 점검
공공 사이트의 "자주 묻는 질문(FAQ)" 페이지를 떠올려 보세요. 질문 제목이 스무 개쯤 죽 나열돼 있고, 그중 하나를 누르면 그 아래로 답변이 스르륵 펼쳐집니다. 다른 질문을 누르면 앞서 펼쳤던 답변이 접히고 새 답변이 열리고요. 정책 안내 페이지의 "단계별 절차"도, 사업 공고의 "지원 분야별 상세"도, 통계 페이지의 "항목별 설명"도 비슷한 식입니다. 제목 줄이 차곡차곡 쌓여 있다가, 누르면 한 칸씩 열렸다 닫혔다 합니다. 우리는 이걸

공공 사이트의 "자주 묻는 질문(FAQ)" 페이지를 떠올려 보세요. 질문 제목이 스무 개쯤 죽 나열돼 있고, 그중 하나를 누르면 그 아래로 답변이 스르륵 펼쳐집니다. 다른 질문을 누르면 앞서 펼쳤던 답변이 접히고 새 답변이 열리고요. 정책 안내 페이지의 "단계별 절차"도, 사업 공고의 "지원 분야별 상세"도, 통계 페이지의 "항목별 설명"도 비슷한 식입니다. 제목 줄이 차곡차곡 쌓여 있다가, 누르면 한 칸씩 열렸다 닫혔다 합니다. 우리는 이걸 그냥 "펼쳐지는 목록" 정도로 부르지만, 이 패턴에는 정식 이름이 있습니다. 아코디언(Accordion)입니다.
아코디언은 "여러 개의 접이식 항목을 한자리에 묶어, 사용자가 원하는 것만 펼쳐 보게 하는" UI 패턴입니다. 긴 내용을 한 화면에 다 쏟아내지 않고 제목만 먼저 보여 준 다음, 필요한 항목만 펼쳐 보게 하죠. 화면을 깔끔하게 정리해 주는 아주 고마운 장치입니다. 그런데 바로 이 "여러 개를 접고 펴는" 동작 때문에, 아코디언은 공공웹에서 조용히, 그러나 끊임없이 잘못 만들어지는 컴포넌트이기도 합니다. 펼침/접힘 상태가 코드로 전달되지 않거나, 키보드로는 펼쳐지지 않거나, 접혀 있는 내용을 검색엔진과 스크린리더가 "없는 것"으로 취급하거나. 마우스로 클릭하는 사람 눈엔 멀쩡한데, 다른 방식으로 화면을 쓰는 사람에겐 줄줄이 닫힌 서랍이 되는 겁니다.
이 글은 "ViewCheck로 5분 자가진단" 시리즈입니다. 그래서 KRDS(대한민국 정부 디자인 시스템)가 아코디언을 어떻게 정의하고 무엇을 요구하는지 짚되, 거기서 멈추지 않고 "그래서 우리 사이트의 아코디언은 지금 그 기준을 지키고 있나?"를 직접 확인하는 방법까지 끝까지 가 보려 합니다. 손으로 하는 5분 셀프 점검, 그리고 페이지가 많을 때 자동으로 돌리는 ViewCheck 점검까지요. 다 읽고 나면, 앞으로 어떤 사이트에서 줄지어 펼쳐지는 FAQ를 만날 때마다 "이건 제대로 만든 아코디언, 저건 위험한 아코디언"이 눈에 들어오실 겁니다.
미리 한 가지만 일러두면, 이 글의 목적은 "아코디언을 더 화려하게 만드는 법"이 아닙니다. 오히려 "조용히, 그러나 누구에게나 똑같이 작동하게 만드는 법"입니다. 아코디언이 잘 만들어졌는지는 마우스 사용자 눈엔 거의 티가 안 납니다. 티가 안 난다는 건 잘 작동할 때 얘기고, 한 번 막히면 그 사용자에겐 그 페이지에서 가장 큰 벽이 됩니다. 접혀 있는 정보를 못 펼치면, 그 정보는 그 사람에게 존재하지 않는 것과 같으니까요. 그리고 아코디언은 그 "접힌 서랍"이 하나가 아니라 줄줄이라, 한 번 막히면 페이지 전체가 통째로 막힙니다.
아코디언이 대체 뭐길래 — 정의부터 정확히
먼저 용어를 맞추겠습니다. 우리가 "펼쳐지는 목록"이라고 뭉뚱그리는 것들은 사실 한 덩어리가 아닙니다. KRDS와 일반적인 UI 패턴 분류는 이걸 목적에 따라 구분합니다.
- 아코디언(Accordion): 여러 개의 접이식 항목(제목+콘텐츠)이 세로로 묶여 있는 패턴. 보통 한 번에 하나만 펼쳐지도록 제어되기도 하고, 여러 개를 동시에 펼치게 두기도 합니다. FAQ 목록이 가장 대표적입니다.
- 디스클로저(Disclosure): 트리거 하나에 콘텐츠 하나가 딸린 단일 토글. "더보기" 버튼 하나로 영역을 펼치고 접는 가장 단순한 형태입니다. 아코디언은 이 디스클로저를 여러 개 묶고 그룹 규칙을 얹은 "묶음 버전"이라고 보면 가깝습니다.
- 탭(Tab): 같은 자리에 여러 패널을 두고 하나씩 갈아 끼우는 패턴. 펼침/접힘이 아니라 "전환"이라 아코디언과 다릅니다. 탭은 가로로 늘어선 제목 중 하나가 항상 선택돼 있지만, 아코디언은 전부 접힌 상태도 가능합니다.
- 트리(Tree)·내비게이션 메뉴: 계층적 메뉴를 펼치는 것. 모양이 비슷해도 "페이지 이동"이 목적이면 아코디언이 아니라 내비게이션입니다.
이 구분이 왜 중요하냐면, 모양이 비슷하다고 아무 패턴이나 아코디언으로 만들면 사용자가 "이게 펼쳐지는 건지, 다른 화면으로 가는 건지" 헷갈리기 때문입니다. 예를 들어 페이지를 이동하는 링크 목록을 아코디언처럼 화살표 달아 놓으면, 사용자는 눌렀을 때 내용이 펼쳐질 거라 기대했다가 엉뚱한 페이지로 끌려갑니다. 반대로, 진짜 아코디언인데 제목이 탭처럼 생겼으면 "여기 누르면 화면이 바뀌나?" 하고 망설입니다. 같은 "화살표 달린 제목"이라도 의미가 다르면 다르게 다뤄야 한다는 것 — 이게 패턴을 구분하는 첫 번째 이유입니다.
이 글에서는 아코디언(접이식 항목의 묶음)을 중심으로 다루되, 그 한 칸인 디스클로저의 요건도 자연스럽게 함께 짚겠습니다. 둘은 접근성 요건이 거의 같고, 공공웹에서 같은 실수가 반복되거든요.
아코디언은 어디에 쓰이나 — 공공웹의 단골 자리
아코디언이 특히 많이 쓰이는 공공 서비스의 자리를 꼽아 보면 이렇습니다.
- FAQ / 자주 묻는 질문: 질문 제목을 누르면 답변이 펼쳐지는 가장 전형적인 아코디언. 공공 사이트라면 거의 빠짐없이 있습니다.
- 정책·제도 안내: "지원 대상", "신청 방법", "구비 서류"처럼 항목별로 접어 둔 긴 안내.
- 사업 공고 상세: "공모 분야", "심사 기준", "제출 양식"을 분야별로 펼쳐 보는 구조.
- 약관·개인정보 처리방침: 조항별로 접어 두고 필요한 조항만 펼쳐 보게 한 긴 문서.
- 이용 안내 / 도움말: "이런 경우엔 어떻게 하나요?"처럼 상황별 안내를 묶어 둔 목록.
- 통계·데이터 페이지: 지표 항목마다 "산출 방법·주의사항"을 접어 둔 설명.
공통점이 보이시나요? 전부 "지금 다 보여 줄 필요는 없지만, 누군가에게는 그중 한두 개가 꼭 필요한" 정보입니다. 그래서 묶어서 접어 두는 거고요. 문제는, 접어 둔 정보를 모든 사용자가 똑같이 펼칠 수 있어야 한다는 점입니다. 누구는 펼치고 누구는 못 펼치면, 그건 정보 제공이 아니라 정보 차별이 됩니다. 그리고 아코디언은 항목이 여럿이라, 그 차별이 한 줄이 아니라 페이지 전체에 줄줄이 걸립니다.

KRDS는 아코디언에 무엇을 요구하나 — 기준 완전 해부
이제 본론입니다. KRDS 가이드라인(디지털 정부서비스 UI/UX 가이드라인, 2025.08판)과 컴포넌트 문서, 그리고 확립된 웹 접근성 기준(WAI-ARIA의 accordion/disclosure 패턴, KWCAG)을 종합해, 아코디언이 충족해야 하는 요건을 영역별로 정리하겠습니다. 참고로 KRDS 컴포넌트 킷(GitHub KRDS-uiux/krds-uiux)에는 아코디언이 두 가지 변형으로 제공됩니다 — 기본형(accordion)과 구분선 형(accordion_line). 두 변형을 따로 둔다는 것 자체가, 아코디언이 "그냥 하나 만들어 다 쓰는" 게 아니라 맥락에 따라 정해진 모습이 있다는 메시지입니다. 아래 요건들이 그대로 뒤에서 셀프 점검과 ViewCheck 점검의 체크 항목이 됩니다.
1) 트리거(제목 줄)는 "버튼"이어야 한다
아코디언의 각 항목을 펼치고 접는 그 제목 줄은, 코드 수준에서 버튼(또는 그에 준하는 상호작용 요소)이어야 합니다. 단순히 <div>나 <span>, <h3>에 클릭 이벤트만 붙여 두면, 키보드로 도달할 수도 없고 스크린리더가 "버튼"이라고 인식하지도 못합니다.
가장 안전한 건 제목 줄의 펼침 트리거를 <button>으로 만드는 것입니다. 버튼은 기본적으로 Tab으로 초점이 가고, Enter/Space로 활성화되며, 스크린리더가 "버튼"이라고 읽어 줍니다. 접근성 권장 패턴에서는 제목 텍스트를 <h3> 같은 헤딩으로 감싸고, 그 안에 <button>을 넣는 구조를 권합니다. 이렇게 하면 헤딩으로서 "목차 역할"도 하고, 버튼으로서 "펼침 동작"도 합니다. 이 공짜 동작을 포기하고 <div>로 만들면, 그 모든 걸 직접 구현해야 하는데 현실에선 거의 다 빠뜨립니다.
2) 펼침/접힘 상태를 코드로 알려야 한다 — `aria-expanded`
아코디언의 핵심 중의 핵심입니다. 각 트리거 버튼에는 지금 그 항목이 펼쳐졌는지 접혔는지를 알리는 aria-expanded 속성이 있어야 합니다. 접혀 있으면 aria-expanded="false", 펼쳐지면 aria-expanded="true"로 상태가 실제로 바뀌어야 합니다.
이게 왜 중요할까요. 마우스 사용자는 콘텐츠가 펼쳐지는 걸 눈으로 봅니다. 화살표가 아래로 돌아가는 것도 보고요. 그런데 스크린리더 사용자에게는 이 시각적 변화가 닿지 않습니다. aria-expanded가 있어야 스크린리더가 "지원 대상이 어떻게 되나요? 버튼, 접힘"이라고 읽어 주고, 누른 뒤엔 "펼침"이라고 알려 줍니다. 이 속성이 없으면, 시각장애인 사용자는 버튼을 눌렀는데 뭐가 펼쳐졌는지, 애초에 펼쳐지는 버튼인지조차 알 수 없습니다. 항목이 스무 개인 FAQ에서 이게 전부 빠져 있으면, 스무 번의 막힘이 됩니다.
흔한 함정 하나. aria-expanded를 처음에 false로 박아 두고, 펼쳐도 값이 안 바뀌게 만드는 경우입니다. 속성만 있고 동작하지 않으면, 스크린리더는 영원히 "접힘"이라고 읽습니다. 사용자는 분명히 펼쳤는데도요. 속성은 "있다/없다"가 아니라 "상태에 따라 바뀌는가"까지 봐야 합니다.
3) 트리거와 콘텐츠를 연결하라 — `aria-controls` / 콘텐츠의 역할
각 트리거 버튼이 어느 콘텐츠 영역을 제어하는지를 aria-controls로 가리켜 두면, 보조기술이 "이 버튼이 저 영역을 펼친다"는 관계를 이해합니다. 콘텐츠 영역(펼쳐지는 답변)에 id를 주고, 버튼의 aria-controls가 그 id를 가리키게 하는 식입니다. 권장 패턴에서는 펼쳐지는 콘텐츠 영역에 role="region"과 aria-labelledby(그 콘텐츠를 펼친 버튼을 가리킴)를 주어, 스크린리더가 "여기는 무슨 항목의 내용"인지 알게 합니다. 항목이 여럿인 아코디언일수록 이 연결이 "지금 펼친 게 몇 번째 항목의 내용인지" 길을 잃지 않게 도와줍니다.
4) 키보드만으로 완전히 쓸 수 있어야 한다
타협 없는 요건입니다. 아코디언은 키보드만으로 다음이 전부 가능해야 합니다.
- Tab으로 각 항목의 트리거 버튼에 차례로 초점 이동
- Enter 또는 Space로 펼치기/접기 토글
- 펼쳐진 콘텐츠 안에 링크·입력이 있으면, 거기로도 자연스럽게 Tab 이동
- 다시 트리거로 돌아와 접기 가능
- (권장) 여러 항목이 있을 때 위·아래 방향키로 트리거 사이를 이동, Home/End로 첫/마지막 항목으로 점프
트리거를 <button>으로 만들면 Tab·Enter·Space 동작이 대부분 공짜로 따라옵니다. 방향키 이동까지 넣으면 더 좋지만, 최소한 Tab과 Enter/Space만큼은 반드시 동작해야 합니다. 문제는 디자인을 이유로 트리거를 <div>나 <a href="#">로 만들 때입니다. 그 순간 키보드 동작을 직접 구현해야 하고, 십중팔구 빠집니다. 마우스 클릭 이벤트만 붙이고 끝내는 거죠.
5) 초점 표시(Focus) — 지금 어느 항목에 있는지 보여야 한다
키보드로 아코디언 항목들을 훑어 내려갈 때, 지금 초점이 어느 트리거에 와 있는지 시각적으로 또렷해야 합니다. 테두리가 강조되거나 외곽선(focus ring)이 보여야 하죠. FAQ처럼 항목이 줄줄이 있는 화면에서 포커스 표시가 없으면, 키보드 사용자는 지금 몇 번째 질문에 있는지 알 수 없어 길을 잃습니다. 디자인이 깔끔해 보인다고 outline: none으로 지우는 실수가 여기서도 반복됩니다. 아코디언은 항목이 많은 만큼, 포커스 표시가 없으면 "내가 지금 어디쯤이지?"의 혼란이 더 큽니다.
6) 접힌 콘텐츠의 "진짜 숨김"
아코디언의 한 항목이 접혀 있을 때, 그 콘텐츠는 시각적으로만 안 보이는 게 아니라 보조기술에서도 일관되게 숨겨져야 합니다. 보통 hidden 속성이나 display:none으로 처리하죠. 여기서 흔한 사고가 둘 있습니다.
- 사고 ①: 시각적으로는 height:0이나 투명도로 감췄는데, 실제 DOM에는 그대로 노출돼 있어서 스크린리더가 접힌 내용까지 다 읽어 버립니다. FAQ 답변 스무 개가 전부 접힌 줄 알았는데, 스크린리더로는 답변이 줄줄 읽혀 "이게 다 뭐지?" 하고 혼란스럽습니다.
- 사고 ②: 반대로 접힌 콘텐츠를 aria-hidden만으로 막아 두고 키보드 초점은 그대로 들어가서, Tab을 누르면 보이지도 않는 영역의 링크로 초점이 사라집니다. 이른바 "초점 함정"의 한 종류입니다.
원칙은 단순합니다. 접혀 있으면 보는 것·읽는 것·초점 가는 것이 전부 일관되게 숨겨져야 하고, 펼쳐지면 전부 일관되게 드러나야 합니다.
7) 검색엔진·콘텐츠 접근성 — 숨겼다고 "없는 것"은 아니다
아코디언으로 접어 둔 콘텐츠도 페이지의 정식 콘텐츠입니다. 그래서 검색엔진이 그 내용을 읽고 색인할 수 있어야 하고(SEO/개방성), 필요하면 직접 링크로 펼쳐진 상태에 도달할 수 있으면 더 좋습니다. 접힌 콘텐츠를 자바스크립트로만 나중에 불러오는(lazy) 방식이라면, 검색엔진이 그 내용을 놓칠 수 있습니다. 특히 FAQ 답변처럼 사람들이 검색으로 찾아오는 정보를 아코디언 안에 넣을 땐, "접혀 있어도 코드엔 처음부터 존재하는가"를 챙겨야 합니다. 공공 사이트의 FAQ는 검색 유입의 큰 통로인데, 접힌 답변이 색인이 안 되면 정작 답이 있는데도 검색에 안 잡히는 손해를 봅니다.
8) 화살표·아이콘·색에만 의미를 싣지 말 것
아코디언은 보통 펼침/접힘을 화살표(▾ / ▴)나 + / − 아이콘, 또는 색 변화로 표현합니다. 그런데 이 시각 신호에만 상태를 싣고 코드(aria-expanded)에는 안 담으면, 화면을 못 보는 사용자에겐 상태가 전달되지 않습니다. 또 색만으로 "펼쳐짐/접힘"을 구분하는 것도 색 구분이 어려운 사용자를 배제합니다. 시각 신호는 보조일 뿐, 의미는 반드시 코드로도 닿아야 합니다. 그리고 화살표·+/− 같은 장식 아이콘은 aria-hidden="true"로 숨겨서, 스크린리더가 의미 없는 기호를 중복으로 읽지 않게 하는 게 좋습니다.
9) 충분한 터치 영역과 트리거 크기
모바일에서 아코디언 트리거(제목 줄)는 손가락으로 누르기 충분히 커야 합니다. KWCAG와 국제 표준 모두 터치 대상의 최소 크기를 권장하는데, 보통 한 변 44px 이상을 기준으로 봅니다. FAQ 질문이 다닥다닥 붙어 있으면 옆 질문을 잘못 펼치기 쉽습니다. 트리거 영역(클릭/터치 가능한 범위)을 제목 텍스트뿐 아니라 그 줄 전체로 넉넉히 잡아 주는 게 좋습니다. 아코디언은 항목 간격이 좁으면 오터치가 특히 잦습니다 — 항목이 세로로 빽빽이 붙어 있으니까요.
10) 기본 펼침 상태와 다중 펼침 정책
아코디언을 처음 열었을 때 전부 접혀 있을지, 첫 항목만 펼쳐 둘지, 동시에 여러 개가 펼쳐지게 할지 한 번에 하나만 펼쳐지게 할지도 결정 사항입니다. 정답이 하나는 아니지만, 원칙은 "사용자가 예측할 수 있게, 일관되게"입니다. 어떤 페이지는 한 번에 하나, 어떤 페이지는 여러 개가 펼쳐지면 사용자가 헷갈립니다. 그리고 중요한 정보(예: 필수 안내, 신청 자격)를 아코디언 안에 접어 두고 기본을 "전부 접힘"으로 두면, 그 정보를 아예 못 보고 지나칠 위험이 있습니다. 꼭 봐야 하는 건 접지 마세요. "한 번에 하나만 펼침" 정책을 쓸 때도 주의가 필요합니다 — 사용자가 A를 읽다가 B를 펼치면 A가 자동으로 접히는데, 이게 의도치 않게 "방금 보던 내용이 사라지는" 당황을 줄 수 있습니다. 이런 동작도 스크린리더에 적절히 전달돼야 합니다.
정리하면, KRDS와 접근성 표준이 아코디언에 요구하는 건 크게 세 축입니다. ① 조작 가능성(트리거는 버튼, 키보드 완전 지원, 충분한 터치 영역), ② 상태 전달성(aria-expanded로 각 항목의 펼침/접힘을 코드로 알림, 화살표·색에만 의존 금지), ③ 콘텐츠 무결성(접힌 내용의 일관된 숨김, 검색엔진·스크린리더에서의 적절한 처리, 트리거-콘텐츠 연결). 이 세 축은 그대로 뒤에서 우리가 점검할 항목이 됩니다.
왜 이렇게까지 따지나 — 원리와 배경
여기까지 읽고 "펼쳐지는 FAQ 하나에 뭐 이리 까다롭나" 싶으실 수 있습니다. 그런데 이 요건들은 누가 괜히 만든 규칙이 아니라, 실제 사용자가 막히는 지점에서 역으로 도출된 것들입니다.

"접혀 있는 정보"는 가장 쉽게 사라지는 정보
아코디언의 본질은 "묶어서 감추기"입니다. 그런데 감추는 순간, 그 정보는 가장 취약해집니다. 마우스 사용자는 화살표를 보고 "여기 뭔가 더 있구나" 짐작해 펼치지만, 그 짐작이 안 되는 사용자에게는 접힌 정보가 통째로 사라진 셈이 됩니다. 더 나쁜 건, 아코디언은 그 "사라지는 정보"가 한 덩어리가 아니라 줄줄이라는 점입니다. FAQ 스무 개가 접혀 있으면, 그 스무 개의 답이 한꺼번에 손이 안 닿는 곳으로 들어갑니다.
생각해 보면 아코디언 안에 들어가는 내용은 대개 중요합니다. FAQ 답변, 신청 조건, 약관 조항, 단계별 절차 — 누군가에게는 그게 그 페이지에 온 이유입니다. 그 핵심을 줄줄이 접어 두었는데 펼치는 방법이 일부 사용자에게만 열려 있다면, 가장 정보가 필요한 사람을 가장 먼저, 가장 많이 배제하는 결과가 됩니다.
공공 서비스는 "안 쓸 자유"가 없다
상업 사이트는 불편하면 사용자가 떠나면 그만입니다. 경쟁사로 가면 되니까요. 그런데 공공 서비스는 다릅니다. 민원을 신청하거나, 약관에 동의하거나, 지원 자격을 확인하는 일은 그 사이트가 아니면 할 수 없습니다. 사용자에게 "안 쓸 자유"가 없어요. 그래서 공공웹의 아코디언이 누군가에게 안 펼쳐지면, 그건 단순한 불편이 아니라 행정 서비스 접근권의 박탈이 됩니다.
지원 자격을 접어 둔 아코디언이 스크린리더로 안 펼쳐지면, 시각장애인은 자기가 자격이 되는지조차 확인할 수 없습니다. 키보드로 안 열리는 FAQ는 손 사용이 불편해 마우스를 못 쓰는 사람에게 똑같은 벽이 됩니다. 고령 사용자에게는 작고 빽빽한 제목 줄이 그 자체로 장벽입니다. 답은 분명히 그 페이지에 있는데, 펼치는 방법이 막혀서 콜센터에 전화를 걸게 되는 거죠. 이게 KRDS가 아코디언의 키보드·스크린리더 지원을 "있으면 좋은 것"이 아니라 "기본 요건"으로 두는 이유입니다.
보이는 것과 읽히는 것의 분리
비장애인은 화면을 "본다"고 생각하지만, 사실 우리는 화면을 보고 머릿속에서 의미로 번역합니다. 화살표가 아래로 돌아가는 걸 보고 "아, 펼쳐졌구나" 하고 압니다. 스크린리더 사용자에게는 이 번역 과정이 없습니다. 코드가 알려 주는 정보가 곧 전부입니다.
그래서 아코디언은 "보기에 펼쳐지는 것"으로는 부족하고, "코드 수준에서 각 항목의 펼침/접힘이 선언되고 갱신되는 것"이어야 합니다. 화살표를 돌리는 CSS만 있고 aria-expanded가 없으면, 스크린리더에겐 아무 일도 안 일어난 것과 같습니다. 이 "보이는 것 ≠ 읽히는 것" 문제가 아코디언 위반의 근본 원인 대부분을 차지합니다. 그리고 항목이 많은 만큼, 이 분리가 페이지 전체에 곱해져서 나타납니다.
일관성이 곧 학습 비용 절감
KRDS가 아코디언의 모습과 동작을 표준화하는 또 다른 이유는 일관성입니다. 정부 사이트마다 펼쳐지는 방식이 제각각이면, 사용자는 사이트를 옮길 때마다 "여기선 어떻게 펼치지? 하나만 펼쳐지나, 여러 개 펼쳐지나?"를 다시 배워야 합니다. 모든 공공 서비스의 아코디언이 같은 방식으로 보이고 같은 방식으로 작동하면, 한 번 익힌 사용법이 모든 사이트에서 통합니다. 디지털 약자에게 이 "다시 안 배워도 됨"은 생각보다 큰 배려입니다. 표준화는 디자이너의 자유를 뺏는 게 아니라, 사용자의 인지 부담을 덜어 주는 일입니다.
작은 패턴일수록 방치되기 쉽다
역설적이지만, 아코디언처럼 "작고 흔한" 패턴일수록 품질 관리에서 밀립니다. 메인 비주얼이나 핵심 기능엔 모두가 눈을 부릅뜨지만, FAQ 페이지의 펼침 메뉴가 스크린리더에 어떻게 읽히는지는 아무도 확인하지 않습니다. 그런데 사용자가 실제로 답을 찾는 곳은 화려한 메인이 아니라 바로 그 FAQ입니다. 가장 덜 주목받는 패턴이 사실은 사용자의 궁금증을 해결하느냐 마느냐를 가르는 길목인 셈입니다. 게다가 FAQ는 "전화 문의를 줄이려고" 만드는 경우가 많은데, 그 FAQ가 접근 불가면 오히려 문의가 늘어납니다 — 만든 목적과 정반대 결과가 나는 거죠.
한 장면 — 같은 FAQ, 두 사람
추상적인 요건을 길게 늘어놓는 것보다, 한 장면을 그려 보는 게 빠를 것 같습니다. 어느 공공 서비스의 "자주 묻는 질문" 페이지, 질문 제목을 누르면 답변이 펼쳐지는 아코디언이 스무 개쯤 줄지어 있다고 합시다.
먼저 마우스를 쓰는 김 주무관. "지원금은 언제 입금되나요?"라는 질문을 클릭하니 답변이 스르륵 펼쳐집니다. 읽고 나서 옆 질문 "서류를 잘못 냈는데 어떻게 하나요?"를 누르니, 앞 답변은 접히고 새 답변이 열립니다. 10초도 안 걸렸습니다. 김 주무관에게 이 FAQ는 아무 문제가 없습니다. 그래서 이 화면을 만든 팀도 "잘 작동한다"고 믿습니다. 자기들이 테스트할 때 늘 마우스를 썼으니까요.
이번엔 시각장애가 있는 박 선생님. 스크린리더를 켜고 Tab으로 FAQ를 훑어 내려갑니다. 그런데 질문 제목 자리에서 스크린리더가 "지원금은 언제 입금되나요?"라고만 읽고 멈춥니다. 이게 누를 수 있는 버튼인지, 누르면 뭐가 펼쳐지는지 알 수 없습니다(트리거가 <div>라 버튼으로 인식 안 됨, aria-expanded 없음). 혹시나 하고 Enter를 눌렀는데 아무 반응이 없습니다. 이 아코디언은 마우스 클릭에만 반응하거든요(키보드 미지원). 게다가 접힌 답변들이 코드엔 그대로 노출돼 있어, Tab을 계속 누르니 펼치지도 않은 답변 텍스트가 줄줄 읽힙니다. 무엇이 질문이고 무엇이 답인지, 지금 몇 번째인지 도무지 구분이 안 됩니다. 박 선생님은 결국 답을 못 찾고 콜센터에 전화를 겁니다 — 답은 분명히 그 페이지에 있는데도요.
같은 FAQ, 같은 스무 개 질문. 한 사람에겐 10초짜리 사소한 펼침이고, 다른 한 사람에겐 줄줄이 닫힌 서랍이자 뒤죽박죽 읽히는 미로입니다. 그리고 이 차이는 "예산이 부족해서"나 "기술이 어려워서" 생긴 게 아닙니다. 그냥 만들 때 마우스 사용자만 떠올렸기 때문에 생긴 차이입니다. 트리거를 <button>으로 만들고, aria-expanded를 토글하고, 접힌 답변을 hidden으로 제대로 숨기는 것 — 그거면 박 선생님의 스크린리더도 "지원금은 언제 입금되나요? 버튼, 접힘"이라고 읽고, Enter로 펼쳐 "펼침"을 듣고 그 답변만 깔끔하게 읽었을 겁니다. 김 주무관과 똑같이 10초면 끝났겠죠. 만약 이 팀이 KRDS 킷의 아코디언 코드를 가져다 썼다면, 이 모든 게 처음부터 갖춰진 상태로 시작했을 겁니다.
5분 셀프 점검 — 지금 바로 해보기
거창한 도구 없이도, 지금 우리 사이트의 아코디언을 직접 점검해 볼 수 있습니다. FAQ 페이지나 정책 안내, 약관 화면을 띄워 놓고 순서대로 해보세요. 이 다섯 가지만 해봐도 대부분의 아코디언 문제가 드러납니다.
1단계 — 마우스를 치우고 Tab만으로 펼쳐 보기.
마우스에서 손을 떼고, Tab 키만으로 아코디언 항목(FAQ 질문 등)까지 이동해 보세요. 초점이 각 제목 줄에 가나요? 가서 또렷이 보이나요(포커스 표시)? 거기서 Enter나 Space를 눌렀을 때 펼쳐지나요? 초점이 안 가거나, 가도 안 보이거나, 눌러도 안 펼쳐지면 — 1순위 문제입니다. 그 아코디언은 키보드 사용자에게 줄줄이 닫힌 서랍입니다. 항목 두세 개만 해봐도 패턴이 보입니다(하나가 안 되면 보통 다 안 됩니다).
2단계 — 펼친 뒤 안으로 들어갔다 다시 나오기.
키보드로 한 항목을 펼쳤다면, 계속 Tab을 눌러 펼쳐진 답변 안의 링크나 입력으로 자연스럽게 초점이 들어가는지 보세요. 그리고 다시 트리거로 돌아와 접을 수 있는지도요. 펼쳤는데 안으로 못 들어가거나, 접었는데 보이지 않는 영역으로 초점이 빨려 들어가면(보이지 않는데 Tab이 멈춤) — 초점 처리 문제입니다.
3단계 — 전부 접은 상태에서 페이지 텍스트 확인.
아코디언 항목을 모두 접은 상태에서, 브라우저의 페이지 내 검색(Ctrl+F / Cmd+F)으로 접혀 있는 답변 안의 단어를 검색해 보세요. 접혀 있어도 검색에 잡히나요? 잡히면 콘텐츠가 코드에 존재한다는 뜻이라 좋습니다(검색엔진도 읽을 수 있음). 다만 스크린리더 관점에선, 접힌 상태에서 그 내용이 "읽히지 않게" 처리됐는지도 함께 봐야 합니다. 시각적으로만 감추고 코드엔 그대로 노출돼 있으면, 스크린리더가 접힌 답변들까지 줄줄 읽어 혼란을 줍니다. 반대로 검색에 아예 안 잡히면, 자바스크립트로만 나중에 불러오는 방식이라 검색엔진이 못 읽을 가능성이 있습니다.
4단계 — 화살표를 가리고 상태 짐작해 보기.
펼침/접힘을 화살표나 +/− 같은 아이콘, 또는 색으로만 표시하고 있지 않은지 보세요. 그 아이콘을 손으로 가렸을 때(또는 색 필터로 흑백으로 봤을 때), 지금 어느 항목이 펼쳐졌는지 알 수 있나요? 아이콘·색에만 의존하고 있다면, 코드(aria-expanded)로도 상태가 전달되는지 개발자도구로 확인해야 합니다. 개발자도구에서 제목 버튼을 클릭(Inspect)해 aria-expanded 값이 펼칠 때 true, 접을 때 false로 바뀌는지 직접 보면 가장 확실합니다.
5단계 — 모바일에서 빠르게 펼쳐 보기.
스마트폰으로 FAQ를 빠르게 펼쳐 보세요. 옆 질문이 잘못 펼쳐지거나, 제목 텍스트의 정확한 픽셀을 눌러야만 펼쳐지면 — 터치 영역이 부족한 겁니다. 트리거 영역을 줄 전체로 넓혀야 합니다. 아코디언은 항목이 세로로 빽빽이 붙어 있어, 데스크톱에선 멀쩡해 보여도 모바일에선 오터치가 잦은 경우가 많습니다.
이 다섯 가지는 누구나 5분이면 할 수 있습니다. 다만 페이지가 많아지면(FAQ가 여러 페이지, 정책 안내가 곳곳에) 사람이 다 보기 어렵습니다 — 그때 ViewCheck로 전 페이지를 한 번에 점검하면 됩니다. 그 얘기는 뒤에서 자세히 하겠습니다.
공공 사이트가 자주 틀리는 지점 — 그리고 올바른 예
이제 현업에서 실제로 반복되는 아코디언 실수들을 보겠습니다. 모두 익명화한 일반적 사례입니다(특정 기관을 지목하지 않습니다). 위에서 본 셀프 점검 항목과 짝지어 읽으면, "내가 점검할 때 뭘 보면 되는지"가 더 선명해집니다.

실수 1) 트리거가 버튼이 아니다 — `<div>`로 만든 가짜 아코디언
가장 흔하고 가장 치명적인 실수입니다. 디자인 자유도를 이유로 펼침 트리거를 <div>나 <span>, 혹은 <a href="#">로 만들고 클릭 이벤트만 붙입니다. 모양은 똑같습니다. 그런데 키보드로 초점이 안 가거나, Enter/Space로 안 펼쳐지거나, 스크린리더가 "버튼"으로 인식하지 못합니다.
- 나쁜 예: <div class="faq-title">질문</div>. role도 tabindex도 aria-expanded도 없음. 마우스로만 작동. 키보드 사용자에겐 존재하지 않는 버튼. 항목이 스무 개면 스무 개가 전부 닫힌 서랍.
- 올바른 예: <h3><button aria-expanded="false" aria-controls="ans-1">질문</button></h3>. 버튼이라 Tab·Enter·Space가 공짜로 따라오고, 스크린리더가 "질문, 버튼, 접힘"이라고 읽음. 헤딩으로 감싸 목차 역할도.
실수 2) `aria-expanded`가 없거나, 있어도 안 바뀐다
트리거를 버튼으로는 만들었는데, 펼침/접힘 상태를 코드로 안 알리는 경우입니다.
- 나쁜 예 ①: aria-expanded가 아예 없음. 스크린리더가 "버튼"이라고만 읽고, 펼쳐지는 버튼인지 모름.
- 나쁜 예 ②: aria-expanded="false"가 박혀 있는데, 펼쳐도 값이 안 바뀜. 스크린리더는 영원히 "접힘"이라 읽음.
- 올바른 예: 펼치면 true, 접으면 false로 실제로 토글. 스크린리더가 각 항목의 상태 변화를 읽어 줌.
실수 3) 접힌 콘텐츠가 시각적으로만 숨겨짐
CSS로 height:0이나 opacity:0, 화면 밖으로 밀어내기만 하고, DOM에는 그대로 노출하는 경우입니다.
- 나쁜 예: 접힌 FAQ 답변 스무 개가 화면엔 안 보이지만 코드엔 그대로 있어, 스크린리더가 모든 답변을 줄줄 읽음. "접혀 있다"는 느낌이 전혀 없고, 질문과 답이 뒤섞여 들림.
- 올바른 예: 접힐 때 hidden 속성이나 display:none으로 보는 것·읽는 것·초점을 일관되게 숨기고, 펼칠 때 그 항목만 드러냄.
실수 4) 초점 함정 — 안 보이는 영역에 초점이 들어감
접힌 콘텐츠를 시각적으로만 가리고 그 안의 링크·버튼이 여전히 Tab 순서에 남아 있는 경우입니다.
- 나쁜 예: 접힌 항목인데 Tab을 누르면 보이지 않는 링크로 초점이 사라짐. 사용자는 "초점이 어디 갔지?" 하고 헤맴. 항목이 많으니 이런 빈칸이 곳곳에 생김.
- 올바른 예: 접힌 항목은 초점 대상에서도 빠지게(숨김 처리로 자동 해결). 펼쳤을 때만 그 항목 내부 요소가 Tab 순서에 들어옴.
실수 5) 화살표·색으로만 상태 표시
펼침/접힘을 화살표 회전이나 색 변화로만 나타내는 경우입니다.
- 나쁜 예: 화살표가 위/아래로 도는 것만으로 상태 표시. 코드엔 상태 없음. 색만 바뀌어 색 구분 어려운 사용자는 구별 못 함.
- 올바른 예: 시각 신호(화살표)는 그대로 두되, aria-expanded로 코드에도 상태를 담아 모두에게 전달. 화살표 아이콘 자체는 aria-hidden="true"로 숨겨 중복 낭독 방지.
실수 6) 중요한 정보를 접어 두고 기본을 "전부 접힘"으로
꼭 봐야 하는 안내(예: 신청 자격, 필수 유의사항)를 아코디언 안에 넣고 기본을 전부 접힌 상태로 두는 경우입니다.
- 나쁜 예: "신청 전 반드시 확인" 같은 핵심 안내가 다른 항목들과 똑같이 접혀 있어, 많은 사용자가 못 보고 지나침.
- 올바른 예: 꼭 봐야 하는 정보는 접지 않거나, 부득이 접더라도 첫 항목으로 기본 펼침 상태로 두고 눈에 띄게 강조. "안 봐도 되는 것"만 접는 게 원칙.
실수 7) 접힌 콘텐츠를 검색엔진이 못 읽음
FAQ 답변을 자바스크립트로 나중에 불러오는(lazy) 방식이라, 초기 HTML에 내용이 없는 경우입니다.
- 나쁜 예: 검색으로 "FAQ 답변 내용"을 찾으려 해도, 그 텍스트가 초기 코드에 없어 검색엔진이 색인 못 함. 정작 답이 있는데 검색에 안 잡혀, FAQ를 만든 보람이 없음.
- 올바른 예: 접힌 콘텐츠도 초기 HTML에 포함(또는 서버 렌더링)해 검색엔진이 읽게 함. 접힘은 표시 상태일 뿐, 콘텐츠는 코드에 존재.
실수 8) 트리거 영역이 텍스트에만 한정 / 항목 간격이 빽빽
펼침 클릭이 제목 글자 픽셀에만 걸려 있어, 살짝만 빗나가도 안 펼쳐지거나 옆 항목이 눌리는 경우입니다.
- 나쁜 예: 제목 글자를 정확히 눌러야만 펼쳐짐. 항목이 세로로 붙어 있어 모바일·손 떨림 사용자에겐 고역.
- 올바른 예: 트리거 버튼 영역을 줄 전체로 넓히고(약 44px 이상 높이), 항목 사이 간격도 여유 있게.
실수 9) "한 번에 하나만 펼침"의 부작용을 안 챙김
A 항목을 읽다가 B를 펼치면 A가 자동으로 접히는 정책인데, 이 변화를 사용자가 인지하기 어려운 경우입니다.
- 나쁜 예: B를 펼쳤더니 방금 보던 A가 소리 없이 접혀, 스크린리더 사용자는 "방금 내용이 왜 사라졌지?" 혼란. 마우스 사용자도 긴 답변을 비교하려다 당황.
- 올바른 예: 한 번에 하나만 펼치는 정책 자체는 괜찮으나, 자동 접힘이 명확히 전달되게 하거나, 비교가 필요한 콘텐츠라면 다중 펼침을 허용. 정책을 사이트 전체에서 일관되게.
실수 10) 페이지마다 동작이 제각각
같은 사이트인데 어떤 FAQ는 한 번에 하나만, 어떤 FAQ는 여러 개가 동시에 펼쳐지고, 키보드 동작도 미묘하게 다른 경우입니다.
- 나쁜 예: 페이지마다 다르게 동작해 사용자가 매번 새로 적응해야 함. 어떤 페이지는 키보드로 되고 어떤 페이지는 안 됨.
- 올바른 예: 디자인 시스템 차원에서 동작을 한 번 정해 전사에 통일. KRDS 컴포넌트 킷(accordion / accordion_line)을 쓰면 자연스럽게 일관됨.
직접 적용하기 — 개발자·디자이너·기획자 가이드
KRDS의 좋은 점은, 위 요건들을 "알아서 잘 만드세요"로 끝내지 않고 바로 쓸 수 있는 자산으로 제공한다는 것입니다.
개발자라면 — KRDS 컴포넌트 킷을 npm install krds-uiux로 설치하거나 CDN(krds.min.css / krds.min.js)으로 불러올 수 있습니다. 저장소의 html/code 폴더에 아코디언 변형 코드(accordion, accordion_line)가 들어 있어, 키보드 동작과 aria-expanded 토글이 이미 구현된 상태로 시작할 수 있습니다. 핵심 습관은 단순합니다. 트리거는 `<button>`으로(가능하면 헤딩으로 감싸서), 상태는 `aria-expanded`로 토글, 접힌 콘텐츠는 `hidden`으로 일관되게 숨김, 트리거-콘텐츠는 `aria-controls`로 연결. 이 네 가지만 지켜도 아코디언 위반의 대부분이 사라집니다. 한 번 공통 컴포넌트로 만들어 두면 이후엔 자동으로 따라오니, 처음에 KRDS 킷 기반으로 잡아 두는 게 장기적으로 가장 빠른 길입니다.
추가로 챙기면 좋은 것들: 트리거 버튼의 클릭 영역을 줄 전체로 넓히기(패딩으로 약 44px 확보), 포커스 표시 유지(outline을 지웠다면 대체 스타일 제공), 화살표 SVG는 aria-hidden="true"로 숨겨 중복 낭독 방지, 접힌 콘텐츠도 초기 HTML에 포함해 검색엔진이 읽게 하기, 펼쳐진 콘텐츠 영역에 role="region"과 aria-labelledby 부여, 여러 항목 사이 방향키 이동까지 넣으면 금상첨화.
디자이너라면 — KRDS 공식 Figma(@krds) 라이브러리에서 아코디언 컴포넌트와 그 상태(접힘/펼침/포커스)를 가져다 쓸 수 있습니다. 직접 그리지 말고 표준 컴포넌트를 배치하면, 디자인 단계에서부터 크기·상태·간격·터치 영역이 기준에 맞춰집니다. 그리고 시안에 "접힘 상태"와 "펼침 상태", "포커스 상태"를 모두 그려 주세요. 평상시 모습 하나만 그리면, 개발 단계에서 상태 처리가 누락되기 쉽습니다. 항목 간 간격도 명시해 두면 모바일 오터치를 미리 막을 수 있습니다.
기획자라면 — 화면 정의서에 "펼쳐지는 FAQ"라고만 적지 말고, "아코디언(기본 전부 접힘 또는 첫 항목 펼침, 키보드 토글, 한 번에 하나만/여러 개 펼침)"처럼 동작·기본 상태·펼침 정책을 함께 명시하세요. 특히 무엇을 접고 무엇을 접지 말지를 결정하는 건 기획의 몫입니다. 꼭 봐야 하는 정보(신청 자격, 필수 유의사항)는 접지 않거나 첫 항목으로 펼쳐 두도록 정의서에서부터 못박아 두세요. 그리고 한 사이트 안에서 펼침 정책을 통일하도록 가이드를 정해 두면, 페이지마다 제각각인 동작을 막을 수 있습니다. 이 한 줄이 디자인·개발 단계의 누락을 막습니다.
그래서 우리 사이트는? — ViewCheck로 자동 점검
앞서 본 5분 셀프 점검은 한 페이지에는 충분합니다. 그런데 공공 사이트는 보통 FAQ가 여러 페이지, 정책 안내가 부서마다, 약관 화면이 곳곳에 흩어져 있습니다. 페이지마다 아코디언이 몇 개인지, 각각 트리거가 버튼인지, 키보드로 펼쳐지는지, aria-expanded가 토글되는지, 접힌 콘텐츠가 제대로 숨겨지는지를 사람이 일일이 손으로 점검하려면 끝이 없습니다. 페이지가 수십·수백 개라면 더더욱요.

ViewCheck(krds.viewcheck.co.kr)는 이 점검을 자동화합니다. URL만 넣으면 페이지를 실제로 크롤링해서, 아코디언을 포함한 컴포넌트들이 KRDS 기준을 지키는지 판정합니다. 아코디언은 KRDS 846규칙 중 컴포넌트(CP) 규칙군 446개에 속하고, 분석 결과의 컴포넌트(Components) 탭에서 확인할 수 있습니다.
ViewCheck가 아코디언에 대해 자동으로 보는 것들:
- 트리거의 정체: 각 펼침 트리거가 버튼(또는 적절한 상호작용 요소)인지, <div>로 만든 가짜인지
- 상태 속성 유무: aria-expanded 같은 상태 속성이 있는지, 콘텐츠 연결(aria-controls)이 있는지
- 키보드·초점 가능성: 트리거에 초점이 도달 가능한지, 포커스 표시가 살아 있는지(접근성·반응형 분석과 연계)
- 콘텐츠 처리: 접힌 콘텐츠가 코드에 존재하면서도 적절히 숨김 처리됐는지
DOM만으로 판단하기 어려운 시각적 부분(예: 커스텀 아코디언의 실제 펼침 모양, 화살표 회전, 항목 간격)은 KRDScan Vision AI가 스크린샷을 함께 보고 보강 판정합니다. 그래서 "코드엔 표준 아코디언 같은 게 없는데 화면엔 분명히 줄지어 펼쳐지는 메뉴가 있는" 비표준 구현도 놓치지 않습니다. 이 점이 단순 코드 검사 도구와 다른 부분입니다 — 사람이 눈으로 보듯 화면을 함께 보기 때문에, 표준을 우회해 만든 UI도 잡아냅니다.
리포트를 어떻게 읽나
분석이 끝나면 컴포넌트 탭에서 아코디언 관련 규칙의 통과/미통과 수와, 미통과한 항목의 위치(어느 페이지)·이유·개선 방법(howToFix)이 함께 나옵니다. 예를 들어 "FAQ 페이지의 아코디언 트리거 18개 중 14개가 버튼이 아니고 aria-expanded 없음"처럼 구체적으로요. 여러 페이지를 한꺼번에 분석하면, "메인의 펼침 메뉴는 멀쩡한데 FAQ 페이지의 아코디언만 키보드로 안 열린다" 같은 페이지별 편차도 한눈에 드러납니다. 어디부터 고쳐야 하는지 우선순위(P0~P3)도 함께 매겨지니, 한정된 시간에 가장 중요한 것부터 손볼 수 있습니다.
무료 진단으로 우리 사이트의 FAQ 페이지부터 한 번 돌려 보면, 손으로는 몇 시간 걸릴 점검이 몇 분 만에 끝납니다. 그리고 그 결과는 막연한 "잘하자"가 아니라, "이 페이지의 이 아코디언 트리거들을 버튼으로 바꾸고 aria-expanded를 붙이자"는 구체적인 작업 목록이 됩니다.
셀프 점검과 ViewCheck, 어떻게 나눠 쓰나
둘은 경쟁이 아니라 보완 관계입니다.
- 셀프 점검(앞의 5분): 한 페이지를 깊게, 실제 사용 감각으로 확인. "이 FAQ 키보드로 정말 쓸 수 있나"를 몸으로 느끼는 데 좋습니다. 개발·디자인 중에 수시로 하기 좋고요.
- ViewCheck: 사이트 전체를 넓게, 빠짐없이 확인. 사람이 다 못 보는 수십·수백 페이지를 한 번에 훑어 "어느 페이지의 어느 아코디언이 문제인지" 목록으로 뽑아 줍니다.
추천 순서는 이렇습니다. 먼저 ViewCheck로 전 페이지를 돌려 "문제가 있는 페이지·아코디언 목록"을 받고, 그중 핵심 경로(FAQ·정책 안내·약관)부터 골라 5분 셀프 점검으로 실제 사용 감각을 확인한 뒤, KRDS 킷 코드로 고치는 겁니다. 넓게 찾고(ViewCheck) → 깊게 확인하고(셀프 점검) → 표준으로 고치는(킷) 한 바퀴죠. 한 번 이 루프를 돌고 나면, 다음 개편 때는 처음부터 표준 컴포넌트로 시작하니 점검할 게 확 줄어듭니다.
자주 묻는 질문
현장에서 아코디언을 다룰 때 반복해서 나오는 질문들을 모았습니다.
Q. 아코디언이랑 디스클로저, 뭐가 다른가요?
디스클로저는 트리거 하나에 콘텐츠 하나가 딸린 단일 토글입니다("더보기" 버튼 하나). 아코디언은 그 디스클로저가 여러 개 세로로 묶여 있고, 보통 "한 번에 하나만 펼침" 같은 그룹 규칙이 추가된 형태입니다. FAQ 목록처럼 여러 질문이 줄지어 있으면 아코디언, 버튼 하나로 영역 하나를 펼치면 디스클로저라고 보면 가깝습니다. 다만 접근성 요건(트리거는 버튼, aria-expanded 토글, 키보드 지원, 접힌 콘텐츠의 일관된 숨김)은 둘이 똑같으니, 점검할 때 구분에 너무 매일 필요는 없습니다.
Q. 아코디언이랑 탭은요? 둘 다 항목을 갈아 끼우는 것 같은데.
핵심 차이는 "전부 접힌 상태가 가능한가"입니다. 탭은 가로로 늘어선 제목 중 하나가 항상 선택돼 있어 패널 하나가 늘 보입니다. 아코디언은 전부 접어 둘 수도 있고, 여러 개를 동시에 펼칠 수도 있습니다. 그리고 탭은 보통 가로 배치, 아코디언은 세로 배치가 자연스럽습니다. 내용이 "서로 배타적인 몇 개 묶음"이고 항상 하나는 봐야 하면 탭, "필요한 것만 골라 펼쳐 보는 긴 목록"이면 아코디언이 맞습니다. FAQ 스무 개를 탭으로 만들면 제목 줄이 끝없이 늘어져 곤란해집니다.
Q. 트리거를 꼭 `<button>`으로 해야 하나요? `<div>`로 하면 안 되나요?
<div>로도 만들 수는 있지만, 그 순간 <button>이 공짜로 주던 키보드 초점·Enter/Space 활성화·스크린리더 인식을 전부 직접 구현해야 합니다(role="button", tabindex="0", 키 이벤트 핸들러 등). 현실에서는 이걸 다 챙기기 어려워 자주 빠집니다. 게다가 아코디언은 항목이 여럿이라, 한 군데서 빠뜨리면 보통 전부 빠집니다. 특별한 이유가 없으면 <button>이 가장 안전하고 빠른 답입니다. KRDS 킷도 버튼 기반으로 제공합니다.
Q. `aria-expanded` 하나만 붙이면 접근성은 끝나나요?
aria-expanded는 아코디언의 핵심이지만 전부는 아닙니다. ① 트리거가 키보드로 도달·활성화되는지, ② 접힌 콘텐츠가 일관되게 숨겨지는지(보는 것·읽는 것·초점 모두), ③ 포커스 표시가 살아 있는지, ④ 터치 영역이 충분한지, ⑤ 트리거와 콘텐츠가 연결(aria-controls)됐는지까지 함께 봐야 합니다. aria-expanded만 붙이고 트리거가 <div>라 키보드로 못 누르면, 속성은 있으나 마나입니다.
Q. 한 번에 하나만 펼쳐지게 하는 게 좋나요, 여러 개가 펼쳐지게 하는 게 좋나요?
정답은 콘텐츠 성격에 달렸습니다. 항목들이 서로 독립적이고 사용자가 보통 하나만 보면 되는 FAQ라면 "한 번에 하나만"이 화면이 깔끔합니다. 반대로 사용자가 여러 항목을 펼쳐 놓고 비교해야 하는 경우(예: 지원 분야별 조건 비교)라면 다중 펼침이 낫습니다. 다만 어느 쪽을 택하든 사이트 전체에서 일관되게 가야 합니다. 그리고 "한 번에 하나만" 정책이라면, 새 항목을 펼칠 때 앞 항목이 소리 없이 접히는 변화가 사용자(특히 스크린리더)에게 당황을 주지 않도록 신경 써야 합니다.
Q. 접힌 FAQ 답변을 검색엔진이 읽나요? SEO에 불리한가요?
접힌 콘텐츠가 초기 HTML(또는 서버 렌더링 결과)에 포함돼 있으면 검색엔진이 읽고 색인합니다. "접힘"은 화면 표시 상태일 뿐, 코드에 텍스트가 있으면 문제없습니다. 불리해지는 경우는 콘텐츠를 클릭 후 자바스크립트로만 불러오는(lazy) 방식일 때입니다. FAQ처럼 검색으로 찾아오는 정보는, 접혀 있어도 코드엔 처음부터 존재하도록 만드세요. 공공 사이트의 FAQ는 검색 유입의 큰 통로라, 이걸 놓치면 "전화 문의 줄이려고 만든 FAQ"가 검색에 안 잡혀 제 역할을 못 합니다.
Q. 중요한 안내를 아코디언으로 접어 둬도 되나요?
원칙은 "안 봐도 되는 것만 접는다"입니다. 신청 자격, 필수 유의사항처럼 꼭 봐야 하는 정보를 다른 항목들과 똑같이 접고 기본을 "전부 접힘"으로 두면, 많은 사용자가 못 보고 지나칩니다. 꼭 봐야 하는 건 접지 않거나, 부득이 접더라도 첫 항목으로 기본 펼침 상태로 두고 강하게 강조하세요. 아코디언은 "정보를 정리하는" 도구이지 "숨기는" 도구가 아닙니다.
Q. 화살표(▾)만으로 펼침/접힘을 표시하면 안 되나요?
화살표 같은 시각 신호는 좋습니다. 다만 그것에만 의존하면 안 됩니다. 화면을 못 보는 사용자에게는 화살표 회전이 닿지 않으니, 반드시 aria-expanded로 코드에도 상태를 담아야 합니다. 화살표는 보조, aria-expanded는 본질이라고 생각하세요. 그리고 화살표 아이콘 자체는 장식이므로 aria-hidden="true"로 숨겨 중복 낭독을 막는 게 좋습니다.
Q. 모바일에서 펼침 영역이 너무 작아 옆 항목이 자꾸 눌립니다.
트리거(누르는 영역)를 제목 글자가 아니라 그 줄 전체로 넓히세요. 높이도 손가락에 맞게(약 44px 이상) 확보하고, 항목 사이 간격도 여유 있게 두면 오터치가 크게 줄어듭니다. 아코디언은 항목이 세로로 붙어 있어 특히 오터치가 잦으니, 구분선 형(accordion_line)처럼 항목 경계가 분명한 변형을 쓰면 더 낫습니다.
Q. 이미 운영 중인 사이트인데, 아코디언을 전부 다시 만들어야 하나요?
전부 갈아엎을 필요는 없습니다. 먼저 ViewCheck로 "지금 어떤 아코디언이, 어느 페이지에서, 무슨 문제를 일으키는지"를 목록으로 만든 다음, 사용 빈도가 높은 핵심 경로(FAQ·정책 안내·약관)의 아코디언부터 차례로 고치면 됩니다. 트리거를 <button>으로 바꾸고 aria-expanded를 붙이는 작업은 생각보다 빠르고, 보통 아코디언은 공통 컴포넌트 하나만 고치면 그걸 쓰는 페이지가 한꺼번에 좋아집니다. 적은 작업으로 가장 많은 사용자를, 가장 많은 페이지에서 먼저 구제할 수 있는 게 아코디언의 장점입니다.
Q. 디자인팀과 개발팀이 서로 "그건 너희 일"이라고 합니다.
아코디언 접근성은 어느 한 팀의 책임이 아니라 합작입니다. 디자이너는 접힘/펼침/포커스 상태와 항목 간격을 시안에 명시하고, 개발자는 그걸 표준 코드로 구현하고, 기획자는 "무엇을 접고 무엇을 접지 말지"와 펼침 정책을 정의해야 합니다. 그래서 KRDS가 디자인(Figma)·코드(GitHub 킷)·문서(가이드라인)를 한 세트로 제공하는 겁니다. 세 팀이 같은 기준을 보고 일하면 "네 일/내 일" 논쟁이 줄어듭니다.
점검했다면, 무엇부터 고칠까 — 우선순위
ViewCheck로 돌려 보면 보통 아코디언 관련 문제가 한두 개로 끝나지 않습니다. 아코디언은 항목이 여럿이고 여러 페이지에 흩어져 있어, "고칠 게 많다"는 압박감이 더 큽니다. 그래서 우선순위가 중요합니다. 아코디언 문제를 심각도 순으로 정리하면 대략 이렇습니다.
가장 먼저(치명적) — 키보드로 아예 펼쳐지지 않는 가짜 아코디언, 그리고 스크린리더가 펼침 버튼으로 인식하지 못하는 트리거. 이건 특정 사용자에게 접힌 정보를 줄줄이 완전히 차단하는 문제라 1순위입니다. FAQ·정책 안내·약관처럼 핵심 경로에 있는 아코디언이라면 더더욱 먼저 손봐야 합니다. "예쁘게 만든 커스텀 아코디언"이 사실 여기 해당하는 경우가 많습니다.
그다음(높음) — aria-expanded가 없거나 토글되지 않아 펼침/접힘 상태가 음성으로 전달되지 않는 경우, 그리고 접힌 콘텐츠가 시각적으로만 숨겨져 스크린리더에 모든 답변이 줄줄 읽히는 경우. 작동은 하지만 지금 어느 게 펼쳐졌는지, 무엇이 질문이고 답인지 스크린리더 사용자가 알 수 없으니 실질적 장벽입니다. 꼭 봐야 하는 정보를 접어 두고 전부 접힘으로 둔 것도 여기 포함됩니다(정보 누락으로 이어지므로).
그 후(보통) — 초점 함정, 화살표·색에만 의존한 상태 표시, 모바일 터치 영역 부족, "한 번에 하나만 펼침"의 부작용 미처리. 사용은 가능하지만 특정 상황·특정 사용자에게 불편을 주는 문제입니다.
여력이 되면(낮음) — 페이지마다 제각각인 펼침 정책 통일, 검색엔진이 접힌 콘텐츠를 읽도록 개선, 트리거 영역 확대, 방향키 이동 추가 같은 사용성·일관성 개선. 접근성을 막는 건 아니지만 경험을 한 단계 끌어올리는 항목입니다.
ViewCheck 리포트는 이 우선순위(P0~P3)를 자동으로 매겨 주기 때문에, "일단 빨간 것부터"가 아니라 "사용자를 가장 많이 막는 것부터" 순서대로 처리할 수 있습니다. 한정된 인력과 일정 안에서 가장 효과 큰 개선에 집중하는 게 핵심입니다. 특히 아코디언은 공통 컴포넌트 하나를 고치면 여러 페이지가 한꺼번에 좋아지는 경우가 많아, 투입 대비 효과가 큰 1순위 후보입니다.
더 깊이 확인하려면 — 공식 자료 안내
이 글은 KRDS의 아코디언 기준을 자가진단 관점에서 풀어 쓴 것입니다. 정확한 원문 기준과 코드·디자인 자산은 아래 공식 자료에서 직접 확인하실 수 있습니다.
- KRDS 가이드라인 PDF(디지털 정부서비스 UI/UX 가이드라인, 2025.08판) — 컴포넌트별 정의와 사용 원칙의 1차 원천.
- KRDS 컴포넌트 문서(웹) — 아코디언의 변형·예시를 화면으로 확인.
- KRDS 컴포넌트 킷(GitHub `KRDS-uiux/krds-uiux`) — 아코디언 변형 2종(accordion, accordion_line) 코드를 그대로 가져다 사용(npm install krds-uiux 또는 CDN).
- KRDS 공식 Figma(@krds) — 디자이너용 아코디언 컴포넌트와 상태.
공식 자료는 "정답지"이고, ViewCheck는 "내 답안을 채점해 주는 도구"라고 생각하시면 됩니다. 둘을 함께 쓰면, 기준을 이해하고(가이드라인) → 내 사이트가 그 기준에 맞는지 확인하고(ViewCheck) → 검증된 코드로 고치는(킷) 한 바퀴가 완성됩니다.
오늘의 체크리스트 — 아코디언, 이것만은
마지막으로, 디자이너·개발자·기획자가 아코디언을 만들거나 검수할 때 바로 쓸 수 있는 체크리스트로 정리합니다. 앞의 5분 셀프 점검과 함께 쓰면, 손으로도 빠르게 확인할 수 있습니다.
- ☐ 각 항목의 펼침 트리거가 버튼(<button>, 가능하면 헤딩으로 감싼)이다(<div> 클릭만으로 만들지 않았다).
- ☐ 각 트리거에 `aria-expanded`가 있고, 펼치면 true·접으면 false로 실제로 토글된다.
- ☐ 트리거와 콘텐츠가 `aria-controls`로 연결되고, 콘텐츠 영역이 적절히 표시(role="region"+aria-labelledby 권장)돼 있다.
- ☐ 키보드만으로 각 트리거 도달·펼치기·접기·내부 이동이 전부 된다.
- ☐ 포커스 표시가 또렷하다(outline: none으로 지우지 않았다).
- ☐ 접힌 콘텐츠가 보는 것·읽는 것·초점에서 일관되게 숨겨진다(시각적으로만 감추지 않았다).
- ☐ 펼침/접힘 상태를 화살표·색에만 의존하지 않는다(코드로도 전달된다).
- ☐ 화살표·+/− 같은 장식 아이콘은 aria-hidden="true"로 숨겼다.
- ☐ 꼭 봐야 하는 정보는 접지 않았다(안 봐도 되는 것만 접었고, 핵심 안내는 기본 펼침/강조).
- ☐ 접힌 콘텐츠도 초기 HTML에 존재해 검색엔진이 읽을 수 있다.
- ☐ 모바일에서 트리거의 터치 영역이 충분하다(줄 전체, 약 44px 이상, 항목 간격 여유).
- ☐ 사이트 전체에서 펼침 정책(한 번에 하나/여러 개)이 일관되다(페이지마다 다르게 동작하지 않는다).
KRDS 컴포넌트 킷(npm install krds-uiux 또는 CDN)을 쓰면 위 항목 대부분이 이미 구현된 상태로 시작할 수 있습니다. 직접 만들다 빠뜨릴 위험을 줄이는 가장 확실한 방법이죠. 공식 Figma 라이브러리(@krds)에서는 디자이너가 아코디언의 변형 2종과 상태(접힘·펼침·포커스)를 그대로 가져다 쓸 수 있습니다.
아코디언은 작아 보이지만, 공공 서비스에서 사용자가 "필요한 정보를 골라 펼쳐 보는" 거의 모든 길목에 있습니다. FAQ에서 답을 찾고, 지원 자격을 확인하고, 약관 조항을 펼쳐 읽는 그 순간들이요. 그 줄지어 선 펼침 하나하나가 누군가에겐 정보로 가는 문이고, 또 누군가에겐 줄줄이 닫힌 서랍입니다. 우리가 무심코 넘긴 "펼쳐지는 FAQ" 하나가, 누군가에게는 그 답을 혼자 찾을 수 있느냐 없느냐를, 그것도 스무 번에 걸쳐 가릅니다.
오늘 정리한 기준이 거창해 보일 수 있지만, 핵심은 결국 단순합니다. 각 트리거를 버튼으로 만들고, aria-expanded로 상태를 코드에 담고, 접힌 내용을 일관되게 숨기고, 검증된 코드를 쓰는 것. 이 네 가지만 챙겨도 아코디언 위반의 대부분은 사라집니다. 그리고 그게 잘 됐는지는, 마우스를 잠깐 치우고 Tab만으로 펼쳐 보는 5분 셀프 점검으로, 혹은 페이지가 많다면 ViewCheck로 몇 분 만에 확인할 수 있습니다. 완벽을 한 번에 만들 필요는 없습니다. 가장 많이 막히는 FAQ 하나부터 점검하고 고쳐 나가면 — 그리고 아코디언은 공통 컴포넌트 하나로 여러 페이지가 함께 좋아지니 — 우리 사이트는 분명히 조금씩, 그러나 꽤 빠르게 더 많은 사람에게 열립니다.
우리 사이트의 아코디언은 지금 키보드로 펼쳐질까요? 스크린리더가 각 항목의 펼침/접힘을 읽어 줄까요? krds.viewcheck.co.kr에서 URL만 넣으면 무료로 확인할 수 있습니다. FAQ 페이지 하나만 돌려 봐도, 위 체크리스트가 실제로 지켜지고 있는지 바로 보입니다.
#KRDS #공공웹 #디자인시스템 #아코디언Accordion #웹접근성 #ViewCheck #정부웹사이트 #UIUX #FAQ #자가진단 #디스클로저 #aria-expanded #아코디언 #Accordion #체크리스트 #점검항목 #UI컴포넌트 #컴포넌트설계 #전자정부 #디지털정부
관련 글
라디오 버튼(Radio button) 완전 해부 — KRDS 공식 기준
지원금 신청서를 작성하다 "신청 유형"을 고르는 칸에서 잠깐 멈춰 본 적 있으실 겁니다. "개인 / 사업자 / 단체" 셋 중 하나를 동그라미 버튼으로 고르는, 그 흔하디흔한 칸 말입니다. 마우스 쓰는 사람에겐 1초짜리 동작이죠. 동그라미를 톡 누르면 점이 찍히고 끝. 그런데 그 1초짜리 칸이 누군가에겐 신청 자체를 포기하게 만드는 벽이 되기도 합니다. 키보드로는 점이 안 찍히거나, 스크린리더가 "이게 뭘 고르는 거냐"를 알려 주지 않거나, 동그
플로팅 버튼(FAB) 자가진단 — ViewCheck 5분 점검
모바일로 어느 공공 사이트의 긴 안내문을 한참 읽어 내려가다, 화면 오른쪽 아래 구석에 동그란 버튼 하나가 둥둥 떠 있는 걸 본 적 있으실 겁니다. 스크롤을 아무리 내려도 그 자리에 고정돼 따라오는 동그라미. "맨 위로", "문의하기", "신청하기" 같은 핵심 동작을 어디서든 한 번에 누르라고 띄워 둔 그 버튼을, 우리는 "플로팅 버튼(FAB, Floating Action Button)"이라고 부릅니다. 평소엔 "아, 편하네" 하고 무심코 누르
플로팅 버튼(FAB) 완전 해부 — KRDS 공식 기준
모바일로 어느 공공 서비스를 쓰다가, 화면 오른쪽 아래 구석에 동그란 버튼 하나가 떠 있는 걸 본 적 있으실 겁니다. 스크롤을 아무리 내려도 그 자리에 계속 붙어 있는 버튼. "맨 위로", "챗봇 상담", "새 글 작성" 같은 걸 부르는 그 동그란 친구. 그게 바로 플로팅 버튼, 줄여서 FAB(Floating Action Button)입니다. 워낙 흔해서 "그냥 떠 있는 버튼"쯤으로 여기지만, 사실 이 작은 동그라미는 만들기가 생각보다 까다롭고

댓글 0
댓글을 불러오는 중…