百度360必应搜狗淘宝本站头条
当前位置:网站首页 > 技术文章 > 正文

微信小程序入门教程之二:页面样式

zhezhongyun 2025-05-16 18:03 40 浏览

这个系列的上一篇教程,教大家写了一个最简单的 Hello world 微信小程序。

但是,那只是一个裸页面,并不好看。今天接着往下讲,如何为这个页面添加样式,使它看上去更美观,教大家写出实际可以使用的页面。

所有示例的完整代码,都可以从 GitHub 的代码仓库[1]下载。

一、总体样式

微信小程序允许在顶层放置一个app.wxss文件,里面采用 CSS 语法设置页面样式。这个文件的设置,对所有页面都有效。

注意,小程序虽然使用 CSS 样式,但是样式文件的后缀名一律要写成.wxss

打开上一篇教程的示例,在项目顶层新建一个app.wxss文件,内容如下。

page {
background-color: pink;
}

text {
font-size: 24pt;
color: blue;
}

上面代码将整个页面的背景色设为粉红,然后将<text>标签的字体大小设为 24 磅,字体颜色设为蓝色。

开发者工具导入代码之后,得到了下面的渲染结果。

可以看到,页面的背景色变成粉红,文本字体变大了,字体颜色变成了蓝色。

实际开发中,直接对<text>标签设置样式,会影响到所有的文本。一般不这样用,而是通过class属性区分不同类型的文本,然后再对每种class设置样式。

打开pages/home/home.wxml文件,把页面代码改成下面这样。

<view>
<text class="title">hello world</text>
</view>

上面代码中,我们为<text>标签加上了一个class属性,值为title

然后,将顶层的app.wxss文件改掉,不再直接对<text>设置样式,改成对class设置样式。

page {
background-color: pink;
}

.title {
font-size: 24pt;
color: blue;
}

上面代码中,样式设置在 class 上面(.title),这样就可以让不同的class呈现不同的样式。修改之后,页面的渲染结果并不会有变化。

这个示例的完整代码,可以到代码仓库[2]查看。

二、Flex 布局

各种页面元素的位置关系,称为布局(layout),小程序官方推荐使用 Flex 布局。不熟悉这种布局的同学,可以看看我写的《Flex 布局教程》[3]

下面演示如何通过 Flex 布局,将上面示例的文本放置到页面中央。

首先,在pages/home目录里面,新建一个home.wxss文件,这个文件设置的样式,只对 home 页面生效。这是因为每个页面通常有不一样的布局,所以页面布局一般不写在全局的app.wxss里面。

然后,home.wxss文件写入下面的内容。

page {
height: 100%;
width: 750rpx;
display: flex;
justify-content: center;
align-items: center;
}

开发者工具导入项目代码,页面渲染结果如下。

下面解释一下上面这段 WXSS 代码,还是很简单的。

(1)height: 100%;:页面高度为整个屏幕高度。

(2)width: 750rpx;:页面宽度为整个屏幕宽度。

注意,这里单位是rpx,而不是pxrpx是小程序为适应不同宽度的手机屏幕,而发明的一种长度单位。不管什么手机屏幕,宽度一律为750rpx。它的好处是换算简单,如果一个元素的宽度是页面的一半,只要写成width: 375rpx;即可。

(3)display: flex;:整个页面(page)采用 Flex 布局。

(4)justify-content: center;:页面的一级子元素(这个示例是<view>)水平居中。

(5)align-items: center;:页面的一级子元素(这个示例是<view>)垂直居中。一个元素同时水平居中和垂直中央,就相当于处在页面的中央了。

这个示例的完整代码,可以到代码仓库[4]查看。

三、WeUI

如果页面的所有样式都自己写,还是挺麻烦的,也没有这个必要。腾讯封装了一套 UI 框架 WeUI[5],可以拿来用。

手机访问 weui.io[6],可以看到这套 UI 框架的效果。

这一节就来看看,怎么使用这个框架的小程序版本 WeUI-WXSS[7],为我们的页面加上官方的样式。

首先,进入它的 GitHub 仓库[8],在dist/style目录下面,找到`weui.wxss`[9]这个文件,将源码[10]全部复制到你的app.wxss文件的头部。

然后,将page/home/home.wxml文件改成下面这样。

<view>
<button class="weui-btn weui-btn_primary">
主操作
</button>
<button class="weui-btn weui-btn_primary weui-btn_loading">
<i class="weui-loading"></i>正在加载
</button>
<button class="weui-btn weui-btn_primary weui-btn_disabled">
禁止点击
</button>
</view>

开发者工具导入项目代码,页面渲染结果如下。

