Uploaded image for project: 'Moodle'
  1. Moodle
  2. MDL-7774 New formslib accessibility
  3. MDL-7780

Choose legend/header text carefully - short and non-repeated

    XMLWordPrintable

    Details

    • Type: Sub-task
    • Status: Closed
    • Priority: Minor
    • Resolution: Fixed
    • Affects Version/s: 1.8
    • Fix Version/s: 1.8
    • Labels:
      None
    • Affected Branches:
      MOODLE_18_STABLE
    • Fixed Branches:
      MOODLE_18_STABLE

      Description

      Header text is used in legend element of new forms library.

      This text is usually read together with the name of the element, in some cases it is skipped (I guess if there are several fields in the group some of them are not read to prevent repetition, I can not find any pattern in it, even-odd rule when tabbing forward first time? - I will have to read the docs one day)

      For example, sign-up form first name field is read as
      Please supply some information about yourself First name required filed Edit
      IMHO the legend should be shorter - it should not give instructions, I would propose something like "User details", the instructions could be in a notice box above the form.

      Another example group mode in course settings is read as:
      Group mode Group mode Help with Group mode Combo box No groups one of three
      the solution should be IMO to use heading "Groups" instead of the repeated "Group mode"

      Conclusion:
      1/ use short descriptive strings for headings
      2/ do not use the same string for heading and option name

        Attachments

          Activity

            People

            • Assignee:
              jamiesensei Jamie Pratt
              Reporter:
              skodak Petr Skoda
              Tester:
              Nobody
              Participants:
              Component watchers:
              Adrian Greeve, Jake Dallimore, Mathew May, Mihail Geshoski, Peter Dias, Adrian Greeve, Jake Dallimore, Mathew May, Mihail Geshoski, Peter Dias
            • Votes:
              0 Vote for this issue
              Watchers:
              1 Start watching this issue

              Dates

              • Created:
                Updated:
                Resolved:
                Fix Release Date:
                31/Mar/07