微信小程序學習之wxs使用教程

更新時間：2021年05月08日 14:37:36 作者：bug制造者

這篇文章主要給大家介紹了關于微信小程序學習之wxs使用教程的相關資料，文中通過示例代碼介紹的非常詳細，對大家的學習或者工作具有一定的參考學習價值，需要的朋友們下面隨著小編來一起學習學習吧

什么是wxs?

wxs(WeiXin Script)是小程序的一套腳本語言, 結合WXML, 可以構建出頁面結構.

wxs標簽

<wxs module="utils" src="../../wxs/test.wxs"></wxs>

module屬性:

當前標簽的模塊名, 建議該值唯一, 若存在同名的模塊名,則按照先后順序覆蓋(后者會覆蓋前者).

src屬性:

a. 只能引用.wxs文件, 且必須是相對路徑;

b. wxs模塊均為單例, wxs模塊在第一次被引用時, 會自動初始化為單例對象，多個頁面、多個地方、多次使用, 使用的都是同一個wxs模塊對象;

c. 如果一個wxs模塊在定義后一直沒有被引用, 則該模塊不會被解析與運行;

wxs模塊

wxs代碼可編寫在wxml文件中的標簽內, 或以.wxs為后綴的文件內(在微信開發(fā)者工具里面, 右鍵直接創(chuàng)建.wxs文件,在里面直接編寫wxs腳本)

寫法1如下:

// test.wxml
<wxs module="utils">
  module.exports = {
    msg: 'hello world'
  }
</wxs>
<view> {{utils.msg}}</view>
// 屏幕輸出: hello world

寫法2如下:

// text.wxml
<wxs module="utils" src="../../common/wxs/test.wxs"></wxs>
// 也可直接使用單標簽閉合的寫法
// <wxs module="utils" src="../../common/wxs/test.wxs" />
<view> {{utils.msg}}</view>
// test.wxs
module.exports = {
  msg: 'hello world'
}

wxs代碼一般建議寫在.wxs文件中.

模塊說明

每一個.wxs文件和wxs標簽都是一個單獨的模塊;
每個模塊都有獨立的作用域, 即在一個模塊里面定義的變量與函數(shù)，默認都是私有的, 對其它模塊不可見.
若一個模塊想對外暴露其內部的私有變量與函數(shù)、只能通過module.exports來實現(xiàn).

Q1: 若同一wxml引入多個wxs, 其中存在同名的變量or函數(shù), 會是什么表現(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)過驗證發(fā)現(xiàn), 每個模塊是有獨立作用域的.

Q2: 若想在.wxs模塊中引入其他wxs文件模塊, 該如何實現(xiàn)呢？

通過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()'
  }
}
// 控制臺輸出
// [WXS Runtime info] hello test1.wxs

wxs注釋

// wxml文件
<wxs module="utils">
// .wxs-單行注釋

/**
 * .wxs-多行注釋
 */
 
/*
var a = 1

</wxs>

上述例子中, 所有的wxs代碼均被注釋了, 第三種寫法比較少見, 在學習的時候看到了順手記錄下.

若是.wxs文件, 則只有單行&多行2種注釋方式.

wxs基礎知識

加法運算（+）用作字符串的拼接;

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

不能使用``拼接運算符、否則會報錯.

wxs目前支持以下幾種數(shù)據(jù)類型:

number(數(shù)值)、string(字符串)、boolean(布爾值)、array(數(shù)組)、object(對象)、function(函數(shù))、date(日期)、regexp(正則)

wxs 數(shù)據(jù)類型中時沒有null/undefined的.

生成date對象需要使用getDate(), 返回一個當前時間的對象.

<wxs module="utils">
module.exports = {
  getNowTime: function () {
    return getDate()
  }
}
</wxs>
<view>{{utils.getNowTime()}}</view>
// 屏幕輸出
// Sat May 01 2021 14:42:57 GMT+0800 (中國標準時間)

不能使用new Date(), 會報錯.

不支持es6語法, 像解構啊, 箭頭函數(shù)都是不支持的.

不能使用let/const申明變量、要用var,存在變量提升。

<wxs module="utils">
module.exports = {
  getnum: function () {
    let a = 10
    return a
  }
}
</wxs>
<view>{{utils.getnum()}}</view>

應用場景

一般后端返回給前端的是時間戳格式, 但是我們要處理成想要的時間格式, 比如yyyy-mm-dd, 此時我們就可用wxs調用時間轉換函數(shù).

也許有人要問了, 在js中用一個函數(shù)對數(shù)據(jù)進行包裝, 然后再輸出到頁面中不也可行嗎? 答案是可行的, 只是在追求一個你認為相對更優(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

有時候后臺返回的網(wǎng)絡圖片地址是相對路徑, 有時候又是完整的圖片路徑, 若要把圖片顯示出來, 需要加上配置好的域名前綴.

<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