오류 정정 | 웹 접근성 콘텐츠 제작 기법(이해의 용이성(Understandable))

사용자 입력 오류 안내

온라인 서식에서 오류가 발생했을 경우, 사용자에게 오류가 발생한 항목과 그 이유를 명확하게 안내해야 합니다. 예를 들어 필수 입력 항목이 누락된 경우, 어떤 항목이 누락되었는지를 구체적으로 알려주어야 합니다.
단, 시스템이나 플랫폼 자체에서 발생한 오류는 이 기준에 포함되지 않습니다.

기대효과

입력 오류에 대한 자세한 텍스트 설명을 제공하는 것은 학습장애가 있는 사용자가 서식을 올바르게 작성하는 데 큰 도움이 됩니다. 오류가 발생한 위치에 단순히 시각적인 표시만 제공하는 경우, 시각장애인이나 저시력 사용자는 오류 위치에 도달하기 전까지 문제를 인식하기 어렵습니다. 따라서, 오류 내용을 먼저 텍스트로 설명하거나, 프로그램적으로 초점을 오류 위치로 이동시킨 뒤 오류 설명을 제공하는 방식이 보다 효과적입니다.
실수로 인해 빚어지는 심각한 결과 또는 과실을 피하기 위해 오류 정정에 필요한 정보나 수단을 제공하는 것은 장애인뿐만 아니라 비장애인에게도 도움이 됩니다.

필요성

사용자가 양식 또는 입력 필드에서 오류를 발생시켰을 때, 이를 인지하고 수정할 수 있도록 적절한 오류 메시지와 정정 방법을 제공해야 합니다. 오류가 발생한 위치와 원인을 명확히 제시함으로써 사용자의 인지적 부담을 줄이고 접근성을 확보할 수 있습니다.

입력 오류를 인식하지 못할 경우 서비스 이용에 큰 장애가 발생합니다.
오류 메시지가 없거나 모호할 경우 정정이 불가능합니다.
장애인, 고령자, 인지장애 사용자의 작업 성공률을 높입니다.

대상

사용자 유형
이유

인지장애인

실수 인식과 수정이 어려움 → 구체적인 피드백 필요
시각장애인

오류 위치 및 내용을 스크린 리더로 안내받아야 함
고령자

메시지 이해가 어려운 경우 많음, 단순하고 명확한 안내 필요

체크리스트

필수 입력 항목 누락 시 메시지를 표시하는가?
잘못된 입력에 대해 어떤 값이 잘못되었는지 안내하는가?
오류 메시지에 정정 방법 또는 예시를 포함하는가?
시각적 표시 외에 보조기술 사용자에게도 오류를 안내하는가?

테스트 방법

일부 입력 필드를 비워두고 제출하여 오류 메시지 출력 여부를 확인합니다.
스크린 리더로 오류 메시지 인식 및 읽기 여부를 확인합니다.
키보드만으로 오류 필드로 포커스가 이동되는지 확인합니다.

QA 지표

오류 발생 시 사용자 정정 성공률
스크린 리더 사용자 오류 인지율
자동 테스트 도구의 오류 검출률 (WAVE, Axe 등)

개발방법

html 예시 – 오류 메시지 제공

								<form>
									<label for="email">이메일</label>
									<input type="email" id="email" name="email" required />
									<div id="error-email" role="alert" style="color:red;">이메일을 입력해 주세요.</div>
								</form>

ARIA 예시 – 오류 연결

								<input id="email" aria-describedby="error-email" />
								<div id="error-email" role="alert">올바른 이메일 주소를 입력하세요.</div>

Vue 예시

								<template>
									<form @submit.prevent="validateForm">
										<label for="name">이름</label>
										<input id="name" v-model="name" :aria-describedby="nameError ? 'nameError' : null" />
										<p v-if="nameError" id="nameError" role="alert"></p>
										<button type="submit">제출</button>
									</form>
								</template>

								<script setup>
									import { ref } from 'vue';
									const name = ref('');
									const nameError = ref('');
									function validateForm() {
										nameError.value = name.value.trim() === '' ? '이름을 입력해 주세요.' : '';
									}
								</script>

React 예시

								function Form() {
									const [name, setName] = React.useState('');
									const [error, setError] = React.useState('');

									const handleSubmit = e => {
										e.preventDefault();
										if (!name.trim()) setError('이름을 입력해 주세요.');
										else setError('');
									};

									return (
										<form onSubmit={handleSubmit}>
											<label htmlFor="name">이름</label>
											<input
												id="name"
												value={name}
												onChange={e => setName(e.target.value)}
												aria-describedby={error ? "name-error" : undefined}
											/>
											{error && <div id="name-error" role="alert" style={{ color: "red" }}>{error}</div>}
											<button type="submit">제출</button>
										</form>
									);
								}

오류 처리 방법

사용자가 입력해야 하는 내용에 대해 쉽게 안내해주어야 합니다.

만일 사용자가 잘못 입력했을 경우에는 어느 부분에서 어떤 오류가 났는지 알려 주어야 하고 이를 정정할 수 있는 방법을 제공해야 합니다.

