微信小程序视图层WXS_WXS模块

微信小程序视图层WXS_小程序WXS模块

微信小程序的WXS 代码能够编写在 小程序wxml 文件中的 <wxs> 标签内，或以 .wxs 为后缀名的文件内。

模块

每个微信小程序的 .wxs 文件和 <wxs> 标签都是一个单独的模块。

每一个模块都有本身独立的做用域。即在一个模块里面定义的变量与函数，默认为私有的，对其余模块不可见。

一个模块要想对外暴露其内部的私有变量与函数，只能经过 module.exports 实现。

.wxs 文件

在微信开发者工具里面，右键能够直接建立小程序的 .wxs 文件，在其中直接编写 WXS 脚本。

示例代码：

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

上述例子在 /pages/comm.wxs 的文件里面编写了小程序的 WXS 代码。该 .wxs 文件能够被其余的 .wxs 文件 或 WXML 中的 <wxs> 标签引用。

module 对象

每一个 wxs 模块均有一个内置的 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"; 

<!-- page/index/index.wxml --> <wxs src="./../tools.wxs" module="tools" /> <view> {{tools.msg}} </view> <view> {{tools.bar(tools.FOO)}} </view> 

页面输出：

some msg
'hello world' from tools.wxs 

require 函数

在小程序的.wxs模块中引用其余 wxs 文件模块，能够使用 require 函数。

引用的时候，要注意以下几点：

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

示例代码：

// /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"; 

// /pages/logic.wxs var tools = require("./tools.wxs"); console.log(tools.FOO); console.log(tools.bar("logic.wxs")); console.log(tools.msg); 

<!-- /page/index/index.wxml --> <wxs src="./../logic.wxs" module="logic" /> 

控制台输出：

'hello world' from tools.wxs logic.wxs some msg 

<wxs> 标签

属性名	类型	默认值	说明
module	String		当前 <wxs> 标签的模块名。必填字段。
src	String		引用 .wxs 文件的相对路径。仅当本标签为单闭合标签或标签的内容为空时有效。

module 属性

module 属性是当前 <wxs> 标签的模块名。在单个微信小程序的 wxml 文件内，建议其值惟一。有重复模块名则按照前后顺序覆盖（后者覆盖前者）。不一样文件之间的 wxs 模块名不会相互覆盖。

module 属性值的命名必须符合下面两个规则：

• 首字符必须是：字母（a-zA-Z），下划线（_）
• 剩余字符能够是：字母（a-zA-Z），下划线（_）， 数字（0-9）

示例代码：

<!--wxml--> <wxs module="foo"> var some_msg = "hello world"; module.exports = { msg : some_msg, } </wxs> <view> {{foo.msg}} </view> 

页面输出：

hello world 

上面例子声明了一个名字为 foo 的模块，将 some_msg 变量暴露出来，供当前页面使用。

src 属性

src 属性能够用来引用其余的 wxs 文件模块。

引用的时候，要注意以下几点：

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

示例代码：

// /pages/index/index.js Page({ data: { msg: "'hello wrold' from js", } }) 

<!-- /pages/index/index.wxml --> <wxs src="./../comm.wxs" module="some_comms"></wxs> <!-- 也能够直接使用单标签闭合的写法 <wxs src="./../comm.wxs" module="some_comms" /> --> <!-- 调用 some_comms 模块里面的 bar 函数，且参数为 some_comms 模块里面的 foo --> <view> {{some_comms.bar(some_comms.foo)}} </view> <!-- 调用 some_comms 模块里面的 bar 函数，且参数为 page/index/index.js 里面的 msg --> <view> {{some_comms.bar(msg)}} </view> 

页面输出：

微信小程序

'hello world' from comm.wxs 'hello wrold' from js 

上述例子在文件 /page/index/index.wxml 中经过 <wxs> 标签引用了 /page/comm.wxs 模块。

注意

• <wxs> 模块只能在定义模块的 WXML 文件中被访问到。使用 <include> 或 <import> 时，<wxs> 模块不会被引入到对应的 WXML 文件中。
• <template> 标签中，只能使用定义该 <template> 的 WXML 文件中定义的 <wxs> 模块。