最新程式碼可至 https://ligerui.googlecode.com 下載。
jQuery LigerUI 是一組以 jQuery 為基礎的 UI 控制項集合,簡單而強大,目標是快速打造 Web 前端介面解決方案。因為是純前端控制項,與後端無關,因此 .NET、JSP、PHP 等各種 Web 服務環境都能使用。目前全部外掛打包壓縮後的 JS 只有 100K 左右,相當輕巧。它採用外掛式開發模式,以「簡單」為設計原則,每個外掛盡量獨立,並支援相依擴展。
LigerUI 是基於 jQuery 的一系列外掛集合,基本上每個外掛都相對獨立,但彼此之間又緊密關聯,合理地組裝就能實作出各種複雜功能。
<head>
<title></title>
<link href="https://www.cnblogs.com/lib/ligerUI/skins/Aqua/css/ligerui-all.css" rel="stylesheet" type="text/css" />
<script src="https://www.cnblogs.com/lib/jquery/jquery-1.3.2.min.js" type="text/javascript"></script>
<script src="https://www.cnblogs.com/lib/ligerUI/js/core/base.js" type="text/javascript"></script>
<script src="https://www.cnblogs.com/lib/ligerUI/js/plugins/ligerTextBox.js" type="text/javascript"></script>
<script type="text/javascript">
$(function ()
{
//我們將一個 html 文本框對象轉換成 ligerui 文本框對象,並返回 ligerui 對象
var g = $("#txt1").ligerTextBox(
{
//如果沒有輸入時,會提示不能為空
nullText: '不能為空'
});
/* 如何獲取屬性 */
//方式一
alert('方式一:' + g.get('disabled'));
//方式二
alert('方式二:' + $("#txt1").ligerTextBox('option', 'disabled'));
/* 如何設置屬性 */
//方式一
g.set('disabled', true);
//方式二
$("#txt1").ligerTextBox('option', 'disabled', false);
/* 如何調用方法 */
//方式一
g.setDisabled();
//方式二
$("#txt1").ligerTextBox('setEnabled');
/* 如何設置事件 */
//這裡給文本框綁定一個改變值的事件,也可以設置 onChangeValue 參數
g.bind('changeValue', function (value)
{
alert(value);
});
});
</script>
</head>
<body style="padding:10px">
<input type="text" id="txt1" value="" style="width:200px"/>
</body>
更多參數與方法可查 API:https://www.ligerui.com/api/。上面是 TextBox 的用法,其他外掛的使用方式類似。
套用外掛後會回傳一個 ligerUI 物件,可以把它存在全域變數裡供後續使用。若因為變數作用域等因素沒能即時保存,還有兩種方式可以取回:
// 方式一:使用 $.fn.ligerGetTextBoxManager
var g = $("#txt1").ligerGetTextBoxManager();
// 方式二:使用 $.ligerui.get
var g = $.ligerui.get('txt1');
第三種方式是直接用 ligerUI 物件的 id 取得。若呼叫時未指定 id,物件的 id 會採用 HTML 元素的 id;若 HTML 元素也沒有 id,則會自動產生一個,因此通常可以用 HTML 元素的 id 來取回。
其實第二種方式可以用第一種取代——ligerTextBox 是可以重複呼叫的,第二次以後的呼叫都會直接回傳 ligerUI 物件。當你不確定某個 HTML 元素是否已套用外掛時,用第二種方式較保險。其他外掛的命名規則與 TextBox 相同。
//方式一:以參數形式傳入
var g = $("#txt1").ligerTextBox(
{
onChangeValue : function(value){alert(value);}
});
//方式二:呼叫 bind 方法
g.bind('changeValue', function (value)
{
alert(value);
});
使用 bind 方法時名稱不帶 "on"。同一事件可以多次綁定;對某些事件而言,若某個回呼函式回傳 false,後面尚未觸發的函式將不會再執行。第二種 bind 寫法是 V1.1.3 引入 core 機制後才有的。
//這裡設置文本框不能編輯
g.setDisabled();
//這裡設置文本框可以編輯
g.setEnabled();
//也可以使用這種方式
$("#grid").ligerGrid('setEnabled');
第二種方式是 V1.1.4 加入的。
// 獲取參數值
var url = g.get('url');
// 或
var url = $("#grid").ligerGrid('option','url');
// 動態設置參數
g.set('url', url);
// 或
g.set({url:url});
// 或
$("#grid").ligerGrid('option','url', url);
set() 是所有外掛統一的屬性設定介面,也是 V1.1.3 引入 core 機制後才有的;外掛傳參方式則是 V1.1.4 引入的。
LigerUI 的預設參數與方法都可以擴展,官方定義了兩個入口:$.ligerDefaults 與 $.ligerMethods。
擴充 $.ligerDefaults.{Plugin}。例如改變表格預設的頭部標題:
if($.ligerDefaults.Grid)
{
$.ligerDefaults.Grid.title = "我的表格";
}
擴充 $.ligerDefaults.{Plugin}String。例如把表格的「載入中」訊息改成英文:
if($.ligerDefaults.GridString)
{
$.ligerDefaults.GridString.loadingMessage = "loading...";
}
擴充 $.ligerMethods.{Plugin}。這裡為 Grid 物件新增一個 alert 方法:
$.extend($.ligerMethods.Grid,
{
alert : function ()
{
//要注意到一點,這裡的 this 就是 ligerui 對象
var rowdata = this.getSelectedRow();
if (!rowdata)
alert('空');
else
alert(rowdata.CustomerID);
}
}
);
function show()
{
//後面就可以這樣使用
var g = $("#maingrid").ligerGrid();
g.alert();
}
要注意的是,在方法擴展中的 this 指向的是 ligerUI 物件本身,而非 DOM 元素,因此可以直接呼叫 getSelectedRow() 這類該外掛的方法。