微信小程序 页面配置

参考： 微信官方文档

页面配置写在每个页面的.json文件里，全局配置写在app.json文件里。若二者发生冲突，以页面配置的属性为准。

其中页面里的index.json如下：

这个属性的隐派哗灶行值为十六进制的颜色类型，默认为#000000。

#后跟六个十六进制字符（从0到9和abcdef）。

上面的#000000可以简写为#000，#ff0000可以简写为#f00

注意到不仅导航栏标题的颜色改变了，连上方的时间和电量的颜色也改变了。

仅支持以下值：

default 默认样式

custom 自定义导航栏，只保留右上角胶囊按钮。

即省略了导航栏标题，页面占据导航栏的位置，之前设置的导航栏背景颜色也失效了。

默认值为#ffffff（白色）

指的是下拉刷新时拉下来部分的背景颜色，需要先打开下拉刷新"enablePullDownRefresh":true，再下拉才能看见。

默认为dark

对比一下，发现改变的是刷新时三个点的颜色，选dark时可以看到三个点轮流改变黑白的刷新动画，而选择light时动画就不明显了。

默认为 "enablePullDownRefresh":false

false改为true后可以像上面那样进行下拉刷新了

注意这里的值为boolean类型，不是字符串，不要羡凯加引号。

支持 auto / portrait / landscape[自动(旋转屏幕)/垂直(默认)/水平]

未完待续...

1.下拉刷新的概念及应用场景。

概念： 下拉刷新是移动端更新列表数据的交互行为，用户通过手指在屏幕上子念培上而下的滑动，可以触发页面的下拉刷新，更新列表数据。

应用场景： 在移动端，数据列表是常见的页面效果，更新列表数据是最基本的页面需求，相比于按钮刷新，定时刷新来说，下拉刷新的用户体验方便友好，已经成为移动端刷新列表数据的最佳解决方案。

微信小程序启动下拉刷新：

两种方式：

1.需要在app.json 的window选项中或页面配置中开启enablePullDownRefresh， 但是，一般情况下，推荐在页面配置中为需要的页面单独开启下拉刷新行为。

2.可以通过wx.startPullDownRefresh() 触发下拉刷新，调用后触发下拉刷新动画，效果与用户手动下拉刷新一致。

配置下拉刷新窗口的样式：

需要在app.json 的window选项中或页面配置中修改backbroundColor 和backgroundTextStyle 选项。

backgroundColor: 用来配置下拉刷新窗口的背景颜色，仅支持16进制颜色值。

backgroundTextStyle 用来配置下拉刷新loading 的样式，仅支持dark和light

onPullDownRefresh： 页面相关事件处理函数--监听用户下拉 *** 作时执行

停止下拉刷新效果：

当处理万下拉刷新后，下拉刷新的loading 效果会一直显示，不会主动消失，需仔仿唯要手动隐藏下拉刷新的loading效果，此时，跳用wx.stopPullDownRefresh()可以停止当前页面的下拉刷新。大旅

注册开发者账号： https://mp.weixin.qq.com/

安扰唯誉装小程序开发工具：https://developers.weixin.qq.com/miniprogram/dev/devtools/download.html

创建项目

pages目录：用于存放所有的页面。

utils目录：用于存放工具类文件。

app.js：是入口文件，程序在运行时，首先要执行该文件。

app.json：是全局配置文件，用于配置小程序的信息（它里面配置的是全局信息）。

app.wxss：是全局样式文件。全局样式文件里面定义的选择器，在所有的页面中生效。

project.config.json：是项目配置文件。

sitemap.json：是SEO配置文件，方便用户搜索到该小程序。

（1）pages配置项

pages里面注册的是视图。用于指定小程序由哪些页面组成，每一项都对应一个页面的路径（含文件名）信息

（2）window配置项

window 是全局窗口配置。

backgroundTextStyle 设置文本样式（下拉loading的样式），仅支持 dark / light。

navigationBarBackgroundColor 设置导航栏背景。

navigationBarTitleText 设置导航栏文本。

navigationBarTextStyle 设置导航栏标题颜色，仅支持 black / white。

（3）style

style 设置样式级别，默认是v2。

（4）sitemapLocation

sitemapLocation 指明sitemap.json 的位置；默认为 'sitemap.json' 即在 app.json 同级目录下名字的 sitemap.json 文件。

每一个页面由四个文件组成：xxx.wxml文件、xxx.wxss文件、 xxx.js文件和xxx.json文件。

（1）xxx.wxml文件

xxx.wxml文件，就相当于一个html文件。在wxml文件中，不能写传统的html标签，只能写微信提供的组件。

① view组件

相当于div标签。

② text组件

相当于span标签。

③ swiper

swiper是滑块视图容器，它里面只能放swiper-item组件。

swiper组件的常用属性：

circular是衔接滑动

autoplay是自动切换

interval是自动切换时间间隔

indicator-dots是否显示面板指示点

indicator-color指示点颜色

indicator-active-color当前选中的指示点颜色

