Skip to content

mashalla/tabpane

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

17 Commits
 
 
 
 
 
 
 
 

Repository files navigation

Accessible TabPanel

Plugin based on original tab pane by akaIDIOT. Its functionally is enhanced for accessible use (keyboard navigation and screen reader support).

Simple Tab Pane is a very simple MooTools class that allows you to create a tab pane from a single element. All it needs is a selector for the tabs (the headers, so to say) and a selector for the corresponding contents.

Because all the tab switching is based on delegated events, no effort is needed to add tabs: simply add elements with the correct class names (or tag names if you specified your selector as such) and you're done!

Styling is left completely up to the user. Whether you want an inline list as the tab headers or a series of links, you're the boss.

Implementation note: because of the way event delegation works, event propagation doesn't work properly when dealing with delegations. Sadly, this handicaps the removing of tabs via items inside the tab header a bit. See the included demo for an implementation of this.

A demo is included in the download package.

Screenshot

How To Use

All you'll need to create a tab pane on your page is instantiate a new TabPane and supply it the container (or its id) in which your tabs and corresponding contents reside:

#JS
var myTabPane = new TabPane('tabs');

Default, it uses the selector '.tab' for a the tab headers and '.content' for the corresponding content sections and adds the css class 'active' to the selected tab header. These values are customizable in the constructor. Should you for example want to select all li elements as tab headers with p elements as the contents, your call to the constructor would look as such:

#JS
var myTabPane = new TabPane('tabs', {
    tabSelector: 'li',
    contentSelector: 'p'
});

Constructor

Syntax:

#JS
var myTabPane = new TabPane(container[, options]);

Arguments:

  1. container - (string or element) The element that contains the tab components (tab headers and contents).
  2. options - (object, optional) On options object, see below.

Options:

  • tabSelector - (string) CSS selector for the tab headers within the container.
  • contentSelector - (string) CSS selector for the tab contents within the container.
  • activeClass - (string) Class name for the active tab header.

Events:

  • change - (function) Function executed when a tab is selected. The index of the selected tab is passed as the only argument.

closeTab

Allows closing of a certain tab and its corresponding content element from the container.

Syntax:

#JS
myTabPane.closeTab(index);

Arguments:

  1. index - (number) The index of the tab to remove.

Events:

  • close - (function) Function executed when a tab is removed. The index of the removed tab is passed as the only argument.
  • change - (function) Fired inadvertedly by changing the tab (see the demo and source for this).

About

No description, website, or topics provided.

Resources

Stars

Watchers

Forks

Packages

No packages published