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 屬性

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> 模組。