PHPackages                             itsjavi/fontawesome-iconpicker - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. itsjavi/fontawesome-iconpicker

AbandonedArchivedLibrary

itsjavi/fontawesome-iconpicker
==============================

Font Awesome Icon Picker plugin for Twitter Bootstrap

3.2.0(7y ago)56486.2k↓27.8%192[19 issues](https://github.com/farbelous/fontawesome-iconpicker/issues)3MITJavaScript

Since Jan 30Pushed 5y ago27 watchersCompare

[ Source](https://github.com/farbelous/fontawesome-iconpicker)[ Packagist](https://packagist.org/packages/itsjavi/fontawesome-iconpicker)[ Docs](https://farbelous.github.io/fontawesome-iconpicker/)[ RSS](/packages/itsjavi-fontawesome-iconpicker/feed)WikiDiscussions master Synced 1mo ago

READMEChangelog (10)DependenciesVersions (12)Used By (3)

fontawesome-iconpicker
======================

[](#fontawesome-iconpicker)

[![npm](https://camo.githubusercontent.com/687c29518c38e0353a52efbd6f359955d6fb86abb7a8816c78c9a57eced68a55/68747470733a2f2f696d672e736869656c64732e696f2f6e706d2f762f666f6e74617765736f6d652d69636f6e7069636b65722e7376673f7374796c653d666c61742d737175617265)](https://www.npmjs.com/package/fontawesome-iconpicker)

Font Awesome Icon Picker is a fully customizable plugin for Twitter Bootstrap, with a powerful base API, based on [bootstrap-popover-picker](https://itsjavi.github.io/bootstrap-popover-picker/)

You can use Font Awesome 5 or another font icon set of your choice (icon list is totally customizable).

[View demos](https://itsjavi.github.io/fontawesome-iconpicker/)

Instantiation
-------------

[](#instantiation)

You can call the plugin in several ways:

```
// Create instance if not exists (returns a jQuery object)
$('.my').iconpicker();
$('.my').iconpicker({ /*options*/ }); // you can also specify options via data-* attributes

// For the first matched element, access to a plugin property value
$('.my').data('iconpicker').iconpickerProperty;

// For the first matched element, call a plugin instance method with the given args
$('.my').data('iconpicker').iconpickerMethod('methodArg1', 'methodArg2' /* , other args */);

// Call and apply a plugin method to EACH matched element.
$.iconpicker.batch('.my', 'iconpickerMethod', 'methodArg1', 'methodArg2' /* , other args */); ->
```

Triggered Events
----------------

[](#triggered-events)

All of them exposes the plugin instance through event.iconpickerInstance

In order of call:

- iconpickerCreate
- iconpickerCreated
- iconpickerShow
- iconpickerShown
- iconpickerSelect (also exposes event.iconpickerItem and event.iconpickerValue)
- iconpickerUpdate
- iconpickerInvalid (also exposes event.iconpickerValue)
- iconpickerSetValue (also exposes event.iconpickerValue)
- iconpickerSetSourceValue (also exposes event.iconpickerValue)
- iconpickerUpdated
- iconpickerSelected (also exposes event.iconpickerItem and event.iconpickerValue)
- iconpickerHide
- iconpickerHidden
- iconpickerDestroy
- iconpickerDestroyed

```
// Bind iconpicker events to the element
$('.my').on('iconpickerSelected', function(event){
  /* event.iconpickerValue */
});
```

Popover placement extensions
----------------------------

[](#popover-placement-extensions)

This plugin comes with more placement options than the original Bootstrap Popover. Here are all the possibilities in detail:

```
        1 2 3 4 5
        G       6
        F       7
        E       8
        D C B A 9

0.      inline (no placement, display as inline-block)
1.      topLeftCorner
2.      topLeft
3.      top (center)
4.      topRight
5.      topRightCorner
6.      rightTop
7.      right (center)
8.      rightBottom
9.      bottomRightCorner
A.      bottomRight
B.      bottom (center)
C.      bottomLeft
D.      bottomLeftCorner
E.      leftBottom
F.      left (center)
G.      leftTop

```

Available options
-----------------

[](#available-options)

```
var options = {
    title: false, // Popover title (optional) only if specified in the template
    selected: false, // use this value as the current item and ignore the original
    defaultValue: false, // use this value as the current item if input or element value is empty
    placement: 'bottom', // (has some issues with auto and CSS). auto, top, bottom, left, right
    collision: 'none', // If true, the popover will be repositioned to another position when collapses with the window borders
    animation: true, // fade in/out on show/hide ?
    //hide iconpicker automatically when a value is picked. it is ignored if mustAccept is not false and the accept button is visible
    hideOnSelect: false,
    showFooter: false,
    searchInFooter: false, // If true, the search will be added to the footer instead of the title
    mustAccept: false, // only applicable when there's an iconpicker-btn-accept button in the popover footer
    selectedCustomClass: 'bg-primary', // Appends this class when to the selected item
    icons: [], // list of icon objects [{title:String, searchTerms:String}]. By default, all Font Awesome icons are included.
    fullClassFormatter: function(val) {
        return 'fa ' + val;
    },
    input: 'input,.iconpicker-input', // children input selector
    inputSearch: false, // use the input as a search box too?
    container: false, //  Appends the popover to a specific element. If not set, the selected element or element parent is used
    component: '.input-group-addon,.iconpicker-component', // children component jQuery selector or object, relative to the container element
    // Plugin templates:
    templates: {
        popover: '' +
            '',
        footer: '',
        buttons: 'Cancel' +
            ' Accept',
        search: '',
        iconpicker: '',
        iconpickerItem: '',
    }
};
```

###  Health Score

47

—

FairBetter than 94% of packages

Maintenance19

Infrequent updates — may be unmaintained

Popularity53

Moderate usage in the ecosystem

Community35

Small or concentrated contributor base

Maturity70

Established project with proven stability

 Bus Factor1

Top contributor holds 56.5% of commits — single point of failure

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

###  Release Activity

Cadence

Every ~71 days

Recently: every ~57 days

Total

10

Last Release

2746d ago

Major Versions

1.4.0 → 2.0.02018-03-19

1.4.1 → 3.0.02018-03-28

### Community

Maintainers

![](https://www.gravatar.com/avatar/74f57f48921e5eed849f568af00641ec34f12b85fbf9fb6e92fcecdc9a4a15df?d=identicon)[itsjavi](/maintainers/itsjavi)

---

Top Contributors

[![itsjavi](https://avatars.githubusercontent.com/u/122741?v=4)](https://github.com/itsjavi "itsjavi (35 commits)")[![mjolnic](https://avatars.githubusercontent.com/u/22207619?v=4)](https://github.com/mjolnic "mjolnic (10 commits)")[![xaguilars](https://avatars.githubusercontent.com/u/18132022?v=4)](https://github.com/xaguilars "xaguilars (4 commits)")[![aschmoe](https://avatars.githubusercontent.com/u/1634686?v=4)](https://github.com/aschmoe "aschmoe (3 commits)")[![fletchtj](https://avatars.githubusercontent.com/u/2665883?v=4)](https://github.com/fletchtj "fletchtj (1 commits)")[![HefloRicardo](https://avatars.githubusercontent.com/u/13373451?v=4)](https://github.com/HefloRicardo "HefloRicardo (1 commits)")[![dehghani-mehdi](https://avatars.githubusercontent.com/u/9152330?v=4)](https://github.com/dehghani-mehdi "dehghani-mehdi (1 commits)")[![mehmetfurkanaydin](https://avatars.githubusercontent.com/u/15969928?v=4)](https://github.com/mehmetfurkanaydin "mehmetfurkanaydin (1 commits)")[![mistermarco](https://avatars.githubusercontent.com/u/107054?v=4)](https://github.com/mistermarco "mistermarco (1 commits)")[![cosmicdreams](https://avatars.githubusercontent.com/u/852080?v=4)](https://github.com/cosmicdreams "cosmicdreams (1 commits)")[![ralphonz](https://avatars.githubusercontent.com/u/5305856?v=4)](https://github.com/ralphonz "ralphonz (1 commits)")[![szydan](https://avatars.githubusercontent.com/u/900118?v=4)](https://github.com/szydan "szydan (1 commits)")[![varunsharma27](https://avatars.githubusercontent.com/u/18154526?v=4)](https://github.com/varunsharma27 "varunsharma27 (1 commits)")[![bagherani](https://avatars.githubusercontent.com/u/12948334?v=4)](https://github.com/bagherani "bagherani (1 commits)")

---

Tags

bootstrapchrome-extensionfontfontawesomefontawesome-iconsfontawesome5icon-pickerjavascriptjsbootstrappickerFontAwesomepopovericonpicker

### Embed Badge

![Health badge](/badges/itsjavi-fontawesome-iconpicker/health.svg)

```
[![Health](https://phpackages.com/badges/itsjavi-fontawesome-iconpicker/health.svg)](https://phpackages.com/packages/itsjavi-fontawesome-iconpicker)
```

###  Alternatives

[fortawesome/font-awesome

The iconic font, CSS, and SVG framework

76.5k7.3M126](/packages/fortawesome-font-awesome)[kartik-v/bootstrap-popover-x

Bootstrap Popover Extended - Popover with modal behavior, styling enhancements and more.

1143.4M3](/packages/kartik-v-bootstrap-popover-x)[kartik-v/yii2-editable

An enhanced editable widget for Yii 2.0 that allows easy editing of displayed data with numerous configuration possibilities.

1163.2M59](/packages/kartik-v-yii2-editable)[kartik-v/yii2-widget-timepicker

Enhanced Yii2 wrapper for the bootstrap timepicker plugin (sub repo split from yii2-widgets)

404.9M14](/packages/kartik-v-yii2-widget-timepicker)[kartik-v/yii2-popover-x

An extended bootstrap 3.0 popover widget which combines both the bootstrap popover and modal features and includes various new styling enhancements.

233.4M8](/packages/kartik-v-yii2-popover-x)[mwsimple/scdatetimepicker-bundle

Symfony bundle for Bootstrap DateTime picker - Twigv3

1163.4k1](/packages/mwsimple-scdatetimepicker-bundle)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)
