mirror of
https://github.com/storybookjs/storybook.git
synced 2025-04-08 11:11:53 +08:00
113 lines
3.5 KiB
Markdown
113 lines
3.5 KiB
Markdown
---
|
|
title: 'Naming components and hierarchy'
|
|
---
|
|
|
|
The title of the component you export in the `default` export controls the name shown in the sidebar.
|
|
|
|
```js
|
|
// Button.stories.js
|
|
export default {
|
|
title: 'Button',
|
|
};
|
|
```
|
|
|
|
Yields this:
|
|
|
|
|
|
|
|
## Grouping
|
|
|
|
It is also possible to group related components in an expandable interface in order to help with Storybook organization. To do so, use the `/` as a separator:
|
|
|
|
```js
|
|
// Button.stories.js
|
|
|
|
export default {
|
|
title: 'Design System/Atoms/Button',
|
|
};
|
|
```
|
|
|
|
```js
|
|
// Checkbox.stories.js
|
|
|
|
export default {
|
|
title: 'Design System/Atoms/Checkbox',
|
|
};
|
|
```
|
|
|
|
Yields this:
|
|
|
|
|
|
|
|
## Roots
|
|
|
|
By default the top-level grouping will be displayed as a “root” in the UI (the all-caps, non expandable grouping in the screenshot above). If you prefer, you can [configure Storybook](..configure/sidebar-and-urls.md#roots) to not show roots.
|
|
|
|
We recommend naming components according to the file hierarchy.
|
|
|
|
## Sorting stories
|
|
|
|
By default, stories are sorted in the order in which they were imported. This can be overridden by adding `storySort` to the `options` parameters in your `preview.js` file.
|
|
|
|
The most powerful method of sorting is to provide a function to `storySort`. Any custom sorting can be achieved with this method.
|
|
|
|
```js
|
|
// .storybook/preview.js
|
|
|
|
export const parameters = {
|
|
options: {
|
|
storySort: (a, b) =>
|
|
a[1].kind === b[1].kind ? 0 : a[1].id.localeCompare(b[1].id, undefined, { numeric: true }),
|
|
},
|
|
};
|
|
```
|
|
|
|
The `storySort` can also accept a configuration object.
|
|
|
|
```js
|
|
// .storybook/preview.js
|
|
|
|
export const parameters = {
|
|
options: {
|
|
storySort: {
|
|
method: '',
|
|
order: [],
|
|
locales: '',
|
|
},
|
|
},
|
|
};
|
|
```
|
|
|
|
| Field | Type | Description | Required | Default Value | Example |
|
|
| ----------- | :----: | :------------------------------------------------------: | :------: | :---------------------: | :-----------------------: |
|
|
| **method** | String | Tells Storybook in which order the stories are displayed | No | Storybook configuration | `'alphabetical'` |
|
|
| **order** | Array | The stories to be show, ordered by supplied name | No | Empty Array `[]` | `['Intro', 'Components']` |
|
|
| **locales** | String | The locale required to be displayed | No | System locale | `en-US` |
|
|
|
|
To sort your stories alphabetically, set `method` to `'alphabetical'` and optionally set the `locales` string. To sort your stories using a custom list, use the `order` array; stories that don't match an item in the `order` list will appear after the items in the list.
|
|
|
|
The `order` array can accept a nested array in order to sort 2nd-level story kinds. For example:
|
|
|
|
```js
|
|
export const parameters = {
|
|
options: {
|
|
storySort: {
|
|
order: ['Intro', 'Pages', ['Home', 'Login', 'Admin'], 'Components'],
|
|
},
|
|
},
|
|
};
|
|
```
|
|
|
|
Which would result in this story ordering:
|
|
|
|
1. `Intro` and then `Intro/*` stories
|
|
2. `Pages` story
|
|
3. `Pages/Home` and `Pages/Home/*` stories
|
|
4. `Pages/Login` and `Pages/Login/*` stories
|
|
5. `Pages/Admin` and `Pages/Admin/*` stories
|
|
6. `Pages/*` stories
|
|
7. `Components` and `Components/*` stories
|
|
8. All other stories
|
|
|
|
Note that the `order` option is independent of the `method` option; stories are sorted first by the `order` array and then by either the `method: 'alphabetical'` or the default `configure()` import order.
|