Как к Support Assistive Technologies

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

Вспомогательные технологии — речевые интерфейсы, средства чтения с экрана, альтернативные устройства ввода данных, и так далее — полезны не только для инвалидов, но также и для людей, использующих компьютеры в неофисных средах. Например, если Вы застреваете в пробке, Вы могли бы использовать вспомогательные технологии, чтобы проверить Вашу электронную почту, используя только речевой ввод и вывод. Информация, которая включает вспомогательным технологиям, может использоваться для других инструментов, также, таких как автоматизированные тестеры GUI и устройства ввода данных, такие как сенсорные экраны. Вспомогательные технологии получают информацию от компонентов, используя API Доступности, который определяется в javax.accessibility пакет.

Поскольку поддержка API Доступности встраивается в компоненты Swing, Ваша программа Swing будет, вероятно, работать просто великолепно со вспомогательными технологиями, даже если Вы не сделаете ничего специального. Например, вспомогательные технологии могут автоматически получить текстовую информацию, которая устанавливается следующими строками кода:

JButton button = new JButton("I'm a Swing button!");
label = new JLabel(labelPrefix + "0    ");
label.setText(labelPrefix + numClicks);
JFrame frame = new JFrame("SwingApplication");

Вспомогательные технологии могут также захватить текст подсказки (если любой) связанный с компонентом, и используйте его, чтобы описать компонент пользователю.

Создание Вашей функции программы гладко со вспомогательными технологиями легко сделать и, в Соединенных Штатах, может требоваться федеральным законом. Для получения дополнительной информации см. Глобальные Юридические Ресурсы для IT Связанные Проблемы Доступности.

Остальная часть этого раздела затрагивает эти темы:

• Правила для Поддержки Доступности
• Тестирование на Доступность
• Определение Доступных Имен и Описаний на Компонентах
• Понятия: Как Доступность Работает
• Создание Пользовательских Доступных Компонентов
• API Доступности
• Примеры, который Использование API Доступности

Правила для Поддержки Доступности

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

• Если компонент не выводит на экран короткую строку (который служит ее именем по умолчанию), определите имя с setAccessibleName метод. Вы могли бы хотеть сделать это для кнопок только для изображения, панели, которые обеспечивают логические группировки, текстовые области, и так далее.
• Установите текст подсказки для компонентов всякий раз, когда имеет смысл делать так. Например:

  aJComponent.setToolTipText(
       "Clicking this component causes XYZ to happen.");
  

• Если Вы не хотите обеспечивать подсказку для компонента, используйте setAccessibleDescription метод, чтобы обеспечить описание, которое вспомогательные технологии могут дать пользователю. Например:

  aJComponent.getAccessibleContext().
      setAccessibleDescription(
      "Clicking this component causes XYZ to happen.");
  

• Определите альтернативы клавиатуры везде, где возможный. Удостоверьтесь, что можно использовать свою программу с только клавиатурой. Попытайтесь скрыть свою мышь! Отметьте, что, если фокус находится в доступном для редактирования текстовом компоненте, можно использовать Shift-Tab, чтобы переместить фокус в следующий компонент.

  Поддержка альтернатив клавиатуры изменяется компонентом. Кнопки поддерживают альтернативы клавиатуры с setMnemonic метод. Меню наследовали поддержку мнемосхемы кнопки и также поддерживают акселераторы, как описано во Включении Работе Клавиатуры. Другие компоненты могут использовать привязки клавиш, чтобы связать пользователя, вводящего с действиями программы.

