🔥 HEADS UP! You are in the Vue 2 compatible branch, check the branch for Vue 3 support.
Helps people who only use the keyboard to jump to what matters most
The population grows very fast nowadays and with that the number of visually impaired increases as well. Did you know that we have over 350 million visually impaired people in the world?
However, we are responsible for doing our utmost to make our applications usable and accessible to everyone.
"Skip to content" or "skip to a section" of your site is one of the most common accessibility techniques today, but not as used as it should be.
This pattern is detailed in the Techniques for WCAG 2.0 in notes G1 and G124, and also served as the inspiration for creating this component.
// npm npm install -S @vue-a11y/skip-to // yarn yarn add @vue-a11y/skip-to// main.jsimportVuefrom'vue'importVueSkipTofrom'@vue-a11y/skip-to'Vue.use(VueSkipTo)newVue({//...})// App.vue <template> <divid="app"> <VueSkipToto="#main"label="Skip to main content" /> <!-- header, navigation, and more --> <mainid="main"> <!-- content --> </main> </div> </template> <script>exportdefault{ name:'app' components:{ Logo, VueSkipTo, },//...}</script>To use multiple links, set an array into the to prop with the following shape:
[{"anchor": "<STRING>",// destination id"label": "<STRING>"// link text}//...]// App.vue <template> <divid="app"> <vue-skip-tolist-label="Skip to":to="[{anchor: '#main', label: 'Main content' },{anchor: '#footer', label: 'Footer' }, ]" ></vue-skip-to> <!-- header, navigation, and more --> <mainid="main"></div> <footerid="footer"></div> </div> </template><!--omitted --><scriptsrc="https://unpkg.com/vue"></script><scriptsrc="https://unpkg.com/@vue-a11y/skip-to"></script></head><body><divid="app"><vue-skip-toto="#main"></vue-skip-to><!-- header, navigation, and more --><mainid="main"><!-- content --></main></div><script>newVue({el: "#app"})</script></body></html>| Prop | Data Type | required | Description | Default |
|---|---|---|---|---|
to | String | Array | false | Destination ID or array of destination objects | '#main' |
label | String | false | Skip link text content | 'Skip to main content' |
list-label | String | false | Skip link list label text | 'Skip to' |
@vue-a11y/skip-to checks if you are using the vue-router, watches changes to $route.path and send focus to the vue-skip-to wrapper.
Recommendation: To make more sense, use the VueSkipTo component right after the root element of your app.
Read more about accessible routing:
- Improved accessible routing in Vue.js (updated)
- What we learned from user testing of accessible client-side routing techniques with Fable Tech Labs
Override the default styles by targeting the following:
.vue-skip-to{} .vue-skip-to__link{} .vue-skip-to__nav{} .vue-skip-to__nav-list{} .vue-skip-to__nav-list-item{}git clone https://github.com/vue-a11y/vue-skip-to.git npm install npm run dev npm run test:e2eOr run Cypress on interactive mode
npm run test:e2e:openThis component was inspired by this article.
- This component working in all modern browsers and IE9;
- Ensures that the target element receives focus, even if it is not a tag that naturally receives focus as the tag
inputanda. In this case, thedivare also given the focus and thetabindexattribute with the value of-1; - Add focus to the destination, even when the address bar already has the corresponding hash;
- From typos in documentation to coding new features;
- Check the open issues or open a new issue to start a discussion around your feature idea or the bug you found;
- Fork repository, make changes and send a pull request;
Follow us on Twitter @vue_a11y
Thank you
