zebra_transform

3.0.0 • Public • Published
zebrajs

Zebra TransForm  Tweet

A tiny jQuery plugin for replacing and beautifying checkboxes, radio buttons, and select boxes in IE7+

npm Total Monthly License

This plugin is mainly intended to be used for styling checkboxes, radio buttons and select boxes in older versions of Internet Explorer, like IE7 and IE8, but it can also be used in other browser if you want to consistently style these form controls cross browser.

Zebra TransForm is a tiny (~5KB minified) jQuery plugin for styling the appearance of check boxes, radio buttons and select boxes without sacrificing functionality and accessibility. This jQuery plugin works by overlaying stylable elements over the native controls. It works in sync with the form's original elements copying the attached event handlers, preserving the tabindex, giving visual feedback when focused, being accessible via keyboard, and looking and behaving in the same way in all major browsers – Chrome, Firefox, Safari, Edge, Opera and Internet Explorer 7+ (in IE6 it will not replace original elements).

Demo

See the demos

Requirements

Zebra TransForm has no dependencies other than jQuery 1.7.1+

Installation

Zebra TransForm is available as an npm package. To install it use:

# the "--save" argument adds the plugin as a dependency in packages.json 
npm install zebra_transform --save

Zebra TransForm is also available as a Bower package. To install it use:

# the "--save" argument adds the plugin as a dependency in bower.json 
bower install zebra_transform --save

Load the latest version of jQuery from a CDN and provide a fallback to a local source, like:

<script src="https://code.jquery.com/jquery-3.3.1.min.js"></script>
<script>window.jQuery || document.write('<script src="path/to/jquery-3.3.1.js"><\/script>')</script> 

Load the Zebra TransForm plugin

<script src="path/to/zebra_transform.js"></script>

Alternatively, you can load Zebra TransForm from JSDelivr CDN like this:

<!-- for the most recent version, not recommended in production -->
<script src="https://cdn.jsdelivr.net/npm/zebra_transform@latest/dist/zebra_transform.min.js"></script>
 
<!-- for a specific version -->
<script src="https://cdn.jsdelivr.net/npm/zebra_transform@3.0.0/dist/zebra_transform.min.js"></script>
 
<!-- replacing "min" with "src" will serve you the non-compressed version -->

Load the style sheet file from a local source

<link rel="stylesheet" href="path/to/zebra_transform.css" type="text/css">

...or from JSDelivr CDN

<!-- for the most recent version -->
<link
  rel="stylesheet"
  href="https://cdn.jsdelivr.net/npm/zebra_transform@3.0.0/dist/css/zebra_transform.min.css">
 
<!-- replacing "min" with "src" will serve you the non-compressed version -->

Now, within the DOM-ready event do

$(document).ready(function() {
 
    // style all checkboxes, radio buttons and selects on the page
    var transform = new $.Zebra_TransForm();
 
    // unless you're planning on using the "update" method
    // you can instantiate the plugin without the "new" keyword
    // and without assigning it to a variable:
    $.Zebra_TransForm();
 
    // style checkboxes only
    $.Zebra_TransForm($('input[type="checkbox"]'));
 
    // style checkboxes and radio buttons only
    $.Zebra_TransForm($('input[type="checkbox"], input[type="radio"]'));
 
    // style checkboxes, radio buttons and selects (same as first example)
    $.Zebra_TransForm($('input[type="checkbox"], input[type="radio"], select'));
 
    // style checkboxes of a specific parent
    $.Zebra_TransForm($('#element input[type="checkbox"]'));
 
    // style only a specific element
    $.Zebra_TransForm($('#element'));
 
    // if you plan on reverting elements to their original state
    // you must instantiate the plugin with the "new" keyword
    // and assign it to a variable
    var zt = new $.Zebra_TransForm();
 
    // revert elements to their original state
    zt.remove();
 
});

Configuration options

Properties

Property Type Default Description
style_disabled_labels boolean true If set to true, labels attached to disabled checkboxes and radio buttons will also be styled to look disabled.

Methods

remove()

Call this method if you want to revert elements to their original state .

var zt = new $.Zebra_TransForm();
 
zt.remove();

Support the development of this project

Donate

Sponsors

Cross browser/device testing is done with

BrowserStack

install

npm i zebra_transform

Downloadsweekly downloads

8

version

3.0.0

license

LGPL-3.0

homepage

github.com

repository

Gitgithub

last publish

collaborators

  • avatar
Report a vulnerability