• Присвойте текстовое описание всем ImageIcon объекты в Вашей программе. Можно установить это свойство при использовании любого setDescription метод или один из String формы ImageIcon конструкторы.
• Если набор компонентов формирует логическую группу, попытайтесь поместить их в один контейнер. Например, используйте a JPanel содержать все переключатели в группе переключателей.
• Всякий раз, когда у Вас есть метка, которая описывает другой компонент, используйте setLabelFor метод так, чтобы вспомогательные технологии могли найти компонент, с которым связывается метка. Это особенно важно, когда метка выводит на экран мнемосхему для другого компонента (такого как текстовое поле).
• Если Вы создаете пользовательский компонент, удостоверьтесь, что он поддерживает доступность. В частности знать это подклассы JComponent не автоматически доступны. Пользовательские компоненты, которые являются потомками других компонентов Swing, должны переопределить наследованную информацию о доступности по мере необходимости. Для получения дополнительной информации см. Понятия: Как Работы Доступности и Создание Пользовательских Доступных Компонентов.
• Используйте примеры, предоставленные утилиты доступности, чтобы протестировать Вашу программу. Хотя основная цель этих примеров состоит в том, чтобы показать программистам, как использовать API Доступности, реализовывая вспомогательные технологии, эти примеры также довольно полезны для тестирования прикладных программ на доступность. Тестирование на шоу Доступности ScrollDemo работая с Обезьяной, одним из примеров утилит доступности. Обезьяна показывает дерево доступных компонентов в программе и позволяет Вам взаимодействовать с теми компонентами.
• Наконец, не повреждайте то, что Вы получаете бесплатно! Если у Вашего GUI есть недоступный контейнер — например, Ваш собственный подкласс Container или JComponent или любой другой контейнер, который не реализует Accessible интерфейс — любые компоненты в том контейнере становятся недоступными.

Тестирование на Доступность

Примеры, которые идут с утилитами доступности, могут дать Вам общее представление о том, насколько доступный Ваша программа. Для получения инструкций по получению этих утилит см. Java Настольная домашняя страница Доступности SE. Следуйте инструкциям в документации утилит доступности для того, чтобы установить виртуальную машину Java (VM), чтобы работать один или больше утилит автоматически.

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

Вот снимок работы Обезьяны ScrollDemo:

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

Первая вещь заметить состоит в том что, даже без явной поддержки в ScrollDemo, Обезьяна в состоянии обнаружить большую информацию о различных компонентах в программе. Большинство компонентов и их дочерние элементы появляются в дереве. Однако, имена для большинства компонентов пусты (нуль), который довольно бесполезен. Описания также пусты.

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

Теперь вот изображение окна Обезьяны для AccessibleScrollDemo:

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

В предыдущем снимке Обезьяны выбирается элемент Заголовка Столбца. Обезьяна выделяет соответствующий компонент в ScrollDemo программа.

Когда элемент выбирается, можно использовать меню Panels Обезьяны, чтобы перевести одну в рабочее состояние из четырех различных панелей, которые позволяют Вам взаимодействовать с выбранным компонентом. Выбирая Панели> панель API Доступности переводит панель в рабочее состояние как один показанный в следующем числе. Эта панель выводит на экран информацию, доступную через методы, определенные в AccessibleContext базируйте class и AccessibleComponent интерфейс.

У обезьяны есть три других панели:

• AccessibleAction: Показывает действия, поддерживаемые доступным компонентом, и позволяет Вам вызывать действие. Работы только с доступным компонентом, контекст которого реализует AccessibleAction интерфейс.
• AccessibleSelection: Показывает текущий выбор доступного компонента и позволяет Вам управлять выбором. Работы только с доступным компонентом, контекст которого реализует AccessibleSelection интерфейс.
• AccessibleHypertext: Шоу любые гиперссылки, содержавшие в пределах доступного компонента и, позволяют Вам пересекать их. Работы только с доступным компонентом, контекст которого реализует AccessibleHypertext интерфейс.

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

Единственный истинный тест доступности должен выполнить Ваши программы с реальными вспомогательными технологиями, однако, можно счесть следующее свободное и средство чтения с экрана с открытым исходным кодом полезным: Настольный Доступ NonVisual (NVDA).

