Skip to page content or skip to Accesskey List.
Search evolt.org
evolt.org login: or register

Work

Main Page Content

Describing Document Text for Accessibility.

Rated 3.97 (Ratings: 14) (Add your rating)

Log in to add a comment
(8 comments so far)

Want more?

 
Picture of wiseguysonly

Tim Roberts

Member info | Full bio

User since: August 17, 2002

Last login: August 17, 2002

Articles written: 3

A key focus of accessible web site design is providing equivalent alternatives to auditory and visual content. This is normally the task of providing alternative text for images, sounds and any client-side scripts that appear in the content. One of the reasons for this focus is to assist screen-reading software to render the content in a coherent format. This enables a variety of users who cannot rely on visual presentation alone, better access to the content of your site.

However, because it is generally assumed that the raw text in a web document literally speaks for itself, it is often overlooked in accessibility checks. Although it is not dangerous to assume your text will be fine, it is worthwhile going the extra mile and adding a few behind the scenes touches that will enhance your site's accessibility.

The Document Title

The title tag in HTML, is often not used to its full capability. A well implemented document title not only adds to its accessibility, but also the usability and promotion of the site. A good format for a document title is:

Site Name: A tag line about your site.

The first thing a screen-reader often does is read aloud the document title. Using special symbols, a meaningless combination of characters to create a pretty title bar or writing something abstract can only serve to confuse the user. A good yet simple tag line also helps the user identify your document purpose. Tell people what your document (or site) is about clearly and concisely.

A site title should also begin with the name of your site. When your site is book marked it is added to the users list alphabetically. If your title begins with the actual name of your site, a user will be able to locate by scanning a list of bookmarks much quicker. It also helps to instill your identity. Avoid using words such as "Welcome to" or "The". Look at The MSN site for an example of a bad title (MSN filed under "W").

Document Language

Defining the natural language of a document is a requirement of WAI AAA compliance. The html tag can take a lang attribute which defines the main language of the document. The attribute value takes the value of a two letter language code. Here is an example of a document declared as English language:

<html lang="EN">

There are several reasons for specifying the language of a document, but from an accessibility view it assists speech software in accent and pronunciation of the document. A document's natural language may also change momentarily, and because of this the lang attribute is also available for just about all elements in HTML4.0 / XHTML1.0 tags. An example of a change in a document's language could be a quote (use the lang attribute in the blockquote) or a more common incidence would be the use of a foreign phrase that has crept into the english language like so:

So I said to her, "<span lang="FR">C'est la vie<span&gt".

Comprehensive list of ISO 639 language codes.

Dealing with Acronyms and Abbreviations.

Acronyms and abbreviations can create problems for a screen reader's pronunciation, dyslexics and anybody who hasn't got clue what they stand for. When they released HTML4.0, the W3 Consortium sought to remedy this with the introduction of special and ingeniously named acronym and abbr tags. These tags are used along with the title attribute:

 &lt;acronym title="Automobile Association"&gt;AA&lt;acronym&gt<br>
&lt;abbr title="Constant"&gt;Const.&lt;abbr&gt

If you are using Internet Explorer, hold your mouse cursor over the following acronym to see the meaning manifested: WAI. You can also try it on other acronyms that appear throughout this page. To a screen reader, the letters would be ignored and the whole meaning would be read out.

A Final Word: On Words.

As with most of the things you need to describe in your web documents, try to keep your writing as crisp and concise as possible. Read your document out aloud and note how it flows, or even better test it with a screen-reader browser such as pwWebSpeak, or IBM's Home Page Reader.

However, don't stifle your style. If your document is meant to be creatively verbose, then so be it. Take notice of other styles on the web. Note the differences between news sites, web-logs, technical articles or whatever you read. Note what makes them difficult to understand and what makes them better. To a disabled person, little details like these can make all the difference.

