layui 的基本使用介紹
全局配置
layui.config({
dir: '/res/layui/' //layui.js 所在路徑(注意勺卢,如果是script單獨(dú)引入layui.js悲没,無(wú)需設(shè)定該參數(shù)。),一般情況下可以無(wú)視
,version: false //一般用于更新模塊緩存谊娇,默認(rèn)不開啟检访。設(shè)為true即讓瀏覽器不緩存。也可以設(shè)為一個(gè)固定的值筐咧,如:201610
,debug: false //用于開啟調(diào)試模式鸯旁,默認(rèn)false噪矛,如果設(shè)為true,則JS模塊的節(jié)點(diǎn)會(huì)保留在頁(yè)面
,base: '' //設(shè)定擴(kuò)展的Layui模塊的所在目錄铺罢,一般用于外部模塊擴(kuò)展
});
定義模塊
方法:layui.define([mods], callback)
layui.define(function(exports){
//do something
exports('demo', function(){
alert('Hello World!');
});
});
加載所需模塊
layui.use(['laypage', 'layedit'], function(){
var laypage = layui.laypage
,layedit = layui.layedit
//do something
});
layui.use(['laypage', 'layedit'], function(laypage, layedit){
//使用分頁(yè)
laypage();
//建立編輯器
layedit.build();
});
動(dòng)態(tài)加載CSS
layui.link(href)
本地存儲(chǔ)
本地存儲(chǔ)是對(duì) localStorage 和 sessionStorage 的友好封裝艇挨,可更方便地管理本地?cái)?shù)據(jù)。
localStorage 持久化存儲(chǔ):layui.data(table, settings)韭赘,數(shù)據(jù)會(huì)永久存在雷袋,除非物理刪除。
sessionStorage 會(huì)話性存儲(chǔ):layui.sessionData(table, settings)辞居,頁(yè)面關(guān)閉后即失效楷怒。注:layui 2.2.5 新增
獲取設(shè)備信息
layui.device(key)
其它
方法/屬性 描述
layui.cache 靜態(tài)屬性。獲得一些配置及臨時(shí)的緩存信息
layui.extend(options) 拓展一個(gè)模塊別名瓦灶,如:layui.extend({test: '/res/js/test'})
layui.each(obj, fn) 對(duì)象(Array鸠删、Object、DOM對(duì)象等)遍歷贼陶,可用于取代for語(yǔ)句
layui.getStyle(node, name) 獲得一個(gè)原始DOM節(jié)點(diǎn)的style屬性值刃泡,如:layui.getStyle(document.body, 'font-size')
layui.img(url, callback, error) 圖片預(yù)加載
layui.sort(obj, key, desc) 將數(shù)組中的對(duì)象按某個(gè)成員重新對(duì)該數(shù)組排序,如:layui.sort([{a: 3},{a: 1},{a: 5}], 'a')
layui.router() 獲得location.hash路由碉怔,目前在Layui中沒(méi)發(fā)揮作用烘贴。對(duì)做單頁(yè)應(yīng)用會(huì)派上用場(chǎng)。
layui.hint() 向控制臺(tái)打印一些異常信息撮胧,目前只返回了error方法:layui.hint().error('出錯(cuò)啦')
layui.stope(e) 阻止事件冒泡
layui.onevent(modName, events, callback) 自定義模塊事件桨踪,屬于比較高級(jí)的應(yīng)用。有興趣的同學(xué)可以閱讀layui.js源碼以及form模塊
layui.event(modName, events, params) 執(zhí)行自定義模塊事件芹啥,搭配onevent使用
layui.factory(modName) 用于獲取模塊對(duì)應(yīng)的 define 回調(diào)函數(shù)
模塊命名空間
layui 的模塊接口會(huì)綁定在 layui 對(duì)象下锻离,內(nèi)部由 layui.define() 方法來(lái)完成。每一個(gè)模塊都會(huì)一個(gè)特有的名字墓怀,并且無(wú)法被占用汽纠。所以你無(wú)需擔(dān)心模塊的空間被污染,除非你主動(dòng) delete layui.{模塊名}傀履。調(diào)用模塊可通過(guò) layui.use 方法來(lái)實(shí)現(xiàn)虱朵,然后再通過(guò) layui 對(duì)象獲得模塊接口。
如何使用內(nèi)部jQuery
//主動(dòng)加載jquery模塊
layui.use(['jquery', 'layer'], function(){
var //重點(diǎn)處
,layer = layui.layer;
//后面就跟你平時(shí)使用jQuery一樣
$('body').append('hello jquery');
});