점검 기준

오류 발생 시 시각적·청각적(스크린 리더) 방식으로 안내하는가?
정정 방법을 제시하고 있는가?
오류 위치와 내용이 명확하게 제시되는가?

점검 방법

빈값 제출 등으로 오류를 유도한 후 안내 메시지를 확인합니다.
오류 메시지가 스크린 리더로 인식되는지 확인합니다.
키보드로 오류 필드에 접근 가능한지 확인합니다.

준수/미준수 사례

미준수 사례

								<form>
									<label for="email">이메일:</label>
									<input type="email" id="email" name="email" required>
									<button type="submit">제출</button>
								</form>

								<script>
									const form = document.querySelector('form');
									form.addEventListener('submit', function(event) {
										const email = document.getElementById('email').value;
										if (!email.includes('@')) {
											alert('잘못된 이메일 형식입니다.');
											event.preventDefault();
										}
									});
								</script>

문제점 :: 오류 메시지가 화면에 나타나지 않으며, 오류가 발생한 필드를 명확히 지정하지 않습니다.; 시각적으로 오류가 발생한 부분을 구체적으로 표시하지 않아 사용자가 오류를 수정하기 어렵습니다.

준수 사례

								<form aria-describedby="email-error">
									<label for="email">이메일:</label>
									<input type="email" id="email" name="email" required aria-invalid="false">
									<span id="email-error" class="error-message" role="alert" style="display:none;">올바른 이메일 형식을 입력하세요.</span>
									<button type="submit">제출</button>
								</form>

								<script>
									const form = document.querySelector('form');
									form.addEventListener('submit', function(event) {
										const emailInput = document.getElementById('email');
										const errorMessage = document.getElementById('email-error');
										if (!emailInput.value.includes('@')) {
											errorMessage.style.display = 'block';
											emailInput.setAttribute('aria-invalid', 'true');
											event.preventDefault();
										} else {
											errorMessage.style.display = 'none';
											emailInput.setAttribute('aria-invalid', 'false');
										}
									});
								</script>

설명 :: aria-invalid="true" 속성을 사용해 오류가 발생한 입력 필드를 화면 리더가 인식할 수 있도록 합니다.; 오류 메시지는 aria-describedby를 사용하여 해당 필드와 연관되도록 합니다.; 오류 메시지가 role="alert"로 설정되어 있어 오류 발생 시 자동으로 화면 리더가 이를 읽을 수 있습니다.; 오류 메시지가 시각적으로 표시되어 사용자가 쉽게 인식하고 수정할 수 있습니다.

접근성 테스트 도구 활용 점검방법

Lighthouse

Lighthouse는 구글에서 제공하는 웹 페이지 품질 개선을 위한 오픈 소스로 자동화 도구입니다. Lighthouse는 사이트의 성능, 접근성, SEO 등에 대한 전반적인 진단을 해줍니다.
상세 설명 : Lighthouse Overview 공식 문서 참조

참고

Lighthouse 모바일의 경우 네트워크 속도를 최대 4배정도 느리게 측정하기 때문에 모바일 Performance가 비교적 낮게 나옵니다.
Metric 별로 어떤 성능 점수가 나는지 Lighthouse 계산기를 통해서 자세히 확인할 수 있습니다.

카테고리가 측정하는 내용

Performance
웹 페이지의 로딩 속도 등 실제 성능을 측정. 성능의 측정항목은 6가지 Metric으로 정의되며, 각 Metric들은 페이지가 로드되는 속도를 다양한 측면에서 측정합니다.
상세 설명 : Lighthouse Performance Audits.
Best practices
Best practices를 따라 개발되었는지 확인
Accessibility
접근성 확인. 폰트 사이즈, 메뉴간 간격 등을 측정
Progressive Web App (PWA)
웹과 네이티브 앱의 기능 모두의 이점을 가지도록 만들어진 서비스인지 체크
SEO
Search Engine Optimization의 약자로 검색 엔진 수집 최적화 측정

사용법

Google Chrome에서 웹 페이지를 엽니다.
DevTools (F12)를 열고 ‘Lighthouse’ 탭을 선택합니다. (단축키 맥:Cmd⌘+Option⌥+I / 윈도우:Ctrl+Shift+I)
‘Accessibility’ 항목을 선택하고 우측 상단의 ‘Analyze page load’를 클릭하여 보고서를 생성합니다.

[Lighthouse를 활용한 검사]
Lighthouse는 접근성 점수와 함께 개선이 필요한 부분을 제시합니다.

[Lighthouse를 활용한 검사]

iOS : Accessibility Inspector

iOS 앱 개발도구인 xcode에는 Accessibility Inspector 툴을 통해 접근성을 수동 검사할 수 있습니다.

사용법

Xcode에서 Accessibility Inspector 툴을 실행합니다. (Xcode > Open Developer Tool > Accessibility Inspector)

[출처 : NULI]
테스트할 장치를 선택합니다. 개발 중인 앱을 Simulator로 빌드 하셨다면 Simulator를 선택하여 진단하실 수 있습니다.

