Difference between revisions of "Accessibility"

From Gramps
Jump to: navigation, search
m (Validate)
(Rules (draft))
Line 36: Line 36:
 
====Rules (draft)====
 
====Rules (draft)====
  
# set a name for a button with image => like atk_object_set_name()
+
# set a name for a button with image
 +
# set a description for all images and icons
 +
 
 +
<object class="GtkButton" id="date_edit">
 +
  <property name="visible">True</property>
 +
  <property name="can_focus">True</property>
 +
  <property name="receives_default">True</property>
 +
  <property name="has_tooltip">True</property>
 +
  <property name="tooltip_text" translatable="yes">Invoke date editor</property>
 +
  <property name="relief">none</property>
 +
  <child internal-child="accessible">
 +
    <object class="AtkObject" id="date_edit-atkobject">
 +
      <property name="AtkObject::accessible-name" translatable="yes">Date edition</property>
 +
    </object>
 +
  </child>
 +
  <child>
 +
    <object class="GtkImage" id="image2264">
 +
      <property name="visible">True</property>
 +
      <property name="icon_name">gramps-date</property>
 +
      <child internal-child="accessible">
 +
        <object class="AtkObject" id="image2264-atkobject">
 +
          <property name="AtkObject::accessible-description" translatable="yes">Date edition</property>
 +
        </object>
 +
      </child>
 +
    </object>
 +
  </child>
 +
</object>
 +
 
 +
 
 +
 
 
# alternative to tooltip is the description => like atk_object_set_description()
 
# alternative to tooltip is the description => like atk_object_set_description()
# for all images and icons use something => like atk_image_set_description()
 
 
# a label for other widget should use mnemonic_widget() or a relation => like atk_relation_set_add_relation()
 
# a label for other widget should use mnemonic_widget() or a relation => like atk_relation_set_add_relation()
  
'''''TODO''''' need to look further for better tricks (''previous and next sections'') and use of tooltip with ATK.
+
'''''TODO''''' need to look further for mnemonic_widget() and focus.
  
 
Think on accessibility support for widgets without Gtk label or alone image on a toggle button, by adding:
 
Think on accessibility support for widgets without Gtk label or alone image on a toggle button, by adding:

Revision as of 01:38, 20 October 2011

Accessibility support

Links

  • AEGIS acronym stands for Open Accessibility Everywhere: Groundwork, Infrastructure, Standards.
  • Possibility project is a nonprofit organization dedicated to creating groundbreaking open source software for persons with disabilities.

Gramps

Gramps aims to provide the best accessibility support. Unfortunatly, all parts of the interface have not been always tested for persons with disabilities. Gramps team try to do its best for a complete accessibility support.

Into Glade

  • Gtk label

GtkLabel automaticaly generates accessibility keys on next GtkEntry] and UndoableEntry fields. Remember that Gramps also uses custom widgets like StyledTextEditor and ValidatableMaskedEntry, which do not always provide relation with a GtkLabel.

  • Toggle buttons and Icons on toolbar

Gramps often uses GtkToggleButtons and alone GtkPixmap (image without label), this excludes blind people and generates a poor interface for accessibility.

Rules (draft)

  1. set a name for a button with image
  2. set a description for all images and icons
<object class="GtkButton" id="date_edit">
  <property name="visible">True</property>
  <property name="can_focus">True</property>
  <property name="receives_default">True</property>
  <property name="has_tooltip">True</property>
  <property name="tooltip_text" translatable="yes">Invoke date editor</property>
  <property name="relief">none</property>
  <child internal-child="accessible">
    <object class="AtkObject" id="date_edit-atkobject">
      <property name="AtkObject::accessible-name" translatable="yes">Date edition</property>
    </object>
  </child>
  <child>
    <object class="GtkImage" id="image2264">
      <property name="visible">True</property>
      <property name="icon_name">gramps-date</property>
      <child internal-child="accessible">
        <object class="AtkObject" id="image2264-atkobject">
          <property name="AtkObject::accessible-description" translatable="yes">Date edition</property>
        </object>
      </child>
    </object>
  </child>
</object>


  1. alternative to tooltip is the description => like atk_object_set_description()
  2. a label for other widget should use mnemonic_widget() or a relation => like atk_relation_set_add_relation()

TODO need to look further for mnemonic_widget() and focus.

Think on accessibility support for widgets without Gtk label or alone image on a toggle button, by adding:

<property name="AtkObject::accessible-name" translatable="yes" comments="">Name access</property>
...
<accessibility>
  <relation type="labelled-by" target="label209"/>
</accessibility>

Into python

Sample

# mark the root of this window with its PID so we can easily identify it
# as this app
root_atk = atk.get_root()
root_atk.set_description(str(os.getpid()))
label_acc = label_widget.get_accessible()
entry_acc = entry.get_accessible()
label_acc.add_relationship(atk.RelationType.LABEL_FOR, entry_acc)
entry_acc.add_relationship(atk.RelationType.LABELLED_BY, label_acc)

Validate

Accerciser provides a AT-SPI Validator Plugin #5313.

Bugs and feature requests

  • #3069: GtkTreeView is very slow / crashes with Assistive Technologies / ATK / a11y enabled
  • #5301: ATK support
  • #5308: Review focus on Editors with toggle buttons
  • #5309: Review ValidatableMaskedEntry for a better Accessibility support