bootstrap-select 插件示例


本文原創地址:http://www.cnblogs.com/landeanfen/p/7457283.html

一、組件開源地址以及API說明

bootstrap-select開源地址:https://github.com/silviomoreto/bootstrap-select

bootstrap-select使用示例:http://silviomoreto.github.io/bootstrap-select/examples/

bootstrap-select文檔說明:http://silviomoreto.github.io/bootstrap-select/options/

二、組件效果示例

一睹初容

多選效果

可配置搜索功能

分組選中

設置最多選中項為2個

 

 自定義說明Title,比如我們定義為“請選擇省份”

 某些情況下如果多選的數量比較多,我們可以顯示“縮略模式”。比如當選擇了兩項以上的時候

自定義樣式

顯示圖標加文字

顯示帶顏色的標簽

展開最多顯示可配置的個數,不如最多顯示3項

 全選和反選

以上都是些常用功能,更多效果可以查看官方示例!

三、使用示例

1、基礎示例

既然是bootstrap-select,組件肯定是依賴bootstrap的,而bootstrap又是依賴jquery的,所以使用組件必須引用如下文件。

復制代碼
<link href="Content/bootstrap/css/bootstrap.min.css" rel="stylesheet" />
<link href="Content/bootstrap-select/css/bootstrap-select.min.css" rel="stylesheet" />

<script src="Content/jquery-1.9.1.min.js"></script>
<script src="Content/bootstrap/js/bootstrap.min.js"></script>
<script src="Content/bootstrap-select/js/bootstrap-select.min.js"></script>
<script src="Content/bootstrap-select/js/i18n/defaults-zh_CN.min.js"></script>
復制代碼

最后一個文件 defaults-zh_CN.min.js 非必需,是組件中文化的時候才需要引用。

使用就更加簡單了,不用任何已經js,直接使用class就可以初始化。

復制代碼
<select class="selectpicker">
    <option value="1">廣東省</option>
    <option value="2">廣西省</option>
    <option value="3">福建省</option>
    <option value="4">湖南省</option>
    <option value="5">山東省</option>                            
</select>
復制代碼

給一個select標簽加上selectpicker樣式即可。

多選就不用多說了

復制代碼
<select class="selectpicker" multiple>
    <option value="1">廣東省</option>
    <option value="2">廣西省</option>
    <option value="3">福建省</option>
    <option value="4">湖南省</option>
    <option value="5">山東省</option>                            
</select>
復制代碼

2、其他效果示例

上面是最簡單的使用,下面就將一些常用的效果給出代碼示例,高手請直接跳過此段。

給組件加搜索功能

復制代碼
<select class="selectpicker" multiple data-live-search="true">
    <option value="1">廣東省</option>
    <option value="2">廣西省</option>
    <option value="3">福建省</option>
    <option value="4">湖南省</option>
    <option value="5">山東省</option>                            
</select>
復制代碼

選項分組

復制代碼
<select class="form-control selectpicker" data-live-search="true" multiple>
        <optgroup label="廣東省">
                <option value="1">廣州市</option>
                <option value="2">深圳市</option>
                <option value="3">珠海市</option>
         </optgroup>   
          <optgroup label="廣西">
                  <option value="1">南寧市</option>
                  <option value="2">柳州</option>
                  <option value="3">桂林市</option>
           </optgroup>  
           <optgroup label="山東">
                   <option value="1">煙台</option>
                   <option value="2">青島</option>
                   <option value="3">濟南</option>
             </optgroup>                          
</select>
復制代碼

設置最多選中項為2個

復制代碼
<select class="selectpicker" multiple data-live-search="true" data-max-options="2">
    <option value="1">廣東省</option>
    <option value="2">廣西省</option>
    <option value="3">福建省</option>
    <option value="4">湖南省</option>
    <option value="5">山東省</option>                            
</select>
復制代碼

縮略模式,比如當選中值大於3個的時候只顯示選中項的個數,注意這個屬性只對多選生效

復制代碼
<select class="selectpicker" multiple data-live-search="true" data-selected-text-format="count > 3">
    <option value="1">廣東省</option>
    <option value="2">廣西省</option>
    <option value="3">福建省</option>
    <option value="4">湖南省</option>
    <option value="5">山東省</option>                            
</select>
復制代碼

顯示帶顏色的標簽

 <select class="form-control selectpicker" title="請選擇省份" multiple>
                        <option data-content="<span class='label label-success'>廣東省</span>">廣東省</option>    
                        <option data-content="<span class='label label-info'>廣西省</span>">廣西省</option>  
                        <option data-content="<span class='label label-warning'>福建省</span>">福建省</option>  
                        <option data-content="<span class='label label-danger'>山東省</span>">山東省</option>                        
</select>

默認樣式選擇

復制代碼
<select class="selectpicker" data-style="btn-primary">
  ...
</select>

<select class="selectpicker" data-style="btn-info">
  ...
</select>

<select class="selectpicker" data-style="btn-success">
  ...
</select>

<select class="selectpicker" data-style="btn-warning">
  ...
</select>

<select class="selectpicker" data-style="btn-danger">
  ...
</select>
復制代碼

3、組件取值賦值

上面都是組件的初始化的一些東西,一般情況下,我們需要對組件進行取值和賦值,我們應該如何操作呢。

3.1、組件取值

關於組件取值保持原生的jquery方法,比如 var value = $('#sel').val(); 這樣是不是很簡單,需要注意的是,如果是多選,這里得到的value變量是一個數組變量,形如 ['1','2','3']。

3.2、組件賦值

組件賦值就需要稍微變換一下了,如果你直接 $('#sel').val('1'); 這樣賦值將會無效,正確的賦值方法為:

$('.selectpicker').selectpicker('val', '1');

在一些級聯選擇的使用場景中,經常需要在賦值的時候順便觸發一下組件的change事件,我們可以這么做。

$('.selectpicker').selectpicker('val', '1').trigger("change");

如果是多選的賦值,也是一樣

$('.selectpicker').selectpicker('val', ['1','2','3']).trigger("change");

4、組件其他用法

全選: $('.selectpicker').selectpicker('selectAll'); 

反選: $('.selectpicker').selectpicker('deselectAll'); 

適應手機模式: $('.selectpicker').selectpicker('mobile'); 

組件禁用:

$('.disable-example').prop('disabled', true);
$('.disable-example').selectpicker('refresh');

組件啟用:

$('.disable-example').prop('disabled', false);
$('.disable-example').selectpicker('refresh');

組件銷毀:

$('.selectpicker').selectpicker('destroy');
 

5、組件封裝

上面關於組件的初始化介紹了那么多,都是通過class='selectpicker'去做初始化的,很多情況下,我們的select的option都是動態獲取,然后再初始化的,於是乎博主仔細尋找api,看里面是否有遠程獲取數據,很遺憾,組件沒有支持這種遠程獲取數據的方法。沒關系,我們自己封裝一個ajax請求,然后動態構造option又有多難呢?這里又得提一下原來那篇封裝js組件的文章了,我們按照那篇文章的思路封裝一個不就好了。以下給出一個參考。

 這樣封裝之后,我們直接使用如下代碼即可初始化組件。

$('#sel').bootstrapSelect({
    url:'/a/b',
    data: {},
    valueField: 'value',
    textField: 'text',
});
 


免責聲明!

本站轉載的文章為個人學習借鑒使用,本站對版權不負任何法律責任。如果侵犯了您的隱私權益,請聯系本站郵箱yoyou2525@163.com刪除。



 
粵ICP備18138465號   © 2018-2025 CODEPRJ.COM