{"id":2386000,"url":"https://itsjavi.github.io/fontawesome-iconpicker","last_synced_at":"2025-07-21T08:31:20.460Z","repository":{"id":17900673,"uuid":"20855538","full_name":"itsjavi/fontawesome-iconpicker","owner":"itsjavi","description":"Font Awesome Icon Picker component for Bootstrap.","archived":true,"fork":false,"pushed_at":"2020-06-04T18:08:09.000Z","size":2532,"stargazers_count":559,"open_issues_count":19,"forks_count":196,"subscribers_count":29,"default_branch":"master","last_synced_at":"2024-04-13T06:33:56.753Z","etag":null,"topics":["bootstrap","chrome-extension","font","fontawesome","fontawesome-icons","fontawesome5","icon-picker","javascript","js"],"latest_commit_sha":null,"homepage":"https://itsjavi.com/fontawesome-iconpicker/","language":"JavaScript","has_issues":false,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/itsjavi.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":"CONTRIBUTING.md","funding":".github/FUNDING.yml","license":"LICENSE","code_of_conduct":"CODE_OF_CONDUCT.md","threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null},"funding":{"issuehunt":"farbelous","custom":"https://www.paypal.me/metaunicorn/20"}},"created_at":"2014-06-15T13:02:49.000Z","updated_at":"2024-04-12T16:49:26.000Z","dependencies_parsed_at":"2022-08-20T01:12:29.047Z","dependency_job_id":null,"html_url":"https://github.com/itsjavi/fontawesome-iconpicker","commit_stats":null,"previous_names":["farbelous/fontawesome-iconpicker"],"tags_count":18,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/itsjavi%2Ffontawesome-iconpicker","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/itsjavi%2Ffontawesome-iconpicker/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/itsjavi%2Ffontawesome-iconpicker/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/itsjavi%2Ffontawesome-iconpicker/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/itsjavi","download_url":"https://codeload.github.com/itsjavi/fontawesome-iconpicker/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":226892127,"owners_count":17698879,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["bootstrap","chrome-extension","font","fontawesome","fontawesome-icons","fontawesome5","icon-picker","javascript","js"],"created_at":"2024-01-24T02:43:27.314Z","updated_at":"2024-11-28T09:31:09.152Z","avatar_url":"https://github.com/itsjavi.png","language":"JavaScript","funding_links":["https://issuehunt.io/r/farbelous","https://www.paypal.me/metaunicorn/20"],"categories":["Bootstrap Fontawesome Icon Picker"],"sub_categories":[],"readme":"fontawesome-iconpicker\n========================\n\n\u003c!--[![Build Status](https://img.shields.io/travis/itsjavi/fontawesome-iconpicker/master.svg?style=flat-square)](https://travis-ci.org/itsjavi/fontawesome-iconpicker)--\u003e\n\u003c!--[![npm@next](https://img.shields.io/npm/v/fontawesome-iconpicker/next.svg?style=flat-square)](https://www.npmjs.com/package/fontawesome-iconpicker?activeTab=versions)--\u003e\n[![npm](https://img.shields.io/npm/v/fontawesome-iconpicker.svg?style=flat-square)](https://www.npmjs.com/package/fontawesome-iconpicker)\n\n\nFont Awesome Icon Picker is a fully customizable plugin for Twitter Bootstrap,\nwith a powerful base API, based on [bootstrap-popover-picker](https://itsjavi.github.io/bootstrap-popover-picker/)\n\nYou can use Font Awesome 5 or another font icon set of your choice (icon list is totally customizable).\n\n[View demos](https://itsjavi.github.io/fontawesome-iconpicker/)\n\n## Instantiation\n\nYou can call the plugin in several ways:\n\n```javascript\n// Create instance if not exists (returns a jQuery object)\n$('.my').iconpicker();\n$('.my').iconpicker({ /*options*/ }); // you can also specify options via data-* attributes\n\n// For the first matched element, access to a plugin property value\n$('.my').data('iconpicker').iconpickerProperty;\n\n// For the first matched element, call a plugin instance method with the given args\n$('.my').data('iconpicker').iconpickerMethod('methodArg1', 'methodArg2' /* , other args */);\n\n// Call and apply a plugin method to EACH matched element.\n$.iconpicker.batch('.my', 'iconpickerMethod', 'methodArg1', 'methodArg2' /* , other args */); -\u003e\n```\n\n## Triggered Events\n\nAll of them exposes the plugin instance through event.iconpickerInstance\n\nIn order of call:\n\n* iconpickerCreate\n* iconpickerCreated\n* iconpickerShow\n* iconpickerShown\n* iconpickerSelect (also exposes event.iconpickerItem and event.iconpickerValue)\n* iconpickerUpdate\n* iconpickerInvalid (also exposes event.iconpickerValue)\n* iconpickerSetValue (also exposes event.iconpickerValue)\n* iconpickerSetSourceValue (also exposes event.iconpickerValue)\n* iconpickerUpdated\n* iconpickerSelected (also exposes event.iconpickerItem and event.iconpickerValue)\n* iconpickerHide\n* iconpickerHidden\n* iconpickerDestroy\n* iconpickerDestroyed\n\n```javascript\n// Bind iconpicker events to the element\n$('.my').on('iconpickerSelected', function(event){\n  /* event.iconpickerValue */\n});\n```\n\n## Popover placement extensions\n\nThis plugin comes with more placement options than the original Bootstrap Popover.\nHere are all the possibilities in detail:\n\n            1 2 3 4 5\n            G       6\n            F       7\n            E       8\n            D C B A 9\n\n    0.      inline (no placement, display as inline-block)\n    1.      topLeftCorner\n    2.      topLeft\n    3.      top (center)\n    4.      topRight\n    5.      topRightCorner\n    6.      rightTop\n    7.      right (center)\n    8.      rightBottom\n    9.      bottomRightCorner\n    A.      bottomRight\n    B.      bottom (center)\n    C.      bottomLeft\n    D.      bottomLeftCorner\n    E.      leftBottom\n    F.      left (center)\n    G.      leftTop\n\n\n## Available options\n\n```javascript\nvar options = {\n    title: false, // Popover title (optional) only if specified in the template\n    selected: false, // use this value as the current item and ignore the original\n    defaultValue: false, // use this value as the current item if input or element value is empty\n    placement: 'bottom', // (has some issues with auto and CSS). auto, top, bottom, left, right\n    collision: 'none', // If true, the popover will be repositioned to another position when collapses with the window borders\n    animation: true, // fade in/out on show/hide ?\n    //hide iconpicker automatically when a value is picked. it is ignored if mustAccept is not false and the accept button is visible\n    hideOnSelect: false,\n    showFooter: false,\n    searchInFooter: false, // If true, the search will be added to the footer instead of the title\n    mustAccept: false, // only applicable when there's an iconpicker-btn-accept button in the popover footer\n    selectedCustomClass: 'bg-primary', // Appends this class when to the selected item\n    icons: [], // list of icon objects [{title:String, searchTerms:String}]. By default, all Font Awesome icons are included.\n    fullClassFormatter: function(val) {\n        return 'fa ' + val;\n    },\n    input: 'input,.iconpicker-input', // children input selector\n    inputSearch: false, // use the input as a search box too?\n    container: false, //  Appends the popover to a specific element. If not set, the selected element or element parent is used\n    component: '.input-group-addon,.iconpicker-component', // children component jQuery selector or object, relative to the container element\n    // Plugin templates:\n    templates: {\n        popover: '\u003cdiv class=\"iconpicker-popover popover\"\u003e\u003cdiv class=\"arrow\"\u003e\u003c/div\u003e' +\n            '\u003cdiv class=\"popover-title\"\u003e\u003c/div\u003e\u003cdiv class=\"popover-content\"\u003e\u003c/div\u003e\u003c/div\u003e',\n        footer: '\u003cdiv class=\"popover-footer\"\u003e\u003c/div\u003e',\n        buttons: '\u003cbutton class=\"iconpicker-btn iconpicker-btn-cancel btn btn-default btn-sm\"\u003eCancel\u003c/button\u003e' +\n            ' \u003cbutton class=\"iconpicker-btn iconpicker-btn-accept btn btn-primary btn-sm\"\u003eAccept\u003c/button\u003e',\n        search: '\u003cinput type=\"search\" class=\"form-control iconpicker-search\" placeholder=\"Type to filter\" /\u003e',\n        iconpicker: '\u003cdiv class=\"iconpicker\"\u003e\u003cdiv class=\"iconpicker-items\"\u003e\u003c/div\u003e\u003c/div\u003e',\n        iconpickerItem: '\u003ca role=\"button\" href=\"#\" class=\"iconpicker-item\"\u003e\u003ci\u003e\u003c/i\u003e\u003c/a\u003e',\n    }\n};\n```\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/itsjavi.github.io%2Ffontawesome-iconpicker","html_url":"https://awesome.ecosyste.ms/projects/itsjavi.github.io%2Ffontawesome-iconpicker","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/itsjavi.github.io%2Ffontawesome-iconpicker/lists"}