Storybook for vue

Easter79
• 阅读 915

一、简介

  Storybook是一款开源的组件开发工具,它可以运行在主程序之外,因此开发者可以用它来独立开发UI组件,或者用它来快速构建ui组件文档。

  目前Storybook支持的框架有:

  • React
  • React Native 
  • Vue
  • Angular
  • Marionette.js
  • Mithril
  • Marko
  • HTML
  • Svelte
  • Riot
  • Ember
  • Preact
  • Rax

  Storybook for vue

  可以看到,Storybook的功能是相当丰富的。本文将以Vue为例,从零开始搭建一个自己的Storybook。

二、安装Storybook

  首先自己创建一下文件夹,storybook-demo。

  官方文档中给的安装方式有2种,第一种是自动化安装,有点类似vue的脚手架,它会自动将环境配置好,开发者无需手动初始化相关配置文件。

npx -p @storybook/cli sb init --type vue

  第二种是可以手动进行配置,读者可以参照官网的教程来进行安装。附送地址:https://storybook.js.org/docs/guides/guide-vue/

  但是笔者经过尝试,使用官方的方法安装的时候会缺少部分依赖导致运行失败,下面将介绍一下笔者自己使用的安装方法。

  首先,安装vue脚手架,然后初始化项目:

vue create storybook-demo

  Storybook for vue

  Storybook for vue

  选择babel和css预处理, 并且在第三部选择安装node-sass,这几项是必须的,其他可根据需要进行选择。  

  Storybook for vue

  脚手架安装完成后,删除无关文件,并在根目录下新建.storybook、stories文件夹,在.storybook下新建以下文件:addons.js、main.js、config.js、webpack.config.js。完成之后目录如下:

  Storybook for vue

  下面再进行storybook的相关安装。

  安装storybook for vue:

npm install @storybook/vue --save-dev

  在根目录下找到package.json文件并配置引导:

{
    "scripts": {
      "storybook": "start-storybook"
    }
}

  当然,你也可以在后面跟上-p port来设置默认端口号,如:

{
    "scripts": {
      "storybook": "start-storybook -p 6006"
    }
}

  在根目录下新建.storybook文件夹,并在里面新建main.js文件,进行相关配置:

module.exports = {

  stories: ['../stories/**/*.stories.js', '../stories/*.stories.js']

};

  这样系统就会自动解析src目录下的*.stories.js、*.stories.ts文件了。

  之后,在根目录下新建src文件夹,在里面新建index.stories.js文件并编写自己的组件:

import Vue from 'vue';
import MyButton from './Button.js';

export default { title: 'Button' };

export const withText = () => '<my-button>with text</my-button>';

export const withEmoji = () => '<my-button>😀 😎 👍 💯</my-button>';

export const asAComponent = () => ({
  components: { MyButton },
  template: '<my-button :rounded="true">rounded</my-button>'
});

  Button.js(由于这里没有安装vue文件的解析依赖,所以只能用js文件来进行代替,如果想引入vue来代替js,可自行安装相关loader):

export default {
  name: 'my-button',

  data() {
    return {
      buttonStyles: {
        border: '1px solid #eee',
        borderRadius: 3,
        backgroundColor: '#FFFFFF',
        cursor: 'pointer',
        fontSize: 15,
        padding: '3px 10px',
        margin: 10,
      },
    };
  },

  template: `
    <button :style="buttonStyles" @click="onClick">
      <slot></slot>
    </button>
  `,

  methods: {
    onClick() {
      console.log('click');
      this.$emit('click');
    },
  },
};

  这样,一个简单的storybook就搭建完成了。在命令行输入:

npm run storybook

  就会自动打开刚才的storybook。

  Storybook for vue

三、storybook的插件 - addons

  通过上面的搭建可以看到,我们自己搭建的storybook与一开始的看到的图片简直就是买家秀和卖家秀的区别。这是因为在storybook中,它提供了很多插件供开发者使用,开发者可以使用addons给每个story增加额外的功能,如使用文档、查看源码、查看事件等,使每个story的功能更加丰富。

  storybook自带的addons已足够使用,当然官方也提供了相关api可以让开发者编写自己的addon,具体实现可移步到官方文档中进行查看。

  官方自带的addons可参考:

  https://storybook.js.org/addons/

  https://github.com/storybookjs/storybook/tree/master/addons

  当然,使用addons之前必须先到https://github.com/storybookjs/storybook/blob/master/ADDONS_SUPPORT.md查看相关addon是否支持当前框架,比如说info插件就只支持react但是不支持vue,之前笔者还在这里研究了半天为什么info一直配置失败。

  下面介绍几个笔者自己用过的addon以及配置方法,其他addon可照猫画虎,根据官方文档给的参数进行配置即可。

