a11y

접근성 콘텐츠 제작 기법

접근성 콘텐츠 제작 기법은 모든 사용자, 특히 장애가 있는 사용자가 웹과 모바일 콘텐츠에 접근하고 사용할 수 있도록 보장하는 방법입니다. 이 기법은 웹 접근성 지침(WCAG: Web Content Accessibility Guidelines)과 모바일 접근성 표준을 따르는 것이 중요합니다. 각각의 영역에 대해 접근성 작업 시 도움이 될 수 있도록 작업되었습니다. 접근성은 법적 요구사항일 뿐만 아니라 사용자를 위한 기본적인 배려이기도 합니다.

모바일 앱 접근성 콘텐츠 제작 기법

사용자가 장애를 가지고 있거나 특정 기능적 제한을 겪는 경우에도 원활하게 모바일 앱을 이용할 수 있도록 하는 방법을 의미합니다. 이러한 접근성을 고려한 콘텐츠 제작은 다양한 사용자들의 요구를 충족시키며, 앱의 사용성을 크게 향상시킵니다.

입력 도움

관련 지침 : 입력 서식 이용 시, 입력 오류를 방지하거나 정정할 수 있는 방법을 제공해야 한다.
모바일 앱에서 입력 서식을 사용할 때, 사용자의 입력 오류를 방지하거나 정정할 수 있는 방법을 제공하는 것은 필수적인 접근성 요건입니다. 이를 통해 사용자의 경험을 개선하고 다양한 사용자층이 쉽게 앱을 사용할 수 있도록 합니다.
WCAG 2.2 Quick Reference - Input Assistance

키워드
#모바일 앱 접근성, #모바일 앱 접근성 콘텐츠 제작 기법, #WCAG2.2, #입력 도움, #입력 오류 방지, #실시간 피드백, #자동 완성, #힌트 제공, #명확한 오류 메시지

1. 필요성

입력 오류 방지 기능은 사용자가 데이터를 정확하게 입력할 수 있도록 하여 앱 사용의 편의성과 정확성을 높입니다. 특히, 시각 장애인, 인지 장애인, 고령 사용자 등에게는 입력 오류 시 빠르고 쉽게 정정할 수 있는 기능이 필수적입니다. 입력 도움 기능은 사용자의 스트레스를 줄이고, 앱에 대한 만족도를 높입니다.

2. 대상

3. 체크리스트

4. 기기별 테스트 방법

5. QA 지표

6. 개발방법

iOS : UITextField 및 실시간 오류 감지

import UIKit

class ViewController: UIViewController, UITextFieldDelegate {
    @IBOutlet weak var usernameField: UITextField!
    @IBOutlet weak var passwordField: UITextField!
    @IBOutlet weak var errorMessageLabel: UILabel!

    override func viewDidLoad() {
        super.viewDidLoad()
        usernameField.delegate = self
        passwordField.delegate = self
    }

    func textFieldDidEndEditing(_ textField: UITextField) {
        if textField == usernameField && (textField.text?.isEmpty ?? true) {
            errorMessageLabel.text = \"아이디를 입력하세요.\"
        } else if textField == passwordField && (textField.text?.count ?? 0) < 6 {
            errorMessageLabel.text = \"비밀번호는 최소 6자 이상이어야 합니다.\"
        } else {
            errorMessageLabel.text = \"\"
        }
    }
}

Android : EditText 및 실시간 오류 감지

<EditText
    android:id=\"@+id/usernameInput\"
    android:layout_width=\"match_parent\"
    android:layout_height=\"wrap_content\"
    android:hint=\"아이디\" />

<EditText
    android:id=\"@+id/passwordInput\"
    android:layout_width=\"match_parent\"
    android:layout_height=\"wrap_content\"
    android:hint=\"비밀번호\"
    android:inputType=\"textPassword\" />

<TextView
    android:id=\"@+id/errorMessage\"
    android:layout_width=\"match_parent\"
    android:layout_height=\"wrap_content\"
    android:textColor=\"@android:color/holo_red_light\" />

HTML : 입력 필드 및 실시간 검증