Writing is a very personal thing and can only be cultivated with practice, but most of the things I have written about in this article can enhance the accessibility of any type of textual content.

Tim Roberts runs a personal site devoted to accessible web design and other day to day issues called WiseGuysOnly.

He is originally from the rainy North of England, but now lives under the Sunshine of Spain's Costa del Sol. In his spare time he works as Senior Developer for Reliant Webs, looks at the stars and watches lots of videos.

Titles and tags

Submitted by bmason on August 19, 2002 - 11:04.

There is another school of thought on title tags, to put the site name last, as in Something descriptive: Site Name (just look up at the title of this page, for example). In situations where you have a user motivated to bookmark multiple pages on your site, this avoids the problem of having all the tags start exactly the same and making it hard to find the specific bookmark you want.

And as far as acronym and abbr go, you'll find better support for them in Netscape 6/Mozilla and in Opera 6. Check out also why you shouldn't tag everything acronym just for Internet Explorer's sake.

login or register to post comments

Or...

Submitted by wiseguysonly on August 19, 2002 - 11:10.

I would still suggest Site Name: Description of page.

This wouldn't cause much problem for a user scanning for an inner page. They would easily be able to locate the site, then skim the taglines. Of course they could also rename the page in their bookmarks if they wished.

login or register to post comments

Don't forget en-cockney etc.

Submitted by BenM on August 19, 2002 - 11:12.

The html tag can take a lang attribute which defines the main language of the document. The attribute value takes the value of a two letter language code.

Actually the language codes accepted may be more than two letters, acceptable language codes. Looking in Section 8.1 of The HTML 4 spec describes this in more detail.

[RFC1766] defines and explains the language codes that must be used in HTML documents.

Briefly, language codes consist of a primary code and a possibly empty series of subcodes:

language-code = primary-code ( "-" subcode )*

login or register to post comments

Dive Into Accessibility

Submitted by blackholebrain on August 19, 2002 - 20:51.

An excellent resource on this subject can be found at DiveIntoAccessibility.org, which sprang forth from Mark Pilgrim's recent online book entitled "30 days to a more accessible web site" -- which ran just a month or so ago. (There are downloadable versions of the book on his site as well). Highly recommended.

login or register to post comments

Language in xml documents

Submitted by luminosity on August 20, 2002 - 00:03.

Don’t forget that in XML you can (and should) use xml:lang to identify your document’s language. HTML from XHTML 1.1 onwards has dropped the lang attribute in favour of xml:lang.

login or register to post comments

css readers?

Submitted by janwinkler on August 21, 2002 - 00:05.

hi, what about CSS to describe the speaker, tables or background-sounds? are there any programs that can handle (voice-)css? i thought ibm's homepage reader could handle that, but it doesn't seem to ...

login or register to post comments

Re: css readers

Submitted by bmason on August 21, 2002 - 01:42.

The only one I'm aware of is Emacspeak, which is a Linux app.

Also note that in the current draft of CSS2 Revision 1, the whole aural style sheet section is now informative, not normative (browsers will not have to support aural CSS to be able to claim CSS2 compliance).

login or register to post comments

Titles

Submitted by bearwalk on August 21, 2002 - 04:00.

Describing the title as Something descriptive: Site Name has an added advantage when the site is listed in a search engine's result page, where the title is used as, well, title.

Take this page's title, for example: when listed in a SE, I wouldn't care whether the site was called evolt.org or grannysmeatballsandcomputeradvice.org, as long as it was about accessibility text.

Users often only read the first few words when scanning, so having them relevant would be important.

There is one exception to this rule IMHO: on the home page, the syntax should indeed be Site Name: Tagline.

login or register to post comments

The access keys for this page are: ALT (Control on a Mac) plus:

evolt.orgEvolt.org is an all-volunteer resource for web developers made up of a discussion list, a browser archive, and member-submitted articles. This article is the property of its author, please do not redistribute or use elsewhere without checking with the author.