VirtualBox

Changeset 68450 in vbox for trunk/doc


Ignore:
Timestamp:
Aug 17, 2017 5:45:42 PM (8 years ago)
Author:
vboxsync
svn:sync-xref-src-repo-rev:
117593
Message:

Docs: Accessibility Support: General concept.

File:
1 edited

Legend:

Unmodified
Added
Removed
  • trunk/doc/manual/en_US/Accessibility.xml

    r68449 r68450  
    6868    </para>
    6969  </chapter>
     70
     71  <chapter>
     72    <title>General concept</title>
     73    <para>
     74      This chapter describes the general navigation and accessibility concept. We should note that not every detail of this
     75      concept is already implemented and not every widget in our project already follows that concept. There is still large work
     76      to be done in that regard. But in the end whole the project should correspond to this concept.
     77    </para>
     78    <para>
     79      In short, every application window of our project should be navigated using the following approaches:
     80      <itemizedlist>
     81        <listitem><para>Mouse Navigation</para></listitem>
     82        <listitem><para>Keyboard Navigation</para></listitem>
     83        <listitem><para>Screen-reader Navigation</para></listitem>
     84      </itemizedlist>
     85    </para>
     86    <sect1>
     87      <title>Mouse Navigation</title>
     88      <itemizedlist>
     89        <listitem>
     90          <para>
     91            Each interactable widget can be focused with mouse (if that is not restricted by underlying host OS).
     92          </para>
     93        </listitem>
     94        <listitem>
     95          <para>
     96            Each hovered interactable widget causes own tool-tip to appear.
     97          </para>
     98        </listitem>
     99        <listitem>
     100          <para>
     101            Each tool-tip is given either in imperative mood (ex. "Create new virtual machine") or in short form (ex. "New").
     102          </para>
     103        </listitem>
     104        <listitem>
     105          <para>
     106            Short tool-tip form is only used if context is obvious for a user.
     107          </para>
     108        </listitem>
     109        <listitem>
     110          <para>
     111            Tool-tip can contain shortcut mentioned in parentheses.
     112          </para>
     113        </listitem>
     114        <listitem>
     115          <para>
     116            Each hovered menu bar / toolbar action causes own status-tip to appear (if window have status-bar).
     117          </para>
     118        </listitem>
     119        <listitem>
     120          <para>
     121            Each status-tip is given in imperative mood only.
     122          </para>
     123        </listitem>
     124        <listitem>
     125          <para>
     126            TBD...
     127          </para>
     128        </listitem>
     129      </itemizedlist>
     130    </sect1>
     131    <sect1>
     132      <title>Keyboard Navigation</title>
     133      <itemizedlist>
     134        <listitem>
     135          <para>
     136            Each interactable widget can be focused with keyboard (if that is not restricted by underlying host OS).
     137          </para>
     138        </listitem>
     139        <listitem>
     140          <para>
     141            Focusing is possible through tabbing or mnemonic navigation.
     142          </para>
     143        </listitem>
     144        <listitem>
     145          <para>
     146            Each button and menu bar / toolbar action can be directly activated with keyboard.
     147          </para>
     148        </listitem>
     149        <listitem>
     150          <para>
     151            Activation is possible via shortcut or mnemonic.
     152          </para>
     153        </listitem>
     154        <listitem>
     155          <para>
     156            Each shortcut is configurable through application preferences.
     157          </para>
     158        </listitem>
     159        <listitem>
     160          <para>
     161            Mnemonic mentioned above is underlined alphanumeric character which is a part of widget label (if widget has label).
     162            Mnemonic being triggered in conjunction with the Alt key.
     163          </para>
     164        </listitem>
     165        <listitem>
     166          <para>
     167            Each mnemonic is unique within the visible part of current application window, there are no collisions.
     168          </para>
     169        </listitem>
     170        <listitem>
     171          <para>
     172            TBD...
     173          </para>
     174        </listitem>
     175      </itemizedlist>
     176    </sect1>
     177    <sect1>
     178      <title>Screen-reader Navigation</title>
     179      <itemizedlist>
     180        <listitem>
     181          <para>
     182            Each interactable widget can be focused with screen-reader cursor.
     183          </para>
     184        </listitem>
     185        <listitem>
     186          <para>
     187            Each focused widget have clear name (or full description) in native user language.
     188          </para>
     189        </listitem>
     190        <listitem>
     191          <para>
     192            Each button and menu bar / toolbar action can be directly activated through the screen-reader cursor functionality.
     193          </para>
     194        </listitem>
     195        <listitem>
     196          <para>
     197            Each complex widget which has children (like list, tree, table and similar) is represented as closed group which
     198            encapsulates it's children clearly.
     199          </para>
     200        </listitem>
     201        <listitem>
     202          <para>
     203            While navigating user is able to skip any group without forcing to be entered inside.
     204          </para>
     205        </listitem>
     206        <listitem>
     207          <para>
     208            Each group child can be a group itself with the same rules as above applicable.
     209          </para>
     210        </listitem>
     211        <listitem>
     212          <para>
     213            Each text-field can be directly edited through the screen-reader cursor functionality.
     214          </para>
     215        </listitem>
     216        <listitem>
     217          <para>
     218            TBD...
     219          </para>
     220        </listitem>
     221      </itemizedlist>
     222    </sect1>
     223  </chapter>
    70224</book>
    71225<!-- vim: set shiftwidth=2 tabstop=2 expandtab: -->
Note: See TracChangeset for help on using the changeset viewer.

© 2025 Oracle Support Privacy / Do Not Sell My Info Terms of Use Trademark Policy Automated Access Etiquette