微信小程序?qū)W習(xí)之wxs使用教程
什么是wxs?
wxs(WeiXin Script)是小程序的一套腳本語(yǔ)言, 結(jié)合WXML, 可以構(gòu)建出頁(yè)面結(jié)構(gòu).
wxs標(biāo)簽
<wxs module="utils" src="../../wxs/test.wxs"></wxs>
module屬性:
當(dāng)前標(biāo)簽的模塊名, 建議該值唯一, 若存在同名的模塊名,則按照先后順序覆蓋(后者會(huì)覆蓋前者).
src屬性:
a. 只能引用.wxs文件, 且必須是相對(duì)路徑;
b. wxs模塊均為單例, wxs模塊在第一次被引用時(shí), 會(huì)自動(dòng)初始化為單例對(duì)象,多個(gè)頁(yè)面、多個(gè)地方、多次使用, 使用的都是同一個(gè)wxs模塊對(duì)象;
c. 如果一個(gè)wxs模塊在定義后一直沒(méi)有被引用, 則該模塊不會(huì)被解析與運(yùn)行;
wxs模塊
wxs代碼可編寫(xiě)在wxml文件中的標(biāo)簽內(nèi), 或以.wxs為后綴的文件內(nèi)(在微信開(kāi)發(fā)者工具里面, 右鍵直接創(chuàng)建.wxs文件,在里面直接編寫(xiě)wxs腳本)
寫(xiě)法1如下:
// test.wxml
<wxs module="utils">
module.exports = {
msg: 'hello world'
}
</wxs>
<view> {{utils.msg}}</view>
// 屏幕輸出: hello world
寫(xiě)法2如下:
// text.wxml
<wxs module="utils" src="../../common/wxs/test.wxs"></wxs>
// 也可直接使用單標(biāo)簽閉合的寫(xiě)法
// <wxs module="utils" src="../../common/wxs/test.wxs" />
<view> {{utils.msg}}</view>
// test.wxs
module.exports = {
msg: 'hello world'
}
wxs代碼一般建議寫(xiě)在.wxs文件中.
模塊說(shuō)明
- 每一個(gè).wxs文件和wxs標(biāo)簽都是一個(gè)單獨(dú)的模塊;
- 每個(gè)模塊都有獨(dú)立的作用域, 即在一個(gè)模塊里面定義的變量與函數(shù),默認(rèn)都是私有的, 對(duì)其它模塊不可見(jiàn).
- 若一個(gè)模塊想對(duì)外暴露其內(nèi)部的私有變量與函數(shù)、只能通過(guò)module.exports來(lái)實(shí)現(xiàn).
Q1: 若同一wxml引入多個(gè)wxs, 其中存在同名的變量or函數(shù), 會(huì)是什么表現(xiàn)呢?
// test.wxml
<wxs module="utils" src="../../wxs/test.wxs"></wxs>
<wxs module="utils1" src="../../wxs/test1.wxs"></wxs>
<view> {{utils.msg}} + {{utils.say()}}</view>
<view> {{utils1.msg}} +{{utils1.say()}}</view>
// test.wxs
module.exports = {
msg: 'hello test.wxs',
say: function (){
return 'test.wxs的say()'
}
}
// test1.wxs
module.exports = {
msg: 'hello test1.wxs',
say: function (){
return 'test1.wxs的say()'
}
}
// 屏幕輸出
// hello test.wxs + test.wxs的say()
// hello test1.wxs + test1.wxs的say()
經(jīng)過(guò)驗(yàn)證發(fā)現(xiàn), 每個(gè)模塊是有獨(dú)立作用域的.
Q2: 若想在.wxs模塊中引入其他wxs文件模塊, 該如何實(shí)現(xiàn)呢?
通過(guò)require函數(shù)
// test.wxs
var test1 = require('./test1.wxs')
module.exports = {
msg: 'hello test.wxs',
say: function (){
console.log(test1.msg)
return 'test.wxs的say()'
}
}
// 控制臺(tái)輸出
// [WXS Runtime info] hello test1.wxs
wxs注釋
// wxml文件 <wxs module="utils"> // .wxs-單行注釋 /** * .wxs-多行注釋 */ /* var a = 1 </wxs>
上述例子中, 所有的wxs代碼均被注釋了, 第三種寫(xiě)法比較少見(jiàn), 在學(xué)習(xí)的時(shí)候看到了順手記錄下.
若是.wxs文件, 則只有單行&多行2種注釋方式.
wxs基礎(chǔ)知識(shí)
加法運(yùn)算(+)用作字符串的拼接;
<wxs module="utils">
module.exports = {
getnum: function () {
var a = 10
var b = 20
var str = a + '+' + b + '=' + (a+b)
return str
}
}
</wxs>
<view>{{utils.getnum()}}</view>
不能使用``拼接運(yùn)算符、否則會(huì)報(bào)錯(cuò).

