![](https://img.laitimes.com/img/9ZDMuAjOiMmIsIjOiQnIsIyZuBnLxZDdzVWZqR3ciF2N6hHOtVzM4MzNw8CXyEzLclDM3EDMy8CXsFGdy9GcvwFduVWboNWY0RXYvwVY0FGZvwVbvNmLu9WauVXLwBXY4dnL3d3dvw1LcpDc0RHaiojIsJye.png)
注意(來自官方文檔)
- wxs 不依賴于運作時的基礎庫版本,可以在所有版本的小程式中運作。
- wxs 與 javascript 是不同的語言,有自己的文法,并不和 javascript 一緻。
- wxs 的運作環境和其他 javascript 代碼是隔離的,wxs 中不能調用其他 javascript 檔案中定義的函數,也不能調用小程式提供的API。
- wxs 函數不能作為元件的事件回調。
- 由于運作環境的差異,在 iOS 裝置上小程式内的 wxs 會比 javascript 代碼快 2 ~ 20 倍。在 android 裝置上二者運作效率無差異。
舉個例子,在
wxs
出來之前,如果我們要連接配接一個數組的内容并顯示在
wxml
中,我們需要通過循環連接配接數組的每一項:
.wxml
- <view>
- <block wx:for="{{names}}" wx:key="item">
- {{item}}
- </block>
- </view>
.js
- Page({
- data: {
- names:[
- 'Tom',
- 'Peter',
- 'Gray',
- 'Lisa'
- ]
- },
- })
或者先在js中連接配接好,放在data中,再顯示在wxml中:
.wxml
- <view>
- {{content}}
- </view>
.js
- Page({
- data: {
- content:"",
- names:[
- 'Tom',
- 'Peter',
- 'Gray',
- 'Lisa'
- ]
- },
- onLoad(options){
- let content = this.data.names.join(" ")
- this.setData({
- content
- })
- }
- })
有了wxs後,我們可以直接在wxml完成:
.wxml
- <wxs module="util">
- var joinArray = function (array) {
- return array.join(' ')
- }
-
- module.exports = {
- joinArray: joinArray
- }
- </wxs>
- <view>
- {{util.joinArray(names)}}
- </view>
或者将工具函數儲存為單獨的檔案,通過引入來使用:
/src/wxs/common.wxs
- var joinArray = function (array) {
- return array.join(' ')
- }
-
- module.exports = {
- joinArray: joinArray
- }
/pages/index/index.wxml
- <wxs src="../../src/wxs/common.wxs" module="util" />
- <view>
- {{util.joinArray(names)}}
- </view>
引入的時候,wxs标簽src填寫相對路徑(絕對路徑無效),module指定名字。
我們也可以将頁面中的一些常量放在wxs中:
- var MAX_COUNT = 19
- module.exports = {
- MAX_COUNT: MAX_COUNT
- }
總結:
-
增強了WXS
的功能,相當于頁面中的腳本語言,我們可以将比如檢查手機格式的函數放在wxml
中來使用(根據是否正确來改變相應的樣式),而不用跑到在wxs
中去檢查。js
需要注意的地方:
-
目前似乎并不支援wxs
(至少ES6
不能使用)let
-
檔案不能被wxs
檔案引用。js
檔案能引用wxs
檔案。wxs
參考:
微信小程式WXS官方文檔