Main content

complementary

Characteristics

Superclass Role:

  • landmark

Inherited States and Properties:

  • aria-atomic
  • aria-busy (state)
  • aria-controls
  • aria-describedby
  • aria-disabled (state)
  • aria-dropeffect
  • aria-expanded (state)
  • aria-flowto
  • aria-grabbed (state)
  • aria-haspopup
  • aria-hidden (state)
  • aria-invalid (state)
  • aria-label
  • aria-labelledby
  • aria-live
  • aria-owns
  • aria-relevant

Name From:

  • author

A supporting section of the document, designed to be complementary to the main content at a similar level in the DOM hierarchy, but remains meaningful when separated from the main content.

Any section of the document that supports but is separable from the main content, but is meaningful on its own even when separated from it. Contents such as advertisements on the page are marked as complementary landmarks. HTML 5 aside tag does the same work that complementary role does. 

There are various types of content that would appropriately have this role. For example, in the case of a portal, this may include but not be limited to show times, current weather, related articles, or stocks to watch. The complementary role indicates that contained content is relevant to the main content. If the complementary content is completely separable main content, it may be appropriate to use a more general role.

User agents should treat elements with the role of complementary as navigational landmarks. Screen readers have good support with complementary landmark and will announce the beginning and end of the landmark.

Syntax

<div role="complementary"> </div>
More in this category: « composite command  »