可以看到,加入 WeUI 框架以后,只要为按钮添加不同的 class,就能自动出现框架提供的样式。你可以根据需要,为页面选择不同的按钮。

这个示例中,<button>元素使用了下面的class

  • weui-btn:按钮样式的基类

  • weui-btn_primary:主按钮的样式。如果是次要按钮,就使用weui-btn_default

  • weui-btn_loading:按钮点击后,操作正在进行中的样式。该类内部需要用<i>元素,加上表示正在加载的图标。

  • weui-btn_disabled:按钮禁止点击的样式。

WeUI 提供了大量的元素样式,完整的清单可以查看这里[11]

这个示例的完整代码,可以到代码仓库[12]查看。

四、加入图片

美观的页面不能光有文字,还必须有图片。小程序的<image>组件就用来加载图片。

打开home.wxml文件,将其改为如下代码。

<view>
<image src="https://picsum.photos/200"></image>
</view>

开发者工具加载项目代码,页面的渲染结果如下,可以显示图片了。

<image>组件有很多属性[13],比如可以通过style属性指定样式。

<view>
<image
src="https://picsum.photos/200"
style="height: 375rpx; width: 375rpx;"
></image>
</view>

默认情况下,图片会占满整个容器的宽度(这个例子是<view>的宽度),上面代码通过style属性指定图片的高度和宽度(占据页面宽度的一半),渲染结果如下。

当然,图片样式不一定写在<image>组件里面,也可以写在 WXSS 样式文件里面。

这个示例的完整代码,可以到代码仓库[14]查看。

五、图片轮播

小程序原生的`[15]可以提供图片轮播效果。

上面页面的图片上面,有三个提示点,表示一共有三张图片,可以切换显示。

它的代码很简单,只需要改一下home.wxml文件即可。

<view>
<swiper
indicator-dots="{{true}}"
autoplay="{{true}}"
style="width: 750rpx;">
<swiper-item>
<image src="https://picsum.photos/200"></image>
</swiper-item>
<swiper-item>
<image src="https://picsum.photos/250"></image>
</swiper-item>
<swiper-item>
<image src="https://picsum.photos/300"></image>
</swiper-item>
</swiper>
</view>

上面代码中,<swiper>组件就是轮播组件,里面放置了三个`[16],表示有三个轮播项目,每个项目就是一个<image>组件。

<swiper>组件的indicator-dots属性设置是否显示轮播点,autoplay属性设置是否自动播放轮播。它们的属性值都是一个布尔值,这里要写成{{true}}。这种{{...}}的语法,表示里面放置的是 JavaScript 代码,这个放在下一次讲解。

这个示例的完整代码,可以到代码仓库[17]查看。

页面样式就讲到这里,下一篇教程讲解怎么在微信小程序里面加入 JavaScript 脚本,跟用户互动。

注意,由于脚本代码比较多,这个系列的后两篇教程将不在微信公号上连载了,大家可以去我的个人网站阅读。

(完)

参考资料

[1]

代码仓库:
https://github.com/ruanyf/wechat-miniprogram-demos

[2]

代码仓库:
https://github.com/ruanyf/wechat-miniprogram-demos/tree/master/demos/03.css

[3]

《Flex 布局教程》:
http://www.ruanyifeng.com/blog/2015/07/flex-grammar.html

[4]

代码仓库:
https://github.com/ruanyf/wechat-miniprogram-demos/tree/master/demos/04.flex

[5]

WeUI: https://github.com/Tencent/weui

[6]

weui.io: https://weui.io/

[7]

WeUI-WXSS: https://github.com/Tencent/weui-wxss/

[8]

GitHub 仓库:
https://github.com/Tencent/weui-wxss/

[9]

weui.wxss:https://github.com/Tencent/weui-wxss/blob/master/dist/style/weui.wxss

[10]

源码:
https://raw.githubusercontent.com/Tencent/weui-wxss/master/dist/style/weui.wxss

[11]

这里:
https://github.com/Tencent/weui-wxss

[12]

代码仓库:
https://github.com/ruanyf/wechat-miniprogram-demos/tree/master/demos/05.weui

[13]

很多属性:
https://developers.weixin.qq.com/miniprogram/dev/component/image.html

[14]

代码仓库:
https://github.com/ruanyf/wechat-miniprogram-demos/tree/master/demos/06.image

[15]

<swiper>组件:
https://developers.weixin.qq.com/miniprogram/dev/component/swiper.html

[16]

<swiper-item>组件:
https://developers.weixin.qq.com/miniprogram/dev/component/swiper-item.html

[17]

