Differences between version 13 and previous revision of RealWorldWebCompliance.
Other diffs: Previous Major Revision, Previous Author, or view the Annotated Edit History
| Newer page: | version 13 | Last edited on Friday, May 20, 2005 1:58:17 pm | by AristotlePagaltzis | Revert |
| Older page: | version 12 | Last edited on Friday, May 20, 2005 1:51:33 pm | by AristotlePagaltzis | Revert |
@@ -21,15 +21,15 @@
* Don't put tooltips in the <tt>alt</tt> attribute. They belong in <tt>title</tt>.
Put an empty <tt>alt</tt> attribute on your images as a rule of thumb. Only contain when the image actually replaces part of a sentence or is otherwise part of the text should the <tt>alt</tt> attribute contain any text, which should be what the image replaces. Imagine your content being read aloud: would the content <tt>alt</tt> attribute make sense as part of the text? If not, its alternative text should be empty. This means decorative and even illustrative images should not containt alternative text.
-* Be careful with your comments:
+* Be careful with your comments: <tt><! ></tt> by themselves delimit a __declaration block__, and the <tt>--</tt> double dashes can be used to open and close comments inside such a block. This means
:
* Don't use <tt><!--</tt> and <tt>--></tt> in <tt><script></tt> tags without making sure they are matched. InternetExplorer won't care, but [Mozilla] will consider the rest of your page commented out.
- * The popular <tt><!----------></tt> style "separators" are dangerous. With an odd
numbers of dashes, the
comment does not close
, so the rest of your page will be commented out. Best to avoid any more than single dashes altogether inside comments
.
+ * The popular <tt><!----------></tt> style "separators" are dangerous. With any
numbers of dashes that is not a multiple of four
, you will leave an open
comment section around
, so the rest of your page will be commented out.
- (Actually,
<! ...
> is a __declaration__, and --...
-- inside a declaration is
a comment. So, putting -- inside it
actually closes your comment, and another -- starts
a new
comment. So
only use double dashes at the start and end of the comment!)
+ * Using
<tt
>--</tt>
inside a comment actually closes it. The rest of what was supposed to be
a comment will spill into your page
. Best to
only use double dashes at the start and end of the comment and avoid any more than space-separated single dashes altogether inside it.
* Don't use <tt>document.all</tt> in your JavaScript
* Don't use MSXMLDOC