Определение Доступных Имен и Описаний на Компонентах

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

public AccessibleScrollDemo() {
    // Get the image to use.
    ImageIcon bee = createImageIcon("images/flyingBee.jpg",
                      "Photograph of a flying bee.");

    // Create the row and column headers.
    columnView = new Rule(Rule.HORIZONTAL, true);
    if (bee != null) {
        columnView.setPreferredWidth(bee.getIconWidth());
    } else {
        columnView.setPreferredWidth(320);
    }
    columnView.getAccessibleContext().setAccessibleName("Column Header");
    columnView.getAccessibleContext().
            setAccessibleDescription("Displays horizontal ruler for " +
                                     "measuring scroll pane client.");
    rowView = new Rule(Rule.VERTICAL, true);
    if (bee != null) {
        rowView.setPreferredHeight(bee.getIconHeight());
    } else {
        rowView.setPreferredHeight(480);
    }
    rowView.getAccessibleContext().setAccessibleName("Row Header");
    rowView.getAccessibleContext().
            setAccessibleDescription("Displays vertical ruler for " +
                                     "measuring scroll pane client.");

    // Create the corners.
    JPanel buttonCorner = new JPanel();
    isMetric = new JToggleButton("cm", true);
    isMetric.setFont(new Font("SansSerif", Font.PLAIN, 11));
    isMetric.setMargin(new Insets(2,2,2,2));
    isMetric.addItemListener(this);
    isMetric.setToolTipText("Toggles rulers' unit of measure " +
                            "between inches and centimeters.");
    buttonCorner.add(isMetric); //Use the default FlowLayout
    buttonCorner.getAccessibleContext().
                 setAccessibleName("Upper Left Corner");

    String desc = "Fills the corner of a scroll pane " +
                  "with color for aesthetic reasons.";
    Corner lowerLeft = new Corner();
    lowerLeft.getAccessibleContext().
              setAccessibleName("Lower Left Corner");
    lowerLeft.getAccessibleContext().setAccessibleDescription(desc);

    Corner upperRight = new Corner();
    upperRight.getAccessibleContext().
               setAccessibleName("Upper Right Corner");
    upperRight.getAccessibleContext().setAccessibleDescription(desc);
    
    // Set up the scroll pane.
    picture = new ScrollablePicture(bee,
                                    columnView.getIncrement());
    picture.setToolTipText(bee.getDescription());
    picture.getAccessibleContext().setAccessibleName(
                                     "Scroll pane client");

    JScrollPane pictureScrollPane = new JScrollPane(picture);
    pictureScrollPane.setPreferredSize(new Dimension(300, 250));
    pictureScrollPane.setViewportBorder(
            BorderFactory.createLineBorder(Color.black));

    pictureScrollPane.setColumnHeaderView(columnView);
    pictureScrollPane.setRowHeaderView(rowView);

    // In theory, to support internationalization you would change
    // UPPER_LEFT_CORNER to UPPER_LEADING_CORNER,
    // LOWER_LEFT_CORNER to LOWER_LEADING_CORNER, and
    // UPPER_RIGHT_CORNER to UPPER_TRAILING_CORNER.  In practice,
    // bug #4467063 makes that impossible (at least in 1.4.0).
    pictureScrollPane.setCorner(JScrollPane.UPPER_LEFT_CORNER,
                                buttonCorner);
    pictureScrollPane.setCorner(JScrollPane.LOWER_LEFT_CORNER,
                                lowerLeft);
    pictureScrollPane.setCorner(JScrollPane.UPPER_RIGHT_CORNER,
                                upperRight);

    // Put it in this panel.
    setLayout(new BoxLayout(this, BoxLayout.X_AXIS));
    add(pictureScrollPane);
    setBorder(BorderFactory.createEmptyBorder(20,20,20,20));
}