代码仓库:
https://github.com/ruanyf/wechat-miniprogram-demos/tree/master/demos/07.swiper

相关推荐

不看必后悔!15个三星GoodLock隐藏小技巧~(上)

很多刚用三星手机的星粉们,一定对三星GoodLock这个宝藏App还不是很了解,今天就带大家一起详细去看看GoodLock这个大家族究竟有多少宝藏功能及成员呢?让我们一起来看看吧~由于Good...

惊魂幻象理智值监控WA!大字体+范围提示一目了然

一个WA助你轻松监控大幻象理智值,不再错过恢复时机这个WA用大字体实时同步我们的理智值下面的图标提示恢复宝珠的剩余次数上面的图标高亮则意味着我们在宝珠的恢复范围内我们可以将图标随意移动到适合自己观察的...

盘点十个超炫的jQuery插件(jquery插件是干什么的)

“DevExpress14.2新版发布会”即将推出。心动不如行动,赶快报名吧!我们期待与您相约。今天小编为大家搜罗了十个超酷的jQuery插件,这可以使你的网站界面更加友好。jQuery创造了令人难...

Google官方梳理,Android 多返回栈技术详解

用户通过系统返回按钮导航回去的一组页面,在开发中被称为返回栈(backstack)。多返回栈即一堆"返回栈",对多返回栈的支持是在Navigation2.4.0-alpha0...

说三星手机系统不好用,因为没有玩明白三星,三星Diy功能超强大

都说三星手机系统不好用,其实真正用起来,挺好用的三星手机系统像块没打磨的玉,默认设置是基础款,用着普通。但你要是肯花点时间,它能变得特别顺手。关键就在一个叫GoodLock的工具,它是三星自家出的...

Sam Helper三星手机用户必装神器(三星手机必装app)

SamHelper这款软件集合了三星手机主题工具当前主题o主题路径o主题安装系统设置屏幕模式o状态栏o文件o频段o暗码Lock&LabsGoodLockoGalaxyLa...

外卖套餐搭配的探索和应用(外卖套餐搭配技巧)

本文系外卖美食知识图谱系列的第三篇文章,从技术层面我们会介绍外卖套餐搭配的技术方案,包括离线、实时的套餐搭配的迭代,套餐质量评估方案,同时会介绍套餐搭配的业务应用。1.背景让用户更方便快捷地选购到满...

用几行原生JS就可以实现丝滑的元素过渡效果

作者:ConardLi大家可以看下下面这个应用的页面切换体验,是不是很丝滑~做过体验优化的朋友应该都清楚,如果用原生的CSS或者JS动画去实现,想要实现出类似的效果,不会特别简单,而且也要考...

速腾车主RNS315固件及2016年6月地图升级详细教程

本来打算买个大众原厂的地图卡,后来在网上看其实不需要原厂地图卡也可以升级,于是开始在网上收集资料,开始天真的以为只要有密匙文件修改一下就可以免费升级了,其实最主要的还是破解的固件,不知道为什么,网上找...

学习一个母词act,一次解析一串关联、复合、衍生词族

首先形义解读一下act的原始意象,A是力量与行动的开始C是范围的覆盖T是目标目的的接触与刻度合在一起,行动行为艺术力量的复合行为以下是关于act的复合词、词根词缀衍生词及其变形后的词根衍生词的详细...

优迈系统(一体化控制柜)快车调试(八)

逻辑故障和驱动故障分析段码管上显示警告码和故障码对照表警告码操作模式故障码操作模式或驱动故障AL000EPC(紧急电源管制模式)ER100DTC(门在设定时间内不能关到位)AL001COR(复位模式)...

Layui简单实现左侧菜单和Tab选项卡动态操作

<!DOCTYPEhtml><html><head><metacharset="utf-8">...

码农如何快速打造一个有设计感的网站

像我这样的程序员来说经常被“设计”这个词吓到,因为我是一名程序员而不是设计师,我拥有的是计算机学位证,另外我对ComicSans字体并不介意。(注:ComicSans字体是Win95附带...

vue3 新特性 computed、watch、watchEffect 看完就会

1、watchEffectwatchEffect侦听器是一个副作用函数,不需要指定监听的某个属性,监视的回调中用到哪个属性,就会监听哪个属性,一旦运行就会立即执行。watchEffect与com...

10个冷门但非常实用前端开发者很少用的CSS规则

许多开发者只学了基础——比如修改颜色、设置字体或创建弹性布局——就止步不前。但CSS是一门精深而多用途的语言,掌握后能帮你构建优雅、高效且无障碍的界面。无论你是从零搭建还是微调设计系统,掌握一些高...