Skip to content

j0inty/bootstrap-iconpicker

 
 

Repository files navigation

Build Status Code Climate Bower Tag Release Issues Issues

Iconpicker

A simple iconpicker for Bootstrap 3.x.

Please note that this project is for Bootstrap 3.x, including Glyphicons. Other icon fonts thats supports: Elusive Icons, Font Awesome, Ionicons, Map Icons, Material Design Icons, Octicons, Typicons, Weather Icons.

Table of contents

Quick start

Three quick start options are available:

  • Download the latest release: Tag.
  • Clone the repo: git clone https://github.com/victor-valencia/bootstrap-iconpicker.git.
  • Install with Bower: bower install bootstrap-iconpicker.

What's included

Within the download you'll find the following directories and files, logically grouping common assets and providing both compiled and minified variations. You'll see something like this:

bootstrap-iconpicker/
├── css/
│   ├── bootstrap-iconpicker.css
│   ├── bootstrap-iconpicker.min.css
├── js/
│   ├── iconset/
│       ├── iconset-all.min.js
│       ├── iconset-elusiveicon-2.0.0.js
│       ├── iconset-elusiveicon-2.0.0.min.js
│       ├── iconset-fontawesome-4.0.0.js
│       ├── iconset-fontawesome-4.0.0.min.js
│       ├── iconset-fontawesome-4.1.0.js
│       ├── iconset-fontawesome-4.1.0.min.js
│       ├── iconset-fontawesome-4.2.0.js
│       ├── iconset-fontawesome-4.2.0.min.js
│       ├── iconset-fontawesome-4.3.0.js
│       ├── iconset-fontawesome-4.3.0.min.js
│       ├── iconset-glyphicon.js
│       ├── iconset-glyphicon.min.js
│       ├── iconset-ionicon-1.5.2.js
│       ├── iconset-ionicon-1.5.2.min.js
│       ├── iconset-mapicon-2.1.0.js
│       ├── iconset-mapicon-2.1.0.min.js
│       ├── iconset-materialdesign-1.1.1.js
│       ├── iconset-materialdesign-1.1.1.min.js
│       ├── iconset-octicon-2.1.2.js
│       ├── iconset-octicon-2.1.2.min.js
│       ├── iconset-typicon-2.0.6.js
│       ├── iconset-typicon-2.0.6.min.js
│       ├── iconset-weathericon-1.2.0.js
│       ├── iconset-weathericon-1.2.0.min.js
│   ├── bootstrap-iconpicker.js
│   └── bootstrap-iconpicker.min.js

We provide compiled CSS and JS (bootstrap-iconpicker.*), as well as compiled and minified CSS and JS (bootstrap-iconpicker.min.*).

Documentation and live examples

See documentation and live examples here: http://victor-valencia.github.io/bootstrap-iconpicker

Bugs and feature requests

Have a bug or a feature request? Please open a new issue. Before opening any issue, please search for existing issues and read the Issue Guidelines, written by Nicolas Gallagher. You may use this JSFiddle as a template for your bug reports.

Changelog

  • v1.7.0.
    • Support for button and div tags.
    • All iconset includes the empty icon value.
    • Option rows accepts the value 0 to indicate all rows.
    • Add options:
      • align
      • header
      • footer
    • Add methods:
      • setAlign
      • setHeader
      • setFooter
    • Support for 1 more icon fonts:
  • v1.6.0.
    • Restructure iconset configuration.
    • Option iconset accepts String and Object (Limit your iconset option).
    • Add options:
      • arrowPrevIconClass
      • arrowNextIconClass
      • labelHeader
      • labelFooter
    • Add methods:
      • setArrowClass
      • setArrowPrevIconClass
      • setArrowNextIconClass
      • setCols
      • setIconset
      • setLabelHeader
      • setLabelFooter
      • setPlacement
      • setRows
      • setSearch
      • setSearchText
      • setSelectedClass
      • setUnselectedClass
    • Support for 6 more icon fonts:
  • v1.5.0.
    • Add search field.
  • v1.4.0.
    • Support for customization of the component.
  • v1.3.1.
    • Bind body click to solve issues for ajax loaded pages. @crlcu
  • v1.3.0.
  • v1.2.1.
  • v1.2.0.
    • Add the method setIcon.
  • v1.1.0.
    • Dispatch change event when an iconpicker is changed. @promatik
  • v1.0.1.
    • Reducing the size of the source file.
  • v1.0.0.
    • Version initial.

Versioning

For transparency into our release cycle and in striving to maintain backward compatibility, Bootstrap-Iconpicker is maintained under the Semantic Versioning guidelines. Sometimes we screw up, but we'll adhere to those rules whenever possible.

Releases will be numbered with the following format:

<major>.<minor>.<patch>

And constructed with the following guidelines:

  • Breaking backward compatibility bumps the major while resetting minor and patch
  • New additions without breaking backward compatibility bumps the minor while resetting the patch
  • Bug fixes and misc changes bumps only the patch

For more information on SemVer, please visit http://semver.org/.

Author

@victor-valencia

Contributors

@victor-valencia, @promatik, @jwhitfieldseed, @crlcu

License

Licensed under the MIT license.

Packages

No packages published

Languages

  • CSS 47.9%
  • JavaScript 29.7%
  • HTML 22.4%