Обучение
Курс для самостоятельного изучения для команды, которая внедряет Lily: восемь модулей, в каждом цель, материал для чтения, упражнение в настоящем браузере и самопроверка с ответами. Около дня в целом; удобно проходить по одному модулю за раз.
Прежде чем начать
Выберите одно руководство по фреймворку и сначала пройдите его. Для упражнений запустите одно из примеров приложений локально или используйте страницы компонентов на этом сайте. Нужна клавиатура, а для модуля 8 — программа экранного доступа: VoiceOver в macOS и iOS, NVDA в Windows или TalkBack в Android, все бесплатные.
Модуль 1 — Что значит headless
Цель: понять, что решает Lily, а что решаете вы.
Прочитайте: страницу «О проекте» и одну страницу компонента, например Button, от начала до конца.
Сделайте: выведите Button и TextInput
без таблицы стилей. Затем подключите одну тему, потом другую. Отметьте, что изменилось, а что нет.
Самопроверка: чего компонент Lily никогда не поставляет? Что поставляет всегда?
Никогда: CSS, шрифты, значки и изображения (кроме значков выбора), английский текст, загрузку данных, язык или валюту по умолчанию. Всегда: самый точный HTML-элемент, его класс в kebab-case первым, ARIA там, где HTML не хватает, работу с клавиатуры и передачу ваших остальных атрибутов.
Самопроверка: вам нужна красная рамка у одной кнопки. Где её задать?
В вашем CSS, на классе (.button) или на добавленном вами классе. Никогда не в компоненте.
Модуль 2 — Клавиатура и фокус
Цель: пользоваться каждым компонентом и тестировать его без мыши.
Прочитайте: таблицу клавиатурных взаимодействий для TabBar, Listbox и Dialog.
Сделайте: отключите мышь. На каждой из трёх страниц доберитесь до демо с помощью Tab и выполните всё, что перечислено в таблице. Откройте диалог, нажмите Escapeи отметьте, куда попал фокус.
Самопроверка: почему панель вкладок занимает одну остановку Tab а не по одной на вкладку?
Составной шаблон APG: Tab переходит между виджетами, а стрелки — внутри одного (перемещаемый tabindex). Панель с десятью остановками заставляет пользователя клавиатуры нажать Tab десять раз, чтобы её пройти.
Самопроверка: где должен быть фокус после закрытия модального диалога?
На элементе, который его открыл. Модальные диалоги Lily используют showModal(), который также удерживает Tab внутри диалога, пока он открыт.
Модуль 3 — Имена, роли и состояния
Цель: дать каждому элементу имя, которое может произнести программа экранного доступа, вашими словами.
Прочитайте: раздел ARIA для IconButton и SwitchButton.
Сделайте: в своём приложении, запущенном на сервере разработки, выведите IconButton без label. Откройте консоль браузера: Lily предупредит, что у элемента нет доступного имени. Добавьте подпись и убедитесь, что предупреждение исчезло. (Предупреждения есть только в сборке для разработки, поэтому рабочая страница, как этот сайт, молчит.)
Самопроверка: когда использовать aria-label, а когда видимый текст?
Видимый текст, когда только можно: его видят все, и пользователи голосового ввода могут его произнести. aria-label только там, где видимого текста нет, например у значка. Если есть и то и другое, имя должно содержать видимые слова (WCAG 2.5.3).
Самопроверка: статус показан только красным. Чего не хватает?
Текста. Цвет может повторять смысл, но никогда не передаёт его в одиночку (WCAG 1.4.1); статусу нужны слова.
Модуль 4 — Формы
Цель: сделать форму, ошибки которой любой может найти и исправить.
Прочитайте и сделайте: руководство по доступным формам, все пять шагов.
Самопроверка: форма не прошла проверку. Куда переходит фокус и что зачитывается?
На сводку ошибок, которая объявляется с заголовком и списком ссылок, по одной на ошибку, каждая ведёт к своему полю.
Самопроверка: почему не отключать кнопку отправки, пока форма не станет верной?
Отключённая кнопка не может сказать, что не так, и многие не поймут, почему она ничего не делает.
Модуль 5 — Темы и контраст
Цель: изменить оформление Lily, не нарушив контраст и фокус.
Прочитайте: руководство по темам и таблицу контраста тем .
Сделайте: замените --color-primary цветом своего бренда. Проверьте, что его пара, --color-primary-content, достигает 4,5:1 и что кольцо фокуса по-прежнему видно на странице.
Самопроверка: цвет вашего бренда слишком светлый для белого текста. Можно ли им пользоваться?
Да, как украшением (--lily-brand: полоса шапки, линия, фон логотипа), но никогда для текста или границы элемента. Текст и границы используют пары содержимого темы.
Модуль 6 — Весь мир
Цель: не делать ни одну страну страной по умолчанию.
Прочитайте и сделайте: форма, которая работает по всему миру.
Самопроверка: почему у CurrencyInput нет валюты по умолчанию?
Любое значение по умолчанию было бы деньгами одной страны и молча ошибалось бы везде. Отсутствующий currencyCode — это ошибка вызывающего кода.
Самопроверка: страница на арабском. Что вы задаёте и что должен делать ваш CSS?
lang="ar" и dir="rtl" (выбор языка задаёт оба); ваш CSS использует логические свойства, чтобы вёрстка отражалась сама.
Модуль 7 — Анимация
Цель: анимировать, никому не вредя.
Прочитайте: рецепты анимации.
Сделайте: включите «уменьшение движения» в операционной системе и перезагрузите страницу с рецептом бегущей строки. Она должна стоять на месте и переноситься. Затем доберитесь до её кнопки паузы с клавиатуры.
Самопроверка: что-то двигается само дольше пяти секунд. Что у него должно быть?
Способ приостановить, остановить или скрыть движение (WCAG 2.2.2), доступный с клавиатуры, а не только при наведении.
Модуль 8 — Проверьте работу
Цель: проверить страницу так, как Lily проверяет свои.
Сделайте: возьмите страницу, созданную в этом курсе, и выполните четыре проверки:
- axe (расширение браузера или
@axe-core/playwrightв тесте): нарушений нет. - Только клавиатура: каждая задача выполнена, фокус всегда виден и никогда не застревает.
- Масштаб 400 % и окно шириной 320 пикселей: нет горизонтальной прокрутки, ничего не обрезано.
- Программа экранного доступа: у каждого элемента есть имя, роль и состояние, а ошибки объявляются.
Самопроверка: axe не сообщает о нарушениях. Доступна ли страница?
Это ещё не доказано. Автоматические проверки находят, возможно, треть проблем; проверки клавиатурой, масштабом и программой экранного доступа находят большую часть остального. Смотрите страницу качества , чтобы узнать, что сам Lily проверил, а что нет.
После курса
- Руководство для здравоохранения, для клинического ПО.
- Помощники: выбор, таблица данных, календарь.
- Помощь, и проект для вопросов.