Quick guidance for referring to (parts of) HTML elements

When writing about HTML, especially in the context of accessibility audits, you always need to be very clear in what you mean. Otherwise, the guidance is challenging to read for your audience.

I recommend to always include brackets with the element names. You can differentiate attributes and values by using these words. Always include the word “value” when talking about values.

  • First mention of an element: “<h1> element”
  • First mention of an attribute: “id attribute”
  • First mention of a value: “my-great-id value”
  • Subsequent mention of an element: “<h1>” or “<h1> element”
  • Subsequent mention of an attribute: “id” or “id attribute”
  • Subsequent mention of a value: “my-great-id value”
  • Avoid the use of “tag” when the whole element is the subject of the sentence, do only use “tag” when it is specific to the start or end tag. Always specify “start tag” or “end tag”.

(This post was imported from my micro.blog.)

Tags:

Language: English

Comments & Webmentions

Comments were disabled on this page.

Preferences (beta)

Select a Theme
Font Settings
Visitor Counting

Preferences are saved on your computer and never transmitted to the server.