快速上手

首先需要说明,WeUI 仅仅是一个样式库而已,其核心文件是 weui.css ,所以与 JS 相关的功能需要自己实现,此入门指南所讲内容也仅限于 weui.css ,jQuery 版、Vue.js 版、React 版等均不在本文范围内,具体请参阅相应的文档。

与 JS 相关功能推荐使用微信官方的 weui.js,具体介绍及文档请参阅:https://github.com/Tencent/weui.js

1.0 改动

WeUI 1.0 版本相比于 0.4.x 版本增加了一些组件,比如 Flex 布局、Footer 等。但比较大的变化是采用了 BEM 命名规范,绝大多数的类名都变了,这也是重写这个入门指南的原因。

BEM 命名规范不在本文讲述范围内,请自行搜索了解、学习。

相关链接:

下载

可以通过上述下载地址下载最新版的 WeUI,而且每个版本都会有简略的更新日志。

本文以目前的最新版本 1.0.2 为例,下载后我们使用 dist/style 文件中的 weui.cssweui.min.css 两个文件。weui.min.cssweui.css 压缩后的版本,体积更小,建议在生产环境使用。

如果你需要修改一些样式,建议新建一个 css 文件覆盖原样式而不是修改原文件。

基本模板

将下载后得到的 weui.min.css 放在你项目的任意位置,然后在页面内引用即可,比如我将其放在根目录下的 css 文件夹内,下面给出一个简单的 HTML 模板。

  1. <!DOCTYPE html>
  2. <html lang="zh-CN">
  3. <head>
  4. <meta charset="UTF-8">
  5. <meta name="viewport" content="width=device-width,initial-scale=1,user-scalable=0">
  6. <title>WeUI</title>
  7. <link rel="stylesheet" href="css/weui.min.css">
  8. </head>
  9. <body ontouchstart>
  10. <!-- Your Code -->
  11. </body>
  12. </html>

注意不要忘了 viewport 的 meta 标签和 body 的 ontouchstart 属性。