jQuery UI 在「插件」之上又包了一層「互動元件」,把滑鼠操作與常見 UI 模式都抽象成一行呼叫。以下依三大類別整理各元件所需的檔案、基本用法與官方文件位置,方便快速查閱。
所需檔案:ui.mouse.js、ui.draggable.js、ui.draggable.ext.js
$(document).ready(function(){
$(".block").draggable();
});
draggable(options) 可接受大量選項,例如 helper、axis、containment、grid、revert 等。
所需檔案:在拖曳三檔之外,再加 ui.droppable.js、ui.droppable.ext.js
$(document).ready(function(){
$(".block").draggable({helper: 'clone'});
$(".drop").droppable({
accept: ".block",
activeClass: 'droppable-active',
hoverClass: 'droppable-hover',
drop: function(ev, ui) {
$(this).append("<br>Dropped!");
}
});
});
activeClass 在可被放置時套用,hoverClass 則在滑鼠懸停於放置區上方時套用,兩者搭配就能做出清楚的視覺回饋。
所需檔案:jquery.dimensions.js、ui.mouse.js、ui.draggable.js、ui.droppable.js、ui.sortable.js
$(document).ready(function(){
$("#myList").sortable({});
});
所需檔案:jquery.dimensions.js、ui.mouse.js、ui.draggable.js、ui.droppable.js、ui.selectable.js
$(document).ready(function(){
$("#myList").selectable();
});
它讓你能像檔案總管那樣用框選或 Ctrl 加點的方式批次選取列表項。
所需檔案:jquery.dimensions.js、ui.mouse.js、ui.resizable.js,並搭配 flora.all.css 主題樣式。
$(document).ready(function(){
$("#example").resizable();
});
檔案:ui.accordion.js、jquery.dimensions.js
$(document).ready(function(){
$("#example").accordion();
});
檔案:jquery.dimensions.js、ui.dialog.js、ui.resizable.js、ui.mouse.js、ui.draggable.js
$(document).ready(function(){
$("#example").dialog();
});
因為對話框需要拖曳與縮放,所以依賴鏈特別長。
檔案:jquery.dimensions.js、ui.mouse.js、ui.slider.js
$(document).ready(function(){
$("#example").slider();
});
檔案:ui.tablesorter.js
$(document).ready(function(){
$("#example").tablesorter({
sortList: [[0,0], [2,1]],
widgets: ['zebra']
});
});
sortList 決定初始排序欄位與方向(0 升冪、1 降冪),widgets: ['zebra'] 則加上斑馬線隔行底色。
檔案:ui.tabs.js
$(document).ready(function(){
$("#example > ul").tabs();
});
這個元件當年對 IE 的支援不算理想,正式專案使用前建議實測。
Shadow 陰影與 Magnifier 放大鏡屬於純視覺裝飾型元件,效果直觀,官方 demo 展示得最清楚,直接看範例即可掌握。
這些元件幾乎都需要 jquery.dimensions.js 提供尺寸計算能力,且多半搭配 Flora 主題的 CSS 才能呈現完整外觀。實際開發時,與其逐個引入單檔,不如用官方下載頁的 builder 勾選所需元件打包成客製版本,可以省下可觀的請求數與檔案大小。