Skip to content

maxmas/pwstabs

 
 

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

36 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

####PWS Tabs is a lightweight jQuery tabs plugin to create responsive flat style tabbed content panels with some cool transition effects powered by CSS3 animations.

####PWS TABS is now Responsive! This feature is still beta, please, help me test it and find possible issues. Preview Preview

Demo

Online demo: http://alexchizhov.com/pwstabs

Preview

Install with Bower

$ bower install pwstabs

Documentation

Getting Started

  1. Include jQuery library and jQuery PWS Tabs plugin in the <head> section.
<script src="//code.jquery.com/jquery-1.11.2.min.js"</script>

<link type="text/css" rel="stylesheet" href="jquery.pwstabs.css">
<script src="jquery.pwstabs-1.2.1.js"></script>
  1. Create tabbed panels and use HTML5 data-pws-* attributes to specify the ID & Name for the tabs.
<div class="hello_world">

   <div data-pws-tab="anynameyouwant1" data-pws-tab-name="Tab Title 1">Our first tab</div>
   <div data-pws-tab="anynameyouwant2" data-pws-tab-name="Tab Title 2">Our second tab</div>
   <div data-pws-tab="anynameyouwant3" data-pws-tab-name="Tab Title 3">Our third tab</div>

</div>

data-pws-tab is used to initiate the tab and as its ID.

data-pws-tab-name is used for a tab display name.

  1. Call the plugin on the parent element to create a basic tabs interface with 100% width and 'scale' transition effect.
jQuery(document).ready(function($){
   $('.hello_world').pwstabs();
});
  1. Available parameters to customize the tabs plugin.
jQuery(document).ready(function($){
   $('.hello_world').pwstabs({

      // scale / slideleft / slideright / slidetop / slidedown / none
      effect: 'scale', 
 
      // The tab to be opened by default
      defaultTab: 1,    
 
      // Set custom container width
      // Any size value (1,2,3.. / px,pt,em,%,cm..)
      containerWidth: '100%',

      // Tabs position: horizontal / vertical
      tabsPosition: 'horizontal',
 
      // Tabs horizontal position: top / bottom
      horizontalPosition: 'top',

      // Tabs vertical position: left / right
      verticalPosition: 'left',
      
      // BETA: Make tabs container responsive: true / false (!!! BETA)
      responsive: false,

      // Themes available: default: '' / pws_theme_violet / pws_theme_green / pws_theme_yellow
      // pws_theme_gold / pws_theme_orange / pws_theme_red / pws_theme_purple / pws_theme_grey
      theme: '',
      
      // Right to left support: true/ false
      rtl: false

   });        
});

5) PWS Tabs Plugin supports Font Awesome 4.2.0

5.1) Include Font Awesome stylesheet from assets directory:

<link type="text/css" rel="stylesheet" href="../assets/font-awesome-4.2.0/css/font-awesome.min.css">

5.2) Use HTML5 `data-pws-tab-icon` attribute to set an icon. Icon names you can find here: Font Awesome Icons.

<div class="hello_world">

<div data-pws-tab="anynameyouwant1" data-pws-tab-name="Tab Title 1" data-pws-tab-icon="fa-heart">Our first tab</div>;
<div data-pws-tab="anynameyouwant2" data-pws-tab-name="Tab Title 2" data-pws-tab-icon="fa-star">Our second tab</div>
<div data-pws-tab="anynameyouwant3" data-pws-tab-name="Tab Title 3" data-pws-tab-icon="fa-map-marker">Our third tab</div>

</div>

Options

Option Default Description Available options Type
effect scale Transition effect scale / slideleft / slideright / slidetop / slidedown / none string
defaultTab 1 Which tab is chosen by default Tab ID number starts with 1 (1,2,3..) number
containerWidth 100% Tabs container width Any size value (1,2,3.. / px,pt,em,%,cm..) string
tabsPosition horizontal Define tabs position horizontal / vertical string
horizontalPosition top Define Horizontal tabs position top / bottom string
verticalPosition left Define Vertical tabs position left / right string
theme '' Change tabs theme pws_theme_violet / pws_theme_green
pws_theme_yellow / pws_theme_gold
pws_theme_orange / pws_theme_red
pws_theme_purple / pws_theme_grey
string
responsive false !!BETA!! Make tabs responsive true / false boolean
rtl false Right to left support true / false boolean

Changelog

Version 1.2.1 (23.01.2015)

  1. To facilitate the creation of new color schemes for developers SASS files added to /assets/sass/ directory.
  2. Plugins StyleSheet /assets/jquery.pwstabs-1.2.1.css was generated from new SASS files (Very few changes from previous version)

Version 1.2.0 (21.01.2015)

  1. Made plugin responsive.
  2. Added themes support. 9 color schemes are available.
  3. Optimized code a bit.
  4. Added responsive.html file in /examples/ directory.
  5. Added colors examples in /examples/examples.html

Version 1.1.4 (19.01.2015)

  1. Added new effect: none. Good for eCommerce websites. Customers don't like to wait :)
  2. Font Awesome 4.2.0 Support => Tabs Icons

Version 1.1.3 (18.01.2015)

  1. Added tabsPosition settings: horizontal / vertical.
  2. Added verticalPosition settings: left / right.
  3. Updated stylesheets.
  4. Updated examples.

Version 1.1.2 (17.01.2015)

  1. Added RTL support.
  2. Added horizontalPosition settings: top / bottom.
  3. New examples with video, Google Maps and mixed content.

Version 1.1.1 (16.01.2015)

  1. Bug fix: added class selector to tabs controller ul element. Solved issue with ul elements in tabs content.

About

jQuery Tabs Plugin

Resources

License

Stars

Watchers

Forks

Packages

No packages published

Languages

  • CSS 71.5%
  • HTML 19.0%
  • JavaScript 9.5%