Nail Polishing Minions

    storybook-react-router
    DefinitelyTyped icon, indicating that this package has TypeScript declarations provided by the separate @types/storybook-react-router package

    1.0.8 • Public • Published

    storybook-router

    A Storybook decorator that allows you to use your routing-aware components.

    Install

    npm install --save-dev storybook-react-router
    

    The StoryRouter decorator

    The decorator is actually a function which wraps the Router instance. It accepts two optional arguments that you can use if you want to build a prototype of your navigation within storybook or if you need more control over the router itself.

    In its default behavior the decorator just log every route action perfomed using the storybook action logger. If you are fine with the default arguments you can add globally the StoryRouter decorator, however if you need to specify some of the arguments you have to use the decorator for every story that needs it.

    Usage

    Suppose you have a component that uses react-router Route and Link:

    import React from 'react';
    import { Route, Link } from 'react-router-dom';
     
    const ChildId = ({match}) => (
      <div>
        <h3>ID: {match.params.id}</h3>
      </div>
    );
     
    const ComponentParams = () => (
      <div>
        <ul>
          <li><Link to="/accounts/netflix">Netflix</Link></li>
          <li><Link to="/accounts/sky">Sky</Link></li>
        </ul>
        <Route path="/accounts/:id" component={ChildId}/>
      </div>
    );
     
    export default ComponentParams;

    you can add the StoryRouter decorator to your story this way:

    import { storiesOf } from '@storybook/react';
    import StoryRouter from 'storybook-react-router';
     
    import ComponentParams from '<your_component_path>/ComponentParams';
     
    storiesOf('Params', module)
      .addDecorator(StoryRouter())
      .add('params', () => (
        <ComponentParams/>
      ));

    If you want to use StoryRouter in all your stories, you can also add it globally by editing your Storybook config.js file:

    import { configure, addDecorator } from '@storybook/react';
    import StoryRouter from 'storybook-react-router';
     
    addDecorator(StoryRouter());
     
    // ...your config
     

    The important thing is to call addDecorator before calling configure, otherwise it will not work!

    StoryRouter arguments

    The first argument is an object that you can use to extend the default behavior. Every time that a key in the object matches with a path Storybook will call the callback specified for the corresponding value with the destination path as argument. This way you can for example link stories together using the links addons with the linkTo function.

    The match is performed using the path-to-regexp module so you can also use parameter names and regexp within the link keys.

    The second argument is another object which will be forwarded to the wrapped MemoryRouter as props. This allows you to write stories having a specific url location or using advanced functionalities as asking the user confirmation before exiting from a location.

    Advanced usage and examples

    You can find more examples in the provided stories. You can run them cloning this repository and executing (supposing you have installed globally lerna):

    yarn install && yarn bootstrap
    yarn storybook-react-examples
    

    Limitations

    As the wrapped Router creates a new history object for each story you cannot pass the history from a story to another one and so you cannot implement a back or forward button which works among stories.

    Install

    npm i storybook-react-router

    DownloadsWeekly Downloads

    88,814

    Version

    1.0.8

    License

    MIT

    Unpacked Size

    14.2 kB

    Total Files

    6

    Last publish

    Collaborators

    • gvaldambrini