<input type=\"text\" id=\"username\" placeholder=\"아이디\">
<input type=\"password\" id=\"password\" placeholder=\"비밀번호\">
<div id=\"errorMessage\" aria-live=\"polite\" class=\"error-message\"></div>

<script>
  document.getElementById('username').addEventListener('input', function() {
    if (this.value === '') {
      document.getElementById('errorMessage').textContent = '아이디를 입력하세요.';
    } else {
      document.getElementById('errorMessage').textContent = '';
    }
  });

  document.getElementById('password').addEventListener('input', function() {
    if (this.value.length < 6) {
      document.getElementById('errorMessage').textContent = '비밀번호는 최소 6자 이상이어야 합니다.';
    } else {
      document.getElementById('errorMessage').textContent = '';
    }
  });
</script>

Vue : 입력 검증 컴포넌트

<template>
  <div>
    <input v-model=\"username\" @input=\"validateUsername\" placeholder=\"아이디\">
    <input type=\"password\" v-model=\"password\" @input=\"validatePassword\" placeholder=\"비밀번호\">
    <div v-if=\"errorMessage\" aria-live=\"polite\" class=\"error-message\"></div>
  </div>
</template>

<script>
export default {
  data() {
    return {
      username: '',
      password: '',
      errorMessage: ''
    };
  },
  methods: {
    validateUsername() {
      if (this.username === '') {
        this.errorMessage = '아이디를 입력하세요.';
      } else {
        this.errorMessage = '';
      }
    },
    validatePassword() {
      if (this.password.length < 6) {
        this.errorMessage = '비밀번호는 최소 6자 이상이어야 합니다.';
      } else {
        this.errorMessage = '';
      }
    }
  }
};
</script>

<style>
  .error-message {
    color: red;
  }
</style>

React : 입력 검증 컴포넌트

import React, { useState } from 'react';

