微信小程序視圖層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> 模塊。