---
title: Tabs
description: Tabs
element: vaadin-tabs
---

## Description

`<vaadin-tabs>` is a Web Component for organizing and grouping content into sections.

```html
<vaadin-tabs selected="4">
  <vaadin-tab>Page 1</vaadin-tab>
  <vaadin-tab>Page 2</vaadin-tab>
  <vaadin-tab>Page 3</vaadin-tab>
  <vaadin-tab>Page 4</vaadin-tab>
</vaadin-tabs>
```

### Styling

The following shadow DOM parts are available for styling:

Part name         | Description
------------------|--------------------------------------
`back-button`     | Button for moving the scroll back
`tabs`            | The tabs container
`forward-button`  | Button for moving the scroll forward

The following state attributes are available for styling:

Attribute      | Description
---------------|--------------------------------------
`orientation`  | Tabs disposition, valid values are `horizontal` and `vertical`
`overflow`     | It's set to `start`, `end`, none or both.

The following custom CSS properties are available for styling:

Custom CSS property              |
:--------------------------------|
| `--vaadin-tabs-background`     |
| `--vaadin-tabs-border-color`   |
| `--vaadin-tabs-border-radius`  |
| `--vaadin-tabs-border-width`   |
| `--vaadin-tabs-font-size`      |
| `--vaadin-tabs-font-weight`    |
| `--vaadin-tabs-gap`            |
| `--vaadin-tabs-padding`        |

See [Styling Components](https://vaadin.com/docs/latest/styling/styling-components) documentation.

## Properties

### disabled

**Type:** `boolean`

If true, the user cannot interact with this element.
When the element is disabled, the selected item is
not updated when `selected` property is changed.

### items

**Type:** `Element[] | undefined`

A read-only list of items from which a selection can be made.
It is populated from the elements passed to the light DOM,
and updated dynamically when adding or removing items.

### orientation

**Type:** `"horizontal" | "vertical"`

Set tabs disposition. Possible values are `horizontal|vertical`

### selected

**Type:** `number | null | undefined`

The index of the selected tab.

## Events

### items-changed

**Type:** [TabsItemsChangedEvent](#tabsitemschangedevent)

Fired when the `items` property changes.

### selected-changed

**Type:** [TabsSelectedChangedEvent](#tabsselectedchangedevent)

Fired when the selection is changed.
Not fired when used in `multiple` selection mode.

## Types

### TabsItemsChangedEvent

```ts
/**
 * Fired when the `items` property changes.
 */
export type TabsItemsChangedEvent = CustomEvent<{ value: Element[] }>;
```

### TabsSelectedChangedEvent

```ts
/**
 * Fired when the `selected` property changes.
 */
export type TabsSelectedChangedEvent = CustomEvent<{ value: number }>;
```