Ethical Framework for Local Government Service | Carlow.ie

Carlow Kilkenny Dog Shelter Closed | Carlow.ie

Contact Us | Carlow.ie

Housing For All | Carlow.ie

Air Pollution | Carlow.ie

Call and Collect | Carlow.ie

Public Participation Network | Carlow.ie

Press Release for Immediate Release – 7th May 2020 | Carlow.ie

Press Release for Immediate Release – 1st April 2020 – Planning Services | Carlow.ie

Open Call for New Membership of FORM-Designmade in Carlow. | Carlow.ie

Webpages should provide a way to skip to the main content of the page. There are 
several ways to accomplish this.

The most common solution is a "Skip to content" link:

```html
<a href="#main">Skip to main content</a>
...
<div id="main">
<h1>Welcome to this page</h1>
```

This link is usually hidden from users unless selected, so it doesn't need to compromise the look of 
your page.

Alternatively, you can use the `<main>` HTML landmark:

```html
<main>
<h1>Welcome to this page</h1>
``` 

or an ARIA role of `main`:

```html
<div role="main">
<h1>Welcome to this page</h1>
``` 

Generally best practice is to combine these approaches, using `<main>` landmark with a link pointing to it:

```html
<a href="#main">Skip to main content</a>
...
<main id="main">
<h1>Welcome to this page</h1>
```

This approach will be most widely supported by screen readers and understood by the highest number of users.

# Justification

Many users of assistive technology are only able to experience content sequentially - that is, they must
step through each part of the page, one part at a time. Often this is a slow process, potentially 
hampered by a physical impediment.

Most web pages have a header containing branding and navigation on every page. Stepping through 
this repetitive part of the page can be hugely frustrating for users of assistive technology. For example, 
a blind user may have to listen to hundreds of navigation links before they can reach the content on a page.

Adding a means to skip directly to the page content massively enhances the experience for these users.

Skip to content links do not need to be visible to everyone. A common implementation means they are only 
experienced by users via the tab key or other assistive technology 
(see [skipping to navigation links](https://webaim.org/techniques/skipnav/) from WebAIM). 

# Methodology

It is not sufficient to include a "skip to content" link. The link must work, and it must appear early
enough in the page to be useful.

* If the page has less than 500 visible characters, it does not require a "skip to content" link.
* If the page has a main landmark (e.g. `<main>` or `role="main"`) it does not require a "skip to content" link.
* Silktide looks for a link with a fragment (e.g. `#main`) pointing to a lower part of the page. The link 
  must not be adjacent to other text nodes. 
* The fragment must point to an ID that exists, or this check will raise an error.
* The link must appear before 500 visible characters of text in the page, or this check will raise an error.

The text inside the link is not considered, as this test must support a wide range of languages.

# Learn more

More about [skipping to navigation links](https://webaim.org/techniques/skipnav/) from WebAIM and 
see [W3C's recommended technique](https://www.w3.org/TR/2016/NOTE-WCAG20-TECHS-20161007/G1).

skip-to-content

December 2023

November 2023

Carlow County Council

	Title / URL	Issues
	Ethical Framework for Local Government Service \| Carlow.iewww.carlow.ie/ethical-framework-for-local-government-service/	1
	Carlow Kilkenny Dog Shelter Closed \| Carlow.iewww.carlow.ie/carlow-kilkenny-dog-shelter-closed/	1
	Contact Us \| Carlow.iewww.carlow.ie/contact-us/	1
	Housing For All \| Carlow.iewww.carlow.ie/housing-for-all/	1
	Air Pollution \| Carlow.iewww.carlow.ie/all-council-services/environment/air-pollution/	1
	Call and Collect \| Carlow.iewww.carlow.ie/call-and-collect/	1
	Public Participation Network \| Carlow.iewww.carlow.ie/all-council-services/community/public-participation-network/	1
	Press Release for Immediate Release – 7th May 2020 \| Carlow.iewww.carlow.ie/press-release-for-immediate-release-7th-may-2020/	1
	Press Release for Immediate Release – 1st April 2020 – Planning Services \| Carlow.iewww.carlow.ie/5001-2/	1
	Open Call for New Membership of FORM-Designmade in Carlow. \| Carlow.iewww.carlow.ie/open-call-for-new-membership-of-form-designmade-in-carlow/	1

Allow users to quickly skip to content

Carlow County Council

Where this issue has occurred