npm 包 @storybook/channels 使用教程

前言

在前端开发中,组件化和视觉化管理是极为重要的。Storybook 是一款给组件开发提供注释性的工具,也是构建 UI 组件库的利器之一。 Storybook 通过展示组件示例,可以使得开发人员能够更加直观地看到组件的外部效果和内部结构。

在 Storybook 中,不同的组件示例可以被组织在不同的 stories 下,有时候不同的 stories 需要传递一些信息。例如,在一个 select 组件中选择了不同的选项,需要同步更新另一个组件。这时候,就需要在不同 stories 之间进行通信,这就要用到 npm 包 @storybook/channels。

本文将详细介绍如何使用 npm 包 @storybook/channels 进行 Storybook 中不同 stories 之间的通信,并含有相应的示例代码。

使用步骤

1. 安装@storybook/channels

使用 npm 或 yarn 安装 @storybook/channels:

- --- - -------------------
- -
- ---- --- -------------------

2. 注册通道

在发送和接收通道消息之前,首先需要注册一个通道。我们需要在各自的 stories 中分别注册通道。

-- --------- --- ------
------ - ------ - ---- --------------------
------ - ----------- - ---- --------------

------ ----- ------- - --------------------

--------------------------- ----- -- -
  --------------------- -------- -------
---

----------------------------- - --------- ------ ------- ---

-- --------- --- ------
------ ----- ------- - ------------------

我们在上面示例代码中,通过 addons.getChannel() 的方式返回一个已经存在的通道,我们也可以通过 createChannel() 的方式创建一个新的通道并注册。

3. 定义事件监听器和事件发布器

在每个 stories 中,需要定义一个事件监听器(listener)和事件发布器(emitter),以完成 message 的发送和接收。示例代码如下:

EventEmitter.js

------ ----- ---- --------
------ - ------- - ---- ------------

------ ------- ----- ------------ ------- --------------- -

  ----------- - -- -- -
    ----------------------------- - ----- ---- ---
  -

  -------- -
    ------ -
      ------- ------------------------------- ----------------
    --
  -
-

在这里,我们定义了一个叫做 EventEmitter 的组件,当点击按钮时就触发了一个名为 "my-event-name" 的事件,同时将一些数据传递给了事件发布器。用户可自定义事件名。

EventListener.js

------ ----- ---- --------
------ - ------- - ---- ------------

------ ------- ----- ------------- ------- --------------- -
  ------------------- -
    --------------------------- ------- ---- -- -
      -------------------
    ---
  -

  -------- -
    ------ --------------- -- -----------------
  -
-

上述代码定义了一个名为 EventListener 的组件,它在 componentDidMount 阶段开始监听事件 "my-event-name",并输出事件对象到 console 中。

4. 启动 Storybook

检查完上述代码是否编写正确后,我们执行命令 npx start-storybooknpm run storybook 启动 Storybook。

5. 触发事件

打开 Storybook,我们可以看到页面渲染出来了 EventListener 和 EventEmitter 两个组件。我们点击 EventEmitter 组件的按钮,你将可以在 console 窗口中看到来自 EventListener 组件的事件输出。

到此,我们就成功实现了在不同 stories 之间进行消息的发送与接收。

总结

上述代码只是 @storybook/channels 的一个简单使用场景。在业务场景下,@storybook/channels 可以通过接收形如 {type: 'REQUEST_SOMETHING', payload: {}} 的消息来触发页面跳转或变更。@storybook/channels 可以实现跨 stories、跨组件之间的信息传递,具备广泛的应用场景。

示例代码

如下是本文的完整示例代码:

-- --------- --- ------

-- ----------
------ - ------ - ---- --------------------
------ - ----------- - ---- --------------

------ ----- ------- - --------------------

--------------------------- ----- -- -
  --------------------- -------- -------
---

----------------------------- - --------- ------ ------- ---

-- ----------------
------ ----- ---- --------
------ ------------ ---- -----------------
------ ------------- ---- ------------------

------ ------- -
  ------ --- -------------------
  ---------- -------------
--

------ ----- ------- - -- -- -
  --
    -------------- --
    ------------- --
  ---
--

-- ---------------
------ ----- ---- --------
------ - ------- - ---- ------------

------ ------- ----- ------------ ------- --------------- -

  ----------- - -- -- -
    ----------------------------- - ----- ---- ---
  -

  -------- -
    ------ -
      ------- ------------------------------- ----------------
    --
  -
-

-- ----------------
------ ----- ---- --------
------ - ------- - ---- ------------

------ ------- ----- ------------- ------- --------------- -
  ------------------- -
    --------------------------- ------- ---- -- -
      -------------------
    ---
  -

  -------- -
    ------ --------------- -- -----------------
  -
-

欢迎各位阅读本文,若还有不明白的地方,可多多交流。

来源:JavaScript中文网 ,转载请联系管理员! 本文地址:https://www.javascriptcn.com/post/98517


