Product
Introducing SSO
Streamline your login process and enhance security by enabling Single Sign-On (SSO) on the Socket platform, now available for all customers on the Enterprise plan, supporting 20+ identity providers.
@accessible/tabs
Advanced tools
Changelog
Readme
🅰 An accessible and versatile tabs component for React with keyboard navigation and labeling features taught in w3.org's WAI-ARIA tabs example
npm i @accessible/tabs
An accessible and versatile tabs component for React modeled after the WAI-ARIA example taught here.
Check out the example on CodeSandbox
import {Tabs, TabList, Tab, Panel} from '@accessible/tabs'
const Component = () => (
<Tabs defaultActive={0} manualActivation>
<TabList>
<div aria-label='Some research thing'>
<Tab>
<button>Abstract</button>
</Tab>
<Tab>
<button>References</button>
</Tab>
</div>
</TabList>
<Panel>
<div>Abstract body</div>
</Panel>
<Panel>
<div>References body</div>
</Panel>
</Tabs>
)
Component | Description |
---|---|
<Tabs> | This component creates the context for your tabs and contains some configuration options. You'll need to add <Tab> and <Panel> as children in order to actually create tabs. |
<TabList> | The component adds role='tablist' to its child component. |
<Tab> | This component clones any React element and turns it into a tab that controls the visible state of a <Panel> . It must be a child of <Tabs> and all tabs must be adjacent in the tree. Each tab has a corresponding <Panel> that shares the same index. |
<Panel> | This component clones its child and turns it into a panel that corresponds to a <Tab> with the same index. All panels must be adjacent in the tree unless an index prop is defined. |
Hook | Description |
---|---|
useTabs() | This hook returns the value of the TabsContext object. |
useTab() | This hook returns the value of the TabContext object. |
This component creates the context for your tabs and contains some configuration options. You'll need to add
<Tab>
and <Panel>
as children in order to actually create tabs.
Prop | Type | Default | Required? | Description |
---|---|---|---|---|
defaultActive | number | 0 | No | The <Tab> index you want active by default. |
active | number | undefined | No | Makes this a controlled component where the activate control has no effect. The tab index defined here is always the one that is active. |
manualActivation | boolean | false | No | By default this component opens tabs automatically when using keyboard navigation to switch between tabs. By setting this to true , the user will have to use the space or enter key to activate the tab after the tab is focused. |
preventScroll | boolean | false | No | When true this will prevent your browser from scrolling the document to bring the newly-focused tab into view. |
onChange | (active: number) => void | undefined | No | Called each time the active tab changes. It provides the active tab index as its only argument. |
children | React.ReactNode[] | undefined | Yes | You can define any children here with some caveats listed elsewhere. |
Prop | Type | Default | Required? | Description |
---|---|---|---|---|
children | React.ReactElement | undefined | Yes | The child is cloned by this component and given a property for role='tablist' . |
This component clones any React element and turns it into a tab that controls the visible state of a <Panel>
. It must be a child of <Tabs>
and all
tabs must be adjacent in the tree. Each tab has a corresponding <Panel>
that shares the same index.
// YES
const MyTabs = () => (
<Tabs>
<TabList>
{/* index: 0 */}
<Tab>
<div />
</Tab>
{/* index: 1 */}
<Tab>
<div />
</Tab>
</TabList>
{/* index: 0 */}
<Panel>
<div />
</Panel>
{/* index: 1 */}
<Panel>
<div />
</Panel>
</Tabs>
)
// ABSOLUTELY NOT
const MyTabs = () => (
<Tabs>
<TabList>
{/* The Tab components here are not adjacent in the tree. */}
<div>
<Tab>
<div />
</Tab>
</div>
<div>
<Tab>
<div />
</Tab>
</div>
</TabList>
<Panel>
<div />
</Panel>
<Panel>
<div />
</Panel>
</Tabs>
)
Prop | Type | Default | Required? | Description |
---|---|---|---|---|
activeClass | string | undefined | No | Adds this class to the child component when the tab is in an active state. |
inactiveClass | string | undefined | No | Adds this class to the child component when the tab is in an inactive state. |
activeStyle | React.CSSProperties | undefined | No | Adds these styles to the child component when the tab is in an active state. |
inactiveStyle | React.CSSProperties | undefined | No | Adds these styles to the child component when the tab is in an inactive state. |
id | string | undefined | No | Defining an ID here overrides the auto id generated for aria attributes. |
disabled | boolean | false | No | Setting this to true will prevent the tab from activating if it isn't already active. |
index | number | undefined | No | Setting an index here overrides the default index created when this component mounts. Indexes are used to match tabs to their corresponding <Panel> . I would recommend not setting this property and letting the library handle it automatically. |
onDelete | (event: KeyboardEvent) => void | undefined | No | This callback will fire if a user presses the Delete key on their keyboard when this tab (not the panel) is focused. |
children | React.ReactElement | undefined | Yes | The child is cloned by this component and has aria attributes injected into its props as well as keyboard event handlers for navigating between tabs. |
This component clones its child and turns it into a panel that corresponds to a <Tab>
with the same
index. All panels must be adjacent in the tree unless an index
prop is defined. For example:
<Tabs>
<TabList>
[0] <Tab>
[1] <Tab>
</TabList>
[0] <Panel>
[1] <Panel>
</Tabs>
Prop | Type | Default | Required? | Description |
---|---|---|---|---|
activeClass | string | undefined | No | Adds this class to the child component when the panel's <Tab> is in an active state. |
inactiveClass | string | undefined | No | Adds this class to the child component when the panel's <Tab> is in an inactive state. |
activeStyle | React.CSSProperties | undefined | No | Adds these styles to the child component when the panel's <Tab> is in an active state. |
inactiveStyle | React.CSSProperties | undefined | No | Adds these styles to the child component when the panel's <Tab> is in an inactive state. |
index | number | undefined | No | Setting an index here overrides the default index created when this component mounts. Indexes are used to match panels to their corresponding <Tab> . I would recommend not setting this property and letting the library handle it automatically. |
children | React.ReactElement | undefined | Yes | The child is cloned by this component and has aria attributes injected into its props and will have its visible state controlled by the <Tab> component with the same index. |
Returns TabContext object
for the <Tab>
corresponding to the provided index
.
It must be used within a child of <Tabs>
.
interface TabContextValue {
// The ID used for aria attributes
id?: string
// A ref to the tab's underlying element
tabRef?: HTMLElement
// The index of the tab
index: number
// Activates this tab unless `disabled` is `true`
activate: () => void
// Is this tab active?
isActive: boolean
// Is this tab disabled?
disabled: boolean
}
This hook returns the value of the TabsContext object. This hook must be within a child of <Tabs>
.
interface TabsContextValue {
// An array of tabs that have been registered
tabs: TabState[]
// Registers a new tab
registerTab: (
index: number,
element: HTMLElement,
id?: string,
disabled?: boolean
) => () => void
// The tab that is currently active
active: number | undefined
// Activates the tab at `index`
activate: (index: number | undefined) => void
// Is manual activation configured?
manualActivation: boolean
}
type TabState =
| {
element?: HTMLElement
id?: string
disabled?: boolean
}
| undefined
MIT
FAQs
🅰 An accessible and versatile tabs component for React with keyboard navigation and labeling features taught in w3.org's WAI-ARIA tabs example
The npm package @accessible/tabs receives a total of 109 weekly downloads. As such, @accessible/tabs popularity was classified as not popular.
We found that @accessible/tabs demonstrated a not healthy version release cadence and project activity because the last version was released a year ago. It has 1 open source maintainer collaborating on the project.
Did you know?
Socket for GitHub automatically highlights issues in each pull request and monitors the health of all your open source dependencies. Discover the contents of your packages and block harmful activity before you install or update your dependencies.
Product
Streamline your login process and enhance security by enabling Single Sign-On (SSO) on the Socket platform, now available for all customers on the Enterprise plan, supporting 20+ identity providers.
Security News
Tea.xyz, a crypto project aimed at rewarding open source contributions, is once again facing backlash due to an influx of spam packages flooding public package registries.
Security News
As cyber threats become more autonomous, AI-powered defenses are crucial for businesses to stay ahead of attackers who can exploit software vulnerabilities at scale.