【小程序】WXSS模板样式

发布于:2024-06-23 ⋅ 阅读:(17) ⋅ 点赞:(0)

目录

WXSS模板样式

概述

什么是WXSS

WXSS 和 CSS 的关系

rpx

什么是rpx尺寸单位

rpx的实现原理

样式导入

@import 语法格式

全局样式和局部样式

全局样式 

局部样式

全局配置 

全局配置文件及常用的配置项

window

小程序窗口的组成部分 

window节点常用的配置项

设置导航栏的标题

设置导航栏的背景色

设置导航栏的标题文本颜色

设置页面下拉刷新的效果

设置下拉刷新时窗口的背景色

设置下拉刷新时loading的背景颜色

设置上拉触底的距离

tabBar

什么是tabBar

tabBar的6个组成部分

tabBar节点的配置项 

每个tab项的配置选项


WXSS模板样式

概述

什么是WXSS

WXSS是一套样式语言,用于美化WXML的组件样式,类似于网页开发中的CSS

WXSS 和 CSS 的关系

WXSS具有CSS大部分特性,同时,WXSS还对CSS 进行了扩充以及修改,以适应微信小程序的开发。与CSS相比,WXSS扩展的特性有:

  • rpx尺寸单位
  • @import样式导入

rpx

什么是rpx尺寸单位

rpx是微信小程序独有的,用来解决屏适配的尺寸单位

rpx的实现原理

rpx的实现原理非常简单:鉴于不同设备屏幕的大小不同,为了实现屏幕的自动适配,rpx把所有设备的屏幕,在宽度上等分为750份(即:当前屏幕的总宽度为750px)

  • 在较小的设备上,1rpx所代表的宽度较小
  • 在较大的设备上,1rpx所代表的宽度较大

小程序在不同设备上运行的时候,会自动把rpx的样式单位换算成对应的像素单位来渲染,从而实现屏幕适配。

样式导入

使用WXSS提供的 @import 语法,可以导入外联的样式表。

@import 语法格式

@import 后跟需要导入的外联样式表的相对路径,用;表示语句结束。示例:

@import "common.wxss"

//在当前页面的wxss文件中

全局样式和局部样式

全局样式 

定义在 app.wxss中的样式为全局样式,作用于每一个页面

局部样式

在页面的 .wxss 文件中定义的样式称为局部样式,只作用与当前页面。

注意:

  1. 当局部样式和全局样式冲突时,根据就近原则,局部样式会覆盖全局样式
  2. 当局部样式的权重大于或等于全局样式的权重时,才会覆盖全局的样式

全局配置 

全局配置文件及常用的配置项

小程序根目录下的 app.json文件是小程序的全局配置文件,常用的配置项如下:

  1. pages       | 记录当前小程序所有页面的存放路径
  2. window     | 全局设置小程序窗口的外观
  3. tabBar      |设置小程序底部的tabBar效果
  4. style          |是否启用新版的组件样式

window

小程序窗口的组成部分 

而我们在window中可以配置导航栏区域和背景区域

window节点常用的配置项

属性名 类型 默认值 说明
navigationBarTitleText String 字符串 导航栏标题文字内容
navigationBarBackgroundColor HexColor #000000 导航栏背景颜色
navigationBarTextStyle String white 导航栏标题颜色,仅支持black/white
backgroundColor HexColor #ffffff 窗口的背景色
backgroundTextStyle String dark 下拉loading的样式,仅支持dark/light
enablePullDownRefresh Boolean false 是否全局开启下拉刷新
onReachBottomDistance Number 50 页面上拉触底事件触发时,距页面底部的距离,单位为px

设置导航栏的标题

设置步骤:app.json->window->navigationBarTileText

设置导航栏的背景色

设置步骤:app.json->window->navigationBarBackgroundColor

设置导航栏的标题文本颜色

设置步骤:app.json->window->navigationBarTextStyle

设置页面下拉刷新的效果

设置步骤:app.json->window中 ,添加 "enablePullDownRefresh": true

设置下拉刷新时窗口的背景色

设置步骤:app.json->window中 ,添加 "backgroundColor": "#ffffff"

设置下拉刷新时loading的背景颜色

设置步骤:app.json->window中 ,添加 "backgroundTextStyle": "dark"

设置上拉触底的距离

通过手指在屏幕上的上拉滑动操作,从而加载更多数据的行为

设置步骤:app.json->window中 ,添加 "onReachBottomDistance": 100

默认50px

tabBar

什么是tabBar

tabBar是移动端应用常见的页面效果,用于实现多页面的快速切换,小程序中通常将其分为:

  • 底部tabBar
  • 顶部tabBar

注意:

  • tabBar中只能配置最少2个,最多5个tab页签
  • 当渲染顶部tabBar时,不显示icon,只显示文本 

tabBar的6个组成部分

  1. backgroundColor:tabBar的背景色
  2. selectedIconPath:选中时的图片路径
  3. borderStyle:tabBar上边框的颜色
  4. iconPath:未选中时的图片路径
  5. selectedColor:tab上的文字选中时的颜色
  6. color:tab上文字的默认(未选中)的颜色

tabBar节点的配置项 

属性 类型 必填 默认值 描述
position String bottom tabBar的位置,仅支持bottom/top
borderStyle String black tabBar上边框的颜色,仅支持black/white
color HexColor tab上文字的默认(未选中)的颜色
selectedColor HexColor tab上的文字选中时的颜色
backgroundColor HexColor tabBar的背景色
list Array tab页签的列表,最少两个,最多五个tab项

每个tab项的配置选项

属性 类型 必填 描述
pagePath String 页面路径,页面必须在pages中预先定义
text String tab上显示的文字
iconPath String 未选中时的图标路径
selectedIconPath String 选中时的图标路径

在app.json中添加 


网站公告

今日签到

点亮在社区的每一天
去签到