Skip to content

LOUISINTERNET/es6-skip-links

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

41 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

SkipLinks

Data attributes

data-skip-link

Create a relationship between two elements. The element with the data attribute become clickable, no matter if it is an anchor, an list element or everything else. The value of the data attribute generates the relationshipt to an container with this particular id.

<span data-skip-link="rel-container">Link</span>
<div id="rel-container">Content</div>

data-skip-close

This data attribute is for an additional close link. The value is the ID of the container which would be closed.

<span data-skip-link="rel-container">Link</span>
<div id="rel-container">
  <p>Content</p>
  <span data-skip-close="rel-container">X</span>
</div>

data-skip-group

With this data attribute you can group links together. It only can be one open so the siblings close every time another group member is clicked.

<ul>
  <li>
    <a href="#" data-skip-link="content-1" data-skip-group="nav">Content One</a>
    <a href="#" data-skip-link="content-2" data-skip-group="nav">Content Two</a>
  </li>
</ul>
<div id="content-1">Content One</div>
<div id="content-2">Content Two</div>

data-skip-breakpoint

To stop the skip link functionality on a specific breakpoint you can use the data-skip-breakpoint attribute. If you only set one number the value stands for max. If you set two values the first in min and the second max.

<span data-skip-link="rel-container" data-skip-breakpoint="400, 960">Link</span>
<div id="rel-container">Content</div>

data-skip-breakpoint-close

If you want to close an open target on a specific breakpoint you can use the data-skip-breakpoint plus the data-skip-breakpoint-close attribute.

<span
  data-skip-link="rel-container"
  data-skip-breakpoint="960"
  data-skip-breakpoint-close
  >Link</span
>
<div id="rel-container">Content</div>

data-skip-state

With the value open this data attribute trigger the skip link just on load so that it woult be active.

<span data-skip-link="rel-container" data-skip-state="open">Link</span>
<div id="rel-container">Content</div>

data-skip-class

By default the class that whould be toggled is "is-visible". If you want your own class that whould be toggled add the data-skip-classattribute

<span data-skip-link="rel-container" data-skip-class="my-is-visible-class"
  >Link</span
>
<div id="rel-container">Content</div>

data-skip-ignore-body

By default a click on every element which is not a skip link or target trigger the close event for all open skip targets. With the data-skip-ignore-body attribute the global close whould be ignored on this element.

<span data-skip-link="rel-container" data-skip-ignore-body="true">Link</span>
<div id="rel-container">Content</div>

Events

skipper:stateChange

With the skipper:stateChange you can add own logic to changes of each skip-link. The event argument contains the changed skip-link under the detail attribute.

document.addEventListener('skipper:stateChange', (e) => {
console.log(`${e.type}: `, e.detail.cache); });

About

No description, website, or topics provided.

Resources

Stars

Watchers

Forks

Packages

No packages published

Contributors 4

  •  
  •  
  •  
  •