Обучение

Курс для самостоятельного изучения для команды, которая внедряет 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 проверяет свои.

Сделайте: возьмите страницу, созданную в этом курсе, и выполните четыре проверки:

  1. axe (расширение браузера или @axe-core/playwright в тесте): нарушений нет.
  2. Только клавиатура: каждая задача выполнена, фокус всегда виден и никогда не застревает.
  3. Масштаб 400 % и окно шириной 320 пикселей: нет горизонтальной прокрутки, ничего не обрезано.
  4. Программа экранного доступа: у каждого элемента есть имя, роль и состояние, а ошибки объявляются.
Самопроверка: axe не сообщает о нарушениях. Доступна ли страница?

Это ещё не доказано. Автоматические проверки находят, возможно, треть проблем; проверки клавиатурой, масштабом и программой экранного доступа находят большую часть остального. Смотрите страницу качества , чтобы узнать, что сам Lily проверил, а что нет.

После курса