/** * @license * Copyright Akveo. All Rights Reserved. * Licensed under the MIT License. See License.txt in the project root for license information. */ import { map, delay, filter } from 'rxjs/operators'; import { Component, Input, Output, EventEmitter, ContentChildren, QueryList, AfterContentInit, HostBinding, ChangeDetectorRef, } from '@angular/core'; import { ActivatedRoute } from '@angular/router'; import { convertToBoolProperty, NbBooleanInput } from '../helpers'; import { NbComponentOrCustomStatus } from '../component-status'; import { NbBadgePosition } from '../badge/badge.component'; import { NbIconConfig } from '../icon/icon.component'; /** * Specific tab container. * * ```ts * *

List of users.

*
``` */ @Component({ selector: 'nb-tab', template: ` `, }) export class NbTabComponent { /** * Tab title * @type {string} */ @Input() tabTitle: string; /** * Tab id * @type {string} */ @Input() tabId: string; /** * Use badge dot mode * @type {boolean} */ @Input() get badgeDot(): boolean { return this._badgeDot; } set badgeDot(val: boolean) { this._badgeDot = convertToBoolProperty(val); } protected _badgeDot: boolean; static ngAcceptInputType_badgeDot: NbBooleanInput; /** * Tab icon name or icon config object * @type {string | NbIconConfig} */ @Input() tabIcon: string | NbIconConfig; /** * Item is disabled and cannot be opened. * @type {boolean} */ @Input('disabled') @HostBinding('class.disabled') get disabled(): boolean { return this.disabledValue; } set disabled(val: boolean) { this.disabledValue = convertToBoolProperty(val); } static ngAcceptInputType_disabled: NbBooleanInput; /** * Show only icons when width is smaller than `tabs-icon-only-max-width` * @type {boolean} */ @Input() set responsive(val: boolean) { this.responsiveValue = convertToBoolProperty(val); } get responsive() { return this.responsiveValue; } static ngAcceptInputType_responsive: NbBooleanInput; @Input() route: string; @HostBinding('class.content-active') activeValue: boolean = false; responsiveValue: boolean = false; disabledValue = false; /** * Specifies active tab * @returns {boolean} */ @Input() get active() { return this.activeValue; } set active(val: boolean) { this.activeValue = convertToBoolProperty(val); if (this.activeValue) { this.init = true; } } static ngAcceptInputType_active: NbBooleanInput; /** * Lazy load content before tab selection * TODO: rename, as lazy is by default, and this is more `instant load` * @param {boolean} val */ @Input() set lazyLoad(val: boolean) { this.init = convertToBoolProperty(val); } static ngAcceptInputType_lazyLoad: NbBooleanInput; /** * Badge text to display * @type string */ @Input() badgeText: string; /** * Badge status (adds specific styles): * 'primary', 'info', 'success', 'warning', 'danger' * @param {string} val */ @Input() badgeStatus: NbComponentOrCustomStatus = 'basic'; /** * Badge position. * Can be set to any class or to one of predefined positions: * 'top left', 'top right', 'bottom left', 'bottom right', * 'top start', 'top end', 'bottom start', 'bottom end' * @type string */ @Input() badgePosition: NbBadgePosition; init: boolean = false; } // TODO: Combine tabset with route-tabset, so that we can: // - have similar interface // - easy to migrate from one to another // - can mix them both (route/content tab) /** * * Dynamic tabset component. * @stacked-example(Showcase, tabset/tabset-showcase.component) * * Basic tabset example * * ```html * * * Tab content 1 * * * Tab content 2 * * * ``` * * ### Installation * * Import `NbTabsetModule` to your feature module. * ```ts * @NgModule({ * imports: [ * // ... * NbTabsetModule, * ], * }) * export class PageModule { } * ``` * ### Usage * * It is also possible to set a badge to a particular tab: * @stacked-example(Tab With Badge, tabset/tabset-badge.component) * * and we can set it to full a width of a parent component * @stacked-example(Full Width, tabset/tabset-width.component) * * `tabIcon` should be used to add an icon to the tab. Icon can also be combined with title. * `responsive` tab property if set allows you to hide the title on smaller screens * (`tabs-icon-only-max-width` property) for better responsive behaviour. You can open the following example and make * your screen smaller - titles will be hidden in the last tabset in the list: * * @stacked-example(Icon, tabset/tabset-icon.component) * * It is also possible to disable a tab using `disabled` property: * @stacked-example(Disabled Tab, tabset/tabset-disabled.component) * * @styles * * tabset-background-color: * tabset-border-radius: * tabset-shadow: * tabset-tab-background-color: * tabset-tab-padding: * tabset-tab-text-color: * tabset-tab-text-font-family: * tabset-tab-text-font-size: * tabset-tab-text-font-weight: * tabset-tab-text-line-height: * tabset-tab-text-transform: * tabset-tab-underline-width: * tabset-tab-underline-color: * tabset-tab-active-background-color: * tabset-tab-active-text-color: * tabset-tab-active-underline-color: * tabset-tab-focus-background-color: * tabset-tab-focus-text-color: * tabset-tab-focus-underline-color: * tabset-tab-hover-background-color: * tabset-tab-hover-text-color: * tabset-tab-hover-underline-color: * tabset-tab-disabled-background-color: * tabset-tab-disabled-text-color: * tabset-tab-disabled-underline-color: * tabset-divider-color: * tabset-divider-style: * tabset-divider-width: * tabset-content-background-color: * tabset-content-padding: * tabset-content-text-color: * tabset-content-text-font-family: * tabset-content-text-font-size: * tabset-content-text-font-weight: * tabset-content-text-line-height: * tabset-scrollbar-color: * tabset-scrollbar-background-color: * tabset-scrollbar-width: * tabset-tab-text-hide-breakpoint: */ @Component({ selector: 'nb-tabset', styleUrls: ['./tabset.component.scss'], template: ` `, }) export class NbTabsetComponent implements AfterContentInit { @ContentChildren(NbTabComponent) tabs: QueryList; @HostBinding('class.full-width') fullWidthValue: boolean = false; /** * Take full width of a parent * @param {boolean} val */ @Input() set fullWidth(val: boolean) { this.fullWidthValue = convertToBoolProperty(val); } static ngAcceptInputType_fullWidth: NbBooleanInput; /** * If specified - tabset listens to this parameter and selects corresponding tab. * @type {string} */ @Input() routeParam: string; /** * Emits when tab is selected * @type EventEmitter */ @Output() changeTab = new EventEmitter(); constructor(private route: ActivatedRoute, private changeDetectorRef: ChangeDetectorRef) { } // TODO: refactoring this component, avoid change detection loop ngAfterContentInit() { this.route.params .pipe( map( (params: any) => this.tabs.find((tab) => this.routeParam ? tab.route === params[this.routeParam] : tab.active), ), delay(0), map((tab: NbTabComponent) => tab || this.tabs.first), filter((tab: NbTabComponent) => !!tab), ) .subscribe((tabToSelect: NbTabComponent) => { this.selectTab(tabToSelect); this.changeDetectorRef.markForCheck(); }); } // TODO: navigate to routeParam selectTab(selectedTab: NbTabComponent) { if (!selectedTab.disabled) { this.tabs.forEach(tab => tab.active = tab === selectedTab); this.changeTab.emit(selectedTab); } } }