function App() {
  const [username, setUsername] = useState('');
  const [password, setPassword] = useState('');
  const [errorMessage, setErrorMessage] = useState('');

  const handleUsernameChange = (e) => {
    setUsername(e.target.value);
    if (e.target.value === '') {
      setErrorMessage('아이디를 입력하세요.');
    } else {
      setErrorMessage('');
    }
  };

  const handlePasswordChange = (e) => {
    setPassword(e.target.value);
    if (e.target.value.length < 6) {
      setErrorMessage('비밀번호는 최소 6자 이상이어야 합니다.');
    } else {
      setErrorMessage('');
    }
  };

  return (
    <div>
      <input type=\"text\" value={username} onChange={handleUsernameChange} placeholder=\"아이디\" />
      <input type=\"password\" value={password} onChange={handlePasswordChange} placeholder=\"비밀번호\" />
      {errorMessage && <div aria-live=\"polite\" className=\"error-message\">{errorMessage}</div>}
    </div>
  );
}

export default App;

<style>
  .error-message {
    color: red;
  }
</style>

7. 점검 기준

8. 점검 방법

9. 준수 사례

10. 미준수 사례

11. 관련 영상

NULI 모바일 앱 접근성 (12. 입력 요소의 용도와 목적 정보 제공)

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

Lighthouse
Lighthouse is an open-source, automated tool for improving the quality of web pages.
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의 약자로 검색 엔진 수집 최적화 측정
  • 사용법
    1. Google Chrome에서 웹 페이지를 엽니다.
    2. DevTools (F12)를 열고 ‘Lighthouse’ 탭을 선택합니다. (단축키 맥:Cmd⌘+Option⌥+I / 윈도우:Ctrl+Shift+I)
    3. ‘Accessibility’ 항목을 선택하고 우측 상단의 ‘Analyze page load’를 클릭하여 보고서를 생성합니다.
    1. Lighthouse는 접근성 점수와 함께 개선이 필요한 부분을 제시합니다.

WAVE
WAVE는 WebAIM에서 만든 확장 프로그램으로 현재 화면의 각 요소가 접근성을 준수하는지 평가합니다. 각 요소가 위반한 내용에 대한 이유와 해결 방법을 제시하여 접근성을 준수하는 개발을 쉽게 할 수 있도록 돕습니다.

  • 사용법
    1. Chrome 브라우저에서 WAVE 확장 프로그램을 설치합니다.
    1. 페이지를 열고 WAVE 확장 프로그램을 실행하여 분석을 시작합니다.
    1. WAVE 페이지에서 발견된 접근성 문제를 제시합니다.

Accessibility Scanner (Android)
Accessibility Scanner는 Android 기기에서 접근성 문제를 탐지하는 Google Play의 앱입니다.

  • 사용법
    1. Android 기기에 Accessibility Scanner 앱을 설치합니다.
    1. 앱을 실행하고 분석하려는 화면에서 스캔을 시작합니다.
    2. 앱은 화면에서 발견된 접근성 문제를 보고하고 개선 방법을 제시합니다.

접근성 트리 뷰(Accessibility Tree)
스크린 리더와 같은 보조 기술은 크로미움의 접근성 API를 사용해 웹콘텐츠와 상호 작용합니다. 접근성 API의 기본 모델은 접근성 트리입니다. 접근성 객체의 트리를 통해 보조 기술은 각 속성과 실제 속성값을 탐색하고 필요한 작업을 수행할 수 있습니다. 웹 개발자는 주로 HTML에서 ARIA 속성과 같은 DOM 속성값을 통해 접근성 트리를 만들고 이를 다룹니다.
크롬 개발자 도구에서는 개발자에게 콘텐츠가 보조 기술에 어떤 식으로 전달되는지 이해할 수 있게 접근성 창을 제공하고 있습니다. DOM 트리 뷰어에서 노드를 선택하면 해당하는 접근성 노드의 속성 정보가 상위 노드, 직계 자식 노드와 함께 창에 표시됩니다.

  • 사용법
    1. 개발자 도구에서 Elements 항목을 선택하고 오른쪽 창에서 Accessibility를 선택하면 “Enable full-page accessibility tree” 항목을 체크
    1. 해당 노드 선택 후 검사

Accessibility Scanner (Android)
Accessibility Scanner는 Android 기기에서 접근성 문제를 탐지하는 Google Play의 앱입니다.

  • 사용법
    1. Android 기기에 Accessibility Scanner 앱을 설치합니다.
    1. 앱을 실행하고 분석하려는 화면에서 스캔을 시작합니다.
    1. 앱은 화면에서 발견된 접근성 문제를 보고하고 개선 방법을 제시합니다.

VSCode 확장 접근성 검사(axe Accessibility Linter)
VSCode 사용 시 별도 확장 설치 후 소스 코드에서 잘못 작성된 부분을 사전에 감지하여 수정할 수 있습니다.

eslint-plugin-jsx-a11y(ReactJS + ESLint)
접근성 오류 부분이 있는지 분석해 주는 플러그인이며 서비스 개발 환경이 React라면 실시간으로 JSX 요소에 대한 접근성 규칙을 확인하고 준수할 수 있도록 돕는 패키지를 설치해 개발할 수 있습니다. 기본적으로 추천되는 규칙 외에 예외로 사용하고 싶은 부분이 있다면 같이 서비스를 개발하는 개발자들과 협의하면서 lint 규칙을 만들어가다 보면 접근성을 준수하는 서비스 개발에 도움이 될 것입니다.
규칙 상세 설명 : jsx-eslint/eslint-plugin-jsx-a11y

사용법
eslint를 전역 설치했다면, eslint-plugin-jsx-a11y 플러그인도 전역으로 설치.

npm install eslint-plugin-jsx-a11y
// 또는
yarn add eslint-plugin-jsx-a11y

.eslintrc.json 파일에 다음과 같이 추가한다.

{
  "extends": "plugin:jsx-a11y/recommended",
  "plugins": "jsx-a11y",
  "rules": {
    "jsx-a11y/aria-role": [
      "error",
      {
        "allowedInvalidRoles": ["text"],
        "ignoreNonDOM": true
      }
    ]
  }
}

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

  • Xcode에서 Accessibility Inspector 툴을 실행합니다. (Xcode > Open Developer Tool > Accessibility Inspector)
  • 테스트할 장치를 선택합니다. 저는 진단하고 싶은 앱을 실행 후 아이폰을 노트북에 연결하여 장치 선택을 했어요. 개발 중인 앱을 Simulator로 빌드 하셨다면 Simulator를 선택하여 진단하실 수 있습니다.
  • Accessibility Inspector 툴 오른쪽 상단에서 audit 버튼을 선택합니다. Run Audit 버튼을 선택합니다.
  • 결과 이슈 목록을 선택하거나 눈 버튼을 선택하시면 해당 항목을 보여줍니다. 장치를 보시면 노란색으로 표시되고, 물음표 버튼를 선택하시면 해당 이슈를 해결할 수 있는 방법을 알려줍니다.
  • 물음표 버튼를 선택하시면 해당 이슈를 해결할 수 있는 방법을 알려줍니다.
  • 목록에서 주의 깊게 봐야 할 이슈는 바로 description에 대한 이슈입니다. 대체 텍스트 이슈는 접근성 사용자에게 매우 크리티컬한 이슈이면서 해결 방법이 매우 수월한 이슈입니다.
  • Xcode의 Identity Inspector 탭의 Accessibility 패널에 대체 텍스트를 넣어주세요.
  • 대체 텍스트 외에도 명도대비, 작은 터치영역등 다양한 접근성 이슈를 체크해주고 있습니다.
  • Inspection
    각 요소별 접근성 항목을 확인할 수 있고, iOS 스크린리더인 VoiceOver 음성으로 들어볼 수 있습니다.
    1. 스피커
      현재 초점이 위치한 요소의 정보를 VoiceOver 음성으로 들려줍니다.
    2. 이전 요소 탐색
      현재 초점이 위치한 곳에서 이전 요소의 정보를 VoiceOver 음성으로 들려줍니다.
    3. 자동 탐색
      현재 초점이 위치한 곳에서 모든 요소를 자동으로 탐색하며 요소의 정보를 VoiceOver 음성으로 들려줍니다.
    4. 다음 요소 탐색
      현재 초점이 위치한 곳에서 다음 요소의 정보를 VoiceOver 음성으로 들려줍니다.
    5. 직접 탐색
      마우스로 요소를 직접 선택하여 탐색합니다.
    6. 현재 초점이 위치한 요소의 접근성 항목을 나타냅니다.
      항목은 Label(대체 텍스트), Value(값), Traits(유형 정보), Identifier(식별자), Hint(힌트 정보), User Input Labels(사용자 입력 텍스트 정보)입니다.

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

  • Analyze > Inspect Code를 실행합니다.
  • Android Studio 4.1.1. 버전을 사용. Android Studio Electric Eel 2022.1.1 Patch 2버전이면 Code 메뉴에 inspect Code가 보임.
  • Inspection profile에서 더보기 버튼을 실행합니다.
  • Inspections 창에서 Lint > Accessibility 항목 중 “Image without contentDescription” 항목과 “Missing accessibility label”을 체크합니다.
  • Android에서 Accessibility 항목 중 주의 깊게 봐야 할 이슈는 바로 이미지 대체 텍스트와 입력 서식 라벨에 대한 이슈입니다.
  • Severity를 Error로 체크해 주세요. Error 이슈를 해결하기 전까지는 빌드 성공을 할 수 없음.
  • 진단 범위도 설정. 모든 범위 In All Sccopes
  • OK를 누르고 코드를 확인. contentDescription 이 없는 ImageView 또는 ImageButton에 빨간색으로 표시된 것을 확인할 수가 있습니다. labelFor 또는 hint가 없는 EditText 역시 빨간색으로 표시된 것을 볼 수 있습니다.
  • 이슈 해결 - ImageView 클래스에 contentDescription을 코드에서 추가. 빨간색으로 표시되었던 코드가 노란색 코드로 변경.
  • 이슈 해결 : EditText 역시 hint 코드를 추가. 빨간색으로 표시되었던 코드가 노란색 코드로 변경.

결론

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

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

참조