当初始化完成时进行触发,全局只触发一次
当启动或者从后台进入前台显示
当从前台进入后台
对页面发送数据进行监听
参看文档路由
- 有两种路由跳转方式:使用组件跳转、调用跳转。
1.打开新页面,页面重定向===》 调用 . 、使用组件
2.页面返回 调用 . 、使用组件 、用户按左上角返回按钮、安卓用户点击物理按键
3. 切换 调用 . 、使用组件 、用户切换
4.重加载 调用 . 、使用组件
:
, 只能打开非 页面。
只能打开 页面。
可以打开任意页面。
页面底部的 由页面决定,即只要是定义为 的页面,底部都有 。
不能在 . 里面进行页面跳转。
-支持的通用单位包括、、。
是相对于基准宽度的单位,可以根据屏幕宽度进行自适应。- 规定屏幕基准宽度750。2
因为是编译器处理的,动态绑定不生效
可使用 .2() 转换为 后再赋值。
例如
样式导入
使用@语句可以导入外联样式表,@后跟需要导入的外联样式表的相对路径,用;表示语句结束。
内联样式
1.:静态的样式统一写到 中。
:用于指定样式规则,其属性值是样式规则中类选择器名(样式类名)的,样式类名不需要带上.,样式类名之间用空格分隔。
选择器
1 .
2 #
3 选择所有 组件全局样式与局部样式
定义在 . 中的样式为全局样式,作用于每一个页面。在 目录下 的 文件中定义的样式为局部样式,只作用在对应的页面,并会覆盖 . 中相同的选择器。注意: . 中通过 @ 语句可以导入外联样式,一样作用于每一个页面。变量固定值
- 中以下组件的高度是固定的,不可修改:布局
为支持跨平台,框架建议使用布局背景图片
- 支持使用在 里设置背景图片,使用方式与普通 项目相同,需要注意以下几点:支持 64 格式图片。支持网络路径图片。使用本地路径背景图片需注意:图片小于 40,- 会自动将其转化为 64 格式;图片大于等于 40, 需者自己将其转换为64格式使用,或将其挪到服务器上,从网络地址引用。本地背景图片的引用路径仅支持以 ~@ 开头的绝对路径(不支持相对路径)。字体图标
- 支持使用字体图标,使用方式与普通 项目相同,需要注意以下几点:
支持 64 格式字体图标。
支持网络路径字体图标。
网络路径必须加协议头 。
从 上拷贝的代码,默认是没加协议头的。
- 本地路径图标字体支持情况:字体文件小于 40,- 会自动将其转化为 64 格式;字体文件大于等于 40, 需者自己转换,否则使用将不生效;字体文件的引用路径仅支持以 ~@ 开头的绝对路径(不支持相对路径)。
- 支持在 模板中嵌套 > 和 </>,用来进行 列表渲染 和 条件渲染。
> 和 </> 并不是一个组件,它们仅仅是一个包装元素,不会在页面中做任何渲染,只接受控制属性。
代码示例
- 在支持绝大部分 6 的同时,也支持了 7 的 /。
-支持使用安装第三方包。
在 - 中使用
- 支持在 5+ 和小程序中使用小程序组件。
平台差异说明
- 在发布到5时支持所有的语法;发布到和小程序时,由于平台限制,无法实现全部语法,但-仍是是对语法支持度最高的跨端框架。本文将详细讲解差异。
- 完整支持 实例的生命周期,同时还新增 应用生命周期 及 页面生命周期。
详见官方文档:生命周期钩子。
注意不要在选项属性或回调上使用箭头函数,比如 : () => .(.) 或 .$('', => .())。因为箭头函数是和父级上下文绑定在一起的, 不会是如你做预期的 实例,且 . 或 . 也会是未定义的。建议使用 - 的 代替 的 。建议使用 - 的 代替 的 。
- 完整支持 模板语法。
详见官方文档:模板语法。
注意 如果使用老版的非自定义组件模式,即中"":,部分模版语法不支持,但此模式已不再推荐使用,详见。
老版非自定义组件模式不支持情况:不支持纯 不支持部分复杂的 渲染表达式不支持过滤器
必须为返回一个初始数据对象的函数;否则页面关闭时,数据不会自动销毁,再次打开该页面时,会显示上次数据。
实现全局变量的方式需要遵循 单文件模式的规范。详细参考:-全局变量的几种实现方式
支持的语法:
支持的语法:
非5端不支持 官方文档: 与 绑定 中的 和 语法。
不支持示例:
注意:以:=""这样的方式设置像素值,其值为实际像素,不会被编译器转换。
此外还可以用 方法生成 或者 字符串,插入到页面中,举例说明:
用在组件上
非5端暂不支持在自定义组件上使用 与 绑定
完整支持 官方文档:计算属性。
完整支持 官方文档:条件渲染
完整列表渲染 官方文档:列表渲染
如果列表中项目的位置会动态改变或者有新的项目添加到列表中,并且希望列表中的项目保持自己的特征和状态(如 中的输入内容, 的选中状态),需要使用 : 来指定列表中项目的唯一的标识符。
: 的值以两种形式提供使用 - 循环 中 的某个 ,该 的值需要是列表中唯一的字符串或数字,且不能动态改变。使用 - 循环中 本身,这时需要 本身是一个唯一的字符串或者数字
当数据改变触发渲染层重新渲染的时候,会校正带有 的组件,框架会确保他们被重新排序,而不是重新创建,以确保使组件保持自身的状态,并且提高列表渲染时的效率。
如不提供 :,会报一个 , 如果明确知道该列表是静态,或者不必关注其顺序,可以选择忽略。
注意:
事件映射表中没有的原生事件也可以使用,例如组件的 事件直接在组件上写成 @,同时这个事件也非常特殊,它的 有 和 两个,导致我们无法在 中区分到底是什么事件,所以你在监听此类事件的时候同时监听事件名和事件类型既 。
为兼容各端,事件需使用 - 或 @ 的方式绑定,请勿使用小程序端的 和 进行事件绑定。
事件修饰符
.:各平台均支持, 使用时会阻止事件冒泡,在非 5 端同时也会阻止事件的默认行为
. 仅在 5 平台支持
.:仅在 5 平台支持
.:仅在 5 平台支持
.:仅在 5 平台支持
.:仅在 5 平台支持
若需要禁止蒙版下的页面滚动,可使用 @..="", 可以用来处理 的事件,也可以是一个空函数。
></p>
按键修饰符:-运行在手机端,没有键盘事件,所以不支持按键修饰符。
支持 官方文档:表单控件绑定。
建议过程中直接使用 -:表单组件。 组件
组件是整个 . 中最复杂的部分,支持 官方文档:组件 。
有且只能使用单文件组件(. 组件)的形式进行支持。其他的诸如:动态组件,自定义 ,和 字符串模版等非5端都不支持。-组件
- 提供了丰富的组件,比如: , 等,需要注意的是原生组件上的事件绑定,需要以 的事件绑定语法来绑定,如 ="" 事件,需要写成 @=""
示例
全局组件
- 支持配置全局组件,需在 . 里进行全局注册,注册后就可在所有页面里使用该组件。
注意:. 的第一个参数必须是静态的字符串。
示例
. 里进行全局注册
. 里可直接使用组件
如何获取上个页面传递的数据如何设置全局的数据和全局的方法如何捕获 的 组件属性设置不生效解决办法
条件编译是里用特殊的注释作为标记,在编译时根据这些特殊的注释,将注释里面的代码编译到不同平台。
写法:以 # 或 # 加** %%** 开头,以 # 结尾。 的条件编译
组件的条件编译. 的条件编译 目录的条件编译- 使用代码块直接创建组件模板
为提升效率,将 - 常用代码封装成了以 开头的代码块,如在 标签内输入 回车,会自动生成如下代码:
代码块分为代码块、代码块,如在 标签内输入 回车,会自动生成如下代码:
-已支持代码块见下方列表。
代码块
代码块
- 使用 调试- 使用各家小程序工具调试- 关于 的调试
- 中可使用的 框架:
- 整包升级检测:
- 资源热更新:
- 导航栏指南:
- 实现全局变量:
微信小程序转换-指南:
项目(组件)迁移指南、示例及资源汇总:
- 引用 第三方库:
- 中使用微信小程序第三方 及资源汇总:
- 中使用 5+ 的原生界面控件(包括、、、、):
- 的 5 版使用注意事项:
-各环节(、、自定义基座、本地、云打包引擎)版本兼容性说明:
- 中选择和上传非图像、视频文件:
=============================================
作者:_凉链接: