1. 程式人生 > >Bootstrap Select(下拉框控制元件)

Bootstrap Select(下拉框控制元件)

Bootstrap Select:下拉框控制元件

官方網站 http://silviomoreto.github.io/bootstrap-select/

本章完全解讀官方文件後所寫,包含樣式與事件介紹與使用。

因為CSDN文章容易樣式問題,所以我把程式碼提供出來,複製到空頁面開啟即可。

上一張效果圖:


<!DOCTYPE html>
<html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=utf-8">
<title>Bootstrap Select</title>
<link href="https://cdn.bootcss.com/bootstrap/3.3.6/css/bootstrap.min.css" rel="stylesheet">
<link href="https://cdn.bootcss.com/bootstrap-select/1.12.4/css/bootstrap-select.min.css" rel="stylesheet">
</head>
<body>
	<div class="container">
		<div class="row clearfix">
			<div class="col-md-12 column">
				<div class="page-header">
					<h1>Bootstrap Select <small>下拉框</small></h1>
				</div>
				<h3>基本select外掛效果</h3>
				<p>為下拉框新增外掛支援 , <span class="label label-success">class="selectpicker"</span></p>
				<div class="form-group">
					<select class="selectpicker">
						<option>A</option>
						<option>B</option>
						<option>C</option>
					</select>
				</div>
				
				<hr>
				<h3>單選模式示例</h3>
				<p><span class="label label-success">class="selectpicker show-tick"</span> , 選中項內容後新增" √ "小圖示</p>
				<p><span class="label label-success">title="請選擇一項"</span> , 未設定預設選項並未選擇時 , 元件框中的提示內容</p>
				<p><span class="label label-success">data-live-search="true"</span> , 為元件新增查詢功能 </p>
				<p><span class="label label-success">data-size="5"</span> , 設定下拉長度 </p>
				<div class="form-group">
					<select class="selectpicker show-tick" title="請選擇一項" data-live-search="true" data-size="5">
						<option>A</option>
						<option>B</option>
						<option>C</option>
						<option>D</option>
						<option>E</option>
						<option>B</option>
						<option>C</option>
					</select>
				</div>

				<hr>
				<h3>多選模式示例</h3>
				<p><span class="label label-success">title="請選擇一項"</span> , 未設定預設選項並未選擇時 , 元件框中的提示內容</p>
				<p><span class="label label-success">data-live-search="true"</span> , 為元件新增查詢功能 </p>
				<p><span class="label label-success">data-size="5"</span> , 設定下拉長度 </p>
				<p><span class="label label-success">multiple</span> , 新增可多選支援 </p>
				<p><span class="label label-success">data-max-options="2"</span> , 設定最多可選個數 </p>
				<p>該屬性在設定<span class="label label-success">data-max-options="2"</span>後 , 建議不使用<span class="label label-default">data-actions-box="true"</span> , 該屬性是新增"選擇所有"和"全部取消選擇"按鈕</p>
				<div class="form-group">
					<select class="selectpicker" title="請選擇一項" data-live-search="true" data-size="5" multiple data-max-options="2">
						<option>A</option>
						<option>B</option>
						<option>C</option>
						<option>D</option>
						<option>E</option>
						<option>B</option>
						<option>C</option>
					</select>
				</div>
				
				<hr>
				<h3>分組選項示例</h3>
				<p>使用optgroup標籤將選項分為一組, 下面介紹optgroup標籤屬性</p>
				<p><span class="label label-success">label="分組名"</span> , 為分組新增名稱 </p>
				<p><span class="label label-success">data-subtext="追加內容"</span> , 為分組追加名稱 </p>
				<div class="form-group">
					<select class="selectpicker" title="請選擇" >
						<optgroup label="AB選項組" data-subtext="ab">
							<option>A</option>
						<option>B</option>
					</optgroup>
					<optgroup label="CD選項組" data-subtext="ab">
						<option>C</option>
						<option>D</option>
						</optgroup>
					</select>
				</div>
				<h3>選項標籤中屬性介紹示例1</h3>
				<p><span class="label label-success">title="代稱"</span> , 改變選項在元件框中顯示內容, 相當於選項的代稱</p>
				<p><span class="label label-success">selected</span> , 預設選中</p>
				<p><span class="label label-default">data-icon="圖示程式碼"</span>為選項前面新增小圖示, 如果沒設定
					<span class="label label-success">title="代稱"</span>屬性, 那麼小圖示隨選項內容一起顯示在元件框中
				</p>
				<p><span class="label label-success">data-subtext="提示文字"</span> , 在選項內容後新增提示(淡灰色小2號字型)文字</p>
				<div class="form-group">
					<select class="selectpicker" >
						<option title="A型別" data-icon="fa fa-file" data-subtext="a項" >A型別選項</option>
						<option title="B型別" data-icon="fa fa-file" selected>B型別選項</option>
						<option title="C型別" data-icon="fa fa-file">C型別選項</option>
					</select>
				</div>
				<h3>選項標籤中屬性介紹示例2</h3>
				<p><span class="label label-default">data-content="html程式碼"</span> , 使用該屬性中的程式碼片段替換該選項的內容, 以及選中後在元件框中顯示的也是該html程式碼</p>
				<p>如果感覺顯示在元件程式碼框中的內容不好 , 使用<span class="label label-success">title="代稱"</span> , 改變選項在元件框中顯示內容, 相當於選項的代稱</p>
				<div class="form-group">
					<select class="selectpicker" >
						<option data-content="<span class='label label-success'>A選項</span>">A選項</option>
						<option data-content="<span class='label label-success'>B選項</span>">B選項</option>
						<option data-content="<span class='label label-success'>C選項</span>">C選項</option>
					</select>
				</div>
				
				<hr>
				<h3>其他屬性介紹</h3>
				<p><span class="label label-success">disabled</span> , 該屬性設定在元件select標籤中為禁用元件 ; 設定在分組標籤(optgroup)中禁選該組 ; 設定在選項標籤(option)中禁選該項。</p>
				<p><span class="label label-default">data-divider="true"</span> , 在選項與下一選項中間新增分割線。</p>
				<hr>
				<h3>Core options(核心選項)</h3>
				<p>核心選項也就是一些屬性,重要的屬性已經在上面介紹完了</p>
				<p>寫法:data-選項名稱:對應值,組合成屬性</p>
				
				<hr>
				<h3>核心方法</h3>
				<p>$('#selectID').selectpicker('selectAll'); // 當為多選下拉框時 ,執行全部選中</p>
				<p>$('#selectID').selectpicker('deselectAll'); // 當為多選下拉框時 ,執行全部取消選中</p>
				<p>$('#selectID').selectpicker('refresh'); // 當你刪除或者新增選項時 ,重新整理程式碼</p>
				<p>$('#selectID').selectpicker('hide'); // 隱藏下拉框</p>
				<p>$('#selectID').selectpicker('show'); // 顯示下拉框</p>
				
				<hr>
				<h3>核心事件</h3>
				<p>$('#selectID').on('show.bs.select', function (e) {}); // 當點選下拉框時,選項項窗體即將顯示觸發</p>
				<p>$('#selectID').on('shown.bs.select', function (e) {}); // 當點選下拉框時,選項項窗體顯示觸發</p>
				<p>$('#selectID').on('hide.bs.select', function (e) {}); // 當點選下拉框時,選項項窗體即將隱藏觸發</p>
				<p>$('#selectID').on('hidden.bs.select', function (e) {}); // 當點選下拉框時,選項項窗體隱藏觸發</p>
				<p>$('#selectID').on('loaded.bs.select', function (e) {}); // 當下拉框被初始化後觸發</p>
				<p>$('#selectID').on('refreshed.bs.select', function (e) {}); // 當重新整理方法(也就是執行該方法.selectpicker('refresh'))下拉框時觸發</p>
				<p>$('#selectID').on('changed.bs.select', function (e) {}); // 當值被改變時觸發</p>
			</div>
		</div>
	</div>
	<script src="https://cdn.bootcss.com/jquery/1.11.3/jquery.min.js"></script>
	<script src="https://cdn.bootcss.com/bootstrap/3.3.6/js/bootstrap.min.js"></script>
	<script src="https://cdn.bootcss.com/bootstrap-select/1.12.4/js/bootstrap-select.min.js"></script>
	<script src="https://cdn.bootcss.com/bootstrap-select/1.12.4/js/i18n/defaults-zh_CN.min.js"></script>
	
</body>
</html>