---
title: 开始使用
toc: true
---

<h1 id="introduce" lay-toc="{title: '简介'}">开始使用</h1>

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

<p style="font-size: 68px; text-align: center; color: #16baaa;">
  Layui
</p>

<table class="layui-table">
  <tbody>
    <tr>
      <td>谐音:类 UI</td>
      <td>用途:用于更简单快速地构建网页界面</td>
    </tr>
    <tr>
      <td>环境:<a href="/notes/browser-support.html" target="_blank">详见不同版本的浏览器兼容规划</a> <sup>N</sup></td>
      <td>特性:原生态开发 / 轻量级模块化 / 外简内丰 / 开箱即用</td>
    </tr>
  </tbody>
</table>

<h2 id="install" lay-toc="">下载引用</h2>

您可以通过以下任意一种方式获得 Layui :

### 🌕 官网下载

您可以在 [官网首页](/) 或 [更新日志](./versions.html) 页面下载到 Layui,它经过了自动化构建,更适合用于生产环境。目录结构如下:

```
layui/
  ├─css
  │  └─layui.css   # 核心样式库
  └─layui.js       # 核心模块库
```

### 🌕 Git 下载

> 您也可以通过 [GitHub](https://github.com/layui/layui/releases) 或 [Gitee](https://gitee.com/layui/layui/releases) 的 releases 列表下载,或直接下载整个仓库。

<p>
  <iframe src="//ghbtns.com/github-btn.html?user=layui&amp;repo=layui&amp;type=watch&amp;count=true&amp;size=large" allowtransparency="true" frameborder="0" scrolling="0" width="156px" height="30px"></iframe>
  <iframe src="//ghbtns.com/github-btn.html?user=layui&amp;repo=layui&amp;type=fork&amp;count=true&amp;size=large" allowtransparency="true" frameborder="0" scrolling="0" width="156px" height="30px"></iframe>
</p>
<div class="layui-btn-container">
  <a class="layui-btn layui-btn-normal" href="https://github.com/layui/layui/" target="_blank" rel="nofollow" style="background-color: #24292E; color: #fff;">GitHub</a>
  <a class="layui-btn layui-btn-normal" href="https://gitee.com/layui/layui/" target="_blank" rel="nofollow" style="background-color: #C71D23; color: #fff;">Gitee</a>
</div>

### 🌕 npm 下载

```
npm i layui
```

### 🌕 第三方 CDN 方式引入:

> 以下均为知名第三方免费开放的公共资源 CDN,每期版本通过 NPM / GitHub 自动同步。

<div class="layui-btn-container">
  <a class="layui-btn layui-btn-primary layui-border-black" href="https://unpkg.com/browse/layui/dist/" target="_blank" rel="nofollow">UNPKG</a>
  <a class="layui-btn layui-btn-primary" style="border-color: #FF6934; color: #FF6934;" href="https://cdnjs.com/libraries/layui" target="_blank" rel="nofollow">CDNJS</a>
  <a class="layui-btn layui-btn-primary" style="border-color: #E64E3D; color: #E64E3D;" href="https://www.jsdelivr.com/package/npm/layui" target="_blank" rel="nofollow">JSDELIVR</a>
</div>


```
<!-- 引入 layui.css -->
<link href="//unpkg.com/layui@{{= d.layui[2].v }}/dist/css/layui.css" rel="stylesheet">
```
```
<!-- 引入 layui.js -->
<script src="//unpkg.com/layui@{{= d.layui[2].v }}/dist/layui.js"></script>
```

<h2 id="quickstart" lay-toc="{}">快速上手</h2>

现在,让我们以一个最简单的示例开始入门:

<pre class="layui-code" lay-options="{preview: 'iframe', previewStyle: 'height: 210px;', copy: true, tools: []}">
  <textarea>
<!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="{{= d.layui[2].cdn.css }}" rel="stylesheet">
</head>
<body>
  <!-- HTML Content -->
  <script src="{{= d.layui[2].cdn.js }}"></script>
  <script>
  // Usage
  layui.use(function(){
    var layer = layui.layer;
    // Welcome
    layer.msg('Hello World', {icon: 6});
  });
  </script>
</body>
</html>
  </textarea>
</pre>

点击上方 `Preview` 标签可进行效果预览。

<h3 id="help">其他帮助</h3>

- <a href="https://layui.dev/playground/2/">在线测试</a>
- <a href="https://github.com/Sight-wcg/layui-theme-dark" rel="nofollow" target="_blank">深色主题</a> (社区贡献)


## 初识寄语

> 愿 Layui 从此成为您得心应手的 Web 界面解决方案,化作您方寸屏幕前的亿万字节!