Коллектив авторов - Luwrain — рабочее окружение для людей с нарушениями зрения

представления на экране. В перспективе здесь же будет третий канал — брайлевский вывод, то есть представление данных на подключаемом тактильном дисплее, но на текущем этапе брайлевский вывод в Luwrain пока ещё не сделан. Реализацию интерфейса Application разработчик должен предоставить самостоятельно.

Документация по интерфейсу Application.

Область (area) — это абстракция элемента управления в рабочем пространстве приложения. За исключением того, что элементы управления в среде Luwrain имеют текстовый вид, никаких иных принципиальных отличий от GUI больше нет. Область выступает и как источник текстовой информации, и как получатель событий от системы. Рабочее пространство приложения может состоять из одной или нескольких областей. В отличии от Application, для Area готовить собственную реализацию необязательно, потому что Luwrain подразумевает библиотеку элементов управления, пригодную для расширения и кастомизации.

Документация по интерфейсу Area.
Библиотека элементов управления

При построении рабочего пространства приложения Luwrain мы по сути оперируем текстовыми аналогами привычных элементов GUI. Это может быть список, редактируемый текст, форма с набором полей, таблица, дерево и прочее. За всё это отвечает пакет org.luwrain.controls.

Документация по пакету org.luwrain.controls.

Здесь для примера подробно рассмотрим создание и кастомизацию списка элементов. В элементах управления в отдельные интерфейсы вынесены модель (model) для хранения контента и представление (uppearance) для уточнения показа информации пользователю.

Документация по интерфейсу ListModel.

Документация по интерфейсу ListItemAppearance.

В списке элементов управления (list) по сути происходит следующее:
• Модель хранит набор элементов и не заботиться о деталях их представления пользователю.
• Методы getItemCount() и getItem() дают доступ ко множеству элементов.
• Метод refresh() уведомляет модель, что пользователь запросил обновление содержимого списка.
• Метод toggleMark() запрашивает смену состояния выделения элемента и может вернуть false, если модель не подразумевает множественное выделение.
• В интерфейсе ListItemAppearance метод introduceItem() должен выполнить некоторое звуковое действие, чтобы сообщить пользователю, что курсор установлен на новом элементе списка. В Luwrain также активно используется сопровождение работы звуковыми сигналами, которые несут определённую смысловую нагрузку и позволяют донести до незрячего пользователя информацию быстрее, чем это можно сделать посредством проговаривания.
• Метод getScreenAppearance() возвращает строку, которая должна быть отображена на экране для визуального представления.
• Методы getObservableLeftBound() и getObservableRightBound() позволяют определить фрагмент строки на экране, который пользователь может исследовать по буквам. Эта область иногда ограничивается, чтобы не заставлять пользователя разбирать символы, предназначенные только для визуального представления.

Обработка событий

Внутри Luwrain выделяется две группы событий: события клавиатуры (KeyboardEvent) и события окружения (EnvironmentEvent).

Под клавиатурой понимаются именно клавиши. Мышь и другие позиционные устройства ввода не используются. Это связано с принципиальными проблемами невозможности удобного невизуального представления данных о позиции мышиного курсора. Touchpad потенциально может транслироваться в события, аналогичные нажатиям сочетаний клавиш, как это, например, реализовано в VoiceOver на OS X.

События окружения передают общие команды с указанием их семантики, например, закрытие, отмена, OK, операции буфера обмена, обновления и так далее. Также есть особый тип событий, который используется для организации взаимодействия многопоточных приложений. С окружением можно работать только в один поток, в котором работает сама среда, все же остальные потоки работают в фоне, но система имеет механизмы для безопасного их взаимодействия.

Документация по классу KeyboardEvent.

Документация по классу EnvironmentEvent.

Поскольку незрячий пользователь не имеет возможности охватить взглядом весь экран, а фактически читает лишь информацию под курсором, воспринимая её в линейном виде, крайне важно обеспечить 100-процентную доступность всего содержимого, сделав его фокусируемым с клавиатуры. В традиционных GUI это достигается путём специальных ухищрений, а в Luwrain это заложено изначально, так что разработчику даже не придётся об этом задумываться. С помощью --">