아코디언(Accordion) 완전 해부 — KRDS 공식 기준
공공 사이트의 "자주 묻는 질문" 페이지를 떠올려 보세요. 질문 수십 개가 한 줄씩 차곡차곡 접혀 있고, 궁금한 항목을 누르면 그 아래로 답이 쓱 펼쳐집니다. 다른 걸 누르면 방금 본 건 닫히고 새 답이 열리죠. 우리는 이걸 너무 당연하게 여겨서 이름조차 잘 모르고 씁니다. 이게 바로 아코디언(Accordion)입니다. 손풍금처럼 펼쳐졌다 접혔다 한다고 해서 붙은 이름이죠.

공공 사이트의 "자주 묻는 질문" 페이지를 떠올려 보세요. 질문 수십 개가 한 줄씩 차곡차곡 접혀 있고, 궁금한 항목을 누르면 그 아래로 답이 쓱 펼쳐집니다. 다른 걸 누르면 방금 본 건 닫히고 새 답이 열리죠. 우리는 이걸 너무 당연하게 여겨서 이름조차 잘 모르고 씁니다. 이게 바로 아코디언(Accordion)입니다. 손풍금처럼 펼쳐졌다 접혔다 한다고 해서 붙은 이름이죠.
저는 공공 웹사이트를 수백 개 들여다보면서, 이 아코디언이 얼마나 자주 쓰이고 또 얼마나 자주 잘못 만들어지는지를 질리도록 봤습니다. FAQ, 약관, 정책 안내, 단계별 신청 안내, 자료실 분류 — 정보가 많은 공공 페이지일수록 아코디언이 빠지질 않습니다. 그런데 정작 "이걸 키보드로 펼칠 수 있나", "스크린리더가 지금 펼쳐졌는지 접혔는지 알려 주나"를 따져 보면, 열에 일곱은 어딘가 빠져 있습니다. 마우스로는 멀쩡히 잘 작동하니까, 만든 사람도 "잘 된다"고 믿고 넘어가는 거죠.
아코디언은 셀렉트나 버튼처럼 "기본 컴포넌트"는 아닙니다. 그런데 묘하게도 더 까다롭습니다. 단순히 클릭하면 끝이 아니라, "지금 열렸는가 닫혔는가"라는 상태가 계속 바뀌고, 그 상태를 사용자에게 정확히 전달해야 하거든요. 보이는 사람에겐 화살표가 위로 돌면 "열렸구나" 하고 알지만, 화면을 못 보는 사람에겐 그 화살표가 아무 정보도 아닙니다. 코드가 직접 "펼쳐짐"이라고 말해 줘야만 알 수 있죠. 이 "상태를 말로 전달하는 일"이 아코디언의 핵심이자, 가장 많이 빠뜨리는 부분입니다.
이 글에서는 KRDS(대한민국 정부 디자인 시스템)가 아코디언을 어떻게 정의하고 무엇을 요구하는지를, 공식 가이드라인과 컴포넌트 킷을 기준으로 하나하나 뜯어보겠습니다. "이렇게 하면 깔끔하다"가 아니라 "정부 표준은 이걸 요구한다"는 사실 기준으로요. 그리고 그 기준을 우리 사이트가 실제로 지키고 있는지 어떻게 확인하는지까지 이어가겠습니다. 다 읽고 나면, 앞으로 어떤 FAQ 페이지를 봐도 "이건 제대로 만든 아코디언, 저건 위험한 아코디언"이 눈에 들어오실 겁니다.
아코디언이 대체 뭐길래 — 정의부터 정확히
먼저 용어부터 맞추겠습니다. 아코디언은 한마디로 "제목(헤더)을 누르면 그에 딸린 내용(패널)이 펼쳐지고 접히는" 컴포넌트입니다. 핵심은 두 부분으로 이뤄진다는 거예요.
- 헤더(머리, 트리거): 항상 보이는 제목 줄. 사용자가 누르는 부분입니다. "환불은 어떻게 하나요?" 같은 질문이 여기 들어갑니다.
- 패널(본문, 내용): 평소엔 접혀 있다가 헤더를 누르면 나타나는 내용. 질문에 대한 답이 여기 들어가죠.
이 둘의 관계가 코드 수준에서 명확히 묶여 있어야 한다는 게 아코디언의 첫 번째 요건입니다. "이 헤더를 누르면 저 패널이 열린다"는 짝지음이 시각적으로만이 아니라 코드로도 선언돼 있어야 보조기술이 따라올 수 있거든요.
여기서 헷갈리기 쉬운 컴포넌트들과 선을 그어 두겠습니다. 모양이 비슷해도 역할이 다르면 다른 컴포넌트입니다.
- 탭(Tab)과 아코디언: 둘 다 "한 번에 하나의 내용을 보여 준다"는 점은 비슷합니다. 하지만 탭은 내용이 가로로 나란히 전환되고, 아코디언은 세로로 펼쳐집니다. 일반적으로 모바일처럼 가로 공간이 부족한 환경에서는 탭보다 아코디언이 적합한 경우가 많습니다.
- 디스클로저(Disclosure)와 아코디언: 디스클로저는 "더 보기"처럼 하나의 내용을 펼쳤다 접는 단순한 토글입니다. 아코디언은 여러 개의 디스클로저가 묶여 하나의 그룹을 이룬 형태라고 보면 이해가 쉽습니다.
- 드롭다운/셀렉트와 아코디언: 드롭다운은 "선택"을 위한 것이고, 아코디언은 "정보 펼침/접힘"을 위한 것입니다. 펼쳐지는 모양이 닮았다고 같은 걸로 다루면 안 됩니다.
이 구분이 왜 중요하냐면, 모양이 비슷하다고 아무 데나 아코디언을 쓰면 사용자가 "여기서 뭘 해야 하는지" 헷갈리기 때문입니다. KRDS가 컴포넌트를 역할별로 나눠 정의해 둔 이유가 바로 이겁니다 — 같은 시각적 패턴이라도 의미가 다르면 다른 컴포넌트로 다뤄야 한다는 것.
KRDS는 아코디언을 두 변형으로 제공한다
KRDS 컴포넌트 킷(GitHub KRDS-uiux/krds-uiux)을 열어 보면 아코디언이 두 가지 변형으로 제공됩니다.
- accordion — 기본형
- accordion_line — 라인(선) 스타일 변형

