Tab
Tab is a component used inside the Tab Group to generate panels that can be navigated using tabs. For concrete usage examples, please see Tab Group component.
Properties #
| Property | Attribute | Description | Type | Default |
|---|---|---|---|---|
accessibleDescription | accessible-description | String for AccessibleLabel | string | this .accessibleDescriptionDefault ? getLocaleString(this.accessibleDescriptionDefault) : null |
accessibleDescriptionDefault | accessible-description-defaults | Defaults for AccessibleLabel | DuetLangObject | string | null |
accessibleLabelledBy | accessible-labelled-by | String of id's that indicate alternative labels elements | string | undefined |
caption | caption | Caption for the tab. | string | undefined |
contentId | content-id | HTML id of element that is to be used when opening this tab. This enables decoupling the content from the tab buttons. | string | undefined |
label | label | Label for the tab. | string | undefined |
notificationMark | notification-mark | Notification mark to show in the tab button. Works better with plain variation, as the dark background of selected default button makes the mark less noticable. | "danger" | "warning" | undefined |
selected | selected | Selected state of the tab. | boolean | undefined |
theme | theme | Theme of the component. | "" | "default" | "turva" | "" |
Methods #
setFocus(options?: FocusOptions) => Promise<void> #
Sets focus on the tab panel.
Parameters #
| Name | Type | Description |
|---|---|---|
options | FocusOptions |
Returns #
Type: Promise<void>
Usage #
This section includes guidelines for designers and developers about the usage of this component in different contexts.
When to use #
- For use inside tab group component to generate panels that can be navigated using tabs.
When not to use #
- Outside of tab group component.
Accessibility #
This component has been validated to meet the WCAG 2.1 AA accessibility guidelines. You can find additional information regarding accessibility of this component below.
- Tab component uses
role="tabpanel"to convey its functionality correctly to assistive technologies.
Integration
For integration, event and theming guidelines, please see Using Components. This documentation explains how to implement and use Duet’s components across different technologies like Angular, React or Vanilla JavaScript.
Tutorials
Follow these practical tutorials to learn how to build simple page layouts using Duet’s CSS Framework, Web Components and other features:
Building Layouts
TutorialsUsing CLI Tools
TutorialsCreating Custom Patterns
TutorialsServer Side Rendering
TutorialsSharing Prototypes
TutorialsUsage With Markdown
Troubleshooting
If you experience any issues while using a component, please head over to the Support page for more guidelines and help.