WeUI 简明入门指南

由于 WeUI 0.4.x 到 1.x 版本更新改动较大,所以本文仅适用于 0.4.x 版本,适用于 1.x 版本的入门指南请查看 WeUI 1.0 简明入门指南

之前做智慧校园的时候想找一个开源的移动端 UI 框架,找了好多个,比如淘宝的 SUI Mobile、QQ 的 FrozenUI 等,基本都没有满意的,这些框架要么过于庞杂,要么太像 iOS!最后无意间发现了 WeUI 这个框架,一眼就爱上了! 加了 WeUI 官方 QQ 群后发现好多童鞋都不知道怎么用,那我就写个简明的入门教程吧!

WeUI 是什么

WeUI 是微信官方设计团队为微信 Web 开发量身打造的一个 UI 样式库,你可以把它理解为一个前端框架,类似于 Bootstrap 的那种。 由于是微信官方出品,所以对微信的兼容性基本没有太大问题,而且各组件的样式和微信一样,能够和微信很好的融合在一起,给用户较好的体验。

如何使用

WeUI 是一个样式库,核心文件就是 weui.css,如果用于生产环境,建议使用官方提供的 CDN 或下载官方最新的 Releases 引入即可,CDN 地址可以在官方 Wiki 中找到,生产环境建议使用压缩后的 weui.min.css 。 来个简单的范例:

<!DOCTYPE html>
<html lang="zh-CN">
<head>
    <meta charset="UTF-8">
    <meta name="viewport" content="width=device-width,initial-scale=1,user-scalable=0">
    <title>WeUI</title>
    <!-- 引入 WeUI -->
    <link rel="stylesheet" href="http://res.wx.qq.com/open/libs/weui/0.4.0/weui.min.css">
</head>
<body ontouchstart>
    <!-- 使用 WeUI -->
    <a href="" class="weui_btn weui_btn_primary">绿色按钮</a>
</body>
</html>

注意:

  • viewport 那个 meta 标签不要忘了加
  • body 标签内有个 ontouchstart 属性也不要忘了

这样就搞定了,你可以任意使用各种组件了,关于组件怎么使用,去看官方 Wiki 就好了,或者 F12 去扒官方 Demo 把他们的代码复制过来就行了,就是这么简单粗暴!

组件

WeUI 的组件目前不是很多,但是也基本能满足大部分需求了。 官方 Demo 里面使用了前端路由,但这并不是 WeUI 的一部分,并且 Demo 内也写了一些自定义的 CSS 样式,也不是 WeUI 的一部分,所以我们使用的时候只有组件的样式可以直接复制来,其他的比如路由、逻辑操作、图片上传等都需要自己来搞定! 下面来几个组件的 Demo 方便需要的童鞋直接复制:

九宫格

九宫格就是官方 Demo 首页那个样式,九宫格不一定非要是九个,几个都可以的,看自己的需求了!

<div class="weui_grids">
    <a href="" class="weui_grid">
        <div class="weui_grid_icon">
            <img src="" alt="">
        </div>
        <p class="weui_grid_label"></p>
    </a>
    <a href="" class="weui_grid">
        <div class="weui_grid_icon">
            <img src="" alt="">
        </div>
        <p class="weui_grid_label"></p>
    </a>
</div>

weui_grids 是整个九宫格组件的样式,weui_grid 是一个一个宫格,我这里只写了两个,你需要几个就写几遍,weui_grid_icon 是一个宫格的图标,weui_grid_label 就是图标下面那个字咯! 图标最好使用矢量图,以保证在不同设备上的清晰度,图片的尺寸不需要自己写上,WeUI 已经帮你搞定了!

Tabbar

Tabbar 是位于页面底部的导航,相当于 App 的Dock 栏,通过点击每个按钮切换页面的主体内容。

<div class="weui_tab">
    <div class="weui_tab_bd"></div>
    <div class="weui_tabbar">
        <a href="" class="weui_tabbar_item weui_bar_item_on">
            <div class="weui_tabbar_icon">
                <img src="" alt="">
            </div>
            <p class="weui_tabbar_label">1</p>
        </a>
        <a href="" class="weui_tabbar_item">
            <div class="weui_tabbar_icon">
                <img src="" alt="">
            </div>
            <p class="weui_tabbar_label">2</p>
        </a>
        <a href="" class="weui_tabbar_item">
            <div class="weui_tabbar_icon">
                <img src="" alt="">
            </div>
            <p class="weui_tabbar_label">3</p>
        </a>
        <a href="" class="weui_tabbar_item">
            <div class="weui_tabbar_icon">
                <img src="" alt="">
            </div>
            <p class="weui_tabbar_label">4</p>
        </a>
    </div>
</div>

Tabbar 的 class 为weui_tabbar, 一般嵌套在 weui_tab 内,weui_tab_bd 为 Tab 页面的主体内容,weui_tabbar_item 为 Tabbar 的一个一个的按钮,建议为 3~5 个,weui_tabbar_icon 为每个按钮的图标,weui_tabbar_label 为图标下面的字,Active 状态可以使用 weui_bar_item_on 样式。 注意,你这样写完后会发现 Tabbar 位于页面最顶端,这是因为 WeUI 没有定义 html, body 的高度,所以给其定义个 height: 100%; 就可以了!

html,body{height: 100%;}

表单