Часто, программа определяет имя компонента и описание непосредственно через доступный контекст компонента. Другие времена, программа устанавливает доступное описание косвенно с подсказками. В случае выключателя см описание устанавливается автоматически в текст на кнопке.

Понятия: Как Доступность Работает

Объект доступен, если он реализует Accessible интерфейс. Accessible интерфейс определяет только один метод, getAccessibleContext, который возвращается AccessibleContext объект. AccessibleContext объект является посредником, который содержит доступную информацию для доступного объекта. Следующие данные показывают, как вспомогательные технологии получают доступный контекст от доступного объекта и запрашивают его для информации:

AccessibleContext абстрактный class, который определяет минимальный набор информации, которую доступный объект должен предоставить о себе. Минимальный набор включает имя, описание, роль, набор состояния, и так далее. Чтобы идентифицировать его доступный объект как наличие определенных возможностей, доступный контекст может реализовать один или больше интерфейсов как показано в Доступной таблице Интерфейсов. Например, JButton реализации AccessibleAction, AccessibleValue, AccessibleText, и AccessibleExtendedComponent. Это не необходимо для JButton реализовывать AccessibleIcon потому что это реализуется ImageIcon присоединенный к кнопке.

Поскольку JComponent САМ class не реализует Accessible интерфейс, экземпляры его прямых подклассов не доступны. Если Вы пишете пользовательский компонент, который наследовался непосредственно от JComponent, Вы должны явно заставить это реализовать Accessible интерфейс. JComponent действительно имеет доступный контекст, вызванный AccessibleJComponent, это реализует AccessibleComponent взаимодействуйте через интерфейс и обеспечивает минимальное количество доступной информации. Можно обеспечить доступный контекст для своих пользовательских компонентов, создавая подкласс AccessibleJComponent и переопределение важных методов. Создание Пользовательских Компонентов Доступные шоу два примера выполнения этого.

Все другие стандартные компоненты Swing реализуют Accessible соедините интерфейсом и имейте доступный контекст, который реализует один или больше предыдущих интерфейсов как соответствующий. Доступные контексты для компонентов Swing реализуются как внутренние классы и имеют имена этого стиля:

Component.AccessibleComponent

Если Вы создаете подкласс стандартного компонента Swing, и Ваш подкласс существенно отличается от своего суперкласса, то следует обеспечить пользовательский доступный контекст для этого. Самый легкий путь состоит в том, чтобы создать подкласс доступного контекста суперкласса class и методы переопределения по мере необходимости. Например, если Вы создаете a JLabel разделите на подклассы существенно отличающийся от JLabel, тогда Ваш JLabel подкласс должен содержать внутренний class, который расширяется AccessibleJLabel. Следующий раздел показывает, как сделать так, используя примеры в который JComponent подклассы расширяются AccessibleJComponent.

Создание Пользовательских Доступных Компонентов

Программа демонстрационного примера прокрутки использует три пользовательских компонентных класса. ScrollablePicture подкласс JLabel, и Corner и Rule оба подклассы JComponent.

ScrollablePicture class полагается полностью на доступность, наследованную от JLabel через JLabel.AccessibleJLabel. Код, который создает экземпляр ScrollablePicture устанавливает текст подсказки для изображения с возможностью прокрутки. Текст подсказки используется контекстом в качестве доступного описания компонента. Этим поведением обеспечивают AccessibleJLabel.

Доступная версия Corner class содержит как раз достаточно кода, чтобы сделать его экземпляры доступными. Мы реализовывали поддержку доступности, добавляя код, показанный полужирным оригинальной версии Corner.

public class Corner extends JComponent implements Accessible {

    protected void paintComponent(Graphics g) {
        //Fill me with dirty brown/orange.
        g.setColor(new Color(230, 163, 4));
        g.fillRect(0, 0, getWidth(), getHeight());
    }

    public AccessibleContext getAccessibleContext() {
        if (accessibleContext == null) {
            accessibleContext = new AccessibleCorner();
        }
        return accessibleContext;
    }

