@vaadin/tabsheet/src/vaadin-tabsheet.js

vaadin-tabsheet

/**
 * @license
 * Copyright (c) 2022 - 2026 Vaadin Ltd.
 * This program is available under Apache License Version 2.0, available at https://vaadin.com/license/
 */
import '@vaadin/tabs/src/vaadin-tabs.js';
import './vaadin-tabsheet-scroller.js';
import { html, LitElement } from 'lit';
import { defineCustomElement } from '@vaadin/component-base/src/define.js';
import { ElementMixin } from '@vaadin/component-base/src/element-mixin.js';
import { PolylitMixin } from '@vaadin/component-base/src/polylit-mixin.js';
import { LumoInjectionMixin } from '@vaadin/vaadin-themable-mixin/lumo-injection-mixin.js';
import { ThemableMixin } from '@vaadin/vaadin-themable-mixin/vaadin-themable-mixin.js';
import { tabSheetStyles } from './styles/vaadin-tabsheet-base-styles.js';
import { TabSheetMixin } from './vaadin-tabsheet-mixin.js';

/**
 * `<vaadin-tabsheet>` is a Web Component for organizing and grouping content
 * into scrollable panels. The panels can be switched between by using tabs.
 *
 * ```html
 * <vaadin-tabsheet>
 *   <div slot="prefix">Prefix</div>
 *   <div slot="suffix">Suffix</div>
 *
 *   <vaadin-tabs slot="tabs">
 *     <vaadin-tab id="tab-1">Tab 1</vaadin-tab>
 *     <vaadin-tab id="tab-2">Tab 2</vaadin-tab>
 *     <vaadin-tab id="tab-3">Tab 3</vaadin-tab>
 *   </vaadin-tabs>
 *
 *   <div tab="tab-1">Panel 1</div>
 *   <div tab="tab-2">Panel 2</div>
 *   <div tab="tab-3">Panel 3</div>
 * </vaadin-tabsheet>
 * ```
 *
 * ### Styling
 *
 * The following shadow DOM parts are exposed for styling:
 *
 * Part name | Description
 * --------- | ---------------
 * `tabs-container`    | The container for the slotted prefix, tabs and suffix
 * `content`    | The container for the slotted panels
 *
 * The following state attributes are available for styling:
 *
 * Attribute         | Description
 * ------------------|-------------
 * `loading` | Set when a tab without associated content is selected
 * `overflow`   | Set to `top`, `bottom`, `start`, `end`, all of them, or none.
 *
 * The following custom CSS properties are available for styling:
 *
 * Custom CSS property                  |
 * :------------------------------------|
 * | `--vaadin-tabsheet-border-color`   |
 * | `--vaadin-tabsheet-border-radius`  |
 * | `--vaadin-tabsheet-border-width`   |
 * | `--vaadin-tabsheet-gap`            |
 * | `--vaadin-tabsheet-padding`        |
 *
 * See [Styling Components](https://vaadin.com/docs/latest/styling/styling-components) documentation.
 *
 * @fires {CustomEvent} items-changed - Fired when the `items` property changes.
 * @fires {CustomEvent} selected-changed - Fired when the `selected` property changes.
 *
 * @customElement vaadin-tabsheet
 * @extends HTMLElement
 * @mixes TabSheetMixin
 * @mixes ElementMixin
 * @mixes ThemableMixin
 */
class TabSheet extends TabSheetMixin(ThemableMixin(ElementMixin(PolylitMixin(LumoInjectionMixin(LitElement))))) {
  static get is() {
    return 'vaadin-tabsheet';
  }

  static get styles() {
    return tabSheetStyles;
  }

  /** @protected */
  render() {
    return html`
      <div part="tabs-container">
        <slot name="prefix"></slot>
        <slot name="tabs"></slot>
        <slot name="suffix"></slot>
      </div>

      <vaadin-tabsheet-scroller part="content">
        <div part="loader"></div>
        <slot id="panel-slot"></slot>
      </vaadin-tabsheet-scroller>
    `;
  }
}

defineCustomElement(TabSheet);

export { TabSheet };