selectable-button.js
====================

A [jQuery][jquery] plugin for turning a `<select>` DOM element into a selectable button, where the button's content is the selected `<option>`'s content, and clicking on the button shows a dropdown of all non-selected `<options>`s.

This plugin generates HTML intended to be styled by [Twitter Bootstrap's][bootstrap] [button dropdown menus][bootstrap-button-dropdowns].


Usage
-----

Include `selectable-button.js` on the HTML page after jQuery:

    <script src="jquery.js"></script>
    <script src="selectable-button.js"></script>

Given the following `<select>` DOM element:

    <select>
      <option>Choice 1</option>
      <option>Choice 2</option>
      <option>Choice 3</option>
      <option>Choice 4</option>
    </select>

Create a selectable button with the following call:

    $('select').selectableButton();


License
-------

See `LICENSE.MIT.txt`, which is a standard [MIT license][mit].



[jquery]: http://jquery.com
[bootstrap]: http://twitter.github.com/bootstrap
[bootstrap-button-dropdowns]: http://twitter.github.com/bootstrap/components.html#buttonDropdowns
[mit]: http://opensource.org/licenses/mit-license.php

selectable-button.js
====================
[![Build Status](https://secure.travis-ci.org/jschementi/selectable-button.png)](http://travis-ci.org/jschementi/selectable-button)

A [jQuery][jquery] plugin for turning a `<select>` DOM element into a selectable button, where the button's content is the selected `<option>`'s content, and clicking on the button shows a dropdown of all non-selected `<options>`s.

This plugin generates HTML intended to be styled by [Twitter Bootstrap's][bootstrap] [button dropdown menus][bootstrap-button-dropdowns].


Usage
-----

Include `selectable-button.js` on the HTML page after jQuery:

    <script src="jquery.js"></script>
    <script src="selectable-button.js"></script>

Given the following `<select>` DOM element:

    <select>
      <option>Choice 1</option>
      <option>Choice 2</option>
      <option>Choice 3</option>
      <option>Choice 4</option>
    </select>

Create a selectable button with the following call:

    $('select').selectableButton();


License
-------

See `LICENSE.MIT.txt`, which is a standard [MIT license][mit].



[jquery]: http://jquery.com
[bootstrap]: http://twitter.github.com/bootstrap
[bootstrap-button-dropdowns]: http://twitter.github.com/bootstrap/components.html#buttonDropdowns
[mit]: http://opensource.org/licenses/mit-license.php

Add build status to readme
Add build status to readme