Accessibility/Learning Disabilities: Difference between revisions

From MozillaWiki
Jump to navigation Jump to search
No edit summary
No edit summary
Line 1: Line 1:
= Purpose =
= Purpose =


To develop an expert system recommending actions an AT might take in response to a queue of live region changes over time.


= Proposed API =
= Proposed API =


Here are some rough ideas for a live region library, which would manage the queue. For the moment, I'd like to assume the library is written in
 
Python for the sake of syntax.


== Processing a change ==
== Processing a change ==


<pre>
def processEvent(node, event_type):
  '''
  Processes a live region event by adding a recommendation to the queue for later use by the AT.


  @param node: A hashable object representing the live region
  @type node: hashable
  @param event_type: Constant representing the kind of change: node addition, node removal
  or text insert/delete
  @type event_type: integer
  '''
</pre>


== Getting a recommendation ==
== Getting a recommendation ==


<pre>
def getNextRecommendation():
  '''
  Retrieves the next recommendation from the queue.
  @return: Recommendation of how to announce a live region change
  @rtype: Recommendation
  '''
</pre>


<pre>
def clearQueue():
  '''
  Clears the queue of recommendations.
  '''
</pre>


== Accessibility callbacks ==
== Accessibility callbacks ==


Allows the AT to register methods the library should call to get information about accessibles. These callbacks allow the library to be cross-platform.
<pre>
def registerGetParent(func):
  '''
  Registers a callback for getting the parent of a given node.
 
  @param func: Function that returns a parent node of the given node.
  @type func: callable
  '''
</pre>


* registerGetControlsRelation(func)
* registerGetLabelledByRelation(func)
* registerGetDescribedByRelation(func)
* registerGetLiveRegionAttrsProperties()
* '''What else?'''


== Rude change callbacks ==  
== Rude change callbacks ==  


Original spec by Aaron. '''But don't the rude changes get pushed to the library via the processEvent method anyways? Couldn't the return value on that method indicate whether getNextRecommendation should be called immediately or not?'''


* registerPushListener() // Register a listener so that if rude changes occur, the library can call back in and push a region
* setLastPushSucccess(boolean)    // Was the last live region push successfully presented?


== Settings ==
== Settings ==
<pre>
def setGlobalSettings(settings):
  '''
  Updates settings for all live regions, either on the current page or across pages.
  @param settings: Name/value setting pairs. Either all settings or a subset to update.
  @type settings: dictionary
  '''
</pre>
<pre>
def setNodeSettings(node, settings):
  '''
  Updates settings for a particular live region. Any settings not defined here fall
  back to using the global equivalents. Setting any particular setting name to value
  None removes that setting from this node, and forces it to use the global value for
  the setting.
  @param node: A hashable object representing the live region
  @type node: hashable
  @param settings: Name/value setting pairs. Either all settings or a subset to update.
  @type settings: dictionary
  '''
</pre>
<pre>
def clearNodeSettings(node):
  '''
  Forces the particular live region to use the global settings.
  @param node: A hashable object representing the live region
  @type node: hashable
  @param settings: Name/value setting pairs. Either all settings or a subset to update.
  @type settings: dictionary
  '''
</pre>
'''Probably need getters too.'''
= Recommendation objects =
<pre>
class Recommendation(object):
  '''
  @ivar event_type: Type of event that triggered the recommendation
  @type event_type: integer
  @ivar node: Object the recommendation concerns
  @type node: hashable
  @ivar suggested_text: Suggested text to announce
  @type suggested_text: string
  @ivar all_text: All text in the live region
  @type all_text: string
  '''
</pre>
'''What else?'''

Revision as of 18:33, 1 June 2007

Purpose

Proposed API

Processing a change

Getting a recommendation

Accessibility callbacks

Rude change callbacks

Settings

Retrieved from "https://wiki.mozilla.org/index.php?title=Accessibility/Learning_Disabilities&oldid=58463"