element.html 28 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453454455456457458459460461462463464465466467468469470471472473474475476477478479480481482483484485486487488489490491492493494495496497498499500501502503504505506507508509510511512513514515516517518519520521522523524525526527528529530531532533534535536537538539540541542543544545546547548549550551552553554555556557558559560561562563564565566567568569570571572573574575576577578579580581582583584585586587588589590591592593594595596597598599600601602603604605606607608609610611612613614615616617618619620621622623624625626627628629630631632633634635636637638639640641642643644645646647648649650651652653654655656657658659660661662663664665666667668669670671672673674675676677678679680681682683684685686687688689690691692693694695696697698699700701702703704705706707708709710711712713714715716717718
  1. <!DOCTYPE html>
  2. <html>
  3. <head>
  4. <meta charset="utf-8">
  5. <title>镜像站@Layui 页面元素规范与说明</title>
  6. <meta name="renderer" content="webkit">
  7. <meta http-equiv="X-UA-Compatible" content="IE=edge,chrome=1">
  8. <meta name="viewport" content="width=device-width, initial-scale=1, maximum-scale=1">
  9. <meta name="apple-mobile-web-app-status-bar-style" content="black">
  10. <meta name="apple-mobile-web-app-capable" content="yes">
  11. <meta name="format-detection" content="telephone=no">
  12. <script>
  13. ;!function(){self!==parent&&(location.href="http://www.baidu.com/")}();
  14. </script>
  15. <link rel="stylesheet" href="/public/layui/dist/css/layui.css" tppabs="http://res.layui.com/layui/dist/css/layui.css?t=1632428048355" media="all">
  16. <link rel="stylesheet" href="/public/static/css/global.css" tppabs="http://res.layui.com/static/css/global.css?t=1632428048355-19" media="all">
  17. </head>
  18. <body>
  19. <div class="layui-header header header-doc" autumn>
  20. <div class="layui-container">
  21. <a class="logo" href="../../index.html" tppabs="http://www.layui.com/">
  22. <img src="/public/static/images/layui/logo.png" tppabs="http://res.layui.com/static/images/layui/logo.png" alt="layui">
  23. </a>
  24. <div class="layui-form layui-hide-xs component" lay-filter="LAY-site-header-component"></div>
  25. <div class="layui-hide-xs site-notice"></div>
  26. <ul class="layui-nav" id="LAY_NAV_TOP">
  27. <li class="layui-nav-item layui-this">
  28. <a href="../index.html" tppabs="http://www.layui.com/doc/">文档</a>
  29. </li>
  30. <li class="layui-nav-item ">
  31. <a href="../../demo/index.html" tppabs="http://www.layui.com/demo/">示例</a>
  32. </li>
  33. <li class="layui-nav-item">
  34. <a href="javascript:;">
  35. <!--<span class="layui-badge-dot" style="left:0; right: auto; margin: -4px 0 0 5px;"></span>-->
  36. 周边
  37. </a>
  38. <dl class="layui-nav-child layui-nav-child-c">
  39. <dd class="layui-hide-sm layui-show-xs" lay-unselect>
  40. <a href="https://gitee.com/sentsin/layui/issues" target="_blank" rel="nofollow">问题反馈</a>
  41. <hr>
  42. </dd>
  43. <dd lay-unselect><a href="../../alone.html" tppabs="http://www.layui.com/alone.html" target="_blank" lay-unselect>独立组件</a></dd>
  44. <dd lay-unselect><a href="../../../fly.layui.com/extend/index.html" target="_blank">扩展组件</a></dd>
  45. </dl>
  46. </li>
  47. <li class="layui-nav-item layui-hide-xs">
  48. <a href="http://gitee.com/sentsin/layui/issues" target="_blank" rel="nofollow">反馈</a>
  49. </li>
  50. </ul>
  51. </div>
  52. </div>
  53. <!-- 让IE8/9支持媒体查询,从而兼容栅格 -->
  54. <!--[if lt IE 9]>
  55. <script src="../../../other/html5shiv/r29/html5.min.js" tppabs="https://cdn.staticfile.org/html5shiv/r29/html5.min.js"></script>
  56. <script src="../../../other/respond.js/1.4.2/respond.min.js" tppabs="https://cdn.staticfile.org/respond.js/1.4.2/respond.min.js"></script>
  57. <![endif]-->
  58. <ul class="site-dir">
  59. <li><a href="#css"><cite>CSS规范</cite></a></li>
  60. <li><a href="#html"><cite>HTML规范</cite></a></li>
  61. <li><a href="#attr"><cite>常用公共属性</cite></a></li>
  62. </ul>
  63. <div class="layui-container layui-row">
  64. <div class="layui-col-md3">
  65. <div class="layui-panel site-menu">
  66. <ul class="layui-menu layui-menu-lg">
  67. <li class="layui-menu-item-group" lay-options="{type: 'group', isAllowSpread: true}">
  68. <div class="layui-menu-body-title">
  69. 基础说明
  70. </div>
  71. <hr>
  72. <ul>
  73. <li class="">
  74. <div class="layui-menu-body-title">
  75. <a href="../index.html" tppabs="http://www.layui.com/doc/">
  76. <span>开始使用 </span>
  77. <span class="layui-font-12 layui-font-gray">Getting Started</span>
  78. </a>
  79. </div>
  80. </li>
  81. <li class="">
  82. <div class="layui-menu-body-title">
  83. <a href="infrastructure.html" tppabs="http://www.layui.com/doc/base/infrastructure.html">
  84. <span>底层方法 </span>
  85. <span class="layui-font-12 layui-font-gray">基础支撑</span>
  86. </a>
  87. </div>
  88. </li>
  89. <li class="layui-menu-item-checked2">
  90. <div class="layui-menu-body-title">
  91. <a href="element.html" tppabs="http://www.layui.com/doc/base/element.html">
  92. <span>页面元素 </span>
  93. <span class="layui-font-12 layui-font-gray">规范 公共类 属性</span>
  94. </a>
  95. </div>
  96. </li>
  97. <li class="">
  98. <div class="layui-menu-body-title">
  99. <a href="modules.html" tppabs="http://www.layui.com/doc/base/modules.html">
  100. <span>模块规范 </span>
  101. <span class="layui-font-12 layui-font-gray">使用 扩展</span>
  102. </a>
  103. </div>
  104. </li>
  105. <li class="">
  106. <div class="layui-menu-body-title">
  107. <a href="faq.html" tppabs="http://www.layui.com/doc/base/faq.html">
  108. <span>常见问题 </span>
  109. <span class="layui-font-12 layui-font-gray">FAQ</span>
  110. </a>
  111. </div>
  112. </li>
  113. <li class="">
  114. <div class="layui-menu-body-title">
  115. <a href="changelog.html" tppabs="http://www.layui.com/doc/base/changelog.html">
  116. <span>更新日志 </span>
  117. <span class="layui-font-12 layui-font-gray">changelog</span>
  118. <span class="layui-badge-dot"></span>
  119. </a>
  120. </div>
  121. </li>
  122. </ul>
  123. </li>
  124. <li class="layui-menu-item-group" lay-options="{type: 'group', isAllowSpread: true}">
  125. <div class="layui-menu-body-title">
  126. 页面元素
  127. </div>
  128. <hr>
  129. <ul>
  130. <li class="">
  131. <div class="layui-menu-body-title">
  132. <a href="../element/layout.html" tppabs="http://www.layui.com/doc/element/layout.html">
  133. <span>布局 </span>
  134. <span class="layui-font-12 layui-font-gray">栅格 后台管理布局</span>
  135. </a>
  136. </div>
  137. </li>
  138. <li class="">
  139. <div class="layui-menu-body-title">
  140. <a href="../element/color.html" tppabs="http://www.layui.com/doc/element/color.html">
  141. <span>颜色 </span>
  142. <span class="layui-font-12 layui-font-gray">主色调 颜色搭配</span>
  143. </a>
  144. </div>
  145. </li>
  146. <li class="">
  147. <div class="layui-menu-body-title">
  148. <a href="../element/icon.html" tppabs="http://www.layui.com/doc/element/icon.html">
  149. <span>图标 </span>
  150. <span class="layui-font-12 layui-font-gray">iconfont 字体图标</span>
  151. </a>
  152. </div>
  153. </li>
  154. <li class="">
  155. <div class="layui-menu-body-title">
  156. <a href="../element/anim.html" tppabs="http://www.layui.com/doc/element/anim.html">
  157. <span>动画 </span>
  158. <span class="layui-font-12 layui-font-gray">内置 CSS3 动画</span>
  159. </a>
  160. </div>
  161. </li>
  162. <li class="">
  163. <div class="layui-menu-body-title">
  164. <a href="../element/button.html" tppabs="http://www.layui.com/doc/element/button.html">
  165. <span>按钮 </span>
  166. <span class="layui-font-12 layui-font-gray">button</span>
  167. </a>
  168. </div>
  169. </li>
  170. <li class="">
  171. <div class="layui-menu-body-title">
  172. <a href="../element/form.html" tppabs="http://www.layui.com/doc/element/form.html">
  173. <span>表单 </span>
  174. <span class="layui-font-12 layui-font-gray">form 元素集合</span>
  175. </a>
  176. </div>
  177. </li>
  178. <li class="">
  179. <div class="layui-menu-body-title">
  180. <a href="../element/nav.html" tppabs="http://www.layui.com/doc/element/nav.html">
  181. <span>导航 </span>
  182. <span class="layui-font-12 layui-font-gray">nav 面包屑</span>
  183. </a>
  184. </div>
  185. </li>
  186. <li class="">
  187. <div class="layui-menu-body-title">
  188. <a href="../element/menu.html" tppabs="http://www.layui.com/doc/element/menu.html">
  189. <span>菜单 </span>
  190. <span class="layui-font-12 layui-font-gray">menu 基础菜单</span>
  191. <span class="layui-badge-dot"></span>
  192. </a>
  193. </div>
  194. </li>
  195. <li class="">
  196. <div class="layui-menu-body-title">
  197. <a href="../element/tab.html" tppabs="http://www.layui.com/doc/element/tab.html">
  198. <span>选项卡 </span>
  199. <span class="layui-font-12 layui-font-gray">Tabs 切换</span>
  200. </a>
  201. </div>
  202. </li>
  203. <li class="">
  204. <div class="layui-menu-body-title">
  205. <a href="../element/progress.html" tppabs="http://www.layui.com/doc/element/progress.html">
  206. <span>进度条 </span>
  207. <span class="layui-font-12 layui-font-gray">progress</span>
  208. </a>
  209. </div>
  210. </li>
  211. <li class="">
  212. <div class="layui-menu-body-title">
  213. <a href="../element/panel.html" tppabs="http://www.layui.com/doc/element/panel.html">
  214. <span>面板 </span>
  215. <span class="layui-font-12 layui-font-gray">panel 卡片 折叠</span>
  216. </a>
  217. </div>
  218. </li>
  219. <li class="">
  220. <div class="layui-menu-body-title">
  221. <a href="../element/table.html" tppabs="http://www.layui.com/doc/element/table.html">
  222. <span>表格 </span>
  223. <span class="layui-font-12 layui-font-gray">静态 table</span>
  224. </a>
  225. </div>
  226. </li>
  227. <li class="">
  228. <div class="layui-menu-body-title">
  229. <a href="../element/badge.html" tppabs="http://www.layui.com/doc/element/badge.html">
  230. <span>徽章 </span>
  231. <span class="layui-font-12 layui-font-gray">小圆点 小边框</span>
  232. </a>
  233. </div>
  234. </li>
  235. <li class="">
  236. <div class="layui-menu-body-title">
  237. <a href="../element/timeline.html" tppabs="http://www.layui.com/doc/element/timeline.html">
  238. <span>时间线 </span>
  239. <span class="layui-font-12 layui-font-gray">timeline</span>
  240. </a>
  241. </div>
  242. </li>
  243. <li class="">
  244. <div class="layui-menu-body-title">
  245. <a href="../element/auxiliar.html" tppabs="http://www.layui.com/doc/element/auxiliar.html">
  246. <span>辅助 </span>
  247. <span class="layui-font-12 layui-font-gray">引用 字段集 横线等</span>
  248. </a>
  249. </div>
  250. </li>
  251. </ul>
  252. </li>
  253. <li class="layui-menu-item-group" lay-options="{type: 'group', isAllowSpread: true}">
  254. <div class="layui-menu-body-title">
  255. 内置模块
  256. </div>
  257. <hr>
  258. <ul>
  259. <li class="">
  260. <div class="layui-menu-body-title">
  261. <a href="../modules/layer.html" tppabs="http://www.layui.com/doc/modules/layer.html">
  262. <span>弹出层 </span>
  263. <span class="layui-font-12 layui-font-gray">layer</span>
  264. </a>
  265. </div>
  266. </li>
  267. <li class="">
  268. <div class="layui-menu-body-title">
  269. <a href="../modules/laydate.html" tppabs="http://www.layui.com/doc/modules/laydate.html">
  270. <span>日期与时间选择 </span>
  271. <span class="layui-font-12 layui-font-gray">laydate</span>
  272. </a>
  273. </div>
  274. </li>
  275. <li class="">
  276. <div class="layui-menu-body-title">
  277. <a href="../modules/laypage.html" tppabs="http://www.layui.com/doc/modules/laypage.html">
  278. <span>分页 </span>
  279. <span class="layui-font-12 layui-font-gray">laypage</span>
  280. </a>
  281. </div>
  282. </li>
  283. <li class="">
  284. <div class="layui-menu-body-title">
  285. <a href="../modules/laytpl.html" tppabs="http://www.layui.com/doc/modules/laytpl.html">
  286. <span>模板引擎 </span>
  287. <span class="layui-font-12 layui-font-gray">laytpl</span>
  288. </a>
  289. </div>
  290. </li>
  291. <li class="">
  292. <div class="layui-menu-body-title">
  293. <a href="../modules/table.html" tppabs="http://www.layui.com/doc/modules/table.html">
  294. <span>数据表格 </span>
  295. <span class="layui-font-12 layui-font-gray">table</span>
  296. </a>
  297. </div>
  298. </li>
  299. <li class="">
  300. <div class="layui-menu-body-title">
  301. <a href="../modules/form.html" tppabs="http://www.layui.com/doc/modules/form.html">
  302. <span>表单 </span>
  303. <span class="layui-font-12 layui-font-gray">form</span>
  304. </a>
  305. </div>
  306. </li>
  307. <li class="">
  308. <div class="layui-menu-body-title">
  309. <a href="../modules/upload.html" tppabs="http://www.layui.com/doc/modules/upload.html">
  310. <span>文件上传 </span>
  311. <span class="layui-font-12 layui-font-gray">upload</span>
  312. </a>
  313. </div>
  314. </li>
  315. <li class="">
  316. <div class="layui-menu-body-title">
  317. <a href="../modules/dropdown.html" tppabs="http://www.layui.com/doc/modules/dropdown.html">
  318. <span>下拉菜单 </span>
  319. <span class="layui-font-12 layui-font-gray">dropdown</span>
  320. <span class="layui-badge-dot"></span>
  321. </a>
  322. </div>
  323. </li>
  324. <li class="">
  325. <div class="layui-menu-body-title">
  326. <a href="../modules/transfer.html" tppabs="http://www.layui.com/doc/modules/transfer.html">
  327. <span>穿梭框 </span>
  328. <span class="layui-font-12 layui-font-gray">transfer</span>
  329. </a>
  330. </div>
  331. </li>
  332. <li class="">
  333. <div class="layui-menu-body-title">
  334. <a href="../modules/tree.html" tppabs="http://www.layui.com/doc/modules/tree.html">
  335. <span>树形组件 </span>
  336. <span class="layui-font-12 layui-font-gray">tree</span>
  337. </a>
  338. </div>
  339. </li>
  340. <li class="">
  341. <div class="layui-menu-body-title">
  342. <a href="../modules/colorpicker.html" tppabs="http://www.layui.com/doc/modules/colorpicker.html">
  343. <span>颜色选择器 </span>
  344. <span class="layui-font-12 layui-font-gray">colorpicker</span>
  345. </a>
  346. </div>
  347. </li>
  348. <li class="">
  349. <div class="layui-menu-body-title">
  350. <a href="../modules/element.html" tppabs="http://www.layui.com/doc/modules/element.html">
  351. <span>常用元素操作 </span>
  352. <span class="layui-font-12 layui-font-gray">element</span>
  353. </a>
  354. </div>
  355. </li>
  356. <li class="">
  357. <div class="layui-menu-body-title">
  358. <a href="../modules/slider.html" tppabs="http://www.layui.com/doc/modules/slider.html">
  359. <span>滑块 </span>
  360. <span class="layui-font-12 layui-font-gray">slider</span>
  361. </a>
  362. </div>
  363. </li>
  364. <li class="">
  365. <div class="layui-menu-body-title">
  366. <a href="../modules/rate.html" tppabs="http://www.layui.com/doc/modules/rate.html">
  367. <span>评分 </span>
  368. <span class="layui-font-12 layui-font-gray">rate</span>
  369. </a>
  370. </div>
  371. </li>
  372. <li class="">
  373. <div class="layui-menu-body-title">
  374. <a href="../modules/carousel.html" tppabs="http://www.layui.com/doc/modules/carousel.html">
  375. <span>轮播 </span>
  376. <span class="layui-font-12 layui-font-gray">carousel</span>
  377. </a>
  378. </div>
  379. </li>
  380. <li class="">
  381. <div class="layui-menu-body-title">
  382. <a href="layedit.html" tppabs="http://www.layui.com/doc/modules/layedit.html">
  383. <span>富文本编辑器 </span>
  384. <span class="layui-font-12 layui-font-gray">layedit</span>
  385. </a>
  386. </div>
  387. </li>
  388. <li class="">
  389. <div class="layui-menu-body-title">
  390. <a href="../modules/flow.html" tppabs="http://www.layui.com/doc/modules/flow.html">
  391. <span>流加载 </span>
  392. <span class="layui-font-12 layui-font-gray">flow</span>
  393. </a>
  394. </div>
  395. </li>
  396. <li class="">
  397. <div class="layui-menu-body-title">
  398. <a href="../modules/util.html" tppabs="http://www.layui.com/doc/modules/util.html">
  399. <span>工具组件 </span>
  400. <span class="layui-font-12 layui-font-gray">util</span>
  401. </a>
  402. </div>
  403. </li>
  404. <li class="">
  405. <div class="layui-menu-body-title">
  406. <a href="../modules/code.html" tppabs="http://www.layui.com/doc/modules/code.html">
  407. <span>代码高亮显示 </span>
  408. <span class="layui-font-12 layui-font-gray">code</span>
  409. </a>
  410. </div>
  411. </li>
  412. </ul>
  413. </li>
  414. </ul>
  415. </div>
  416. <div class="layui-hide-v"> - </div>
  417. </div>
  418. <div class="layui-col-md9 site-content">
  419. <h1 class="site-h1">页面元素规范与说明</h1>
  420. <blockquote class="layui-elem-quote">layui 提倡返璞归真,遵循于原生态的元素书写规则,所以通常而言,你仍然是在写基本的 HTML 和 CSS 代码,不同的是,在 HTML 结构上及 CSS 定义上需要小小遵循一定的规范。</p>
  421. </blockquote>
  422. <div class="site-title">
  423. <fieldset><legend><a name="css">CSS内置公共基础类</a></legend></fieldset>
  424. </div>
  425. <table class="layui-table">
  426. <colgroup>
  427. <col width="150">
  428. <col>
  429. </colgroup>
  430. <thead>
  431. <tr>
  432. <th>类名(class)</th>
  433. <th>说明</th>
  434. </tr>
  435. </thead>
  436. <tbody>
  437. <tr>
  438. <td colspan="2" style="text-align: center">布局 / 容器</td>
  439. </tr>
  440. <tr>
  441. <td>layui-main</td>
  442. <td>用于设置一个宽度为 1140px 的水平居中块(无响应式)</td>
  443. </tr>
  444. <tr>
  445. <td>layui-inline</td>
  446. <td>用于将标签设为内联块状元素</td>
  447. </tr>
  448. <tr>
  449. <td>layui-box</td>
  450. <td>用于排除一些UI框架(如Bootstrap)强制将全部元素设为box-sizing: border-box所引发的尺寸偏差</td>
  451. </tr>
  452. <tr>
  453. <td>layui-clear</td>
  454. <td>用于消除浮动(一般不怎么常用,因为layui几乎没用到浮动)</td>
  455. </tr>
  456. <tr>
  457. <td>layui-btn-container</td>
  458. <td>用于定义按钮的父容器。(layui 2.2.5 新增)</td>
  459. </tr>
  460. <tr>
  461. <td>layui-btn-fluid</td>
  462. <td>用于定义流体按钮。即宽度最大化适应。(layui 2.2.5 新增)</td>
  463. </tr>
  464. <tr>
  465. <td colspan="2" style="text-align: center">辅助</td>
  466. </tr>
  467. <tr>
  468. <td>layui-icon</td>
  469. <td>用于图标</td>
  470. </tr>
  471. <tr>
  472. <td>layui-elip</td>
  473. <td>用于单行文本溢出省略</td>
  474. </tr>
  475. <tr>
  476. <td>layui-unselect</td>
  477. <td>用于屏蔽选中</td>
  478. </tr>
  479. <tr>
  480. <td>layui-disabled</td>
  481. <td>用于设置元素不可点击状态</td>
  482. </tr>
  483. <tr>
  484. <td>layui-circle</td>
  485. <td>用于设置元素为圆形</td>
  486. </tr>
  487. <tr>
  488. <td>layui-show</td>
  489. <td>用于显示块状元素</td>
  490. </tr>
  491. <tr>
  492. <td>layui-hide</td>
  493. <td>用于隐藏元素</td>
  494. </tr>
  495. <tr>
  496. <td colspan="2" style="text-align: center">文本</td>
  497. </tr>
  498. <tr>
  499. <td>layui-text</td>
  500. <td>定义一段文本区域(如文章),该区域内的特殊标签(如a、li、em等)将会进行相应处理</td>
  501. </tr>
  502. <tr>
  503. <td>layui-word-aux</td>
  504. <td>灰色标注性文字,左右会有间隔</td>
  505. </tr>
  506. <tr>
  507. <td colspan="2" style="text-align: center">背景色</td>
  508. </tr>
  509. <tr>
  510. <td>layui-bg-red</td>
  511. <td>用于设置元素赤色背景</td>
  512. </tr>
  513. <tr>
  514. <td>layui-bg-orange</td>
  515. <td>用于设置元素橙色背景</td>
  516. </tr>
  517. <tr>
  518. <td>layui-bg-green</td>
  519. <td>用于设置元素墨绿色背景(主色调)</td>
  520. </tr>
  521. <tr>
  522. <td>layui-bg-cyan</td>
  523. <td>用于设置元素藏青色背景</td>
  524. </tr>
  525. <tr>
  526. <td>layui-bg-blue</td>
  527. <td>用于设置元素蓝色背景</td>
  528. </tr>
  529. <tr>
  530. <td>layui-bg-black</td>
  531. <td> 用于设置元素经典黑色背景</td>
  532. </tr>
  533. <tr>
  534. <td>layui-bg-gray</td>
  535. <td>用于设置元素经典灰色背景</td>
  536. </tr>
  537. <tr>
  538. <td colspan="2" style="text-align: center">字体大小及颜色 <a name="font"></a></td>
  539. </tr>
  540. <tr>
  541. <td colspan="2">
  542. <pre class="layui-code">
  543. layui-font-12 (12px 的字体)
  544. layui-font-14 (14px 的字体)
  545. layui-font-16 (16px 的字体)
  546. layui-font-18 (18px 的字体)
  547. layui-font-20 (20px 的字体)
  548. layui-font-red (红色字体)
  549. layui-font-orange (橙色字体)
  550. layui-font-green (绿色字体)
  551. layui-font-cyan (青色字体)
  552. layui-font-blue (蓝色字体)
  553. layui-font-black (黑色字体)
  554. layui-font-gray (灰色字体)
  555. </pre>
  556. </td>
  557. </tr>
  558. </tbody>
  559. </table>
  560. <div class="site-title">
  561. <fieldset><legend><a name="css">CSS命名规范</a></legend></fieldset>
  562. </div>
  563. <div class="site-text">
  564. <p>class命名前缀:<em>layui</em>,连接符:<em>-</em>,如:<em>class="layui-form"</em></p>
  565. <p>命名格式一般分为两种:一:<em>layui-模块名-状态或类型</em>,二:<em>layui-状态或类型</em>。因为有些类并非是某个模块所特有,他们通常会是一些公共类。如:一(定义按钮的原始风格):<em>class="layui-btn layui-btn-primary"</em>、二(定义内联块状元素):<em>class="layui-inline"</em></p>
  566. <p>大致记住这些简单的规则,会让你在填充HTML的时候显得更加得心应手。另外,如果你是开发Layui拓展(模块),你最好也要遵循于类似的规则,并且请勿占用Layui已经命名好的类,假设你是在帮Layui开发一个markdown编辑器,你的css书写规则应该如下:</p>
  567. <pre class="layui-code" lay-title="CSS">
  568. .layui-markdown{border: 1px solid #e2e2e2;}
  569. .layui-markdown-tools{}
  570. .layui-markdown-text{}
  571. </pre>
  572. </div>
  573. <div class="site-title">
  574. <fieldset><legend><a name="html">HTML规范:结构</a></legend></fieldset>
  575. </div>
  576. <div class="site-text">
  577. <p>Layui在解析HTML元素时,必须充分确保其结构是被支持的。以Tab选项卡为例:</p>
  578. <pre class="layui-code" lay-title="HTML">
  579. &lt;div class=&quot;layui-tab&quot;&gt;
  580. &lt;ul class=&quot;layui-tab-title&quot;&gt;
  581. &lt;li class=&quot;layui-this&quot;&gt;标题一&lt;/li&gt;
  582. &lt;li&gt;标题二&lt;/li&gt;
  583. &lt;li&gt;标题三&lt;/li&gt;
  584. &lt;/ul&gt;
  585. &lt;div class=&quot;layui-tab-content&quot;&gt;
  586. &lt;div class=&quot;layui-tab-item layui-show&quot;&gt;内容1&lt;/div&gt;
  587. &lt;div class=&quot;layui-tab-item&quot;&gt;内容2&lt;/div&gt;
  588. &lt;div class=&quot;layui-tab-item&quot;&gt;内容3&lt;/div&gt;
  589. &lt;/div&gt;
  590. &lt;/div&gt;
  591. </pre>
  592. <p>你如果改变了结构,极有可能会导致Tab功能失效。所以在嵌套HTML的时候,你应该细读各个元素模块的相关文档(如果你不是拿来主义)</p>
  593. </div>
  594. <div class="site-title">
  595. <fieldset><legend><a name="attr">HTML规范:常用公共属性</a></legend></fieldset>
  596. </div>
  597. <div class="site-text">
  598. <p>很多时候,元素的基本交互行为,都是由模块自动开启。但不同的区域可能需要触发不同的动作,这就需要你设定我们所支持的自定义属性来作为区分。如下面的 <em>lay-submit</em>、<em>lay-filter</em>即为公共属性(即以 <em>lay-</em> 作为前缀的自定义属性):</p>
  599. <pre class="layui-code">
  600. &lt;button class="layui-btn" lay-submit lay-filter="login">登入&lt;/button>
  601. </pre>
  602. <p>目前我们的公共属性如下所示(即普遍运用于所有元素上的属性)</p>
  603. <table class="layui-table">
  604. <thead>
  605. <tr>
  606. <th style="width: 100px;">属性</th>
  607. <th>描述</th>
  608. </tr>
  609. </thead>
  610. <tbody>
  611. <tr>
  612. <td>lay-skin=" "</td>
  613. <td>定义相同元素的不同风格,如checkbox的开关风格</td>
  614. </tr>
  615. <tr>
  616. <td>lay-filter=" "</td>
  617. <td>事件过滤器。你可能会在很多地方看到他,他一般是用于监听特定的自定义事件。你可以把它看作是一个ID选择器</td>
  618. </tr>
  619. <tr>
  620. <td>lay-submit</td>
  621. <td>定义一个触发表单提交的button,不用填写值</td>
  622. </tr>
  623. <tr>
  624. </tbody>
  625. </table>
  626. <p>额,好像有点少的样子(反正你也基本不会看文档。。(づ╥﹏╥)づ)。其它的自定义属性基本都在各自模块的文档中有所介绍。</p>
  627. </div>
  628. <div class="site-title">
  629. <fieldset><legend><a name="other">结语</a></legend></fieldset>
  630. </div>
  631. <div class="site-text">
  632. <p>其实很多时候并不想陈列条条框框(除了一些特定需要的),所以你会发现本篇的篇幅较短。(哈哈哈哈哈,其实是写文档写得想吐了)</p>
  633. </div>
  634. <div class="layui-elem-quote">
  635. <p>layui - 在每一个细节中,用心与你沟通</p>
  636. </div>
  637. </div>
  638. </div>
  639. <div class="layui-footer footer footer-doc">
  640. <p>
  641. Copyright &copy; 2021 <a href="../../index.html" tppabs="http://www.layui.com/">「本站仅为 layui 文档保留的镜像站点,与官方无关」</a> MIT Licensed</p>
  642. <p>
  643. <a href="../../about/disclaimer.html" tppabs="http://www.layui.com/about/disclaimer.html" target="_blank">免责声明</a>
  644. <a href="../../about/relatedlinks.html" tppabs="http://www.layui.com/about/relatedlinks.html" target="_blank">友链</a>
  645. <a href="javascript:;" site-event="weixinmp">公众号</a>
  646. </p>
  647. </div>
  648. <script>
  649. window.global = {
  650. pageType: 'doc'
  651. ,preview: function(){
  652. var preview = document.getElementById('LAY_preview');
  653. return preview ? preview.innerHTML : '';
  654. }()
  655. };
  656. </script>
  657. <div class="site-tree-mobile layui-hide">
  658. <i class="layui-icon layui-icon-spread-left"></i>
  659. </div>
  660. <div class="site-mobile-shade"></div>
  661. <script src="/public/layui/dist/layui.js" tppabs="http://res.layui.com/layui/dist/layui.js?t=1632428048355" charset="utf-8"></script>
  662. <script>
  663. layui.config({
  664. base: '/public/static/lay/modules/layui/'
  665. ,version: '1632428048355'
  666. }).use('global');
  667. </script>
  668. <script>
  669. </script>
  670. </body>
  671. </html>