3pp-mirror/docusaurus
1
0
Fork 0
mirror of https://github.com/facebook/docusaurus.git synced 2025-05-28 08:27:03 +02:00
Code Issues Projects Releases Packages Wiki Activity

docs(v2): add info about tabs DefaultValue prop (#4942)

Browse source
This commit is contained in:
Arthur 2021-06-10 15:04:32 +02:00 • committed by GitHub
parent b835aecaec
commit fea24e586e
No known key found for this signature in database
GPG key ID: 4AEE18F83AFDEB23
1 changed files with 8 additions and 0 deletions
Download patch file Download diff file Expand all files Collapse all files

8
website/docs/guides/markdown-features/markdown-features-tabs.mdx
View file

@ -50,6 +50,14 @@ By default, tabs are rendered eagerly, but it is possible to load them lazily by
:::
## Displaying a default tab
Set the `defaultValue` property in the `Tabs` component to the label value of your choice to show the matching tab by default.
For example, in the example above, `defaultValue="apple"` forces the `Apple` tab to be open by default.
If the `defaultValue` property is not provided or refers to an non-existing value, only the tab headings appear until the user clicks on a tab.
## Syncing tab choices {#syncing-tab-choices}
You may want choices of the same kind of tabs to sync with each other. For example, you might want to provide different instructions for users on Windows vs users on macOS, and you want to changing all OS-specific instructions tabs in one click. To achieve that, you can give all related tabs the same `groupId` prop. Note that doing this will persist the choice in `localStorage` and all `<Tab>` instances with the same `groupId` will update automatically when the value of one of them is changed. Note that `groupID` are globally-namespaced.