fontawesome-iconpicker, Twitter Bootstrap的Font Awesome icon 选择器组件

分享于 

6分钟阅读

GitHub

  繁體 雙語
Font Awesome Icon Picker plugin for Twitter Bootstrap 3
  • 源代码名称:fontawesome-iconpicker
  • 源代码网址:http://www.github.com/farbelous/fontawesome-iconpicker
  • fontawesome-iconpicker源代码文档
  • fontawesome-iconpicker源代码下载
  • Git URL:
    git://www.github.com/farbelous/fontawesome-iconpicker.git
    Git Clone代码到本地:
    git clone http://www.github.com/farbelous/fontawesome-iconpicker
    Subversion代码到本地:
    $ svn co --depth empty http://www.github.com/farbelous/fontawesome-iconpicker
    Checked out revision 1.
    $ cd repo
    $ svn up trunk
    
    fontawesome-iconpicker

    Font Awesome 是一个完全可以定制的插件插件,具有强大的基 API,基于 bootstrap-popover-picker

    你可以使用 Font Awesome 或者其他字体 icon 设置你的选择(。icon 列表完全可以自定义)。

    视图演示插件

    实例化

    你可以通过以下几种方式调用插件:

    // 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 */); ->

    触发事件

    所有这些插件都通过 event.iconpickerInstance 公开插件实例

    按呼叫顺序:

    • iconpickerCreate
    • iconpickerCreated
    • iconpickerShow
    • iconpickerShown
    • iconpickerSelect ( 同时公开 event.iconpickerItem 和 event.iconpickerValue )
    • iconpickerUpdate
    • iconpickerInvalid ( 同时公开 event.iconpickerValue )
    • iconpickerSetValue ( 同时公开 event.iconpickerValue )
    • iconpickerSetSourceValue ( 同时公开 event.iconpickerValue )
    • iconpickerUpdated
    • iconpickerSelected ( 同时公开 event.iconpickerItem 和 event.iconpickerValue )
    • iconpickerHide
    • iconpickerHidden
    • iconpickerDestroy
    • iconpickerDestroyed
    // Bind iconpicker events to the element$('.my').on('iconpickerSelected', function(event){
     /* event.iconpickerValue */});

    Popover位置扩展

    这个插件带有比原始 Bootstrap Popover更多的放置选项。 以下是所有可能的情况:

    
     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
    
    
    
    

    可用选项

    var defaults = {
     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 classes (declared at the bottom of this script for maintainability)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:'<div class="iconpicker-popover popover"><div class="arrow"></div>'+'<div class="popover-title"></div><div class="popover-content"></div></div>',
     footer:'<div class="popover-footer"></div>',
     buttons:'<button class="iconpicker-btn iconpicker-btn-cancel btn btn-default btn-sm">Cancel</button>'+' <button class="iconpicker-btn iconpicker-btn-accept btn btn-primary btn-sm">Accept</button>',
     search:'<input type="search" class="form-control iconpicker-search" placeholder="Type to filter"/>',
     iconpicker:'<div class="iconpicker"><div class="iconpicker-items"></div></div>',
     iconpickerItem:'<a role="button" href="#" class="iconpicker-item"><i></i></a>',
     }
    };

    COM  BOO  引导  Bootstrap  awe  ICO  
    相关文章