====== Unified Use Cases for Expert Handlers (Draft 2.03b) ====== //**document status: internal draft -- this is a work-in-progress**//\\ //**revision date: 2008-01-27**//\\ //**previous versions: [[:accessibility:handlers:usecases:unified:draft2.03|Draft 2.03 (2008-01-26)]], [[:accessibility:handlers:usecases:unified:draft2.02b|Draft 2.02b (2008-01-20)]], [[:accessibility:handlers:usecases:unified:draft2.02a|Draft 2.02a (2008-01-14)]], [[:accessibility:handlers:usecases:unified:draft2.01|Draft 2.01 (2007-12-22)]]**//\\ \\ //**authors: Pete Brunet, Vladmir Bulatov, Gregory J. Rosmaita, Janina Sajka and Neil Soiffer**// //(chair, Expert Handlers SIG)//\\ //**edited and annotated by [[https://www.linuxfoundation.org/en/User:Oedipus|Gregory J. Rosmaita]]**// ---- **please provide feedback on this draft to the Expert Handlers SIG either via the [[https://lists.linux-foundation.org/mailman/listinfo/accessibility-handlers|Expert Handlers emailing list (preferred)]] or directly to [[https://www.linuxfoundation.org/en/Talk:Accessibility/Handlers/UseCases/Unified/Draft2.02|this document's "Discussion" page]] to which posted comments will be appended by the editor** ---- =====Contents===== * [[https://www.linuxfoundation.org/#Unified_Use_Cases_for_Expert_Handlers_.28Draft_2.03b.29|1 Unified Use Cases for Expert Handlers (Draft 2.03b)]] * [[https://www.linuxfoundation.org/#Introduction:_What_Are_Expert_Handlers.3F|1.1 Introduction: What Are Expert Handlers?]] * [[https://www.linuxfoundation.org/#Speech_Output_Use_Cases_for_Expert_Handlers|1.2 Speech Output Use Cases for Expert Handlers]] * [[https://www.linuxfoundation.org/#Alternative_Input_Use_Cases|1.3 Alternative Input Use Cases]] * [[https://www.linuxfoundation.org/#Navigability_Use_Cases|1.4 Navigability Use Cases]] * [[https://www.linuxfoundation.org/#Magnification_Use_Cases|1.5 Magnification Use Cases]] * [[https://www.linuxfoundation.org/#Braille_Display.2C_Embossing_and_Tactile_Conversion_Use_Cases|1.6 Braille Display, Embossing and Tactile Conversion Use Cases]] * [[https://www.linuxfoundation.org/#Universal_Use_Cases|1.7 Universal Use Cases]] * [[https://www.linuxfoundation.org/#Universal_Use_Case_1:_Where_Am_I.3F|1.7.1 Universal Use Case 1: Where Am I?]] * [[https://www.linuxfoundation.org/#Universal_Use_Case_2:_Document_Summary|1.7.2 Universal Use Case 2: Document Summary]] * [[https://www.linuxfoundation.org/#Putting_It_All_Together:_Expert_Handlers_and_the_Flow_of_Control|2 Putting It All Together: Expert Handlers and the Flow of Control]] * [[https://www.linuxfoundation.org/#Footnotes|3 Footnotes]] ===== Introduction: What Are Expert Handlers? ===== The purpose and responsibility of accessibility interfaces, such as Microsoft Active Accessibility (MSAA) and IAccessible2 (IA2), is to provide assistive technology (AT) with the ability to access and interact with the information contained in an application. This allows an AT to access the information in the application's DOM. Interpreting, displaying, and navigating the information is the responsibility of the AT. Generalized markup is sometimes complimented by markup specifications that facilitate more semantically precise content markup. Assistive technology typically handles generalized content markup, but does not know about specialized markup. Because of this, users of AT are unable to access or navigate specialized markup effectively. Generalized content markup (such as [[:accessibility:handlers:references:gmls#html-info|HTML]]) is complimented by markup specifications that facilitate more semantically precise content markup. Examples of specialized, semantically precise markup include [[:accessibility:handlers:references:smls#mathml-info|MathML]] and [[:accessibility:handlers:references:smls#musicxml-info|MusicXML]]. The Open A11y Expert Handlers SIG is exploring a standardized plug-in mechanism to AT software. The goal of this plug-in standard is to allow AT software to take advantage of expert software that understands specialized markup. This plug-in standard will allow the expert software to provide enhanced, semantically rich access to specialized markup so that the AT can properly render (visually, aurally, and/or tactilely) and help users navigate the semantic meaning encoded in the specialized markup. \\ ===== Speech Output Use Cases for Expert Handlers ===== Computer users who are blind or severely visually impaired often use assistive technology (AT) built around synthetic text to speech (TTS). These AT applications are commonly called "screen readers." Screen reader users listen to a synthetic voice rendering of on screen content because they are physically unable to see this content on a computer display monitor. Because synthetic voice rendering is intrinsically temporal, whereas on screen displays are (or can easily be made) static, various strategies are provided by screen readers to allow users to tightly control the alternative TTS rendering. Screen reader users often find it useful, for instance, to skim through content until a particular portion is located and then examine that portion in a more controlled manner, perhaps word by word or even character by rendered character. It is almost never useful to wait for a synthetic voice rendering that begins at the upper left of the screen and proceeds left to right, row by row, until it reaches the bottom because such a procedure is temporally inefficient, requiring the user to strain to hear just the portion desired in the midst of unsought content. Thus, screen readers provide mechanisms that allow the user to focus anywhere in the content and examine only that content which is of interest. Screen readers have proven highly effective at providing their users access to content which is intrinsically textual and linear in nature. It is not hard to provide mechanisms to focus synthetic voice rendering paragraph by paragraph, sentence by sentence, word by word, or character by character. Access to on screen widgets have also proven effective by rendering that static content in list form, where the user can pick from a menu of options using up and down arrow plus the enter key to indicate a selection, in liue of picking an icon on screen using a mouse. Access to content arrayed in a table can also succeed by allowing the AT to simulate the process a sighted user employs to consider tables. In other words, mechanisms are provided to hear the contents of a cell and also the row and column labels for that cell (which define the cell's meaning). Similar "smart" content rendering and navigation strategies are required by screen reader users in more complex, nonlinear content such as mathematical (chemical, biological, etc) expressions, music, and graphical renderings. Because such content is generally the province of knowledge domain experts and students, and not the domain of most computer users, screen readers do not invest the significant resources necessary to serve only a small portion of their customer base with specialized routines for such content. Furthermore, the general rendering and navigation strategies provided for linear (textual), menu, and tabular content are woefully insufficient to allow users to examine specific portions of such domain specific expressions effectively. On the other hand domain specific markup often does provide sufficient specificity so that the focus and rendering needs of the screen reader can be well supported. In order to gain effective access to such domain specific content screen reader users require technology that can: * Synthetically voice the expression in a logical order * Allow the user to focus on particular, logical portions of expressions possibly at several layers of granularity * Appropriately voice specialized symbols and symbolic expressions ---- ===== Alternative Input Use Cases ===== There are users with disabilities who do not require accomodation in order to read domain specific markup. Rather, these users require assistive technologies to facilitate their scrolling and/or editing of content. Highly effective assistive technologies exist to accomodate alternative input strategies ranging from: * speech input technology, such as [[http://www.ddwin.com/dictate.htm|DragonDictate]] or [[http://www.ddwin.com/deluxe.htm|NaturallySpeaking]]; * mouse and keyboard alternative systems, such as the [[http://www.gok.ca/|GNOME On-Screen Keyboard (GOK)]], [[http://www.oatsoft.org/trac/jambu|Jambu]], which provides improved web accessibility for switch and alternative pointer users, and [[http://www.oatsoft.org/Software/open-eyes|OpenEyes]], an open-source open-hardware toolkit for real-time eye-tracking; * context aware word-prediction technologies, such as [[http://www.inference.phy.cam.ac.uk/dasher/|Dasher]] Users of alternative input assistive technologies require two specific accomodations for scrolling and editing domain specific content: - Context aware expedited scrolling and navigation. The Navigation Use Cases outlined in this document will serve this requirement. - Knowledge domain context aware command and content vocabulary for speech based navigation systems and for word-prediction systems. ---- ===== Navigability Use Cases ===== AT users need to be able to navigate within sub-components of documents containing specialized content, such as math, music or chemical markup. Typically these specialized components have content which needs to receive "focus" at different levels of granularity, e.g. a numerator within a numerator, an expression, a term, a bar of music, etc. Within each level, functions are needed in response to AT commands to inspect and navigate to and from "items" (e.g., by word, bar, expression, clause, term, depending upon the type of content being expressed) for a particular level of granularity: - contextual query/inspection of object/glyph with current focus ("[[https://www.linuxfoundation.org/#Universal_Use_Case_1:_Where_Am_I.3F|Where Am I?]]") - character-by-character - previous/current/next item - all items with user-defined characteristics - all items in a author-defined category [[[https://www.linuxfoundation.org/#fn1|footnote 1]]] - first/last item on a line - first/last item within next higher or lower level of granularity - first/last item in the document There are two scenarios to consider, a read-only scenario and a scenario where the user is editing the document. There are three system components that need to interact: the user agent, e.g. a browser, the AT, and the expert handler. In the read-only case, the AT responds to some sort of "Point of Regard" change event and depending on the "role" of the object which received focus, the AT fetches accessibility information pertinent to that role and then formats/outputs a response tailored to an AT user, e.g. TTS/braille. In the case of specialized content, an expert handler needs to be used by the AT because the AT doesn't know how to deal with such specialized content directly. In order to meaningfully interact with the specialized content, the user needs to be able to execute the following actions: * change level of granularity up/down * read all from top * read all from Point of Regard (POR) * goto and read first/last item on the current line * goto and read first/last item within the next less/more granular item * goto and read first/last item in the document * goto and read previous/current/next item In the case of editable content there may also be a desire to have separate cursors, e.g. one to remain at the POR (the caret, if editing), and one to move around for review purposes. The AT will already have UI input commands for most of the above functions, but probably not for changing to higher/lower levels of granularity. If the AT needs to provide the user with an increased level of granularity, in response, the AT would call the handler to change the mode of granularity. The AT will handle the UI commands and in turn call the handler to return an item at the current level of granularity. The AT would have told the handler about the output mode, e.g. braille or TTS. Armed with those three things: level of granularity, mode of output, and which item (first, last, previous, current, next), the handler knows what to do. In the case of editable content, the UA provides the input UI for the user. This editing capability would most likely be provided via a plugin. An example of such a plugin is needed so that one can evaluate what accessibility features need to be added to the existing editors. ---- ===== Magnification Use Cases ===== A common use of magnification is to proportionately enlarge content. For text-based (or more generally, font-based) applications, this means that AT software should be able to request rendering with larger sized fonts or a certain amount of magnification relative to some baseline magnification. Applications beyond standard text-based ones include math, music, and labeled plots/graphics. For non text-based applications such as graphics and chemical structures, magnification could be based on a certain percentage of the normal size or given by "fill this area". These two ideas can always be mapped onto each other. In all of these cases, the magnification may be due to having the entire documented magnified or it may be due to a request to magnify an individual instance (such as an equation). There are two other uses for magnification: - While navigating or speaking, it might be desirable to magnify the part being navigated/spoken to make it easier to see. For example, while playing some music, the current measure and next measure might be magnified to ease reading while leaving the rest unmagnified so that the amount of screen space used is minimized. There will also need to be a method to reset the magnification.\\ \\ - Math and Chemical notation shrink fonts for superscripts and subscripts. In math, these are further reduced for nested scripts. One common feature for math renderers is to set a minimum font size. Typically, this is 50% of the base font size and corresponds to the size used for doubly nested scripts. It is potentially useful to allow the AT to control the maximum percent shrinkage used by renderers. Another possibility is to have a feature that says "don't shrink at all". Although the rendering would not be consider high quality typesetting, it does make scripts more readable to those with some vision impairment. ---- ===== Braille Display, Embossing and Tactile Conversion Use Cases ===== An Expert Handler should be able to provide braille data for braille display output by generic AT. Custom braille output is needed, because generic AT has no knowledge about how specific specialized data can and should be represented via braille. An example is mathematics: there are many different braille codes used to represent mathematics that vary from country to country and agency to agency, which affects how [[:accessibility:handlers:references:smls#mathml-info|MathML]] is translated into a tactile form. \\ Simple ASCII strings are normally used to communicate braille to braille devices. However, there are a lot of specific ASCII-to-dots pattern-encoding tables used to generate braille that conforms to a natural language's braille conventions. Therefore AT and expert handler have to negotiate braille table to be used. A more universal approach would be use special braille Unicode symbols in range from ''0x2800'' to ''0x28FF''. There is also a need to have braille output tailored to various level of granularity. For example, at a low level of granularity, the user would receive an overall description of the mathematical expression or image, while at the highest level of granularity, the user would receive a complete braille translation of the whole math expression or list of all labeled components of the image. Some data may need to be expressed in a more advanced tactile output format than refreshable braille. For example, graphical data would greatly benefit from being embossed on paper or a 2D braille display. Input devices, such as a touchpad or camera, which allow a user to communicate to the computer which parts of the graphic the user is interested in and needs to be tactilely displayed. Such interactive functionality should be left exclusively to the expert handler. This means that an expert handler must have an interactive mode and a way for an AT to trigger/toggle this mode on. In such a mode, an AT should also provide a way for the expert handler to produce more than one output stream -- such as simultaneous speech and braille output -- directly via an AT device which uses the same TTS engine or/and braille display. ---- ===== Universal Use Cases ===== ==== Universal Use Case 1: Where Am I?==== The user must have a means of obtaining all available information about the object/character with focus, beginning with the repetition of the character or the programmatic binding which describes the object with focus. The ability to query the AT to determine one's point of regard within a document and within containers in the document is essential. The user must be able to obtain information about the current point of regard at from most generic level -- what percentage of the document or section has been read, how much of the document or section remains to be read -- to the most atomic. Therefore, an AT must create a User Interface where successive "Where Am I?" queries by the user generate more verbose or more terse responses. [[[https://www.linuxfoundation.org/#fn2|footnote 2]]] ==== Universal Use Case 2: Document Summary==== A user may find it necessary to consult a "Document Summary", containing a list of the types of elements and containers in the document. The user needs to know the document title and language as well as the number of tables, links, headings, frames, forms, controls, items, images, and pages. The application may implement a document summary feature natively through its own UI instead of an accessibility API, but in the case of specialized markup, may need the assistance of an expert handler in order to present an appropriate document summary for the content being summarized. \\ ---- ====== Putting It All Together: Expert Handlers and the Flow of Control ====== The goal of the [[:accessibility:handlers:start|Expert Handlers working group]] is to define a standard so that AT software can call on expert software to interpret specialized markup. One issue that needs to be addressed is how and where (in the flow of control of reading a page) should the expert handler get invoked. Here are three possibilities: * During installation, the expert handler registers itself with the rendering application (e.g., the web browser, PDF viewer, etc.). When the page is loaded, the handler is invoked by the renderer to convert the DOM or some proxy for the DOM node to make it appear to have non-expert content. For example, it might convert the specialized markup to text or some generalized markup that AT can typically handle. * The AT traverses the DOM and when it gets to some node it doesn't understand, it consults some resource that associates a particular handler with the node name. It gets the node's content (which might include other nodes) from the DOM and passes that content to the expert handler. It then issues requests to the handler (e.g., "give me text to speak for the content"). * The AT traverses the DOM and when it gets to some node it doesn't understand, it consults some resource that associates a particular handler with the node name. It then points the expert handler to that node and issues requests to the handler. In this case, the handler is directly interacting with the DOM. Although similar, the later two cases probably have implications on the difficulty of implementation and the capabilities of the interface. Some of these are: * If the expert handler directly reads the DOM, then the expert handler must understand MSAA, [[:accessibility:iaccessible2:start|IA2]], or whatever is appropriate for the level of functionality it needs. This also implies that the rendering application must support those standards. If not, the expert handler would need to know how to access application specific DOMs. * If the expert handler is given a copy of what resides in the DOM, then interacting with the content (e.g., filling in a text field) would complicate any standard that is developed because support for passing info about input would need to be part of the standard. \\ ---- ====== Footnotes====== **Note 1.** for example, the ''FIELDSET'', ''LEGEND'', ''LABEL'' grouping and labelling mechanisms for ''FORM'' controls or the ''headers''/''id'' relationship defined for ''TABLE'' in [[http://www.w3.org/TR/html401|HTML 4.01]]/[[http://www.w3.org/TR/xhtml10/|XHTML 1.0]] or the [[http://www.w3.org/TR/aria-roadmap|ARIA]] markup "''labelledby''" and "''describedby''" * [[https://www.linuxfoundation.org/#fn1-back|return to the text following note 1]] **Note 2.** For each potential point of regard, the AT may require the following element characteristics, if they exist, depending on the type of elements in the item at the current POR: * **For all locations:** - Number of items in the document - Relative item number (n of total) within the document - Document title * **Table information if in a table:** - Caption and table summary - Content for row and column headers - Relative number (n of total number) for the table in the document - Relative row and column number (x of total, y of total) within parent table - Table type/role (data, spreadsheet, calendar) * **Section information if in a section:** - Section type (page, frame, heading) - Section title - Relative number (n of total) for the section type in the document - Level if in a section with a heading - Relative item number (n of total) within the section * **Form control information if on a form control:** - Group label for a control (such as ''LEGEND'' or ''OPTGROUP'' in HTML) if in a group - Label or alternative text (such as ''title'' or ''alt'' in HTML or ''title'' and ''desc'' in SVG) - Type of form control (role) - State - Relative number (n of total) of the parent form in the document - Relative form control number (n of total) within the parent form * **Map information if in a map:** - Relative area number (n of total) within the areas of a map - Title attribute for map * **List or menu information if within a menu or list:** - Type (role) - menu, simple list, definition list, ordered list, folder, navigation bar, and so on - Title from parent menu or list - Relative number (n of total) of parent list or menu in the document - Relative list item number (n of total) within the list * **Link information if on a link:** - Relative link number (n of total) within the document - Link state: visited, unvisited, active, focused, external or internal - Extended information, such as that provided by the title attribute * [[https://www.linuxfoundation.org/#fn2-back|return to the text following note 2]] \\ \\ \\ ---- * [[:accessibility:handlers:usecases:start|return to the Handlers SIG's Use Case page]] * [[:accessibility:handlers:draftpages:start|Expert Handlers Draft Documents Index]] * [[:accessibility:handlers:start|return to the Handlers SIG's main page]] * [[:accessibility:start|return to the Open A11y's main page]]