1. story-source - 查看当前story源码

  安装:

npm i @storybook/addon-storysource --save-dev

  配置:

  .storybook/main.js

const path = require("path");
module.exports = {
  stories: ["../stories/**/*.stories.js", "../stories/*.stories.js"],
  addons: [
    {
      name: "@storybook/addon-storysource",
      options: {
        rule: {
          // test: [/\.stories\.jsx?$/], This is default
          include: [path.resolve(__dirname, "../stories")], // 找到自己存放stories的文件夹
        },
        loaderOptions: {
          prettierConfig: { printWidth: 80, singleQuote: false },
        },
      },
    },
  ],
};

  其中,loaderOptions的默认值为:

{
  printWidth: 100,
  tabWidth: 2,
  bracketSpacing: true,
  trailingComma: 'es5',
  singleQuote: true,
}

  在.storybook/addons.js里面进行插件注册:

import '@storybook/addons';
import '@storybook/addon-storysource'

  到这里就可以了,重新运行一下看一下结果:

  Storybook for vue

2. readme - 当前组件的文档说明

  Storybook for vue

  安装:

npm install --save-dev storybook-readme

  注册:

  .storybook/addons.js

import 'storybook-readme/register';

  配置:

  这里可分为全局配置和局部配置,全局配置可以在.storybook/config.js里面进行相关配置,局部配置可在制定的*.stories.js文件里进行配置。区别如下:

  全局配置需调用以下方法:

import { addDecorator } from '@storybook/vue';
import { addReadme, configureReadme } from 'storybook-readme';

configureReadme({
    // ...some code
});

addDecorator(addReadme);

  局部配置:

import { storiesOf } from "@storybook/vue";

import MyButton from "./MyButton.vue";
import ButtonReadme from "./MyButton.md";
storiesOf("Demo", module)
  .addParameters({
    readme: {
      codeTheme: "duotone-sea",
      content: ButtonReadme,
      sidebar: ButtonReadme,
    }
  })
  .add("Button", () => {
    return {
      components: {
        MyButton,
      },
      template: `<my-button type="primary">My Button</my-button>`,
    };
  });

  由于这个addon是没有官方文档的,笔者花了好长时间才找到一个开源文档,可移步到https://github.com/tuchk4/storybook-readme进行参考,里面也有相关demo可以查看。

  稍微解释一下里面各方法参数的作用:

configureReadme({
  /**
   * Wrapper for story. Usually used to set some styles
   * React: React.ReactNode
   * Vue: Vue component
   */
  // 组件区域的预处理,相当于在组件展示的时候外面套上一层div,组件作为插槽插入到这个div里面,在这里可以设置div的样式,如果是使用vue的话可以以vue组件格式插入,下面同理
  StoryPreview

  /**
   * Wrapper for content and sidebar docs. Usually used to set some styles
   * React: React.ReactNode
   * Vue: Vue component
   */
  // 文档部分的样式,即插件里面的content
  DocPreview/**
   * Wrapper for header docs. Usually used to set some styles
   * React: React.ReactNode
   * Vue: Vue component
   */
  HeaderPreview/**
   * Wrapper for footer docs. Usually used to set some styles
   * React: React.ReactNode
   * Vue: Vue component
   */
  FooterPreview

  /**
   * Header docs in markdown format
   */
  header: '',

  /**
   * Footer docs in markdown format
   */
  footer: '',
});

  Storybook for vue

   不理解preview的可以看一下上图,比如header的内容就为“用户交互组件demo”,headerPreview就是下面那层border,如果有将readme注册到addons.js里面,在绿色方框里还会有一个readme选项,可以查看文档。

  在给特定story添加readme的时候,可以看到可以添加两个文档,如:

storiesOf("Demo", module)
  .addParameters({
    readme: {
      codeTheme: "duotone-sea",
      content: ButtonReadme,
      sidebar: ButtonReadme,
    }
  })
  .add("Button", () => {
    return {
      components: {
        MyButton,
      },
      template: `<my-button type="primary">My Button</my-button>`,
    };
  });

  其中,这里可能会有读者不理解。里面是content是对应图中红色方框的内容,sidebar则是对应绿色方框里的内容(如果有注册),codeTheme是md文档的样式,可自行设置。

  这里还有一个小技巧,就是在编写content的时候,可以在文档中插入以下代码:

<!-- STORY -->

  这段代码可以控制我们的组件要在文档的哪个部分出现。如果不填写,则默认会先显示文档内容,再显示组件内容。所以我们最好在文档的最前面先添加上述代码,先将我们的组件展示出来,再进行文档编写。

  这就是笔者目前用过的两个addon了,其他addons读者可以自己尝试,可以让自己的storybook更加个性化,功能更加完善。

点赞
收藏
评论区
推荐文章
blmius blmius
3年前
MySQL:[Err] 1292 - Incorrect datetime value: ‘0000-00-00 00:00:00‘ for column ‘CREATE_TIME‘ at row 1
文章目录问题用navicat导入数据时,报错:原因这是因为当前的MySQL不支持datetime为0的情况。解决修改sql\mode:sql\mode:SQLMode定义了MySQL应支持的SQL语法、数据校验等,这样可以更容易地在不同的环境中使用MySQL。全局s
皕杰报表之UUID
​在我们用皕杰报表工具设计填报报表时,如何在新增行里自动增加id呢?能新增整数排序id吗?目前可以在新增行里自动增加id,但只能用uuid函数增加UUID编码,不能新增整数排序id。uuid函数说明:获取一个UUID,可以在填报表中用来创建数据ID语法:uuid()或uuid(sep)参数说明:sep布尔值,生成的uuid中是否包含分隔符'',缺省为
待兔 待兔
5个月前
手写Java HashMap源码
HashMap的使用教程HashMap的使用教程HashMap的使用教程HashMap的使用教程HashMap的使用教程22
Jacquelyn38 Jacquelyn38
3年前
2020年前端实用代码段,为你的工作保驾护航
有空的时候,自己总结了几个代码段,在开发中也经常使用,谢谢。1、使用解构获取json数据let jsonData  id: 1,status: "OK",data: 'a', 'b';let  id, status, data: number   jsonData;console.log(id, status, number )
Stella981 Stella981
3年前
KVM调整cpu和内存
一.修改kvm虚拟机的配置1、virsheditcentos7找到“memory”和“vcpu”标签,将<namecentos7</name<uuid2220a6d1a36a4fbb8523e078b3dfe795</uuid
Wesley13 Wesley13
3年前
mysql设置时区
mysql设置时区mysql\_query("SETtime\_zone'8:00'")ordie('时区设置失败,请联系管理员!');中国在东8区所以加8方法二:selectcount(user\_id)asdevice,CONVERT\_TZ(FROM\_UNIXTIME(reg\_time),'08:00','0
Wesley13 Wesley13
3年前
00:Java简单了解
浅谈Java之概述Java是SUN(StanfordUniversityNetwork),斯坦福大学网络公司)1995年推出的一门高级编程语言。Java是一种面向Internet的编程语言。随着Java技术在web方面的不断成熟,已经成为Web应用程序的首选开发语言。Java是简单易学,完全面向对象,安全可靠,与平台无关的编程语言。
Stella981 Stella981
3年前
Django中Admin中的一些参数配置
设置在列表中显示的字段,id为django模型默认的主键list_display('id','name','sex','profession','email','qq','phone','status','create_time')设置在列表可编辑字段list_editable
Wesley13 Wesley13
3年前
MySQL部分从库上面因为大量的临时表tmp_table造成慢查询
背景描述Time:20190124T00:08:14.70572408:00User@Host:@Id:Schema:sentrymetaLast_errno:0Killed:0Query_time:0.315758Lock_
Python进阶者 Python进阶者
10个月前
Excel中这日期老是出来00:00:00,怎么用Pandas把这个去除
大家好,我是皮皮。一、前言前几天在Python白银交流群【上海新年人】问了一个Pandas数据筛选的问题。问题如下:这日期老是出来00:00:00,怎么把这个去除。二、实现过程后来【论草莓如何成为冻干莓】给了一个思路和代码如下:pd.toexcel之前把这
Easter79
Easter79
Lv1
今生可爱与温柔,每一样都不能少。
文章
2.8k
粉丝
5
获赞
1.2k