④ image

image是图片组件，最好全部采用网络图片，因为小程序的总体积不允许超过2MB。

（2）xxx.wxss文件

xxx.wxss文件，就相当于一个css文件。在wxss文件中，最好不要写标签选择器和id选择器，统一写类选择器缓段。

为了让小程序里面的内容在各种设备上能够自适应显示，微信推出了响应式单位：rpx。在iphone6中，2rpx=1px。

（3）xxx.js文件

xxx.js文件，是交互文件（核心文件）。

Page()函数，返回页面对象，该山空函数需要传一个配置参数，这个配置参数是一个对象。在这个配置对象中，定义当前页面的所有内容。

① data

定义页面的数据。

② 自定义函数

开发者可以添加任意的函数或数据到Object 参数中，在页面的函数中用this可以访问。

（4）xxx.json文件

xxx.json文件，是页面的配置文件（它里面配置的是当前页面信息）。

WXML 中的动态数据均来自对应 Page 的 data。

（1）获取data中数据

通过插值表达式{{}}，可以显示js里面定义的data里面的数据。

（2）组件属性(需要在双引号之内)

（3）运算

可以在{{}} 内进行简单的运算。

① 三元运算

② 逻辑判断

bindtap是触屏事件，其实就是相当于网页中的点击事件。

小程序中bindtap绑定方法时不能传参数。所以组件通过data-xxx传递数据。

注意： 自定义属性的命名用驼峰或者大写命名，小程序内部会自动转成小写。

8、setData()方法

setData()方法，更新页面中数据。页面数据更新后，调用setData()方法重新渲染到页面。

wx:for指令用于循环数组数据，生成组件。

循环出来的每一项通过item返回，每一项对应的索引，通过index返回。

wx:key=""，设置每一项唯一的标识。循环列表时，添加wx:key的好处是，将来列表发生变化时重新渲染列表的损耗为更低。

条件渲染可以使用wx:if或hidden。

一般来说，wx:if 有更高的切换消耗而 hidden 有更高的初始渲染消耗。因此，如果需要频繁切换的情景下，用 hidden 更好，如果在运行时条件不大可能改变则 wx:if 较好。

wx:if用于条件渲染：条件为真生成里面的内容，条件为假不会生成里面的内容。（每次重新生成内容）

也可以用wx:elif 和 wx:else 来添加一个 else 块。

hidden用于条件渲染：条件为真隐藏里面的内容，条件为假显示里面的内容。（每次切换样式）

在app.json文件中添加tabBar节点。tabBar是小程序客户端底部或顶部tab栏的实现。

color：tab上的文字默认颜色，仅支持十六进制颜色。

selectedColor：tab上的文字选中时的颜色，仅支持十六进制颜色。

backgroundColor：tab的背景色，仅支持十六进制颜色。

borderStyle：tabbar上边框的颜色， 仅支持 black / white。

position：tabBar的位置，默认值是: bottom，仅支持 bottom / top。当 position 为 top 时，不显示 icon。

custom：自定义tabBar。

（2）list

list：tab的列表。

list 接受一个数组，只能配置最少 2 个、最多 5 个 tab。

pagePath：页面路径，必须在pages 中先定义。

text：tab 上按钮文字。

iconPath：图片路径，icon 大小限制为 40kb，建议尺寸为 81px * 81px，不支持网络图片。selectedIconPath：选中时的图片路径，icon 大小限制为 40kb，建议尺寸为 81px * 81px，不支持网络图片。

（1）跳转普通页面

方法① navigator组件

方法② navigateTo()方法

navigateTo()方法，用于跳转普通页面。

（2）跳转tabBar页面

方法① navigator组件

如果要使用navigator组件跳转tabBar页面，需要设置open-type="switchTab"。

方法② switchTab()方法

switchTab()方法，用于跳转tabBar页面。

title：提示的标题

content：提示的内容

success：接口调用成功的回调函数。回调函数中的confirm属性返回true，表示点击的是确定按钮，否则是取消按钮。

title：提示的内容

icon：图标

duration：消息提示框的显示时间

mask：是否显示透明蒙层，防止触摸穿透

模块化语法有两种：① commonjs规范，② es6规范。

nodejs环境采用的就是commonjs规范。采用exports 或 module.exports 导出成员，采用require() 导入成员。

微信小程序支持commonjs规范，同时还支持官方的ES6规范。ES6规范采用export 导出成员，采用import 导入成员。

将封装的方法放到util目录下的js文件中。可以新建js文件，也可以写在直接util.js文件中。

（1）确认框方法

定义确认框方法，并导出

（2）消息框方法

定义消息框方法，并导出

（3）获取事件参数的方法

import是ES6的导入语句。

wx对象是微信小程序的全局对象，在任何地方都可以使用。

（1） 注册语句

（2） 在app.js入口文件中导入

注意： 注册给wx对象的方法，需要在app.js文件中导入，才可使用。

（3） 调用方法

wx.方法名(参数)

---