skipLinkTarget skip link target

Current accessibility standards (WCAG, 508) require that some mechanism be provided to allow end users to skip over blocks of content that are repeated on all web pages, such as navigation links. The typical solution for meeting this requirement is to insert a "skip link" at the start of the page. The skip link allows the user to jump directly to the unique page content, thus saving both keyboard and screen reader users the trouble of traversing repetitive content.

While it is possible for ADF Faces application developers to implement their own skip links using af:goLink, the af:skipLinkTarget tag simplifies this task. When the af:skipLinkTarget tag is present in an ADF Faces page, ADF Faces automatically creates a skip link at the start of the page. This skip link jumps directly to the specified skip link target. There is no need to manually insert an af:goLink or a target anchor.

One of the advantages of the af:skipLinkSolution is that the skip link provided by ADF Faces is usually hidden from view. The skip link is automatically shown when it receives the focus (ie. when the end user tabs to the skip link, which is the first tab stop in the page), and is automatically hidden again as soon as the user activates the skip link or tabs to the next element. This approach avoids extra visual clutter in the chrome area of the page. There is no need to make extra room in the UI for the skip link content - it is displayed on demand.

Note that the af:skipLink tag has the following requirements:

Warnings are logged in the event that any of these requirements are not met. The easiest way to avoid these issues is to place the af:skipLinkTarget inside any of the ADF Faces panel components (inside of an af:document of course). Application developers are encouraged to specify the af:skipLinkTarget once in a page template, rather than attempt to add this individually to every page.


Name Type Supports EL? Description
text String Yes an optional value to use as the text of the skip link. If no value is specified a default value (eg. "Skip to contents") will be provided.
accessibilityHint String Yes an optional hint to help screen reader users locate accessibility settings. It may be difficult for screen reader users to determine whether they have enabled the the appropriate preference to provide access to screen reader optimized content. It may also be difficult for screen reader users to locate the UI for modifying accessibility preference. The accessibilityHint attribute specifies a message to include with the skip link to help clarify how to access accessibility preferences. This message is rendered in a manner such that it is read by screen readers, but not visible to non-screen reader users.