微信小程序WXS功能模块

版权声明:本文为博主原创文章,未经博主允许不得转载。 https://blog.csdn.net/xuelian3015/article/details/86314381

好久没有看微信小程序的官方文档了,最近在开发个人小程序时,才发现WXS功能。有点跟不上节奏了!

WXS模块代码可以写在WXML文件中的标签内,或者是以 .wxs为后缀的文件内。
每一个.wxs文件和标签都是一个单独的模块。拥有自己独立的作用域,一个模块里定义的变量和函数默认是私有的,如果需要对外暴露内部私有变量和函数,则通过module.exports实现。

每一个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>

require函数:在 .wxs中通过require函数可以引用其他的wxs文件模块。但是:
1、只能引用.wxs文件模块,而且必须使用相对路径。
2、wxs模块都为单例,模块第一次被引用时,会自动初始化为单例对象,多个页面多个地方多次引用,使用的都是同一个模块对象。
3、若WXS在定义后一直没有被引用,那么该模块不会被解析运行。
// /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 标签的模块名
src String 引入.wxs文件的相对路径

其中的module属性值的首字母必须是:字母(a-zA-Z),下划线(_)。其余字符可以是字母,下划线和数字。
在WXML文件中引用WXS标签如下:

            <wxs module="foo">
                  var some_msg = "hello world"; module.exports = { msg : some_msg, }
            </wxs>
            <view>{{foo.msg}}</view>

src属性用来引用其他的wxs文件模块,但是:
1、只能引用.wxs文件模块,而且必须使用相对路径。
2、wxs模块都为单例,模块第一次被引用时,会自动初始化为单例对象,多个页面多个地方多次引用,使用的都是同一个模块对象。
3、若WXS在定义后一直没有被引用,那么该模块不会被解析运行。

WXS的出现增强了WXML的功能,可以把它理解为WXML页面的脚本,我们可以将比如检查手机格式的函数放在wxs中来使用(根据是否正确来改变相应的样式),而不用跑到在js中去检查。类似于HTML中的script脚本一样。只需要区分WXS和script即可。
wxs目前不完全支持ES6(至少let,const不能使用)
wxs文件不能被js文件引用。wxs文件能引用wxs文件。

猜你喜欢

转载自blog.csdn.net/xuelian3015/article/details/86314381
今日推荐