기본형은 각 항목이 박스(면)로 구분되는 형태이고, 라인 스타일은 항목 사이를 가느다란 구분선으로만 나누는 더 가벼운 형태입니다. 둘 다 본질적인 동작(헤더 클릭 → 패널 펼침/접힘)은 같고, 시각적 무게감만 다릅니다. 정보 밀도가 높은 자료실이나 약관처럼 항목이 많은 곳에는 라인 스타일이, 각 항목을 또렷이 구분해야 하는 FAQ에는 기본형이 어울리는 식이죠.
두 변형을 따로 제공한다는 사실 자체가 메시지입니다. "아코디언은 그냥 하나 만들어서 다 쓰는 게 아니라, 정보의 성격에 맞는 정해진 모습이 있다"는 것. 그리고 변형이 둘뿐이라는 건, 아코디언의 핵심이 "겉모습"이 아니라 "동작과 상태"에 있다는 뜻이기도 합니다. 어떻게 생겼느냐보다, 펼침/접힘이 누구에게나 제대로 작동하느냐가 훨씬 중요한 컴포넌트예요.
KRDS는 아코디언에 무엇을 요구하나 — 기준 완전 해부
이제 본론입니다. KRDS 가이드라인(디지털 정부서비스 UI/UX 가이드라인, 2025.08판)과 컴포넌트 문서를 기준으로, 아코디언이 충족해야 하는 요건을 영역별로 정리하겠습니다. 미리 말씀드리면, 아코디언의 요건은 결국 한 문장으로 수렴합니다 — "펼쳤다 접었다 하는 상태를, 보는 사람뿐 아니라 코드로도 정확히 알려라."
1) 헤더는 버튼이어야 한다
아코디언에서 가장 먼저, 그리고 가장 많이 어긋나는 부분입니다. 사용자가 누르는 헤더는 단순한 글자 덩어리(<div>나 <span>)가 아니라, 코드 수준에서 버튼(button)으로 선언돼 있어야 합니다.
왜 이게 중요할까요. 버튼으로 선언되면 키보드 초점을 받을 수 있고, Enter나 Space로 누를 수 있고, 스크린리더가 "버튼"이라고 읽어 줍니다. 이 세 가지가 전부 공짜로 따라옵니다. 반대로 헤더를 그냥 <div>로 만들고 클릭 이벤트만 붙이면, 마우스로는 작동하지만 키보드로는 초점조차 갈 수 없습니다. 스크린리더는 그걸 그냥 "텍스트"로 읽고 지나가 버리죠. "여기를 누르면 펼쳐진다"는 사실 자체를 음성 사용자가 알 수 없게 됩니다.
KRDS 컴포넌트 킷이 헤더를 <button>으로 구현해 제공하는 이유가 바로 이겁니다. 직접 만들다 <div>로 빠뜨리지 말고, 버튼으로 선언된 검증된 코드를 쓰라는 겁니다.
2) 펼침/접힘 상태를 코드로 선언한다 (aria-expanded)
아코디언의 심장입니다. 헤더 버튼에는 지금 패널이 펼쳐졌는지 접혔는지를 알리는 aria-expanded 속성이 있어야 합니다. 펼쳐지면 aria-expanded="true", 접히면 aria-expanded="false"로 바뀌어야 하죠.
이게 왜 그렇게 중요한지 한 장면으로 그려 보겠습니다. 눈으로 보는 사람은 화살표가 아래를 향하면 "접힘", 위를 향하면 "펼침"이라고 직관적으로 압니다. 색이 진해지거나 배경이 바뀌는 것도 단서가 되죠. 그런데 화면을 못 보는 사람에게는 이 시각적 단서가 아무 의미가 없습니다. 코드가 aria-expanded로 "지금 펼쳐졌습니다", "지금 접혔습니다"라고 말해 줘야만 알 수 있어요.
aria-expanded가 없으면 스크린리더는 그냥 "환불은 어떻게 하나요, 버튼"이라고만 읽습니다. 사용자가 그 버튼을 눌러도, 화면 어딘가에서 내용이 펼쳐졌다는 걸 알 길이 없죠. "분명히 눌렀는데 아무 일도 안 일어난 것 같은" 답답한 상황이 벌어집니다. 그래서 aria-expanded는 아코디언에서 "있으면 좋은 것"이 아니라 "없으면 안 되는" 필수 요건입니다.
3) 헤더와 패널을 코드로 연결한다 (aria-controls)
헤더 버튼이 "내가 어떤 패널을 여닫는지"를 코드로 가리켜야 합니다. 이를 위해 헤더에 aria-controls 속성으로 해당 패널의 id를 지정합니다. 그러면 보조기술이 "이 버튼을 누르면 저기 있는 저 내용이 열린다"는 관계를 이해할 수 있죠.
여기에 더해, 헤더와 패널을 시맨틱하게 묶어 주는 패턴이 권장됩니다. 흔히 헤더 버튼을 적절한 제목 요소(<h3> 등) 안에 두고, 패널에는 그 헤더를 가리키는 aria-labelledby를 달아 "이 내용 영역의 제목은 저 헤더"라는 걸 알려 줍니다. 이렇게 해 두면 스크린리더 사용자가 제목만 빠르게 훑어보며 원하는 항목을 찾고, 필요한 것만 펼쳐 읽을 수 있습니다. 아코디언이 "정보를 정리해 한눈에 훑게 한다"는 본래 목적을, 음성 사용자에게도 똑같이 제공하는 거죠.
4) 키보드만으로 완전히 쓸 수 있어야 한다
타협이 없는 요건입니다. 아코디언은 키보드만으로 다음이 전부 가능해야 합니다.
- Tab으로 각 헤더 버튼에 초점 이동
- Enter 또는 Space로 해당 항목 펼치기/접기
- 펼쳐진 패널 안의 링크·버튼 등에도 Tab으로 자연스럽게 이동
- (구현에 따라) 위·아래 방향키로 헤더 간 이동, Home/End로 처음·끝 헤더로 점프
헤더를 진짜 <button>으로 만들었다면 Tab 초점과 Enter/Space 작동은 자동으로 따라옵니다. 문제는 앞서 말한 "가짜 헤더(<div>)"를 쓸 때입니다. 그 순간 위 동작을 전부 직접 구현해야 하는데, 현실에서는 거의 다 빠뜨립니다. 마우스 클릭 이벤트만 붙이고 끝내는 거죠. 그래서 KRDS 컴포넌트 킷은 키보드 동작과 ARIA 속성이 이미 구현된 코드를 제공합니다 — 직접 만들다 빠뜨리지 말고 검증된 걸 쓰라는 겁니다.
5) 초점 표시(Focus) — 지금 어디에 있는지 보여야 한다
키보드로 헤더 사이를 이동할 때, 지금 초점이 어느 헤더에 와 있는지 시각적으로 알 수 있어야 합니다. 테두리가 강조되거나 외곽선(focus ring)이 또렷하게 나타나야 하죠. 이 표시를 디자인이 지저분해 보인다는 이유로 CSS에서 outline: none으로 지워 버리는 경우가 정말 많습니다. 그러면 키보드 사용자는 자기가 화면 어느 항목에 있는지 알 수 없게 됩니다. 항목이 스무 개쯤 되는 긴 FAQ에서 초점 표시가 없으면, 키보드 사용자는 그야말로 깜깜이로 헤매게 되죠.
포커스 표시는 지우는 게 아니라, 디자인과 어울리게 다듬는 것이 정답입니다.
6) 단일 펼침 vs 다중 펼침 — 정책을 정하고 일관되게
아코디언에는 두 가지 동작 정책이 있습니다.
- 단일 펼침: 한 번에 하나의 항목만 열림. 새 항목을 펼치면 이전 항목은 자동으로 접힘. 화면이 깔끔하게 유지되고, 한 번에 한 가지에만 집중하게 합니다.
- 다중 펼침: 여러 항목을 동시에 펼쳐 둘 수 있음. 여러 답을 비교하거나 한꺼번에 훑어볼 때 유리합니다.
어느 쪽이 정답이라기보다, 콘텐츠 성격에 맞게 고르고 한 사이트 안에서 일관되게 쓰는 것이 핵심입니다. FAQ처럼 답을 하나씩 보면 되는 곳은 단일 펼침이, 약관처럼 여러 조항을 펼쳐 비교해야 하는 곳은 다중 펼침이 어울립니다. 문제는 같은 사이트에서 페이지마다 정책이 들쭉날쭉할 때입니다. 사용자가 "여긴 하나만 열리네? 저긴 여러 개 열리네?" 하고 매번 다시 학습해야 하거든요.
7) 모두 펼치기 / 모두 접기 — 긴 목록의 배려
항목이 많은 아코디언에는 "모두 펼치기 / 모두 접기" 버튼을 제공하는 것이 좋습니다. 약관처럼 전체를 한 번에 읽거나 검색(Ctrl+F)하고 싶은 사용자에게, 항목을 하나씩 스무 번 누르게 하는 건 가혹하니까요. 특히 인쇄하거나 브라우저 내 검색으로 특정 단어를 찾으려는 사용자에게 "모두 펼치기"는 생각보다 큰 편의입니다. 접힌 상태의 패널 내용은 브라우저 검색에 안 걸리는 경우가 많거든요.
8) 터치 영역과 크기
모바일에서 아코디언 헤더는 손가락으로 누를 수 있을 만큼 충분히 커야 합니다. 한국형 웹 접근성 지침(KWCAG)과 국제 표준 모두 터치 대상의 최소 크기를 권장합니다 — 일반적으로 한 변 44px 이상을 기준으로 삼습니다. 헤더 줄의 높이가 너무 낮으면 손가락으로 정확히 누르기 어렵고, 화살표 아이콘만 작게 만들어 그 부분만 눌리게 하면 더 나쁩니다. 헤더 줄 전체가 누름 영역이 되도록 충분한 높이와 여백을 확보해야 합니다.
9) 펼침 애니메이션과 모션 민감성
아코디언이 펼쳐질 때 부드러운 애니메이션을 넣는 경우가 많습니다. 자연스럽긴 한데, 과하면 문제가 됩니다. 전정기관이 예민하거나 모션에 민감한 사용자에게 급격한 움직임은 어지럼증을 유발할 수 있거든요. 그래서 운영체제의 "동작 줄이기(reduce motion)" 설정을 존중해, 그런 사용자에게는 애니메이션을 줄이거나 없애는 배려가 권장됩니다. 또 애니메이션이 너무 느리면 정보 접근이 답답해지니, 빠르고 절제된 모션이 좋습니다.
정리하면, KRDS의 아코디언 기준은 크게 세 축입니다. ① 의미의 명확성(헤더는 버튼, 헤더-패널 연결), ② 상태의 전달성(aria-expanded로 펼침/접힘을 코드로 알림), ③ 조작 가능성(키보드 완전 지원, 충분한 터치 영역, 초점 표시). 이 세 축은 그대로 ViewCheck가 아코디언을 판정하는 기준이기도 합니다.
아코디언을 써야 할 때, 쓰지 말아야 할 때
KRDS 기준을 다 지켜 아코디언을 잘 만드는 것만큼이나 중요한 게, 애초에 아코디언이 맞는 선택인지 판단하는 일입니다. 좋은 아코디언보다 더 좋은 건, 아코디언이 필요 없는 화면일 때도 있으니까요.
- 항목이 여러 개이고 각각 제목+내용 구조이며, 사용자가 필요한 것만 골라 본다 → 아코디언의 영역입니다. FAQ, 약관 조항, 단계별 안내가 대표적입니다.
- 내용이 짧고 다 보여 줘도 부담이 없다 → 굳이 접지 마세요. 한두 문장짜리 답을 펼침/접힘 뒤에 숨기면, 사용자는 답을 보려고 불필요하게 한 번 더 눌러야 합니다. "클릭 한 번 아끼려다 클릭을 늘리는" 역설이죠.
- 핵심 정보·중요한 안내 → 아코디언 안에 숨기지 마세요. 접혀 있으면 사용자가 그 안에 중요한 내용이 있다는 걸 모르고 지나칠 수 있습니다. 꼭 봐야 하는 정보는 펼쳐진 채로, 또는 아코디언 밖에 둬야 합니다.
- 내용 간 전환이 빈번하고 가로 공간이 넉넉하다 → 탭(Tab)이 더 나을 수 있습니다.
- 단 하나의 내용을 펼쳤다 접는다 → 아코디언(그룹)이 아니라 디스클로저("더 보기") 한 개면 충분합니다.
이 판단을 기획 단계에서 한 번만 제대로 하면, 뒤따르는 접근성·사용성 문제의 상당수가 애초에 생기지 않습니다.
왜 이렇게까지 따지나 — 원리와 배경
여기까지 읽고 "FAQ 펼침 메뉴 하나에 뭐 이리 까다롭나" 싶으실 수 있습니다. 그런데 이 요건들은 누가 괜히 만들어 낸 규칙이 아니라, 실제 사용자가 막히는 지점에서 역으로 도출된 것들입니다.

