npm 包地址
github 包地址
pubsub-js
是一个轻量级的 JavaScript
基于主题的消息订阅发布库 ,压缩后小于1b。它具有使用简单、性能高效、支持多平台等优点,可以很好地满足各种需求。
功能特点:
- 无依赖
- 同步解耦
- ES3 兼容。pubsub-js 能够在任何可以执行 JavaScript 的地方运行。
- AMD / CommonJS 模块支持
- 不修改订阅者(jQuery 自定义事件修改订阅者)
- 易于理解和使用(得益于同步解耦)
- 小(ish),压缩后小于 1kb
获取 pubsub-js
你可以通过以下几种方式获取 pubsub-js
。
- 使用 NPM 包
首先,你需要在项目根目录下使用以下命令安装 pubsub-js
:
# 使用 pnpm 安装
pnpm add pubsub-js
# 使用 npm 安装
npm install --save pubsub-js
# 使用 yarn 安装
yarn add pubsub-js
- 使用 CDN
你还可以通过 CDN
获取构建好的 pubsub-js
文件。将以下代码添加到 HTML
文件的 <script>
标签中:
<script src="https://unpkg.com/pubsub-js"></script>
<!-- or -->
<script src="http://www.jsdelivr.com/#!pubsubjs"></script>
<!-- or -->
<script src="https://cdnjs.com/libraries/pubsub-js"></script>
- 从 GitHub下载
GitHub下载地址
截止到目前,获取的最新版本是 v1.9.4
,如图:
引入 pubsub-js
- 通过 NPM 包引入
在 JavaScript
文件顶部使用 import
引入 pubsub-js
:
// using ES6 modules
import PubSub from 'pubsub-js'// using CommonJS modules
const PubSub = require('pubsub-js')
- 使用
script
标签引入
通过直接在 HTML
文件中添加 <script>
标签,引入构建好的 pubsub-js
文件:
<!DOCTYPE html>
<html><head><meta charset="utf-8" /><!-- 引入 pubsub-js 文件 --><script src="https://unpkg.com/pubsub-js"></script></head>
</html>
简单使用
以更新未读消息数量为例。
- 首先,新建一个
pubsub.js
文件
import PubSub from 'pubsub-js'export default PubSub
- 使用
subscribe
订阅事件/unsubscribe
取消订阅
import { onMounted, onUnmounted, ref } from 'vue'
import PubSub from '@/utils/pubsub'const count = ref(0)const readmessage = () => {count.value = count.value - 1
}
onMounted(() => {PubSub.subscribe('messageread', readmessage)...
})
onUnmounted(() => {PubSub.unsubscribe('messageread', readmessage)
})
- 使用
publish
发送消息
import PubSub from '@/utils/pubsub'...
PubSub.publish('messageread')
...
订阅 subscribe
- 获取订阅
// subscriptions by token from all topics
PubSub.getSubscriptions('token');
- 订阅计数
// count by token from all topics
PubSub.countSubscriptions('token');
取消/清除订阅 unsubscribe
订阅之后,一定要取消订阅。
- 取消特定订阅
// create a function to receive the topic
var mySubscriber = function (msg, data) {console.log(msg, data);
};// add the function to the list of subscribers to a particular topic
// we're keeping the returned token, in order to be able to unsubscribe
// from the topic later on
var token = PubSub.subscribe('MY TOPIC', mySubscriber);// unsubscribe this subscriber from this topic
PubSub.unsubscribe(token);
- 取消某个函数的所有订阅
// create a function to receive the topic
var mySubscriber = function(msg, data) {console.log(msg, data);
};// unsubscribe mySubscriber from ALL topics
PubSub.unsubscribe(mySubscriber);
- 清除某个主题的所有订阅
// no further notifications for 'a.b' and 'a.b.c' topics
// notifications for 'a' will still get published
PubSub.subscribe('a', myFunc1);
PubSub.subscribe('a.b', myFunc2);
PubSub.subscribe('a.b.c', myFunc3);PubSub.unsubscribe('a.b');
- 清除所有订阅
// all subscriptions are removed
PubSub.clearAllSubscriptions();
pubsub-js
通过发布/订阅模式实现实现组件间的解耦合,可以减少代码的复杂度和维护成本,使代码设计更人性化。