Accessible react tab component
Supports React 0.14.9+ and 15.3+
This is the documentation for 1.0 if you are looking for the documentation for version 0.8 please got to this page
yarn add react-tabsYou can also still use npm
npm install react-tabs --saveOr use directly in your html as UMD component
<script src="https://unpkg.com/react-tabs@1.0.0/dist/react-tabs.min.js" />https://reactcommunity.org/react-tabs/example/
(TODO: This demos are outdated and use super old versions of react and react-tabs)
import { Tab, Tabs, TabList, TabPanel } from 'react-tabs';
export default () => (
<Tabs>
<TabList>
<Tab>Title 1</Tab>
<Tab>Title 2</Tab>
</TabList>
<TabPanel>
<h2>Any content 1</h2>
</TabPanel>
<TabPanel>
<h2>Any content 2</h2>
</TabPanel>
</Tabs>
);Allows reseting the internal id counter which is used to generate unique id's for tabs and tab panels.
You should never need to use this in the browser. Only if you are running an isomorphic react app that is rendered on the server you should call resetIdCounter() before every render so that the ids that get generated on the server match the ids generated in the browser.
import { resetIdCounter } from 'react-tabs';
resetIdCounter();
ReactDOMServer.renderToString(...);react-tabs consists of 4 components which all need to be used together.
If you specify additional props on the <Tabs /> component they will be forwarded to the rendered <div />.
default:
"react-tabs"
Provide a custom class name for the outer <div /> of the tabs.
You can also supply an array of class names or an object where the class names are the key and the value is a boolean indicating if the name should be added. See the docs of classnames on how to supply different class names.
default:
false
If set to true the tabs will be focused on initial render. This allows immediate use of keyboard keys to switch tabs after the first render.
default:
0
This allows changing the tab that should be open on initial render. This is a zero-based index, so first tab is 0, second tab is 1, ...
This can only be used in uncontrolled mode when react-tabs handles the current selected tab internally and for this reason cannot be used together with
selectedIndex. See here for more info on modes.
default:
"react-tabs__tab--disabled"
Provide a custom class name for disabled tabs.
This option can also be set directly at the
<Tab />component.
default:
false
By default only the current active tab will be rendered to DOM. If set to true all tabs will be rendered to the DOM always.
This can also be enabled for each individual
<TabPanel />component with its propforceRender.
default:
undefined
This event handler is called every time a tab is changed. It will be called with the index that will be changed to, the lastIndex which was selected before and the underlying event which is usually either a keydown or click event.
The callback can optionally return true to cancel the change to the new tab.
Returning
truewhen the change to the new tab should be canceled is also important in controlled mode, as react-tabs still internally handles the focus of the tabs. (Really? maybe find a better way)
In controlled mode ths
onSelecthandler is required prop.
default:
null
Set the currently selected tab. This is a zero-based index, so first tab is 0, second tab is 1, ...
This enables controlled mode, which also requires onSelect to be set. See here for more info on modes.
default:
"react-tabs__tab--selected"
Provide a custom class name for the active tab.
This option can also be set directly at the
<Tab />component.
default:
"react-tabs__tab-panel--selected"
Provide a custom class name for the active tab panel.
This option can also be set directly at the
<TabPanel />component.
If you specify additional props on the <TabList /> component they will be forwarded to the rendered <ul />.
default:
"react-tabs__tab-list"
Provide a custom class name for the <ul />.
You can also supply an array of class names or an object where the class names are the key and the value is a boolean indicating if the name should be added. See the docs of classnames on how to supply different class names.
If you specify additional props on the <Tab /> component they will be forwarded to the rendered <li />.
default:
"react-tabs__tab"
Provide a custom class name for the <li />.
You can also supply an array of class names or an object where the class names are the key and the value is a boolean indicating if the name should be added. See the docs of classnames on how to supply different class names.
default:
false
Disable this tab which will make it not do anything when clicked. Also a disabled class name will be added (see disabledClassName)
default:
"react-tabs__tab--disabled"
Provide a custom class name for disabled tabs.
This option can also be set for all
<Tab />components with the propdisabledTabClassNameon<Tabs />.
default:
"react-tabs__tab--selected"
Provide a custom class name for the active tab.
This option can also be set for all
<Tab />components with the propselectedTabClassNameon<Tabs />.
If you specify additional props on the <TabPanel /> component they will be forwarded to the rendered <div />.
default:
"react-tabs__tab-panel"
Provide a custom class name for the <div /> containing the tab content.
You can also supply an array of class names or an object where the class names are the key and the value is a boolean indicating if the name should be added. See the docs of classnames on how to supply different class names.
default:
false
By default the tab content will only be rendered when the tab is active. If set to true the tab will also be rendered if inactive.
This can also be enabled for all
<TabPanel />components with the propforceRenderTabPanelon<Tabs />.
default:
"react-tabs__tab-panel--selected"
Provide a custom class name for the active tab panel.
This option can also be set for all
<TabPanel />components with the propselectedTabPanelClassNameon<Tabs />.
React tabs has two different modes it can operate in, which change the way how much you need to take care about the state yourself.
This is the default mode of react-tabs and makes the react-tabs components handle its state internally. You can change the starting tab with defaultIndex and you can listen for changes with onSelect.
In this mode you cannot force a tab change during runtime.
<Tabs defaultIndex={1} onSelect={index => console.log(index)}>
<TabList>
<Tab>Title 1</Tab>
<Tab>Title 2</Tab>
</TabList>
<TabPanel></TabPanel>
<TabPanel></TabPanel>
</Tabs>This mode has to be enabled by supplying selectedIndex to the <Tabs /> component.
In this mode react-tabs does not handle any tab selection state internally and leaves all the state management up to the outer application.
This mode also enforces you to set a handler for onSelect. defaultIndex does not have any effect and will therefore throw an error.
class App extends Component {
constructor() {
this.state = { tabIndex: 0 };
}
render() {
return (
<Tabs selectedIndex={this.state.tabIndex} onSelect={tabIndex => this.setState({ tabIndex })}>
<TabList>
<Tab>Title 1</Tab>
<Tab>Title 2</Tab>
</TabList>
<TabPanel></TabPanel>
<TabPanel></TabPanel>
</Tabs>
);
}
}react-tabs does not include any style loading by default. Default stylesheets are provided and can be included in your application if desired.
When using webpack and a appropriate loader (css-loader, sass-loader, less-loader or style-loader) you can simply import the default stylesheet.
import 'react-tabs/style/react-tabs.css';
// or
import 'react-tabs/style/react-tabs.scss';
// or
import 'react-tabs/style/react-tabs.less';When using SASS you can easily import the default styles
@import '../../path/to/node_modules/react-tabs/style/react-tabs.scss';When using LESS you can easily import the default styles
@import '../../path/to/node_modules/react-tabs/style/react-tabs.less';You can also always just simply copy the default style to your own css/scss/less and modify it to your own needs. The changelog will always tell you when classes change and we also consider changes that break the styling as semver major.
MIT