shoelace/src/components/tab-panel/tab-panel.ts

65 wiersze
1.7 KiB
TypeScript
Czysty Zwykły widok Historia

2022-07-19 13:06:12 +00:00
import { classMap } from 'lit/directives/class-map.js';
2023-01-13 20:43:55 +00:00
import { customElement, property } from 'lit/decorators.js';
import { html } from 'lit';
2022-07-20 19:29:19 +00:00
import { watch } from '../../internal/watch';
2023-01-13 20:43:55 +00:00
import ShoelaceElement from '../../internal/shoelace-element';
2021-07-10 00:45:44 +00:00
import styles from './tab-panel.styles';
import type { CSSResultGroup } from 'lit';
2021-02-26 14:09:13 +00:00
2022-12-06 16:48:57 +00:00
let id = 0;
2021-02-26 14:09:13 +00:00
/**
Enrich components `@summary` with description from docs (#962) * keep header styles with repositioned description text * `animated-image` move description to component * code style * `avatar` add summary from docs * `badge` add summary from docs * `breadcrumb` add summary from docs * `button` add summary from docs * lead sentence is now part of the header * `button-group` add summary from docs * `card` add summary from docs * `checkbox` add summary from docs * `color-picker` add summary from docs * `details` add summary from docs * `dialog` add summary from docs * `divider` add summary from docs * `drawer` add summary from docs * `dropdown` add summary from docs * `format-bytes` add summary from docs * `format-date` add summary from docs * `format-number` add summary from docs * `icon` add summary from docs * `icon-button` add summary from docs * `image-comparer` add summary from docs * `include` add summary from docs * `input` add summary from docs * `menu` add summary from docs * `menu-item` add summary from docs * `menu-label` add summary from docs * `popup` add summary from docs * `progressbar` add summary from docs * `progress-ring` add summary from docs * `radio` add summary from docs * `radio-button` add summary from docs * `range` add summary from docs * `rating` add summary from docs * `relative-time` add summary from docs * `select` add summary from docs * `skeleton` add summary from docs * `spinner` add summary from docs * `split-panel` add summary from docs * `switch` add summary from docs * `tab-group` add summary from docs * `tag` add summary from docs * `textarea` add summary from docs * `tooltip` add summary from docs * `visually-hidden` add summary from docs * `animation` add summary from docs * `breadcrumb-item` add summary from docs * `mutation-observer` add summary from docs * `radio-group` add summary from docs * `resize-observer` add summary from docs * `tab` add summary from docs * `tab-panel` add summary from docs * `tree` add summary from docs * `tree-item` add summary from docs * remove `title` for further usage of `Sl` classnames in docs * revert: use markdown parser for component summary
2022-10-21 13:56:35 +00:00
* @summary Tab panels are used inside [tab groups](/components/tab-group) to display tabbed content.
2023-01-12 15:26:25 +00:00
* @documentation https://shoelace.style/components/tab-panel
2021-02-26 14:09:13 +00:00
* @status stable
2023-01-12 15:26:25 +00:00
* @since 2.0
2021-02-26 14:09:13 +00:00
*
2021-06-25 20:25:46 +00:00
* @slot - The tab panel's content.
2021-02-26 14:09:13 +00:00
*
2022-12-06 16:18:14 +00:00
* @csspart base - The component's base wrapper.
2021-10-04 13:29:14 +00:00
*
* @cssproperty --padding - The tab panel's padding.
2021-02-26 14:09:13 +00:00
*/
2021-03-18 13:04:23 +00:00
@customElement('sl-tab-panel')
2022-08-17 15:37:37 +00:00
export default class SlTabPanel extends ShoelaceElement {
static styles: CSSResultGroup = styles;
2021-02-26 14:09:13 +00:00
2022-12-06 16:48:57 +00:00
private readonly attrId = ++id;
private readonly componentId = `sl-tab-panel-${this.attrId}`;
2021-02-26 14:09:13 +00:00
/** The tab panel's name. */
2021-11-04 22:12:47 +00:00
@property({ reflect: true }) name = '';
2021-02-26 14:09:13 +00:00
/** When true, the tab panel will be shown. */
2021-07-01 00:04:46 +00:00
@property({ type: Boolean, reflect: true }) active = false;
2021-02-26 14:09:13 +00:00
2021-06-02 12:47:55 +00:00
connectedCallback() {
super.connectedCallback();
this.id = this.id.length > 0 ? this.id : this.componentId;
2022-07-20 19:29:19 +00:00
this.setAttribute('role', 'tabpanel');
}
@watch('active')
handleActiveChange() {
this.setAttribute('aria-hidden', this.active ? 'false' : 'true');
2021-02-26 14:09:13 +00:00
}
render() {
return html`
2022-12-02 22:03:59 +00:00
<slot
2022-07-19 13:06:12 +00:00
part="base"
class=${classMap({
'tab-panel': true,
'tab-panel--active': this.active
})}
2022-12-02 22:03:59 +00:00
></slot>
2021-02-26 14:09:13 +00:00
`;
}
}
2021-03-12 14:09:08 +00:00
declare global {
interface HTMLElementTagNameMap {
'sl-tab-panel': SlTabPanel;
}
}