    protected class AccessibleCorner extends AccessibleJComponent {
        //Inherit everything, override nothing.
    }
}

Вся доступность, обеспеченная этим class, наследована от AccessibleJComponent. Этот подход прекрасен для Corner потому что AccessibleJComponent обеспечивает разумное количество информации о доступности значения по умолчанию и потому что углы являются неинтересными: они существуют только, чтобы привести в рабочее состояние немного экранного пространства. Другие классы, такой как Rule, потребность предоставить настроенную информацию.

Rule обеспечивает доступный контекст для себя тем же самым способом как Corner, но контекст переопределяет два метода, чтобы обеспечить детали о роли компонента и состоянии:

protected class AccessibleRuler extends AccessibleJComponent {

    public AccessibleRole getAccessibleRole() {
        return AccessibleRuleRole.RULER;
    }

    public AccessibleStateSet getAccessibleStateSet() {
        AccessibleStateSet states =
            super.getAccessibleStateSet();
        if (orientation == VERTICAL) {
            states.add(AccessibleState.VERTICAL);
        } else {
            states.add(AccessibleState.HORIZONTAL);
        }
        if (isMetric) {
            states.add(AccessibleRulerState.CENTIMETERS);
        } else {
            states.add(AccessibleRulerState.INCHES);
        }
        return states;
    }
}

AccessibleRole перечисление объектов, которые идентифицируют роли, которые могут играть компоненты Swing. Это содержит предопределенные роли, такие как метка, кнопка, и так далее. Линейки в нашем примере не соответствуют хорошо ни одной из предопределенных ролей, таким образом, программа изобретает новый в подклассе AccessibleRole:

class AccessibleRuleRole extends AccessibleRole {
    public static final AccessibleRuleRole RULER
        = new AccessibleRuleRole("ruler");

    protected AccessibleRuleRole(String key) {
        super(key);
    }

    //Should really provide localizable versions of these names.
    public String toDisplayString(String resourceBundleName,
                                  Locale locale) {
        return key;
    }
}

Любой компонент, у которого есть состояние, может предоставить информацию о состоянии вспомогательным технологиям, переопределяя getAccessibleStateSet метод. У правила есть два набора состояний: ее ориентация может быть или вертикалью или горизонталью, и ее единицы измерения могут быть или сантиметрами или дюймами. AccessibleState перечисление предопределенных состояний. Эта программа использует свои предопределенные состояния для горизонтальной ориентации и вертикали. Поскольку AccessibleState ничего не содержит для сантиметров и дюймов, программа делает подкласс, чтобы обеспечить соответствующие состояния:

class AccessibleRulerState extends AccessibleState {
    public static final AccessibleRulerState INCHES
        = new AccessibleRulerState("inches");
    public static final AccessibleRulerState CENTIMETERS
        = new AccessibleRulerState("centimeters");

    protected AccessibleRulerState(String key) {
        super(key);
    }

    //Should really provide localizable versions of these names.
    public String toDisplayString(String resourceBundleName,
                                  Locale locale) {
        return key;
    }
}

Вы видели, как реализовать доступность для двух простых компонентов, которые существуют только, чтобы нарисовать себя экранными. Компоненты, которые делают больше, такие как отвечание на мышь или события клавиатуры, должны обеспечить более тщательно продуманные доступные контексты. Можно найти примеры реализации доступных контекстов, копаясь в исходном коде для компонентов Swing.

API Доступности

Таблицы в этом разделе покрывают только часть API доступности. Для получения дополнительной информации о API доступности, см. документацию API для классов и пакетов в пакете доступности. Кроме того, сошлитесь на документацию API для доступных контекстов для отдельных компонентов Swing.

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

• Именование и Соединение Компонентов
• Создание Пользовательского Доступного Компонента
• Доступные Интерфейсы

Примеры, который Использование API Доступности

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