folderselect.js 是一款仿 windows 资源管理器风格的 jQuery 复选框美化插件。它能够以文件夹的形式来显示分层的数据结构,它还支持 AJAX 数据调用,事件回调,数据头等。
可以通过下面的方法来初始化该美化复选框插件。
$("#element").folderselect({
data: my_json_hierarchical_data,
headers: [],
url: false,
icon_item: "item.png",
icon_folder: "folder.png",
icon_home: "home.png",
spinner_gif: "ajax-loader.gif",
item_selected_callback: function(item) {},
item_removed_callback: function(item) {},
folder_entered_callback: function(folder) {}
});
你可以在初始化 jQuery 对象上调用 folderselect('selected')方法来获取被选择的复选框元素。你所得到的数据和你在初始化的时候放入的数据是相同的。
var selected_items = $("#element").folderselect('selected');
除了 data 参数,所有的其他参数都是可选的。
headers:该字符串数组将转换为每个文件夹的 headers
url:如果用户尝试打开一个空的文件夹(content = []),将使用该 URL 发送一个 POST 请求来获取文件夹的内容
icon_folder / icon_item / icon_home:不同图标的 URL 地址
item_selected_callback:当某项被选择时调用
item_removed_callback:当某项取消选择时被调用
folder_entered_callback:当文件夹打开时被调用
data:参考下面
data 参数是一个包含分层数据的 json 对象。它可能只是一个基本的树结构,然后在用户点击的时候通过 ajax 来调用子节点的数据。
data 参数包含 2 种类型的对象:items 和 folders。它们有相同点和不同点。
type:可取值为'folder'或'item'
icon:使用的 item/folder 图标的 URL 地址
cells:字符串数组。第一个字符串标识 folder/icon 的名称。如果使用 headers,cells 的数量将等于 headers 的数量
payload:一个任意的 json 对象
content:在该文件夹中可以找到的 item/folder 对象数组
headers:在文件夹中显示的 Headers 的数组
openable:设置为 true 是文件夹可以打开,false 则不能。如果一个 ajax 请求为一个文件夹得到了空的数据,那么它就会被设置为 false
open:如果设置为 true,则文件夹默认打开。默认只有一个文件夹是打开的
selectable:如果设置为 true,则 item 可以被选择
selected:如果设置为 true,则 item 默认被选择
演示地址 | 下载地址 |
专业提供WordPress主题安装、深度汉化、加速优化等各类网站建设服务,详询在线客服!