wxs目前支持以下幾種數(shù)據(jù)類(lèi)型:
number(數(shù)值)、string(字符串)、boolean(布爾值)、array(數(shù)組)、object(對(duì)象)、function(函數(shù))、date(日期)、regexp(正則)
wxs 數(shù)據(jù)類(lèi)型中時(shí)沒(méi)有null/undefined的.
生成date對(duì)象需要使用getDate(), 返回一個(gè)當(dāng)前時(shí)間的對(duì)象.
<wxs module="utils">
module.exports = {
getNowTime: function () {
return getDate()
}
}
</wxs>
<view>{{utils.getNowTime()}}</view>
// 屏幕輸出
// Sat May 01 2021 14:42:57 GMT+0800 (中國(guó)標(biāo)準(zhǔn)時(shí)間)
不能使用new Date(), 會(huì)報(bào)錯(cuò).

不支持es6語(yǔ)法, 像解構(gòu)啊, 箭頭函數(shù)都是不支持的.
不能使用let/const申明變量、要用var,存在變量提升。
<wxs module="utils">
module.exports = {
getnum: function () {
let a = 10
return a
}
}
</wxs>
<view>{{utils.getnum()}}</view>

應(yīng)用場(chǎng)景
一般后端返回給前端的是時(shí)間戳格式, 但是我們要處理成想要的時(shí)間格式, 比如yyyy-mm-dd, 此時(shí)我們就可用wxs調(diào)用時(shí)間轉(zhuǎn)換函數(shù).
也許有人要問(wèn)了, 在js中用一個(gè)函數(shù)對(duì)數(shù)據(jù)進(jìn)行包裝, 然后再輸出到頁(yè)面中不也可行嗎? 答案是可行的, 只是在追求一個(gè)你認(rèn)為相對(duì)更優(yōu)解.
<wxs module="utils">
module.exports = {
formatTime: function (timeStamp) {
var now = getDate(parseInt(timeStamp))
var year = now.getFullYear()
var month = now.getMonth()+1
month = month < 10 ? '0' + month: month
var day = now.getDate()
day = day < 10 ? '0' + day :day
return year + '-' + month + '-' + day
}
}
</wxs>
<view>{{utils.formatTime(1619852841428)}}</view>
// 屏幕輸出
// 2021-05-01
有時(shí)候后臺(tái)返回的網(wǎng)絡(luò)圖片地址是相對(duì)路徑, 有時(shí)候又是完整的圖片路徑, 若要把圖片顯示出來(lái), 需要加上配置好的域名前綴.
<wxs module="utils">
module.exports = {
getImg: function (url = '') {
var origin = 'https://xxx.com'
if (url.indexOf('https') !== -1 || url.indexOf('http') !== -1) {
return url
} else {
return origin + url
}
}
}
</wxs>
<image src="{{utils.getImg('/a.png')}}"></image>
// src輸出
// https://xxx.com/a.png
踩坑記錄
在wxml中調(diào)用時(shí)使用編譯出現(xiàn)了Expected LineFeed

解決方案: 把ES6的東西全部換成ES5, 用var申明.
總結(jié)
到此這篇關(guān)于微信小程序?qū)W習(xí)之wxs使用教程的文章就介紹到這了,更多相關(guān)微信小程序wxs使用內(nèi)容請(qǐng)搜索腳本之家以前的文章或繼續(xù)瀏覽下面的相關(guān)文章希望大家以后多多支持腳本之家!
相關(guān)文章
ES6中Proxy與Reflect實(shí)現(xiàn)重載(overload)的方法
這篇文章主要介紹了ES6中Proxy與Reflect實(shí)現(xiàn)重載(overload)的方法,分析了重載的原理及使用Proxy和Reflect來(lái)實(shí)現(xiàn)重載的操作步驟與相關(guān)技巧,需要的朋友可以參考下2017-03-03
javascript實(shí)現(xiàn)當(dāng)前頁(yè)導(dǎo)航激活的方法
這篇文章主要介紹了javascript實(shí)現(xiàn)當(dāng)前頁(yè)導(dǎo)航激活的方法,涉及javascript操作css的技巧,具有一定參考借鑒價(jià)值,需要的朋友可以參考下2015-02-02
Javascript 更新 JavaScript 數(shù)組的 uniq 方法
2008-01-01
通過(guò)JS深度判斷兩個(gè)對(duì)象字段相同
這篇文章主要介紹了通過(guò)JS深度判斷兩個(gè)對(duì)象字段相同,文中通過(guò)示例代碼介紹的非常詳細(xì),對(duì)大家的學(xué)習(xí)或者工作具有一定的參考學(xué)習(xí)價(jià)值,,需要的朋友可以參考下2019-06-06
IE8中使用javascript動(dòng)態(tài)加載CSS的解決方法
這篇文章主要介紹了IE8中使用javascript動(dòng)態(tài)加載CSS的解決方法,此方法也不是很完美,需要的朋友參考下吧2014-06-06
轉(zhuǎn)換json格式的日期為Javascript對(duì)象的函數(shù)
項(xiàng)目中碰到了用jQuery從后臺(tái)獲取的json格式的日期的字符串,需要將此字符串轉(zhuǎn)換成JavaScript的日期對(duì)象,記在此處,以備后用。2010-07-07
通過(guò)實(shí)例解析JavaScript for in及for of區(qū)別
這篇文章主要介紹了通過(guò)實(shí)例解析JavaScript for in及for of區(qū)別,文中通過(guò)示例代碼介紹的非常詳細(xì),對(duì)大家的學(xué)習(xí)或者工作具有一定的參考學(xué)習(xí)價(jià)值,需要的朋友可以參考下2020-06-06

