storybook使用

2024-08-30 18:12
文章标签 使用 storybook

本文主要是介绍storybook使用,希望对大家解决编程问题提供一定的参考价值,需要的开发者们随着小编来一起学习吧!

文中有部分名词可能不准确,见谅

本文主要介绍storybook+shadcn/ui+tailwindcss的storybook代码编写。

相关lib版本
“storybook”: “^8.2.4”,
“tailwindcss”: “^3.4.1”,

一、简介

首先,使用storybook开发一个组件需要两个文件,一个是组件*.tsx一个是story*.stories.ts/*.stories.tsx,css使用了tailwind,所以不单独进行css文件的编写。
在这里关于story文件*.stories.ts/*.stories.tsx,如果有引入组件的需求,请务必使用tsx或者jsx,否则无法识别。

二、开始

以开发一个列表为例,此列表的列表项左侧是icon+title,并且支持点击选中和点击事件。
分成两个组件开发。一个是<ListItem>,一个是<List>
先看ListItem的开发

1.ListItem

1)组件

下方是ListItem的组件代码,icon可以是导入的icon组件或者本地图片放在img标签内,这点随意。
注意,因为是tsx,所以该组件需要声明类型。

//ListItem.tsx
import React from 'react';interface List{title: string;icon: string;
}interface ListItemProps {list: List;onClick: () => void;selected?: boolean;
}const ListItem: React.FC<ListItemProps> = ({list,onClick,selected = false,
}) => {return(<divclassName={`flex items-center justify-between p-4 text-sm ${selected?'border-l-4 border-l-black bg-gray-500':''}`}onClick={onClick}><div className="flex items-center"><div className="relative mr-4 size-10"><img src={list.icon} alt=""/></div><div className="font-semibold">{list.title}</div></div></div>)
}

这个组件接收三个参数,分别是list对象、onClick函数和select状态。根据这三个,在story文件中定义不同的story。

2)story
//ListItem.stories.tsx
import { Meta, StoryObj } from '@storybook/react';
import ListItem from './ListItem';const meta: Meta<typeof ListItem> = {title: 'List/ListItem',component: ListItem,argTypes: {onClick: { action: 'onClick' },selected: { control: 'boolean' },},tags: ['autodocs'],
};export default meta;type Story = StoryObj<typeof ListItem>;

编写story文件,导入Meta生成meta,定义组件的属性。对于onClick和selected,放在argTypes中,因为需要在文档中实现这两个属性的交互。StoryObj用于生成推断类型,在生成story实例时进行类型声明

//ListItem.stories.tsx
const List = {title: "tmp1";icon: "img1";
}export const Default: Story = {args: {network: List,selected: false,},
};export const Selected: Story = {args: {network: List,selected: true,},
};

上方的代码生成了两个story实例。在args中定义属性。args也可以在meta定义时声明,这样就可以得到所有story实例通用的属性。类似继承和重写。

2.List

1)组件
//List.tsx
import React from 'react';
import ListItem from './ListItem';interface List{title: string;icon: string;
}
interface ListProps {lists: List[];onSelect: () => void;selected:string
}const List: React.FC<ListProps> = ({lists,onSelect,selected
}) => {return (<div className="divide-y">{lists.map((list) => (<ListItemkey={list.title}list={list}onClick={onSelect}selected={list.title === selected}/>))}</div>);
};export default List;
2)story
//List.stories.tsx
import { Meta, StoryObj } from '@storybook/react';
import List from './List';const meta: Meta<typeof List> = {title: 'List/List',component: List,argTypes: {onSelect: { action: 'onSelect' },selected: { control: 'text' },},
};export default meta;type Story = StoryObj<typeof List>;const lists: List[] = [{title: 'tmp1',icon: 'img1',},{title: 'tmp2',icon: 'img2',},
];export const Default: Story = {args: {list2,selected: 'tmp2',},
};

这篇关于storybook使用的文章就介绍到这儿,希望我们推荐的文章对编程师们有所帮助!



http://www.chinasem.cn/article/1121563

相关文章

使用Docker构建Python Flask程序的详细教程

《使用Docker构建PythonFlask程序的详细教程》在当今的软件开发领域,容器化技术正变得越来越流行,而Docker无疑是其中的佼佼者,本文我们就来聊聊如何使用Docker构建一个简单的Py... 目录引言一、准备工作二、创建 Flask 应用程序三、创建 dockerfile四、构建 Docker

Python使用vllm处理多模态数据的预处理技巧

《Python使用vllm处理多模态数据的预处理技巧》本文深入探讨了在Python环境下使用vLLM处理多模态数据的预处理技巧,我们将从基础概念出发,详细讲解文本、图像、音频等多模态数据的预处理方法,... 目录1. 背景介绍1.1 目的和范围1.2 预期读者1.3 文档结构概述1.4 术语表1.4.1 核

Python使用pip工具实现包自动更新的多种方法

《Python使用pip工具实现包自动更新的多种方法》本文深入探讨了使用Python的pip工具实现包自动更新的各种方法和技术,我们将从基础概念开始,逐步介绍手动更新方法、自动化脚本编写、结合CI/C... 目录1. 背景介绍1.1 目的和范围1.2 预期读者1.3 文档结构概述1.4 术语表1.4.1 核

Conda与Python venv虚拟环境的区别与使用方法详解

《Conda与Pythonvenv虚拟环境的区别与使用方法详解》随着Python社区的成长,虚拟环境的概念和技术也在不断发展,:本文主要介绍Conda与Pythonvenv虚拟环境的区别与使用... 目录前言一、Conda 与 python venv 的核心区别1. Conda 的特点2. Python v

Spring Boot中WebSocket常用使用方法详解

《SpringBoot中WebSocket常用使用方法详解》本文从WebSocket的基础概念出发,详细介绍了SpringBoot集成WebSocket的步骤,并重点讲解了常用的使用方法,包括简单消... 目录一、WebSocket基础概念1.1 什么是WebSocket1.2 WebSocket与HTTP

C#中Guid类使用小结

《C#中Guid类使用小结》本文主要介绍了C#中Guid类用于生成和操作128位的唯一标识符,用于数据库主键及分布式系统,支持通过NewGuid、Parse等方法生成,感兴趣的可以了解一下... 目录前言一、什么是 Guid二、生成 Guid1. 使用 Guid.NewGuid() 方法2. 从字符串创建

Python使用python-can实现合并BLF文件

《Python使用python-can实现合并BLF文件》python-can库是Python生态中专注于CAN总线通信与数据处理的强大工具,本文将使用python-can为BLF文件合并提供高效灵活... 目录一、python-can 库:CAN 数据处理的利器二、BLF 文件合并核心代码解析1. 基础合

Python使用OpenCV实现获取视频时长的小工具

《Python使用OpenCV实现获取视频时长的小工具》在处理视频数据时,获取视频的时长是一项常见且基础的需求,本文将详细介绍如何使用Python和OpenCV获取视频时长,并对每一行代码进行深入解析... 目录一、代码实现二、代码解析1. 导入 OpenCV 库2. 定义获取视频时长的函数3. 打开视频文

Spring IoC 容器的使用详解(最新整理)

《SpringIoC容器的使用详解(最新整理)》文章介绍了Spring框架中的应用分层思想与IoC容器原理,通过分层解耦业务逻辑、数据访问等模块,IoC容器利用@Component注解管理Bean... 目录1. 应用分层2. IoC 的介绍3. IoC 容器的使用3.1. bean 的存储3.2. 方法注

Python内置函数之classmethod函数使用详解

《Python内置函数之classmethod函数使用详解》:本文主要介绍Python内置函数之classmethod函数使用方式,具有很好的参考价值,希望对大家有所帮助,如有错误或未考虑完全的地... 目录1. 类方法定义与基本语法2. 类方法 vs 实例方法 vs 静态方法3. 核心特性与用法(1编程客