♻️(react) fix Storybook source blocks

Due to the recent upgrade to Storybook 7, the source blocks of Canvases
were broken, they were only showing args. This was mainly due to the fact
that as of Storybook 7 the meta tags of the MDX files have changed, thus
causing the issue. These are now based on imports. We also needed to rename
index.stories.mdx files to index.mdx because Storybook was throwing errors,
maybe due to a conflicts with index.stories.tsx files and new imports.
Anyway this way of naming MDX files seems to be the recommend one based on
the official documentation.
This commit is contained in:
Nathan Vasse
2023-05-22 11:39:11 +02:00
committed by NathanVss
parent f264c29a4a
commit 8cda41772d
11 changed files with 37 additions and 37 deletions

View File

@@ -0,0 +1,68 @@
import { Canvas, Meta, Story, Source, ArgsTable } from '@storybook/addon-docs';
import { Pagination, usePagination } from './index';
import * as Stories from './index.stories';
<Meta of={Stories}/>
# Pagination
The Pagination component can be used anywhere you have some data you want to split between pages, you can use it
for synchronous loading as well as asynchronous loading. You can paginate your already loaded data, but you can also
fetch it from a server, the component is really versatile.
<Canvas sourceState="none">
<Story id="components-pagination--basic"/>
</Canvas>
<Source
language='ts'
dark
format={false}
code={`import { Pagination, usePagination } from "@openfun/cunningham-react";`}
/>
## Usage
The Pagination component comes with a hook called `usePagination` that handles the logic behind it. Pagination is a
controlled component, so, to make it more handy we provide you this hook.
The most basic usage you can make of it is this one, defining a pagination with 10 pages.
### Basic
<Canvas sourceState="shown">
<Story id="components-pagination--basic"/>
</Canvas>
### List of items
But this won't make you really happy if you want to paginate your list of items, so you can wire things a bit better.
Let's make a component that paginate a list of random number.
<Canvas sourceState="shown">
<Story id="components-pagination--list"/>
</Canvas>
### Set page programmatically
You can also set the page programmatically, for example, if you want to use a query parameter to set the page.
<Canvas sourceState="shown">
<Story id="components-pagination--force-page"/>
</Canvas>
### Things to know
- The pagination will never render if the number of pages is less than 2.
## Props
### `<Pagination/>` component
<ArgsTable of={Pagination} />
### `usePagination` hook
<ArgsTable of={usePagination} />