小程序wxs语法的使用

一、WXS介绍

• WXS(WeiXin Script)是小程序的一套脚本语言,结合 WXML,可以构建出页面的结构。
• WXS 与 JavaScript 是不同的语言,有自己的语法,并不和 JavaScript 一致。
• WXS 的运行环境和其他 JavaScript 代码是隔离的,WXS 中不能调用其他 JavaScript 文件中定义的函数,也不能调用小程序提供的API。

二、WXS模块

WXS 代码可以编写在 wxml 文件中的 标签内,或以 .wxs 为后缀名的文件内。每一个 .wxs 文件和 标签都是一个单独的模块。每个模块都有自己独立的作用域,即在一个模块里面定义的变量与函数,默认为私有的,对其他模块不可见。
1、module对象
每个 wxs 模块均有一个内置的 module 对象,通过exports属性,可以对外共享本模块的私有变量与函数。即一个模块要想对外暴露其内部的私有变量与函数,只能通过 module.exports 实现。如下:

// /pages/tools.wxs
var foo = "'hello world' from tools.wxs";
var bar = function (d) {
  return d;
}
module.exports = {
  FOO: foo,
  bar: bar,
};
module.exports.msg = "some msg";

2、require函数
在.wxs模块中引用其他 wxs 文件模块,可以使用 require 函数。引用的时候,要注意如下几点:

  • 只能引用 .wxs 文件模块,且必须使用相对路径。
  • wxs 模块均为单例,wxs 模块在第一次被引用时,会自动初始化为单例对象。多个页面,多个地方,多次引用,使用的都是同一个 wxs 模块对象。
  • 如果一个 wxs 模块在定义之后,一直没有被引用,则该模块不会被解析与运行。
// /pages/logic.wxs
var tools = require("./tools.wxs");
console.log(tools.FOO);  // 'hello world' from tools.wxs
console.log(tools.bar("logic.wxs"));  // logic.wxs
console.log(tools.msg);  // some msg

3、 标签
小程序wxs语法的使用_第1张图片

module 属性是当前 标签的模块名。在单个 wxml 文件内,建议其值唯一。有重复模块名则按照先后顺序覆盖(后者覆盖前者)。不同文件之间的 wxs 模块名不会相互覆盖。其命名必须符合下面两个规则:

  • 首字符必须是:字母(a-zA-Z),下划线(_)
  • 剩余字符可以是:字母(a-zA-Z),下划线(_), 数字(0-9)

src 属性可以用来引用其他的 wxs 文件模块。引用的时候,要注意如下几点:

  • 只能引用 .wxs 文件模块,且必须使用相对路径。
  • wxs 模块均为单例,wxs 模块在第一次被引用时,会自动初始化为单例对象。多个页面,多个地方,多次引用,使用的都是同一个 wxs 模块对象。
  • 如果一个 wxs 模块在定义之后,一直没有被引用,则该模块不会被解析与运行。

<wxs src="./../tools.wxs" module="tools" />
<view> {{tools.msg}} view>  
<view> {{tools.bar(tools.FOO)}} view>  

注:

  • 模块只能在定义模块的 WXML 文件中被访问到。使用 时,
    模块不会被引入到对应的 WXML 文件中。
  • 标签中,只能使用定义该