WXS

WXS(WeiXin Script)是小程序的一套脚本语言,结合 WXML,可以构建出页面的结构。

注意

  1. WXS 不依赖于运行时的基础库版本,可以在所有版本的小程序中运行。
  2. WXS 与 JavaScript 是不同的语言,有自己的语法,并不和 JavaScript 一致。
  3. WXS 的运行环境和其他 JavaScript 代码是隔离的,WXS 中不能调用其他 JavaScript 文件中定义的函数,也不能调用小程序提供的API。
  4. WXS 函数不能作为组件的事件回调。
  5. 由于运行环境的差异,在 iOS 设备上小程序内的 WXS 会比 JavaScript 代码快 2 ~ 20 倍。在 android 设备上二者运行效率无差异。

以下是一些使用 WXS 的简单示例,要完整了解 WXS 语法,请参考WXS 语法参考

页面渲染

  1. <!--wxml-->
  2. <wxs module="m1">
  3. var msg = "hello world";
  4. module.exports.message = msg;
  5. </wxs>
  6. <view> {{m1.message}} </view>

页面输出:

  1. hello world

数据处理

  1. // page.js
  2. Page({
  3. data: {
  4. array: [1, 2, 3, 4, 5, 1, 2, 3, 4]
  5. }
  6. })
  1. <!--wxml-->
  2. <!-- 下面的 getMax 函数,接受一个数组,且返回数组中最大的元素的值 -->
  3. <wxs module="m1">
  4. var getMax = function(array) {
  5. var max = undefined;
  6. for (var i = 0; i < array.length; ++i) {
  7. max = max === undefined ?
  8. array[i] :
  9. (max >= array[i] ? max : array[i]);
  10. }
  11. return max;
  12. }
  13. module.exports.getMax = getMax;
  14. </wxs>
  15. <!-- 调用 wxs 里面的 getMax 函数,参数为 page.js 里面的 array -->
  16. <view> {{m1.getMax(array)}} </view>

页面输出:

  1. 5