猜你喜欢

  • npm 包 mixtrack-client 使用教程

    介绍 mixtrack-client 是一个基于 Node.js 实现的用于调用 Mixtrack 数据接口的 npm 包。 Mixtrack 是一款混音工具,提供了丰富的音乐库和制作工具。

    5 年前
  • npm包@f/is-undefined 使用教程

    前言 在前端开发中,我们常常需要判断某个变量是否为undefined,为了方便使用,有些开发者会自己封装一些方法来判断变量的类型。但是,在npm库中,也有很多优秀的工具来帮助我们实现这个功能,@f/i...

    5 年前
  • npm 包 awv3-react 使用教程

    简介 awv3-react 是一个基于 React 的前端组件库,可用于快速搭建前端页面。它提供了灵活且易于使用的 UI 组件,可以用于移动端和 PC 端页面的开发。

    5 年前
  • npm 包 apollo-upload-client 使用教程

    简介 apollo-upload-client 是一个用于GraphQL请求中上传文件的客户端 JavaScript 库,官方提供了 React 和 Angular 的封装。

    5 年前
  • npm 包 @types/webpack-merge 使用教程

    在前端项目中,使用 Webpack 来打包和构建项目已经成为一种主流。而在 Webpack 的配置中,使用 webpack-merge 来合并配置也越来越受到重视。

    5 年前
  • npm 包 @types/memory-fs 使用教程

    随着前端技术的不断发展,越来越多的项目需要涉及到文件系统的操作。在 Node.js 中,文件系统操作是很常见的。然而在前端中,要进行文件系统操作则需要使用到一些特殊的工具库。

    5 年前
  • npm 包 @types/json5 使用教程

    在前端开发中,JSON 是一个非常常见的数据格式。但是,在实际开发中,很多时候我们需要对 JSON 数据进行一些特殊处理,例如在实际应用中使用 JavaScript 的方式去解析和读取 JSON 数据...

    5 年前
  • NPM包@types/jsdom使用教程

    在前端开发中,为了使我们的代码更具有可读性和可维护性,通常会使用 TypeScript 来编写我们的代码。在 TypeScript 中,由于其强类型特性,我们需要为常用的 JavaScript 库添加...

    5 年前
  • npm 包 @types/js-yaml 使用教程

    1. 什么是 @types/js-yaml? @types/js-yaml 是一个 npm 包,它提供了 js-yaml 的 TypeScript 类型定义。如果您在使用 TypeScript 进行前...

    5 年前
  • NPM 包 component-inherit 使用教程

    在前端开发中,有很多时候我们需要继承一个组件,即让一个组件继承另一个组件的属性和方法。这时候,我们可以使用 npm 包 component-inherit。下面,我将为大家介绍该 npm 包的使用方法...

    5 年前
  • npm 包 @holytiny/wxmp-engine.io-parser 使用教程

    简介 @holytiny/wxmp-engine.io-parser 是一个兼容小程序平台的 engine.io 协议解析器。它可以用于实现小程序实时通信能力,例如聊天应用。

    5 年前
  • npm 包 @types/react-dom 使用教程

    前言 在使用 React 开发前端项目的时候,会用到一些常用的库和工具,比如 react 和 react-dom 等。这些库都是通过 npm 进行安装和管理的。在使用这些库的时候,我们经常需要使用到它...

    5 年前
  • npm 包 @types/react 使用教程

    什么是 @types/react 在使用 TypeScript 开发 React 应用的过程中,由于 React 并没有提供完整的类型定义文件,我们就需要依赖 @types/react 这个 npm ...

    5 年前
  • npm 包 @svgr/rollup 使用教程

    背景 SVG 是一种矢量图形标准,它的优点就是可以在任意尺寸下无失真,而缺点则是难以编辑和交互。由于在前端中,尤其是在 React 应用中使用 SVG 的需求量越来越大,因此产生了一些 SVG 编辑器...

    5 年前
  • npm 包 @types/rc-slider 使用教程

    在前端开发中,经常会使用到一些滑块组件来实现数据的选择。其中,rc-slider 是一个简单易用的滑块组件,它的优点在于支持多种类型的滑块,例如单选、多选、连续、不连续等等。

    5 年前
  • npm 包 @babel/plugin-proposal-private-methods 使用教程

    在 JavaScript 的面向对象编程中,私有方法是类中的一种隐藏的方法,只能在类内部调用,而外部无法访问。这种方法可以有效保护类中的属性和方法不被外部随意修改和调用。

    5 年前
  • npm 包 rc-pagination 使用教程

    什么是 rc-pagination? rc-pagination 是一个用于分页的 React 组件库,它有着简单易用、灵活多样等特点,目前在 npm 上的下载量已经超过了 200 万次。

    5 年前
  • npm 包 @babel/runtime-corejs3 使用教程

    随着前端代码越来越复杂,我们需要使用各种工具和技术来提高代码的可维护性和可读性。其中,使用 Babel 来将 ES6 以上的代码转换为 ES5 是必不可少的一环。但是,由于 Babel 自身的一些限制...

    5 年前
  • npm 包 rc-notification 使用教程

    在前端开发中,我们经常需要使用弹窗通知等功能。而 rc-notification 是一个非常好用的 npm 包,可自定义通知信息、位置、时长等。本文将详细介绍 rc-notification 的使用方...

    5 年前
  • npm 包 @babel/preset-typescript 使用教程

    在前端开发中,TypeScript 已经成为越来越受欢迎的语言。但是,在使用 TypeScript 编写代码并将其转换为 JavaScript 时,我们需要使用一些工具帮助我们处理类型检查和语法转换。

    5 年前

相关推荐

    暂无文章