微信小程序入门教程之二:页面样式
zhezhongyun 2025-05-16 18:03 64 浏览
这个系列的上一篇教程,教大家写了一个最简单的 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,而不是px。rpx是小程序为适应不同宽度的手机屏幕,而发明的一种长度单位。不管什么手机屏幕,宽度一律为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
相关推荐
- Python入门学习记录之一:变量_python怎么用变量
-
写这个,主要是对自己学习python知识的一个总结,也是加深自己的印象。变量(英文:variable),也叫标识符。在python中,变量的命名规则有以下三点:>变量名只能包含字母、数字和下划线...
- python变量命名规则——来自小白的总结
-
python是一个动态编译类编程语言,所以程序在运行前不需要如C语言的先行编译动作,因此也只有在程序运行过程中才能发现程序的问题。基于此,python的变量就有一定的命名规范。python作为当前热门...
- Python入门学习教程:第 2 章 变量与数据类型
-
2.1什么是变量?在编程中,变量就像一个存放数据的容器,它可以存储各种信息,并且这些信息可以被读取和修改。想象一下,变量就如同我们生活中的盒子,你可以把东西放进去,也可以随时拿出来看看,甚至可以换成...
- 绘制学术论文中的“三线表”具体指导
-
在科研过程中,大家用到最多的可能就是“三线表”。“三线表”,一般主要由三条横线构成,当然在变量名栏里也可以拆分单元格,出现更多的线。更重要的是,“三线表”也是一种数据记录规范,以“三线表”形式记录的数...
- Python基础语法知识--变量和数据类型
-
学习Python中的变量和数据类型至关重要,因为它们构成了Python编程的基石。以下是帮助您了解Python中的变量和数据类型的分步指南:1.变量:变量在Python中用于存储数据值。它们充...
- 一文搞懂 Python 中的所有标点符号
-
反引号`无任何作用。传说Python3中它被移除是因为和单引号字符'太相似。波浪号~(按位取反符号)~被称为取反或补码运算符。它放在我们想要取反的对象前面。如果放在一个整数n...
- Python变量类型和运算符_python中变量的含义
-
别再被小名词坑哭了:Python新手常犯的那些隐蔽错误,我用同事的真实bug拆给你看我记得有一次和同事张姐一起追查一个看似随机崩溃的脚本,最后发现罪魁祸首竟然是她把变量命名成了list。说实话...
- 从零开始:深入剖析 Spring Boot3 中配置文件的加载顺序
-
在当今的互联网软件开发领域,SpringBoot无疑是最为热门和广泛应用的框架之一。它以其强大的功能、便捷的开发体验,极大地提升了开发效率,成为众多开发者构建Web应用程序的首选。而在Spr...
- Python中下划线 ‘_’ 的用法,你知道几种
-
Python中下划线()是一个有特殊含义和用途的符号,它可以用来表示以下几种情况:1在解释器中,下划线(_)表示上一个表达式的值,可以用来进行快速计算或测试。例如:>>>2+...
- 解锁Shell编程:变量_shell $变量
-
引言:开启Shell编程大门Shell作为用户与Linux内核之间的桥梁,为我们提供了强大的命令行交互方式。它不仅能执行简单的文件操作、进程管理,还能通过编写脚本实现复杂的自动化任务。无论是...
- 一文学会Python的变量命名规则!_python的变量命名有哪些要求
-
目录1.变量的命名原则3.内置函数尽量不要做变量4.删除变量和垃圾回收机制5.结语1.变量的命名原则①由英文字母、_(下划线)、或中文开头②变量名称只能由英文字母、数字、下画线或中文字所组成。③英文字...
- 更可靠的Rust-语法篇-区分语句/表达式,略览if/loop/while/for
-
src/main.rs://函数定义fnadd(a:i32,b:i32)->i32{a+b//末尾表达式}fnmain(){leta:i3...
- C++第五课:变量的命名规则_c++中变量的命名规则
-
变量的命名不是想怎么起就怎么起的,而是有一套固定的规则的。具体规则:1.名字要合法:变量名必须是由字母、数字或下划线组成。例如:a,a1,a_1。2.开头不能是数字。例如:可以a1,但不能起1a。3....
- Rust编程-核心篇-不安全编程_rust安全性
-
Unsafe的必要性Rust的所有权系统和类型系统为我们提供了强大的安全保障,但在某些情况下,我们需要突破这些限制来:与C代码交互实现底层系统编程优化性能关键代码实现某些编译器无法验证的安全操作Rus...
- 探秘 Python 内存管理:背后的神奇机制
-
在编程的世界里,内存管理就如同幕后的精密操控者,确保程序的高效运行。Python作为一种广泛使用的编程语言,其内存管理机制既巧妙又复杂,为开发者们提供了便利的同时,也展现了强大的底层控制能力。一、P...
- 一周热门
- 最近发表
- 标签列表
-
- HTML 教程 (33)
- HTML 简介 (35)
- HTML 实例/测验 (32)
- HTML 测验 (32)
- JavaScript 和 HTML DOM 参考手册 (32)
- HTML 拓展阅读 (30)
- HTML文本框样式 (31)
- HTML滚动条样式 (34)
- HTML5 浏览器支持 (33)
- HTML5 新元素 (33)
- HTML5 WebSocket (30)
- HTML5 代码规范 (32)
- HTML5 标签 (717)
- HTML5 标签 (已废弃) (75)
- HTML5电子书 (32)
- HTML5开发工具 (34)
- HTML5小游戏源码 (34)
- HTML5模板下载 (30)
- HTTP 状态消息 (33)
- HTTP 方法:GET 对比 POST (33)
- 键盘快捷键 (35)
- 标签 (226)
- opacity 属性 (32)
- transition 属性 (33)
- 1-1. 变量声明 (31)
