Layui 是一款国产的开源前端 UI 框架,由贤心开发并长期维护。它的定位很清晰:面向传统 Web 项目,尤其是后台管理系统、企业官网、CMS 模板这类需要快速搭建界面的场景。与 Vue、React 这类构建式框架不同,Layui 采用「浏览器直接可用」的思路,不需要 Node 编译、不需要打包工具,下载解压、引入两个文件就能跑起来。框内置了栅格布局、按钮、表单、表格、弹层、日期选择、上传、分页等一整套组件,同时保留了模块化加载机制,体积轻、上手快,对 jQuery 时代的项目兼容性也比较好。下面从安装、引入、模块加载到常用组件,把 Layui 的使用方法完整梳理一遍。
打开 Layui 官网下载最新版本的压缩包,解压后得到一个完整的目录。核心文件只有三部分:css/layui.css 样式文件、layui.js 核心脚本,以及 font/ 图标字体目录。把整个 layui 文件夹原样复制到项目的静态资源目录,例如 static/layui/。这里要特别注意:不要只摘出 layui.js 而丢掉 font 目录,否则页面上所有图标都会显示成方块。
static/
layui/
css/layui.css
font/iconfont.eot 等图标文件
layui.js
modules/
如果只是临时演示、或者不想往项目目录里塞文件,可以用公共 CDN。国内建议选 npmmirror 或各云厂商的节点,境外节点有时不太稳定。使用时在页面头部引入 layui.css,在页面尾部引入 layui.js,版本号建议固定不要写 latest,避免版本升级导致样式突变。正式项目仍推荐下载到本地,否则 CDN 一波波动就能让整站样式失效。
在已有构建流程的项目里,执行 npm install layui 即可。然后在入口文件引入 layui/dist/css/layui.css 和 layui/dist/layui.js,通过全局变量 layui 使用。这种方式适合与 Vue、React 混合开发,但要注意组件必须在 DOM 挂载完成后再初始化,否则拿不到元素。
引入顺序不能颠倒:样式放在 head 里,脚本放在 body 末尾。Layui 的所有组件都通过 layui.use() 按需加载,回调里拿到对应模块对象后再调用方法。这样写的好处是用到哪个模块才请求哪个,页面加载更轻:
layui.use(['layer', 'form'], function () {
var layer = layui.layer;
var form = layui.form;
layer.msg('欢迎使用 Layui');
});
最小可用的完整流程是:引入 css 和 js → 页面上写一份带 layui 类名的 HTML 结构 → 在 use 回调里初始化组件。Layui 就是这样一个“写结构、加 class、初始化”的固定节奏,不需要额外配置。
给表单加上 class="layui-form",控件使用 layui-input、layui-select、layui-checkbox 等类名,然后在 use 回调里执行 form.render() 渲染。动态插入的表单元素需要重新 render 一次,否则不会显示 Layui 的样式。表单校验可以用 lay-verify="required|phone|email" 直接写在控件上,提交时用 form.on 绑定 submit 事件拦截,不刷新页面就能拿到字段值并提交给接口。
表格是 Layui 最受欢迎的组件,支持分页、排序、筛选、行工具栏、复选框。基础用法如下:
table.render({
elem: '#demo',
data: [
{id: 1, name: '张三', city: '郑州'},
{id: 2, name: '李四', city: '洛阳'}
],
page: true,
cols: [[
{field: 'id', title: 'ID', width: 80},
{field: 'name', title: '姓名'},
{field: 'city', title: '城市'}
]]
});
实际项目里通常把 data 换成 url,由后端返回指定格式的 JSON,再用 parseData 或 request 参数适配自己接口的字段名和分页参数,这点在 CMS 类项目里尤其常用。
layer.msg() 显示轻提示,layer.alert() 显示警告框,layer.open() 是最常用的通用弹层,可通过 type 指定页面层、iframe 层或加载层。做后台系统时,编辑弹窗一般用 type: 2 打开独立的 iframe 页面,关闭弹窗后再重新加载父页的表格数据。
日期组件用 laydate.render({elem: '#date'}),支持范围选择和自定义格式;上传组件用 upload.render(),指定 url、选择文件后的回调以及 accept 类型即可,进度条和失败提示框架已经处理好了,不用自己再写。
新手最容易踩的坑集中在几处。一是图标不显示,几乎都是 font 目录缺失或路径不对,检查一下 css 与 font 是否在同一级目录下即可。二是 layui.use 的回调不执行,通常有三种原因:layui.js 加载失败被浏览器拦截、模块名拼写错误、或者被其他脚本提前覆盖了 layui 变量,后者在引入多套前端库的项目里很常见。三是组件样式不生效,多数情况是漏了 layui-form 这类容器类名,或者动态拼接出来的元素没有重新 render。四是与 Vue、React 混用时,直接在组件 setup 阶段初始化 Layui 往往拿不到 DOM,应该放到 mounted 之后。另外 Layui 2.8 之后对模块加载做了调整,layui.use 的写法仍然兼容,但部分老版本的 layui.define 自定义模块写法需要按官方文档更新。
Layui 的价值在于「省事」:不引入构建工具、不写复杂配置,一个 CSS 加一个 JS,就能在半小时内搭出一个像样的后台界面。对于中小型项目、企业内部系统、CMS 模板开发来说,它依然是性价比很高的选择。只要掌握引入方式、layui.use 的模块加载逻辑,再熟悉表单、表格、弹层这几个高频组件,日常开发的大部分界面需求都能覆盖。等真正上手一个项目之后,你会发现它的文档和社区示例已经相当齐全,遇到问题基本都能在官网示例页里找到答案。
上一篇:没有了!
下一篇:没有了!