펼침/접힘은 "상태"다 — 그래서 어렵다
버튼은 누르면 끝입니다. 링크는 누르면 이동합니다. 그런데 아코디언은 누를 때마다 "열림 ↔ 닫힘"이라는 상태가 토글됩니다. 이 "상태가 계속 변한다"는 점이 아코디언을 다른 컴포넌트보다 까다롭게 만듭니다.
상태가 있는 컴포넌트는, 그 상태를 사용자에게 정확히 전달해야 비로소 완성됩니다. 보는 사람에겐 화살표 방향과 펼쳐진 내용이 상태를 알려 주지만, 못 보는 사람에겐 코드의 aria-expanded가 유일한 통로입니다. 이걸 빠뜨리면, 음성 사용자는 "내가 방금 연 건가 닫은 건가"를 영영 알 수 없습니다. 마치 불 꺼진 방에서 스위치를 눌렀는데, 불이 켜졌는지 꺼졌는지 알려 주는 신호가 하나도 없는 셈이죠. 아코디언의 모든 ARIA 요건은 결국 "상태를 말로 전달하기" 위한 장치입니다.
공공 서비스는 "안 쓸 자유"가 없다
상업 사이트는 불편하면 사용자가 떠나면 그만입니다. 경쟁사로 가면 되니까요. 그런데 공공 서비스는 다릅니다. 약관에 동의하고, 신청 절차를 확인하고, FAQ에서 자격 요건을 찾는 일은 그 사이트가 아니면 할 수 없습니다. 사용자가 "안 쓸 자유"가 없어요. 그래서 공공 웹의 아코디언이 누군가에게 작동하지 않으면, 그건 단순한 불편이 아니라 행정 서비스 접근권의 박탈이 됩니다.
FAQ 아코디언이 키보드로 안 열리면, 손 사용이 불편해 마우스를 못 쓰는 사람은 그 답을 영영 볼 수 없습니다. 약관 아코디언이 스크린리더로 상태를 안 알려 주면, 시각장애인은 "내가 약관을 펼쳐서 읽은 게 맞나"를 확신하지 못한 채 동의 버튼을 눌러야 합니다. 동의의 전제인 "읽음"이 무너지는 거죠. 이게 KRDS가 아코디언의 키보드·스크린리더 지원을 "있으면 좋은 것"이 아니라 "기본 요건"으로 두는 이유입니다.
보이는 것과 읽히는 것의 분리
비장애인은 화면을 "본다"고 생각하지만, 사실 우리는 화면을 보고 머릿속에서 의미로 번역합니다. 화살표가 위를 향한 걸 보고 "아, 펼쳐졌구나" 하고 짐작하죠. 스크린리더 사용자에게는 이 짐작 과정이 없습니다. 코드가 알려 주는 정보가 곧 전부입니다.
그래서 아코디언은 "보기에 펼쳐진 것"으로는 부족하고, "코드 수준에서 펼쳐졌다고 선언된 것"이어야 합니다. 화살표 이미지를 위로 돌려 펼친 것처럼 보이게 만들어도, 코드가 aria-expanded="true"라고 말해 주지 않으면 스크린리더에겐 아무 변화가 없습니다. 이 "보이는 것 ≠ 읽히는 것" 문제가 아코디언 위반의 근본 원인 대부분을 차지합니다. KRDS의 모든 컴포넌트 요건이 결국 "시각과 코드의 일치"라는 한 가지 원리로 수렴하는 셈입니다.
정보 과부하를 다스리는 도구
아코디언이 사랑받는 이유는 분명합니다. 정보가 많을 때, 전부 펼쳐 놓으면 페이지가 끝없이 길어지고 사용자는 압도됩니다. 아코디언은 제목만 먼저 보여 주고 필요한 것만 펼치게 함으로써, 긴 정보를 "한입 크기"로 다스립니다. 이건 인지 부담을 줄이는 훌륭한 UX 전략이에요.
다만 이 장점은 양날의 검입니다. 잘 쓰면 정보를 정리하지만, 잘못 쓰면 정보를 숨깁니다. 중요한 안내를 아코디언 안에 접어 두면, 사용자는 그게 거기 있는 줄도 모르고 지나칩니다. "깔끔해 보이려고" 핵심을 숨기는 우를 범하기 쉽죠. KRDS가 아코디언을 표준화하면서도 "무엇을 접고 무엇을 펼쳐 둘지"의 판단을 강조하는 건 이 때문입니다.
일관성이 곧 학습 비용 절감
KRDS가 아코디언의 모습과 동작을 표준화하는 또 다른 이유는 일관성입니다. 정부 사이트마다 아코디언이 제각각이면, 사용자는 사이트를 옮길 때마다 "여긴 어떻게 펼치지? 하나만 열리나 여러 개 열리나?"를 다시 익혀야 합니다. 모든 공공 서비스의 아코디언이 같은 방식으로 보이고 같은 방식으로 작동하면, 한 번 익힌 사용법이 모든 사이트에서 통합니다. 디지털 약자에게 이 "다시 안 배워도 됨"은 생각보다 큰 배려입니다. 표준화는 디자이너의 자유를 뺏는 게 아니라, 사용자의 인지 부담을 덜어 주는 일입니다.
한 장면 — 같은 약관, 두 사람
추상적인 요건을 길게 늘어놓는 것보다, 한 장면을 그려 보는 게 빠를 것 같습니다. 어느 공공 서비스의 "온라인 신청" 화면, 동의해야 할 약관이 아코디언으로 정리돼 있다고 합시다. "개인정보 수집·이용 동의", "제3자 제공 동의", "이용약관" 세 항목이 접혀 있고, 각각을 펼쳐 읽은 뒤 동의 체크를 하게 돼 있습니다.
먼저 마우스를 쓰는 이 주무관. 첫 항목을 클릭하니 내용이 펼쳐지고, 쭉 읽은 뒤 다시 클릭해 접습니다. 화살표가 아래로 돌아가는 걸 보고 "접혔구나" 합니다. 세 항목을 차례로 펼쳐 읽고 동의를 마칩니다. 1분도 안 걸렸습니다. 이 주무관에게 이 아코디언은 아무 문제가 없습니다. 그래서 이 화면을 만든 팀도 "잘 작동한다"고 믿습니다. 자기들이 테스트할 때 늘 마우스를 썼으니까요.
이번엔 시각장애가 있는 정 선생님. 스크린리더를 켜고 Tab으로 폼을 훑어 내려갑니다. 그런데 약관 항목 자리에서 스크린리더가 "개인정보 수집·이용 동의"라고 텍스트만 읽고 멈춥니다. 이게 누를 수 있는 버튼인지, 펼칠 수 있는 건지 알 수 없습니다(헤더가 <div>로 만든 가짜). 어찌어찌 마우스 좌표로 클릭이 됐다 쳐도, 펼쳐졌다는 신호(aria-expanded)가 없어서 내용이 열린 건지 알 수 없습니다. 정 선생님은 약관을 제대로 읽었다는 확신 없이 동의 버튼을 눌러야 하는, 찜찜한 상황에 놓입니다. 결국 신청을 포기하고 가족에게 부탁합니다.
같은 화면, 같은 아코디언. 한 사람에겐 1분짜리 사소한 확인이고, 다른 한 사람에겐 닫힌 문입니다. 그리고 이 차이는 "예산이 부족해서"나 "기술이 어려워서" 생긴 게 아닙니다. 그냥 만들 때 마우스 사용자만 떠올렸기 때문에 생긴 차이입니다. KRDS의 아코디언 요건은, 이 두 사람의 경험을 같게 만들기 위한 최소한의 약속입니다. 그리고 그 약속을 지켰는지는 사람이 매번 스크린리더로 확인하기 어렵기 때문에, 자동 점검이 필요한 겁니다.
만약 이 팀이 KRDS 킷의 아코디언 코드를 가져다 썼다면 어땠을까요. 정 선생님의 스크린리더는 "개인정보 수집·이용 동의, 버튼, 접힘"이라고 읽었을 거고, Enter를 누르면 "펼쳐짐"이라고 알려 줬을 겁니다. 내용을 다 읽고 다시 접으면 "접힘"이라고 다시 확인해 줬겠죠. 이 주무관과 똑같이 확신을 갖고 동의했을 겁니다. 차이를 만드는 건 거창한 기술이 아니라, "검증된 컴포넌트를 쓰느냐"라는 작은 선택입니다.
공공 사이트가 자주 틀리는 지점 — 그리고 올바른 예
이제 현업에서 실제로 반복되는 아코디언 실수들을 보겠습니다. 모두 익명화한 일반적 사례입니다(특정 기관을 지목하지 않습니다).

