Layui 开源项目教程

2026-01-16 10:36:10作者：裴锟轩Denise

项目介绍

Layui 是一套开源免费的 Web UI 组件库，采用自身轻量级模块化规范，遵循原生态的 HTML/CSS/JavaScript 开发模式，极易上手，拿来即用。其风格简约轻盈，而内在雅致丰盈，甚至包括文档在内的每一处细节都经过精心雕琢，非常适合网页界面的快速构建。Layui 区别于一众主流的前端框架，却并非逆道而行，而是信奉返璞归真之道，确切地说，它更多是面向于追求简单的务实主义者。

项目快速启动

引入核心文件

首先，在您的 HTML 文件中引入 Layui 的核心 CSS 和 JavaScript 文件：

<!DOCTYPE html>
<html>
<head>
    <meta charset="utf-8" />
    <meta name="viewport" content="width=device-width, initial-scale=1" />
    <title>Quick Start - Layui</title>
    <link href="/layui/css/layui.css" rel="stylesheet" />
</head>
<body>
    <!-- HTML Content -->
    <script src="/layui/layui.js"></script>
    <script>
        // Usage
        layui.use(function () {
            var layer = layui.layer;
            // Welcome
            layer.msg("Hello World", { icon: 6 });
        });
    </script>
</body>
</html>

基本使用

在引入核心文件后，您可以通过 layui.use 方法来使用 Layui 的各个模块。例如，使用 layer 模块来显示一个欢迎消息：

layui.use(function () {
    var layer = layui.layer;
    layer.msg("Hello World", { icon: 6 });
});

应用案例和最佳实践

案例一：表单验证

Layui 提供了强大的表单验证功能，以下是一个简单的表单验证示例：

<!DOCTYPE html>
<html>
<head>
    <meta charset="utf-8" />
    <meta name="viewport" content="width=device-width, initial-scale=1" />
    <title>Form Validation - Layui</title>
    <link href="/layui/css/layui.css" rel="stylesheet" />
</head>
<body>
    <form class="layui-form">
        <div class="layui-form-item">
            <label class="layui-form-label">用户名</label>
            <div class="layui-input-block">
                <input type="text" name="username" required lay-verify="required" placeholder="请输入用户名" autocomplete="off" class="layui-input">
            </div>
        </div>
        <div class="layui-form-item">
            <label class="layui-form-label">密码</label>
            <div class="layui-input-block">
                <input type="password" name="password" required lay-verify="required" placeholder="请输入密码" autocomplete="off" class="layui-input">
            </div>
        </div>
        <div class="layui-form-item">
            <div class="layui-input-block">
                <button class="layui-btn" lay-submit lay-filter="formDemo">立即提交</button>
                <button type="reset" class="layui-btn layui-btn-primary">重置</button>
            </div>
        </div>
    </form>
    <script src="/layui/layui.js"></script>
    <script>
        layui.use(['form', 'layer'], function () {
            var form = layui.form;
            var layer = layui.layer;

            // 监听提交
            form.on('submit(formDemo)', function (data) {
                layer.msg(JSON.stringify(data.field));
                return false;
            });
        });
    </script>
</body>
</html>