Uploaded image for project: 'JDK'
  1. JDK
  2. JDK-8096409

[Accessibility] Define title, description, and help

XMLWordPrintable

    • Icon: Bug Bug
    • Resolution: Fixed
    • Icon: P4 P4
    • 8u40
    • 8u40
    • javafx
    • None

      We should have more specific definition for title, description, and help.

      On Windows there are: UIA_NamePropertyId, UIA_LocalizedControlTypePropertyId, UIA_HelpTextPropertyId
      On Mac: AXTitle (or AXValue), AXDescription, AXRoleDescription, AXHelp.
      AXDescription is defined as:
      "The purpose of the element, not including the role, described in a way that is slightly more specific than the value of the AXRoleDescription attribute, but shorter than value of the AXHelp attribute. Often used to describe images or buttons with images and no title. A description is usually short and uses neither capitalization nor punctuation."
      Testing showed that setting AXDescription basically replaces AXTitle.

      On JavaFX there is
      TITLE - AXTitle on Mac and UIA_NamePropertyId on Windows
      DESCRIPTION - AXDescription on Mac and nothing on Windows.
      TOOLTIP - AXHelp on Mac and UIA_HelpTextPropertyId on Windows.

      I believe we should have:
      TITLE - AXTitle on Mac and UIA_NamePropertyId on Windows (unchanged)
      DESCRIPTION - AXRoleDescription on Mac and UIA_LocalizedControlTypePropertyId on Windows.
      HELP - AXHelp on Mac and UIA_HelpTextPropertyId on Windows.

      Note on HELP: If the Node does not answer HELP but it has a tooltip, then the textual content of the tooltip can be used as help.

            fheidric Felipe Heidrich (Inactive)
            fheidric Felipe Heidrich (Inactive)
            Votes:
            0 Vote for this issue
            Watchers:
            2 Start watching this issue

              Created:
              Updated:
              Resolved:
              Imported: