Доступность

Интерфейс GtkAccessible предоставляет информацию о доступности элементов пользовательского интерфейса приложения. Приложения вспомогательных технологий (AT), такие как Orca, передают эту информацию пользователям с ограниченными возможностями, чтобы помочь им использовать приложение.

Стандартные элементы управления GTK реализуют интерфейс GtkAccessible и поэтому по умолчанию доступны для AT. Это означает, что если вы используете элементы управления GTK, такие как GtkButton, GtkEntry или GtkListView, вам нужно предоставить только специфичные для приложения детали, когда значения по умолчанию неполны. Вы можете сделать это, установив соответствующие свойства в ваших шаблонах GtkBuilder и файлах определений пользовательского интерфейса или установив свойства, определенные интерфейсом GtkAccessible.

Если вы реализуете свой собственный тип, производный от GtkWidget, вам необходимо установить свойства GtkAccessible самостоятельно и предоставить реализацию виртуальных функций GtkAccessible.

Даже если стандартные элементы управления интерфейсом пользователя, предоставляемые GTK, содержат информацию об обеспечении доступности по умолчанию, для разработчиков приложений существуют дополнительные свойства и соображения. Например, если ваше приложение предоставляет пользователю форму для заполнения, необходимо убедиться в том, что:

Еще один пример: если вы создаете панель инструментов, содержащую кнопки только с иконками, необходимо убедиться в том, что:

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

Разработчики приложений, использующие GTK, должны обеспечивать доступность своих элементов управления интерфейсом пользователя в процессе разработки. При использовании шаблонов GtkBuilder и файлов определения интерфейса пользователя GTK предоставляет инструмент проверки, который проверяет, имеет ли каждый элемент интерфейса пользователя действительную роль и свойства; этот инструмент можно использовать в составе набора тестов приложения, чтобы избежать регрессий.

Каждый элемент управления интерфейсом пользователя реализует интерфейс GtkAccessible, чтобы разработчики виджетов и приложений могли задавать роли, состояния и отношения между элементами управления интерфейсом пользователя. Этот API является чисто описательным.

Каждая реализация GtkAccessible должна предоставить экземпляр GtkATContext, который действует как прокси для API доступности конкретной платформы:

Кроме того, для набора тестов GTK доступен специальный бэкенд доступности, чтобы обеспечить воспроизводимость проблем в конвейере непрерывной интеграции.

Практики авторизации предназначены для разработчиков приложений, а также разработчиков элементов графического интерфейса, основанных на GTK.

Функционально, роли GtkAccessible, состояния, свойства и отношения аналогичны CSS для технологий辅助. Например, для пользователей считывателей экрана различные доступные атрибуты управляют отображением их невизуального опыта. Неправильные роли и атрибуты могут привести к полностью недоступному пользовательскому интерфейсу.

gtk_widget_class_set_accessible_role (widget_class, GTK_ACCESSIBLE_ROLE_BUTTON);

gtk_label_set_text (GTK_LABEL (label), "Some text");
gtk_accessible_update_property (GTK_ACCESSIBLE (label),
                GTK_ACCESSIBLE_PROPERTY_LABEL,
                "Assistive technologies users will perceive "
                "this text, not the contents of the label",
                -1);

gtk_button_set_label (GTK_BUTTON (button), "Download");
gtk_box_append (GTK_BOX (button), button);

gtk_label_set_text (GTK_LABEL (label), "Final report.pdf");
gtk_box_append (GTK_BOX (box), label);

gtk_accessible_update_relation (GTK_ACCESSIBLE (button),
                GTK_ACCESSIBLE_RELATION_LABELLED_BY,
                g_list_append (NULL, label),
                -1);

API доступности в основном используется для выражения семантики, полезной для технологий辅助, но его также можно использовать для скрытия элементов. Каноническим способом сделать это является использование GTK_ACCESSIBLE_ROLE_PRESENTATION, который объявляет, что элемент пользовательского интерфейса предназначен только для целей представления и, как следствие, не оказывает существенного влияния на доступность интерфейса.

Роль “представление” не следует путать со состоянием GTK_ACCESSIBLE_STATE_HIDDEN; состояние “скрытый” является временным и обычно контролируется отображением и скрытием виджета с помощью API GtkWidget.

При создании пользовательских виджетов следование установленным шаблонам может помочь обеспечить, чтобы виджеты хорошо работали и для пользователей доступных технологий.