[출처 : NULI]
Accessibility Inspector 툴 오른쪽 상단에서 audit 버튼을 선택합니다. Run Audit 버튼을 선택합니다.

[출처 : NULI]
결과 이슈 목록을 선택하거나 눈 버튼을 선택하시면 해당 항목을 보여줍니다. 장치를 보면 노란색으로 표시되고, 물음표 버튼를 선택하면 해당 이슈를 해결할 수 있는 방법을 알려줍니다.

[출처 : NULI]
물음표 버튼를 선택하면 해당 이슈를 해결할 수 있는 방법을 알려줍니다.

[출처 : NULI]
목록에서 주의 깊게 봐야 할 이슈는 description에 대한 이슈입니다. 대체 텍스트 이슈는 접근성 사용자에게 매우 크리티컬한 이슈이면서 해결 방법이 매우 수월한 이슈입니다.

[출처 : NULI]
Xcode의 Identity Inspector 탭의 Accessibility 패널에 대체 텍스트를 넣어주세요.
대체 텍스트 외에도 명도대비, 작은 터치영역등 다양한 접근성 이슈를 체크해주고 있습니다.

[출처 : NULI]
각 요소별 접근성 항목을 확인할 수 있고, iOS 스크린리더인 VoiceOver 음성으로 들어볼 수 있습니다.
1. 스피커
  현재 초점이 위치한 요소의 정보를 VoiceOver 음성으로 들려줍니다.
2. 이전 요소 탐색
  현재 초점이 위치한 곳에서 이전 요소의 정보를 VoiceOver 음성으로 들려줍니다.
3. 자동 탐색
  현재 초점이 위치한 곳에서 모든 요소를 자동으로 탐색하며 요소의 정보를 VoiceOver 음성으로 들려줍니다.
4. 다음 요소 탐색
  현재 초점이 위치한 곳에서 다음 요소의 정보를 VoiceOver 음성으로 들려줍니다.
5. 직접 탐색
  마우스로 요소를 직접 선택하여 탐색합니다.
6. 현재 초점이 위치한 요소의 접근성 항목을 나타냅니다.
  항목은 Label(대체 텍스트), Value(값), Traits(유형 정보), Identifier(식별자), Hint(힌트 정보), User Input Labels(사용자 입력 텍스트 정보)입니다.
[출처 : NULI]

Android : Lint

Android 앱 개발도구인 Android Studio 의 Lint를 통해 개발과정에서 접근성을 수동 검사할 수 있습니다.

사용법

Analyze > Inspect Code를 실행합니다.

[출처 : NULI]
Android Studio 4.1.1. 버전을 사용합니다. Android Studio Electric Eel 2022.1.1 Patch 2버전이면 Code 메뉴에 inspect Code가 보입니다.

[출처 : NULI]
Inspection profile에서 더보기 버튼을 실행합니다.

[출처 : NULI]
Inspections 창에서 Lint > Accessibility 항목 중 “Image without contentDescription” 항목과 “Missing accessibility label”을 체크합니다.
Android에서 Accessibility 항목 중 주의 깊게 봐야 할 이슈는 바로 이미지 대체 텍스트와 입력 서식 라벨에 대한 이슈입니다.
Severity를 Error로 체크해 주세요. Error 이슈를 해결하기 전까지는 빌드 성공을 할 수 없습니다.

[출처 : NULI]
진단 범위도 설정해야 합니다. 모든 범위 [In All Sccopes]

[출처 : NULI]
OK를 누르고 코드를 확인합니다. contentDescription 이 없는 ImageView 또는 ImageButton에 빨간색으로 표시된 것을 확인할 수가 있습니다. labelFor 또는 hint가 없는 EditText 역시 빨간색으로 표시된 것을 볼 수 있습니다.

[출처 : NULI]
이슈 해결 : ImageView 클래스에 contentDescription을 코드에서 추가합니다. 빨간색으로 표시되었던 코드가 노란색 코드로 변경됩니다.

[출처 : NULI]
이슈 해결 : EditText 역시 hint 코드를 추가합니다. 빨간색으로 표시되었던 코드가 노란색 코드로 변경됩니다.

[출처 : NULI]

결론

접근성은 시작은 있지만 끝이 없는 작업입니다.
오류 항목을 정기적으로 점검하여 접근성 개선을 한다면 점차 검사를 할 항목이 줄어들게 될 것입니다. 모두가 차별 없이 서비스를 이용할 수 있도록 접근성 유지를 위한 모두의 노력이 필요합니다. 무엇보다 접근성 작업은 서비스를 제공한다면 선택이 아닌 필수로 지켜야하는 항목임을 잊지 말아야 합니다.

접근성 작업 시 점검 필수사항

접근성 가이드(WCAG, KWCAG, WAI-ARIA) 내용 숙지
접근성 체크리스트 작성
접근성 자동 및 수동 검사(스크린리더) 진행
접근성 검사 툴(Lighthouse Accessibility 등) 활용 오류 항목 개선 및 내용 정리
접근성 사용자 테스트
접근성 정기적인 모니터링

관련 WCAG 2.2 성공 기준