실수 1) 헤더가 버튼이 아니다 — `<div>`로 만든 가짜 아코디언
가장 흔하고 가장 치명적인 실수입니다. 디자인 자유도를 이유로, 또는 그냥 손이 덜 간다는 이유로, 헤더를 <div>나 <span>에 클릭 이벤트만 붙여 만듭니다. 모양은 똑같습니다. 그런데 키보드 초점이 가지 않고, Enter로 펼칠 수 없고, 스크린리더가 "버튼"으로 인식하지 못합니다.
- 나쁜 예: <div class="acc-head">환불 안내</div>. role도 tabindex도 aria-expanded도 없음. 마우스로만 작동. 키보드 사용자에겐 존재하지 않는 항목이나 마찬가지.
- 올바른 예: 헤더를 <button type="button" aria-expanded="false" aria-controls="panel-1">환불 안내</button>로 선언. 키보드 초점·Enter/Space·스크린리더 인식이 전부 따라옴. KRDS 킷의 accordion 코드가 정확히 이 구조입니다.
실수 2) aria-expanded가 없다 (또는 바뀌지 않는다)
헤더는 버튼으로 잘 만들었는데, 펼침/접힘 상태를 알리는 aria-expanded가 아예 없거나, 있어도 클릭할 때 값이 안 바뀌는 경우입니다.
- 나쁜 예: aria-expanded가 없음. 또는 처음에 false로 박아 놓고 펼쳐도 그대로 false. 스크린리더가 상태 변화를 못 읽음.
- 올바른 예: 펼치면 자바스크립트가 aria-expanded="true"로, 접으면 false로 갱신. 스크린리더가 "펼쳐짐 / 접힘"을 정확히 안내.
실수 3) 헤더와 패널이 코드로 연결돼 있지 않다
화면상으로는 헤더 바로 아래에 패널이 붙어 있지만, 코드 수준에서는 둘이 아무 관계도 선언돼 있지 않은 경우입니다.
- 나쁜 예: aria-controls도 aria-labelledby도 없음. 보조기술이 "이 버튼이 무슨 내용을 여는지", "이 내용의 제목이 무엇인지"를 모름.
- 올바른 예: 헤더에 aria-controls="panel-1", 패널에 id="panel-1"과 aria-labelledby="head-1"을 달아 양방향으로 묶음. 스크린리더가 제목과 내용을 연결해 안내.
실수 4) 화살표 아이콘만 의미를 담고 있다
펼침/접힘을 화살표 회전이나 +/− 아이콘으로만 표현하고, 그 의미가 코드엔 없는 경우입니다.
- 나쁜 예: 화살표가 위/아래로 도는 것만으로 상태를 표현. 색맹·저시력 사용자, 스크린리더 사용자에게 정보 전달 안 됨.
- 올바른 예: 시각적 화살표는 그대로 두되, 상태는 aria-expanded로 코드에 담아 중복 안내. 아이콘은 보조 수단, 코드가 본질.
실수 5) 초점 표시 제거
디자인 통일성을 위해 outline: none으로 헤더의 포커스 링을 지웁니다.
- 나쁜 예: 키보드로 헤더 사이를 이동해도 지금 어느 항목에 있는지 안 보임. 항목이 많을수록 더 치명적.
- 올바른 예: 포커스 시 또렷한 테두리·외곽선 유지. KRDS 아코디언의 포커스 정의를 따름.
실수 6) 중요한 정보를 아코디언에 숨김
"깔끔해 보이려고" 꼭 봐야 할 안내·경고·필수 조건을 아코디언 안에 접어 둡니다.
- 나쁜 예: 신청 자격이나 제출 마감 같은 핵심 정보가 접힌 패널 안에 있어, 펼치지 않은 사용자는 보지 못하고 지나침.
- 올바른 예: 핵심 정보는 펼쳐진 채로 두거나 아코디언 밖에 배치. 아코디언은 "있으면 좋은 부가 정보"를 정리하는 용도로 한정.
실수 7) 너무 짧은 내용을 굳이 접음
한두 문장짜리 답을 아코디언으로 감춰, 사용자가 답을 보려고 불필요하게 한 번 더 클릭하게 만듭니다.
- 나쁜 예: "운영 시간은?" → (펼침) → "오전 9시~오후 6시". 한 줄 답을 보려고 클릭 한 번 추가.
- 올바른 예: 내용이 짧으면 펼친 채로 보여 주거나 일반 목록으로. 아코디언은 내용이 길어 접을 가치가 있을 때만.
실수 8) 모바일에서 너무 작은 헤더, 검색 안 되는 접힌 내용
데스크톱 기준으로만 만들어 모바일에서 헤더가 손가락에 비해 작고, 접힌 패널 내용이 브라우저 검색에 안 걸립니다.
- 나쁜 예: 헤더 높이가 손가락보다 작아 오터치 발생. "모두 펼치기"가 없어 약관을 Ctrl+F로 검색할 수 없음.
- 올바른 예: 헤더 줄 전체를 충분한 높이(약 44px 이상)의 누름 영역으로. 항목이 많으면 "모두 펼치기/접기" 제공.
직접 적용하기 — 개발자·디자이너·기획자 가이드
KRDS의 좋은 점은, 위 요건들을 "알아서 잘 만드세요"로 끝내지 않고 바로 쓸 수 있는 자산으로 제공한다는 것입니다.
개발자라면 — KRDS 컴포넌트 킷을 npm install krds-uiux로 설치하거나 CDN(krds.min.css / krds.min.js)으로 불러올 수 있습니다. 저장소의 html/code 폴더에 아코디언 변형 코드(accordion, accordion_line)가 그대로 들어 있어, 헤더의 <button> 선언, aria-expanded 토글, aria-controls 연결, 키보드 동작이 이미 구현된 상태로 시작할 수 있습니다. "접근성은 어렵다"는 말의 절반은 "직접 만들어서 어렵다"는 뜻인데, 검증된 코드를 가져다 쓰면 그 절반이 사라집니다. 특히 aria-expanded를 클릭마다 갱신하는 로직처럼 빠뜨리기 쉬운 부분이 이미 들어 있다는 게 큰 차이입니다.
디자이너라면 — KRDS 공식 Figma(@krds) 라이브러리에서 아코디언의 두 변형(기본형·라인형)과 펼침/접힘 상태를 컴포넌트로 가져다 쓸 수 있습니다. 직접 그리지 말고 표준 컴포넌트를 배치하면, 디자인 단계에서부터 헤더 높이·간격·상태 표현이 기준에 맞춰집니다. 시안 단계에서 "펼쳐진 상태"와 "접힌 상태"를 둘 다 그려 개발자에게 전달하면, 상태 누락이 줄어듭니다. 또 화살표 같은 상태 아이콘만으로 의미를 전달하지 않도록, 색·아이콘·텍스트가 함께 작동하게 설계하세요.
기획자라면 — 화면 정의서에 "FAQ 펼침 메뉴"라고만 적지 말고, "아코디언(단일 펼침, 기본 전체 접힘, 모두 펼치기 제공)"처럼 동작 정책·초기 상태·부가 기능을 함께 명시하세요. 특히 약관처럼 "반드시 읽혀야 하는" 내용을 아코디언에 넣을 때는, 핵심 정보를 접힌 채로 둘지 펼쳐 둘지를 기획 단계에서 못 박아야 합니다. 이 한 줄이 디자인·개발 단계의 누락과 "중요 정보 숨김" 사고를 막습니다.
그래서 우리 사이트는? — ViewCheck로 5분 점검
여기까지가 KRDS의 아코디언 기준입니다. 그런데 정작 어려운 건 "그래서 우리 사이트 아코디언은 이걸 지키고 있나?"를 확인하는 일입니다. 페이지마다 아코디언이 몇 개인지, 각 헤더가 버튼으로 선언됐는지, aria-expanded가 클릭마다 바뀌는지, 헤더와 패널이 코드로 연결됐는지, 키보드로 펼쳐지는지를 사람이 일일이 손으로 점검하려면 끝이 없습니다. 페이지가 수십·수백 개인 공공 사이트라면 더더욱요.

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

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