Home Verkennen Help
Inloggen
epsylon
/
Elgg-Lorea-Hydra
Volgen 1
Ster 0
Vork 0
Bestanden Kwesties 0 Pull-aanvragen 0
Aftakking: master
Aftakkingen Labels
Elgg-Lorea-H...
/
docs
/
guides
/
accessibility.rst

accessibility.rst 2.7 KB
Permalink Geschiedenis Ruwe

123456789101112131415161718192021222324252627282930313233343536373839404142434445 
  1. Accessibility
    2. 

  2. =============
    3. 

  3. 

  4. This page aims to list and document accessibility rules and best practices, to help core and plugins developpers to make Elgg the most accessible social engine framework that everyone dreams of.
    5. 

  5. 

  6. .. note::
    7. 

  7. 

  8.    This is an ongoing work, please contribute on `Github <https://github.com/Elgg/Elgg>`_ if you have some skills in this field!
    9. 

  9. 

  10. Resources + references
    11. 

  11. ----------------------
    12. 

  12. 

  13. - `Official WCAG Accessibility Guidelines Overview <http://www.w3.org/WAI/WCAG20/glance/>`_
    14. 

  14. - `Official WCAG Accessibility Guidelines <http://www.w3.org/TR/WCAG/>`_
    15. 

  15. - `Resources for planning and implementing for accessibility <http://www.w3.org/WAI/managing>`_
    16. 

  16. - `Practical tips from the W3C for improving accessibility <http://www.w3.org/WAI/impl/improving>`_
    17. 

  17. - `Preliminary review of websites for accessibility <http://www.w3.org/WAI/eval/preliminary.html>`_
    18. 

  18. - `Tools for checking the accessibility of websites <http://www.w3.org/WAI/ER/tools/>`_
    19. 

  19. - `List of practical techniques for implementing accessibility <http://www.w3.org/TR/WCAG20-TECHS/Overview.html#contents>`_ (It would be great if someone could go through this and filter out all the ones that are relevant to Elgg)
    20. 

  20. 

  21. Tips for implementing accessibility
    22. 

  22. -----------------------------------
    23. 

  23. 

  24. - All accessibility-related tickets reported to trac should be tagged with "a11y", short for "accessibility"
    25. 

  25. - Use core views such as ``output/*``, and ``input/*`` to generate markup, since we can bake a11y concerns into these views
    26. 

  26. - All images should have a descriptive ``alt`` attribute. Spacer or purely decorative graphics should have blank ``alt`` attributes
    27. 

  27. - All ``<a>`` tags should have text or an accessible image inside. Otherwise screen readers will have to read the URL, which is a poor experience ``<a>`` tags should contain descriptive text, if possible, as opposed to generic text like "Click here"
    28. 

  28. - Markup should be valid
    29. 

  29. - Themes should not reset "outline" to nothing. ``:focus`` deserves a special visual treatment so that handicapped users can know where they are
    30. 

  30. 

  31. Tips for testing accessibility
    32. 

  32. ------------------------------
    33. 

  33. 

  34. - Use the tools linked to from the resources section. `Example report for community.elgg.org on June 16, 2012 <http://try.powermapper.com/Reports/a6276098-0883-4d04-849e-8c05999812f2/report/map.htm>`_
    35. 

  35. - Try different font-size/zoom settings in your browser and make sure the theme remains usable
    36. 

  36. - Turn off css to make sure the sequential order of the page makes sense
    37. 

  37. 

  38. Documentation objectives and principles
    39. 

  39. ---------------------------------------
    40. 

  40. 

  41. - Main accessibility rules
    42. 

  42. - collect and document best practices
    43. 

  43. - Provide code examples
    44. 

  44. - Keep the document simple and usable
    45. 

  45. - Make it usable for both beginner developpers and experts (from most common and easiest changes to elaborate techniques)
    46.