这个就不写代码了,去复制 Demo 或 Wiki 里面的代码就好了,不过有一点要注意:你会发现表单内可以输入日期、时间和数字等,但这并不是 WeUI 的组件,而是使用 HTML 5 的 input 属性,然后调用的浏览器自身的控件来输入日期、时间等的。 日期:

<input type="date" class="weui_input">

时间:

<input type="datetime-local" class="weui_input">

数字:

<input type="number" class="weui_input">

更多 HTML 5 Input 类型请参考:HTML5 Input 类型

最后编辑于
©著作权归作者所有,转载或内容合作请联系作者
  • 序言:七十年代末,一起剥皮案震惊了整个滨河市,随后出现的几起案子,更是在滨河造成了极大的恐慌,老刑警刘岩,带你破解...
    沈念sama阅读 156,757评论 4 359
  • 序言:滨河连续发生了三起死亡事件,死亡现场离奇诡异,居然都是意外死亡,警方通过查阅死者的电脑和手机,发现死者居然都...
    沈念sama阅读 66,478评论 1 289
  • 文/潘晓璐 我一进店门,熙熙楼的掌柜王于贵愁眉苦脸地迎上来,“玉大人,你说我怎么就摊上这事。” “怎么了?”我有些...
    开封第一讲书人阅读 106,540评论 0 237
  • 文/不坏的土叔 我叫张陵,是天一观的道长。 经常有香客问我,道长,这世上最难降的妖魔是什么? 我笑而不...
    开封第一讲书人阅读 43,593评论 0 203
  • 正文 为了忘掉前任,我火速办了婚礼,结果婚礼上,老公的妹妹穿的比我还像新娘。我一直安慰自己,他们只是感情好,可当我...
    茶点故事阅读 51,903评论 3 285
  • 文/花漫 我一把揭开白布。 她就那样静静地躺着,像睡着了一般。 火红的嫁衣衬着肌肤如雪。 梳的纹丝不乱的头发上,一...
    开封第一讲书人阅读 40,329评论 1 210
  • 那天,我揣着相机与录音,去河边找鬼。 笑死,一个胖子当着我的面吹牛,可吹牛的内容都是我干的。 我是一名探鬼主播,决...
    沈念sama阅读 31,659评论 2 309
  • 文/苍兰香墨 我猛地睁开眼,长吁一口气:“原来是场噩梦啊……” “哼!你这毒妇竟也来了?” 一声冷哼从身侧响起,我...
    开封第一讲书人阅读 30,383评论 0 195
  • 序言:老挝万荣一对情侣失踪,失踪者是张志新(化名)和其女友刘颖,没想到半个月后,有当地人在树林里发现了一具尸体,经...
    沈念sama阅读 34,055评论 1 238
  • 正文 独居荒郊野岭守林人离奇死亡,尸身上长有42处带血的脓包…… 初始之章·张勋 以下内容为张勋视角 年9月15日...
    茶点故事阅读 30,337评论 2 241
  • 正文 我和宋清朗相恋三年,在试婚纱的时候发现自己被绿了。 大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
    茶点故事阅读 31,864评论 1 256
  • 序言:一个原本活蹦乱跳的男人离奇死亡,死状恐怖,灵堂内的尸体忽然破棺而出,到底是诈尸还是另有隐情,我是刑警宁泽,带...
    沈念sama阅读 28,227评论 2 251
  • 正文 年R本政府宣布,位于F岛的核电站,受9级特大地震影响,放射性物质发生泄漏。R本人自食恶果不足惜,却给世界环境...
    茶点故事阅读 32,820评论 3 231
  • 文/蒙蒙 一、第九天 我趴在偏房一处隐蔽的房顶上张望。 院中可真热闹,春花似锦、人声如沸。这庄子的主人今日做“春日...
    开封第一讲书人阅读 25,999评论 0 8
  • 文/苍兰香墨 我抬头看了看天上的太阳。三九已至,却和暖如春,着一层夹袄步出监牢的瞬间,已是汗流浃背。 一阵脚步声响...
    开封第一讲书人阅读 26,750评论 0 192
  • 我被黑心中介骗来泰国打工, 没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留,地道东北人。 一个月前我还...
    沈念sama阅读 35,365评论 2 269
  • 正文 我出身青楼,却偏偏与公主长得像,于是被迫代替她去往敌国和亲。 传闻我的和亲对象是个残疾皇子,可洞房花烛夜当晚...
    茶点故事阅读 35,260评论 2 258

推荐阅读更多精彩内容

  • Android 自定义View的各种姿势1 Activity的显示之ViewRootImpl详解 Activity...
    passiontim阅读 170,543评论 25 707
  • 发现 关注 消息 iOS 第三方库、插件、知名博客总结 作者大灰狼的小绵羊哥哥关注 2017.06.26 09:4...
    肇东周阅读 11,594评论 4 59
  • 接到一些私信问最近为什么没有更新,主要是一个奥斯卡典礼下来攒了不少稿子所以最近只能抽时间写些短评。所以这次只好先简...
    珞之同学阅读 422评论 24 11
  • 我本来标题想写成应该如何写作,但是后来想了想其实我也不知道怎么写,我也不知道怎么写才是好的,所以就诚实的加了副标题...
    Gzw丶南山阅读 280评论 0 0
  • 大千世界,强者如云。其中的至强者都有一段不朽的传奇,但真正横扫各方的万古无一,只因地有序,天有则。万古多少的至强只...
    羊橙阅读 520评论 0 0