微信小程序脚本语言 WXS 怎么用

这是微信小程序踩坑系列的第二篇，想要了解更多关于微信小程序开发的那些事，欢迎关注我的《微信小程序》专栏。

前言

前几天有个同学问我 微信小程序支持管道过滤器 吗？
用过 angular 或者 vue 的同学都应该会在项目里用到 filter，然而在小程序中是不支持的。但是也有一些解决办法，有一篇文章讲得还算不错，我在这里贴一下微信小程序使用filter过滤器几种方式。
但我只是关心 WXS 能不能实现 filter 以及还能做什么？带着这样的疑问，我重新看了一遍微信小程序官方的 WXS。

image

下面举个简单的例子：

<wxs module="m1">var msg = "hello world"; module.exports.message = msg;</wxs>
<view>{{m1.message}}</view>

上面的例子可以输出 hello world 页面，当你阅读完官方文档，会发现小程序的脚本语言的功能很捉鳖，比如只支持 es5 语法，不支持外部引入 js 等等。但是我仍然期待它未来支持更多的能力。

下面接入正题，探索文章题目的疑问

一、用 WXS 实现 filter

前端通常有一个需求，那就是把后台传过来的时间戳转为不同规格的日期后显示出来。以往的做法一般是用一个函数对数据进行包装，然后输出到页面。就像前面提到的那篇文章里面所说的第一种方法一样，但是有人考虑到性能问题，认为在js里面循环处理比较耗性能（这点我不做评价，毕竟自己没有真正测试过）
关于日期格式化的例子在前面提到的文章已经有了，在这里我再举一个比较简单的例子。在我开发过的项目里面，后台返回的网路图片地址通常是相对地址，也就是说要把图片显示出来，还得加上配置好的域名前缀。而我通常是拿到数据后进行遍历操作，把需要前端展示的图片加上前缀。但是有了 WXS，我们可以这样做：

<wxs module="filter">
    function getFullPath(url) {
        return "https://shiyuanjieyi.cn" + url
    }
    module.exports.getFullPath = getFullPath
</wxs>
<image src="{{filter.getFullPath(url)}}"></image>

在上面这个例子中，可以看到整个过程基本类似于 vue 等框架自定义 filter 的做法。

二、 WXS 还能做什么

其实很多时候，我们并不了解 WXS 还能做更多条件渲染的一些东西。请看下面一个例子：

<wxs module="filter">
  function getData(entry, type) {
    var imgUrl = '';
    var content = '';
    switch (entry) {
      case 'needs':
        imgUrl = '/images/goods_empty.png';
        content = '暂时没有需求';
        break;
      case 'goods':
        imgUrl = '/images/goods_empty.png';
        content = '暂时没有商品';
        break;
      case 'activity':
        imgUrl = '/images/activity_empty.png';
        content = '该专栏暂时没有活动';
        break;
      case 'channel':
        imgUrl = '/images/article_empty.png';
        content = '该专栏暂时没有资讯';
        break;
      case 'micro-circle':
        imgUrl = '/images/article_empty.png';
        content = '没有相关的话题哦';
        break;
      case 'needs-release':
        imgUrl = '/images/goods_release_empty.png';
        content = '你还没有发布任何需求哦';
        break;
      case 'goods-release':
        imgUrl = '/images/goods_release_empty.png';
        content = '你还没有发布任何商品哦';
        break;
      case 'goods-collection':
        imgUrl = '/images/goods_collect_empty.png';
        content = '你还没有收藏任何商品哦';
        break;
      case 'apply':
        imgUrl = '/images/activity_apply_empty.png';
        content = '你还没有报名任何活动哦';
        break;
      case 'activity-collection':
        imgUrl = '/images/activity_collect_empty.png';
        content = '你还没有收藏任何活动哦';
        break;
      default:
        break;
    }
    if (type === 'image') {
      return imgUrl;
    } else {
      return content;
    }
  }
  module.exports.getData = getData;
</wxs>
<template name="nodata">
  <view class="no-data">
    <image src="{{filter.getData(entry, 'image')}}" class="no-data-icon"></image>
    <view class="no-data-text">{{filter.getData(entry, 'content')}}</view>
  </view>
</template>

上例中，我使用了 WXS 的函数功能帮我做条件判断，拿到对应的模板输出，其功能就是一个空数据展示页面。或许你会问这样写的好处是什么？
那我可以告诉你，它很容易扩展，比如新增一个页面需要对应的空数据模板，那么直接在 switch 语句中加多一个 case 即可。况且如果把逻辑写在 WXML 上代码会很复杂，不容易看懂。
明白了这一点，你会发现，只要是在 WXML 上需要做一些逻辑判断的操作都可以 WXS 代替。
也就是说，在开发中，我们都可以用 WXS 的函数功能帮助我们清晰有效地处理 WXML 上渲染的一些视图。

三、思考（引伸）

1、对于需要做成 filter 形式的 WXS，最好把它写在一个.wxs文件里，需要使用时，直接在对应 WXML 上引用即可。

var foo = "'hello world' from tools.wxs";
var bar = function (d) {
  return d;
}
module.exports = {
  FOO: foo,
  bar: bar,
};
module.exports.msg = "some msg";

<wxs src="./../tools.wxs" module="tools" />
<view>{{tools.msg}}</view>
<view>{{tools.bar(tools.FOO)}}</view>

2、在 .wxs 模块中引用其他 wxs 文件模块，可以使用 require 函数，但是不能引用其他 js 文件模块。

四、参考链接

WXS·小程序

（完）

本文作者 Thinker

本文如有错误之处，请留言，我会及时更正

觉得对您有帮助的话就点个赞或收藏吧！

欢迎转载或分享，转载时请注明出处

阅读原文