I'm learning HTML5 and have been given a project of converting CSS Zen Gardens into a HTML5 semantic version. I've been able to convert most of it with ease, however the links / navigation at the bottom are giving me some problems.
What would be the best way of converting this / handling multiple navigations?
<div id="linkList2">
<div id="lselect">
<h3 class="select"><span>Select a Design:</span></h3>
<ul>
<!-- Links -->
</ul>
</div>
<div id="larchives">
<h3 class="archives"><span>Archives:</span></h3>
<ul>
<!-- Links -->
</ul>
</div>
<div id="lresources">
<h3 class="resources"><span>Resources:</span></h3>
<ul>
<!-- Links -->
</ul>
</div>
</div>
At the moment I'm torn between thinking linkList2 should be a section, and each of the child div elements should be nav elements, or that linkList2 should be a nav, with the child div elements being sections.
If you make linkList2 a section then your semantics are 'here is navigation for this section'. Note that nav is already sectioning content, so wrapping it in a section would be somewhat redundant.
Also note that the spec says:
Not all groups of links on a page need to be in a nav element — the element is primarily intended for sections that consist of major navigation blocks.
There's no need to put every set of links in a nav just for the sake of it. I think your approach of making linkList2 a nav would be best, though I wouldn't worry too much about making the child elements section:
<nav id="linkList2">
<div id="lselect">
<h1 class="select"><span>Select a Design:</span></h1>
<ul>
<!-- Links -->
</ul>
</div>
<div id="larchives">
<h1 class="archives"><span>Archives:</span></h1>
<ul>
<!-- Links -->
</ul>
</div>
<div id="lresources">
<h1 class="resources"><span>Resources:</span></h1>
<ul>
<!-- Links -->
</ul>
</div>
</nav>
As I mentioned above, nav is sectioning content, so all the headings should really be h1 as they are all the highest level headings in their respective sections (I've changed them above). However I think it is still permissible, from a practical accessibility standpoint, to leave them as h3 if they are preceded by h2 and h1 headings in the markup.
The other approach which would be fine is:
<div id="linkList2">
<nav id="lselect">
<h1 class="select"><span>Select a Design:</span></h1>
<ul>
<!-- Links -->
</ul>
</nav>
<nav id="larchives">
<h1 class="archives"><span>Archives:</span></h1>
<ul>
<!-- Links -->
</ul>
</nav>
<nav id="lresources">
<h1 class="resources"><span>Resources:</span></h1>
<ul>
<!-- Links -->
</ul>
</nav>
</div>
As I mentioned before, don't wrap in a section (or article), nav is enough.
A final point, since your question is about semantics. I know you're working on CSS Zen Garden's markup so the point is probably to have elements in your new page to correspond to all the old ones so that all the stylesheets still work, but you should know that this is not an example of good 'semantic markup'. Here are some things you should be aware of:
span elements within the headings and (more arguably) the child div elements lselect, larchives and lresources.id and class attributes everywhere. For instance there is no need to have both an id of lselect and a class of select, instead you could just use a selector #lselect h1.linkList2 is a terrible id semantically. It's not on a linked list and whether or not it's the second one depends on all the rest of the markup. The ids and class names used are also part of semantic markup.You should use the <nav> HTML5 element as this is not only the most semantic element for what you want, but it also allows people using screen readers to navigate the page using landmarks (the <nav> will correspond to the navigation landmark).
Now, if there are multiple regions of your website with links (e.g.: Primary navigation and secondary navigation), you should make sure that the different <nav> elements are correctly labelled. This makes screen readers announce the landmarks correctly (e.g.: "Primary, navigation", "Secondary, navigation"), instead of generically announcing everything as "navigation"), which could be confusing.
To label <nav> elements, you can do one of the following:
Use aria-label to provide text alternates to the elements.
<nav aria-label=’primary’>
<ul>
...List on links here...
</ul>
</nav>
<nav aria-label=’secondary’>
<ul>
...List on links here...
</ul>
</nav>
If there is text on screen that can make the region identifiable (e.g.: "Related Content"), you can make use of aria-labelledby.
<nav aria-label="Site Menu">
<ul>
...List on links here...
</ul>
</nav>
<article>
<h1>Title</h1>
...
<nav aria-labelledby="id-1">
<h2 id="id-1">
Related Content
</h2>
<ul>
...List on links here...
</ul>
</nav>
</article>
Here are a few resources that explain this further:
If you love us? You can donate to us via Paypal or buy me a coffee so we can maintain and grow! Thank you!
Donate Us With