自定義jQuery PickList插件 - 用法與實例(3)

PickList插件還有以下API方法：

 

setDefaults(options)

修改pickList的全局默認設置。

// 設置pickList插件的默認item_selector爲"li.pickListItem" // 設置pickList插件的默認selectedItemClassName爲"highlight" $.pickList.setDefaults({ item_selector : "li.pickListItem", selectedItemClassName : "highlight" });

 

initAvailableItems()

重新初始化availableList中的Item條目，爲這些條目綁定事件回調；

var pl = $("#applicantPanel").pickList({ availableList_selector : "#editDlg_availableApplicantList", pickedList_selector : "#editDlg_pickedApplicantList", addButton_selector : "#editDlg_btnAddApplicant", removeButton_selector : "#editDlg_btnRemoveApplicant" }); // 一些操作.... pl.initAvailableItems();

initPickedItems()

重新初始化pickedList中的Item條目，爲這些條目綁定事件回調；

addButton_click()

addButton被點擊。availableList中的每一個被選中的條目，都分別會和pickedList中的所有條目比較(使用containsItem()比較)，如果containsItem()返回true，則pickedList中的相同的條目會加上"selectedItemClassName"定義的CSS樣式；如果不返回true，則該條目會被移至pickedList。

 

removeButton_click()

removeButton被點擊。pickedList中的每一個被選中的條目，都分別會和availableList中的所有條目比較(使用 containsItem()比較)，如果containsItem()返回true，則availableList中的相同的條目會加上"selectedItemClassName"定義的CSS樣式；如果不返回true，則該條目會被移至availableList。

 

clearAvailableList()

清空availableList中的條目。返回當前PickList控件。

var pl = $("#applicantPanel").pickList({ availableList_selector : "#editDlg_availableApplicantList", pickedList_selector : "#editDlg_pickedApplicantList", addButton_selector : "#editDlg_btnAddApplicant", removeButton_selector : "#editDlg_btnRemoveApplicant" }); // 一些操作.... pl.clearAvailableList();

 

clearPickedList()

清空pickedList中的條目。返回當前PickList控件。

 

insertAvailableItems(html)

將包含新條目的HTML插入到availableList的DOM中。返回當前PickList控件。

var itemsHtml = ""; $.each(data.queryResult, function(i, n){ itemsHtml += "<li class='pickListItem'><span class='idCol'>" + n.id + "</span><span class='nameCol'>" + n.fullName + "</span></li>"; }); pl.clearAvailableList().insertAvailableItems(itemsHtml);

 

insertPickedItems(html)

將包含新條目的HTML插入到pickedList的DOM中。返回當前PickList控件。

 

getAvailableItems()

獲得availableList中的所有條目，返回值爲jQuery對象數組。

 

getPickedItems()

獲得pickedList中的所有條目，返回值爲jQuery對象數組。

if(pl.getPickedItems().size()<=0) { result = "PickedList列表不能爲空！/n"; return result; }

 

getSelectedAvailableItems()

獲得availableList中的所有處於選中狀態的條目，返回值爲jQuery對象數組。

 

getSelectedPickedItems()

獲得pickedList中的所有處於選中狀態的條目，返回值爲jQuery對象數組。

 

getLastClickedAvailableItem()

獲得availableList中的最近被點擊的條目，返回值爲jQuery對象。

 

getLastClickedPickedItem()

獲得pickedList中的最近被點擊的條目，返回值爲jQuery對象。