收藏
评论

基础教程 - 小程序能力官方


上一章中我们把小程序涉及到的文件类型阐述了一遍,我们结合 QuickStart 这个项目来讲一下这些文件是怎么配合工作的。

小程序的启动

微信客户端在打开小程序之前,会把整个小程序的代码包下载到本地。

紧接着通过 app.json 的 pages 字段就可以知道你当前小程序的所有页面路径:

{  "pages":[    "pages/index/index",    "pages/logs/logs"
  ]
}

这个配置说明在 QuickStart 项目定义了两个页面,分别位于 pages/index/index 和 pages/logs/logs 目录。而写在 pages 字段的第一个页面就是这个小程序的首页(打开小程序看到的第一个页面)。

于是微信客户端就把首页的代码装载进来,通过小程序底层的一些机制,就可以渲染出这个首页。

小程序启动之后,在 app.js 定义的 App 实例的 onLaunch 回调会被执行:

App({
  onLaunch: function () {    // 小程序启动之后 触发
  }
})

整个小程序只有一个 App 实例,是全部页面共享的,更多的事件回调参考文档 注册程序 App

接下来我们简单看看小程序的一个页面是怎么写的。

程序与页面

你可以观察到 pages/logs/logs 下其实是包括了4种文件的,微信客户端会先根据 logs.json 配置生成一个界面,顶部的颜色和文字你都可以在这个 json 文件里边定义好。紧接着客户端就会装载这个页面的 WXML 结构和 WXSS 样式。最后客户端会装载 logs.js,你可以看到 logs.js 的大体内容就是:

Page({
  data: { // 参与页面渲染的数据
    logs: []
  },
  onLoad: function () {    // 页面渲染后 执行
  }
})

Page 是一个页面构造器,这个构造器就生成了一个页面。在生成页面的时候,小程序框架会把 data 数据和 index.wxml 一起渲染出最终的结构,于是就得到了你看到的小程序的样子。

在渲染完界面之后,页面实例就会收到一个 onLoad 的回调,你可以在这个回调处理你的逻辑。

有关于 Page 构造器更多详细的文档参考 注册页面 Page

组件

小程序提供了丰富的基础组件给开发者,开发者可以像搭积木一样,组合各种组件拼合成自己的小程序。

就像 HTML 的 div, p 等标签一样,在小程序里边,你只需要在 WXML 写上对应的组件标签名字就可以把该组件显示在界面上,例如,你需要在界面上显示地图,你只需要这样写即可:

<map>map>

使用组件的时候,还可以通过属性传递值给组件,让组件可以以不同的状态去展现,例如,我们希望地图一开始的中心的经纬度是广州,那么你需要声明地图的 longitude(中心经度) 和 latitude(中心纬度) 两个属性:

<map longitude="广州经度" latitude="广州纬度">map>

组件的内部行为也会通过事件的形式让开发者可以感知,例如用户点击了地图上的某个标记,你可以在 js 编写 markertap 函数来处理:

<map bindmarkertap="markertap" longitude="广州经度" latitude="广州纬度">map>

当然你也可以通过 style 或者 class 来控制组件的外层样式,以便适应你的界面宽度高度等等。

更多的组件可以参考 小程序的组件

API

为了让开发者可以很方便的调起微信提供的能力,例如获取用户信息、微信支付等等,小程序提供了很多 API 给开发者去使用。

要获取用户的地理位置时,只需要:

wx.getLocation({
  type: 'wgs84',
  success: (res) => {    var latitude = res.latitude // 经度
    var longitude = res.longitude // 纬度
  }
})

调用微信扫一扫能力,只需要:

wx.scanCode({
  success: (res) => {    console.log(res)
  }
})

需要注意的是:多数 API 的回调都是异步,你需要处理好代码逻辑的异步问题。

更多的 API 能力见 小程序的API

通过这个章节你已经大概了解了小程序运行的一些基本概念,当你开发完一个小程序之后,你就需要发布你的小程序。在下个章节,你会知道发布前需要做什么准备。


最后一次编辑于  2017-12-27
收藏

26 个评论

  • 📱春华📱通讯📱
    📱春华📱通讯📱
    2018-01-10

     一点基础都没有,感觉挺难的,不知道怎么开始?


     

    2018-01-10
    赞同 9
    回复 3
  • 学意
    学意
    2018-01-25
    <map longitude="广州经度" latitude="广州纬度">map>

    我还以为格式就是这样的,结果一直报错。原来应该是

    <map longitude="广州经度" latitude="广州纬度"></map>


    2018-01-25
    赞同 6
    回复 2
    • Sky
      Sky
      2018-06-22

      就是呀,这个错误太低级!

      2018-06-22
      3
      回复
    • sam
      sam
      2018-11-09

      帮助文档里有这些,估计是校对工作没做好

      2018-11-09
      回复
  • 勿忘心安
    勿忘心安
    2018-03-18

    一脸懵逼,,,零基础,,

    2018-03-18
    赞同 4
    回复
  • 不知道名字
    不知道名字
    2018-06-13

    比java还简单啊

    2018-06-13
    赞同 3
    回复
  • 阿那律
    阿那律
    2018-08-28

    看来是既需要懂CSS(对应WXSS).也需要懂HTML(对应WXML).还需要懂JAVASCRIPT(JS)懂完了这些再去理解小程序的原理,然后就会了。我说的对吗?

    2018-08-28
    赞同 1
    回复 1
    • Uncle Pun
      Uncle Pun
      2018-09-11

      教育技术学刚好对口。


      2018-09-11
      回复
  • 📱春华📱通讯📱
    📱春华📱通讯📱
    2018-01-10

     添加开发者,是添加其他人的微信号吗?还是添加其他人的微信公众号呢?


     

    2018-01-10
    赞同 1
    回复 1
    • iRouRou
      iRouRou
      2018-09-29

      微信号即可

      2018-09-29
      回复
  • JungleLee
    JungleLee
    2019-01-06

    那个能做成静态的小程序吗?一定要配置域名什么的吗?

    2019-01-06
    赞同
    回复 2
    • A_哈利路亚
      A_哈利路亚
      2019-01-16

      本地的可以不用,如果只是展示类型的没有请求接口,不需要配置域名

      2019-01-16
      回复
    • JungleLee
      JungleLee
      2019-01-21

      谢谢大佬!

      2019-01-21
      回复
  • 普金博士
    普金博士
    2018-12-20

    需要自己编程吗


    2018-12-20
    赞同
    回复
  • 宁一
    宁一
    2018-12-11

    下面评论那个框怎么实现


    2018-12-11
    赞同
    回复
  • 粉爱文化传媒
    粉爱文化传媒
    2018-12-05

    有人知道怎么操作吗


    2018-12-05
    赞同
    回复

正在加载...

登录 后发表内容