微信小程序wxs

微信小程序文章推荐: 微信小程序必备开发技能总结(不断更新)

一、 微信小程序中的wxs 是什么?

wxs 是微信小程序提供的一套独有的脚本语言。它和javascript 非常像,但是又有所不同,它结合wxml 可以构建构建出页面结构。下面先来看一下具体用法。

二、wxs 的内联用法

index.wxml

html 复制代码
<view>
    <wxs module="m1">
        module.exports.filterNumber = function (arr) {
            return arr.filter(function (item) {
                return item % 2 === 0
            })
        }
    </wxs>
    <view wx:for="{{m1.filterNumber(list)}}" wx:key="index">{{item}}</view>
</view>

index.js

js 复制代码
// index.js
Page({
    data: {
        list: [
            1, 2, 3, 4, 5, 6
        ]
    }
})

运行效果:

wxs 有几个特点:

  • wxs 代码都必须写在wxs 标签之间(内联的,外联可以写在.wxs文件中)
  • 每个标签都必须有一个module属性,这是wxs的唯一id, 在wxml模板中要使用wxs标签中定义的方法必须通过module定义的属性值进行调用。
  • wxs中定义的方法必须通过module.exports 进行导出,只能使用commonjs规范,不能使用es6 的导出规范
  • 在wxs 中不支持es6语法,比如let const 等是不能使用的
  • wxs 中定义的函数不能作为模板中的事件回调。

我们来证明下最后一个点, 其他几点在这里就演示了,大家自己尝试下。

html 复制代码
<view>
    <wxs module="m1"src="../../wxs/filter-list.wxs"> 
    </wxs>
    <view wx:for="{{m1.filterNumber(list)}}" wx:key="index">{{item}}</view>
    <button bindtap="m1.filterNumber(list)" type="primary">按钮</button>
</view>

点击按钮, 你会发现事件没有触发,并且控制台会有警告 Component "pages/index/index" does not have a method "m1.filterNumber(list)" to handle event "tap". 大概意思就是没有定义m1.filterNumber(list) 方法,也就验证了 wxs 中定义的函数不能作为模板中的事件回调。

三、外联的使用方式:

index.wxml

html 复制代码
<view>
    <wxs module="m1"src="../../wxs/filter-list.wxs"> 
    </wxs>
    <view wx:for="{{m1.filterNumber(list)}}" wx:key="index">{{item}}</view>
</view>

filter-list.wxs

js 复制代码
module.exports.filterNumber = function (arr) {
    return arr.filter(function (item) {
        return item % 2 === 0
    })
}

从上面的例子可以看到, 引用外部的wxs,首先定义一个wxs的文件,并且导出模板需要的方法属性,然后在模板中通过wxs标签的src 引用,并且只能引用 .wxs 文件模块,且必须使用相对路径

三、wxs 文件中引用wxs 文件

在.wxs 文件中可以继续引用wxs 文件,只能引用wxs 文件,不能引用其他的文件,在.wxs文件中使用require 引用外部的wxs文件。具体使用方式如下:

index.wxml

html 复制代码
<view>
    <wxs module="m1"src="../../wxs/filter-list.wxs"> 
    </wxs>
    <view wx:for="{{m1.filterNumber(list)}}" wx:key="index">{{item}}</view>
    <view>姓名: {{m1.info.name}}</view>
    <view>年龄: {{m1.info.age}}</view>
</view>

filter-list.wxs

js 复制代码
var info = require('./info.wxs')

module.exports.filterNumber = function (arr) {
    return arr.filter(function (item) {
        return item % 2 === 0
    })
}
module.exports.info = info

info.wxs

js 复制代码
var info = {
    name: 'xiaoming',
    age: 20
}

module.exports = info

运行效果如下:

四、总结

本篇介绍了微信小程序中wxs 的内联用法和外联用法,以及wxs 的优点,缺点,注意点,在开发中可以适当的使用wxs 实现逻辑的复用。减少代码体积

若你对微信小程序感兴趣可以关注 uni-app,小程序知识储备 专栏

相关推荐
不会敲代码15 小时前
手写 Mini React:从 JSX 到虚拟 DOM 再到 render,搞懂 React 底层原理
前端·javascript·react.js
kyriewen6 小时前
你的代码仓库变成“毛线团”了?Monorepo 用 Turborepo 拆成“乐高积木”
前端·javascript·面试
身如柳絮随风扬7 小时前
你知道什么是 Ajax 吗?—— 从入门到原理,一篇彻底搞懂
前端·ajax·okhttp
旷世奇才李先生7 小时前
Vue3\+TypeScript 2026实战——企业级前端项目架构搭建与性能优化全指南
前端·架构·typescript
Beginner x_u7 小时前
前端八股整理(工程化 02)|CommonJS/ESM、Webpack Loader/Plugin 与Vite 对比
前端·webpack·node.js·plugin·loader
openKaka_8 小时前
createRoot 到底创建了什么:FiberRootNode 和 HostRootFiber 的初始化过程
前端·javascript·react.js
习明然8 小时前
UniApp开发体验感受总结
前端·uni-app
刀法如飞9 小时前
Claude Code Skills 推荐:2026年最值得安装的10个AI技能
前端·后端·ai编程
阿豪只会阿巴9 小时前
【没事学点啥】TurboBlog轻量级个人博客项目——项目介绍
javascript·python·django·html
Lee川10 小时前
面试手写 KeepAlive:React 组件缓存的实现原理
前端·react.js·面试