首先先在微信公众平台上注册小程序个人账号。然后下载微信web开发者工具,新建小程序项目,如下图所示:
下面是小程序项目公有目录与私有目录的工程结构了解
命名带有app前缀的一般都是主目录也就是公有目录,一般包含三个文件,app.json、app.wxss、app.js(不能去修改他们的命名)
然后就是需要我们去开发的需求界面,几乎每个界面都是一个私有目录。一般都包含四个文件,*.js,*.wxml,*.wxss,*.json。
接下来,让我们手写新建一个自己的第一个小程序demo
app.json
文件用来对微信小程序进行全局配置,决定页面文件的路径、窗口表现、设置网络超时时间、设置多 tab 等。
用于指定小程序由哪些页面组成,每一项都对应一个页面的 路径+文件名 信息。文件名不需要写文件后缀,框架会自动去寻找对于位置的 .json
, .js
, .wxml
, .wxss
四个文件进行处理。
如果小程序是一个多 tab 应用(客户端窗口的底部或顶部有 tab 栏可以切换页面),可以通过 tabBar 配置项指定 tab 栏的表现,以及 tab 切换时显示的对应页面。如下图所示:
其中,pages属性中谁写在第一行,谁就是首页。
wxss文件进行样式配置
wxml文件具体页面呈现
在小程序中的数据绑定形式主要是{{ }}
wxss样式文件的使用
WXSS 用来决定 WXML 的组件应该怎么显示。
为了适应广大的前端开发者,WXSS 具有 CSS 大部分特性。同时为了更适合开发微信小程序,WXSS 对 CSS 进行了扩充以及修改。
与 CSS 相比,WXSS 扩展的特性有:
建议: 开发微信小程序时设计师可以用 iPhone6 作为视觉稿的标准。
注意: 在较小的屏幕上不可避免的会有一些毛刺,请在开发时尽量避免这种情况。
使用@import
语句可以导入外联样式表,@import
后跟需要导入的外联样式表的相对路径,用;
表示语句结束。
框架组件上支持使用 style、class 属性来控制组件的样式。
.
,样式类名之间用空格分隔。
在 view 组件后边插入内容 |
在 view 组件前边插入内容 |
定义在 app.wxss 中的样式为全局样式,作用于每一个页面。在 page 的 wxss 文件中定义的样式为局部样式,只作用在对应的页面,并会覆盖 app.wxss 中相同的选择器。
1、小程序的wxss文件的尺度单位主要是rpx(
使用@import
语句可以导入外联样式表,@import
后跟需要导入的外联样式表的相对路径,用;
表示语句结束。
小程序app的生命周期
App()
函数用来注册一个小程序。接受一个 Object
参数,其指定小程序的生命周期回调等。
App() 必须在 app.js
中调用,必须调用且只能调用一次。不然会出现无法预期的后果。
生命周期回调—监听小程序初始化 | 小程序初始化完成时(全局只触发一次) |
生命周期回调—监听小程序显示 | 小程序启动,或从后台进入前台显示时 |
生命周期回调—监听小程序隐藏 | 小程序从前台进入后台时 |
小程序发生脚本错误,或者 api 调用失败时触发,会带上错误信息 | |
小程序要打开的页面不存在时触发,会带上页面信息回调该函数 | |
前台、后台定义: 当用户点击左上角关闭,或者按了设备 Home 键离开微信,小程序并没有直接销毁,而是进入了后台;当再次进入微信或再次打开小程序,又会从后台进入前台。需要注意的是:只有当小程序进入后台一定时间,或者系统资源占用过高,才会被真正的销毁。
关闭小程序(基础库版本1.1.0开始支持): 当用户从扫一扫、转发等入口(为, )进入小程序,且没有置顶小程序的情况下退出,小程序会被销毁。
小程序运行机制在基础库版本 1.4.0 有所改变: 上一条关闭逻辑在新版本已不适用。
小程序初始化完成时触发,全局只触发一次。
打开小程序的query |
当场景为由从另一个小程序或公众号或App打开时,返回此字段 |
来源小程序或公众号或App的 appId,详见下方说明 |
来源小程序传过来的数据,scene=1037或1038时支持 |
公众号 profile 页相关小程序列表 |
小程序启动,或从后台进入前台显示时触发。
小程序从前台进入后台时触发。
小程序发生脚本错误,或者 api 调用失败时触发。
基础库 1.9.90 开始支持,低版本需做。
小程序要打开的页面不存在时触发。
打开不存在页面的 query |
是否本次启动的首个页面(例如从分享等入口进来,首个页面是开发者配置的分享页面) |
开发者可以在 onPageNotFound
回调中进行重定向处理,但必须在回调中同步处理,异步处理(例如 setTimeout 异步执行)无效。
onPageNotFound
监听,当跳转页面不存在时,将推入微信客户端原生的页面不存在提示页面。
onPageNotFound
回调中又重定向到另一个不存在的页面,将推入微信客户端原生的页面不存在提示页面,并且不再回调 onPageNotFound
。
在 App 未定义时返回默认实现。当App被调用时,默认实现中定义的属性会被覆盖合并到App中。一般用于。
|
getApp()
获取实例之后,不要私自调用生命周期函数。
2、因为要在手机端远程调试,所以还需要appid。在小程序微信官方后台找到appid
3、在app.js上分别打上断点。打开调试器。在手机上调试的时候,重开小程序,点击vConsole进入调试模式。
私有页面的生命周期以及导航
Page(Object)
函数用来注册一个页面。接受一个 Object
类型参数,其指定页面的初始数据、生命周期回调、事件处理函数等。
Object 内容在页面加载时会进行一次深拷贝,需考虑数据大小对页面加载的开销
data
是页面第一次渲染使用的初始数据。
页面加载时,data
将会以JSON
字符串的形式由逻辑层传至渲染层,因此data
中的数据必须是可以转成JSON
的类型:字符串,数字,布尔值,对象,数组。
渲染层可以通过 对数据进行绑定。
生命周期的触发以及页面的路由方式
页面加载时触发。一个页面只会调用一次,可以在 onLoad 的参数中获取打开当前页面路径中的参数。
打开当前页面路径中的参数 |
页面显示/切入前台时触发。
页面初次渲染完成时触发。一个页面只会调用一次,代表页面已经准备妥当,可以和视图层进行交互。
监听用户下拉刷新事件。
监听用户上拉触底事件。
监听用户滑动页面事件。
页面在垂直方向已滚动的距离(单位px) |
注意:只有定义了此事件处理函数,右上角菜单才会显示“转发”按钮
button :页面内转发按钮;menu :右上角转发菜单
|
此事件需要 return 一个 Object,用于自定义转发内容,返回内容如下:
当前页面 path ,必须是以 / 开头的完整路径 |
自定义图片路径,可以是本地文件路径、代码包文件路径或者网络图片路径。支持PNG及JPG。显示图片长宽比是 5:4。 |
基础库 1.9.0 开始支持,低版本需做。
被点击tabItem的序号,从0开始 |
被点击tabItem的页面路径 |
被点击tabItem的按钮文字 |
Page
中还可以定义组件事件处理函数。在渲染层的组件中加入,当事件被触发时,就会执行 Page 中定义的事件处理函数。
基础库 1.2.0 开始支持,低版本需做。
到当前页面的路径,类型为String
。
setData
函数用于将数据从逻辑层发送到视图层(异步),同时改变对应的 this.data
的值(同步)。
setData引起的界面更新渲染完毕后的回调函数 |
undefined
,否则这一项将不被设置并可能遗留一些潜在问题。
以下内容你不需要立马完全弄明白,不过以后它会有帮助。
下图说明了 Page 实例的生命周期。
wxs模块讲解--页面引用
在wxs.wxml文件上创建相应内容
在内部去引用另一个wxs
小程序模板在外部页面的引用
“”“”“”“”“”“”“”
“”“”“”“”“”“”“”“”“”“”
“”“”“”“”“”“”
“”“”“”“”“”“”“”“”“”“”
“”“”“”“”“”“”“”“”“”“”“”“”“”
“”“”“”“”“”“”
“”“”“”“”“”“”
“”“”“”“”“”“”
“”“”“”“”“”“”
“”“”“”“”“”“”“”“”“”“”“”“”“”“”“”“”
“”“”“”“”“”“”“”
“”“”“”“”“”“”
“”“”“”“”“”“”“”“”
“”“”“”“”“”“”“”“”“”“”“”“”“”
“”“”“”“”“”“”“”“”“”“”“”“”“”
“”“”“”“”“”“”
——“”“”“”“”“”“”“”“”“”
“”“”“”“”“”“”“”“”“”“”“”“”
“”“”“”→“”→“”→“”“”
人们常说程序员的生活枯燥为人刻板,其实这是你不懂程序员,代码之外,这些高智商的人幽默有趣,论坛常常是他们展现才华的地方,BLOG是他们分享技术的地方,BBS等地方有问题他门总是热心帮助解答,处理程序异常,修改程序错误等。