File

projects/wvr-elements/src/lib/wvr-tabs/wvr-tabs.component.ts

Description

The principle component for a tabbed presentation.

Extends

WvrBaseComponent

Implements

OnInit

Metadata

changeDetection	`ChangeDetectionStrategy.Default`
selector	`wvr-tabs-component`
styleUrls	`./wvr-tabs.component.scss`
templateUrl	`./wvr-tabs.component.html`

Index

Constructor

constructor(injector: Injector)

Defined in projects/wvr-elements/src/lib/wvr-tabs/wvr-tabs.component.ts:18

Parameters :

Name	Type	Optional
injector	`Injector`	No

Inputs

animate
Type : `string`
Inherited from `WvrBaseComponent`
Defined in `WvrBaseComponent:68`
A setter which parses a json string describing animation instructions and stores the derived object in `_animationSettings`.

animateConfig
Type : `string`
Inherited from `WvrBaseComponent`
Defined in `WvrBaseComponent:76`
A setter which parses a json string describing animation setting and stores the derived object in `_animationConfig`.

animateId
Type : `string`
Inherited from `WvrBaseComponent`
Defined in `WvrBaseComponent:84`
An attribute input allowing for the designation of an animation identifier for the purpose of animation targeting.

animateTarget
Type : `string`
Inherited from `WvrBaseComponent`
Defined in `WvrBaseComponent:87`
An attribute input allowing for the designation of an animation target for animation events.

hiddenInMobile
Type : `boolean`
Default value : `false`
Inherited from `WvrBaseComponent`
Defined in `WvrBaseComponent:107`
An attribute input specifying if this component should be hidden in the mobile layout.

ngBindings
Type : `string`
Inherited from `WvrBaseComponent`
Defined in `WvrBaseComponent:116`

themeVariant
Type : `ThemeVariantName`
Inherited from `WvrBaseComponent`
Defined in `WvrBaseComponent:55`
Used to define the class type of an alert component.

wvrData
Type : `string`
Inherited from `WvrBaseComponent`
Defined in `WvrBaseComponent:45`

wvrTheme
Type : `string`
Inherited from `WvrBaseComponent`
Defined in `WvrBaseComponent:50`
Allows for the override of theme for the particular component.

Outputs

animationEventTrigger
Type : `EventEmitter`
Inherited from `WvrBaseComponent`
Defined in `WvrBaseComponent:110`
An Output biding used for triggering animations.

HostBindings

class.wvr-bootstrap

Type : boolean

Default value : true

Inherited from WvrBaseComponent

Defined in WvrBaseComponent:58

A host binding used to ensure the presense of the wvr-bootstrap class.

class.wvr-hidden

Type : boolean

Inherited from WvrBaseComponent

Defined in WvrBaseComponent:102

A host bound accessor which applies the wvr-hidden class if both isMobileLayout and hiddenInMobile evaluate to true.

style

Type : any

Inherited from WvrBaseComponent

Defined in WvrBaseComponent:60

Methods

activate

activate(tab: HTMLElement)

Defined in projects/wvr-elements/src/lib/wvr-tabs/wvr-tabs.component.ts:51

Parameters :

Name	Type	Optional
tab	`HTMLElement`	No

Returns : boolean

Private deactivate

deactivate(tab: HTMLElement)

Defined in projects/wvr-elements/src/lib/wvr-tabs/wvr-tabs.component.ts:67

Parameters :

Name	Type	Optional
tab	`HTMLElement`	No

Returns : void

ngOnInit

ngOnInit()

Inherited from WvrBaseComponent

Defined in WvrBaseComponent:24

Returns : void

applyThemeOverride

applyThemeOverride(customProperty: string, value: string)

Inherited from WvrBaseComponent

Defined in WvrBaseComponent:237

Parameters :

Name	Type	Optional
customProperty	`string`	No
value	`string`	No

Returns : void

bootstrapNgBindings

bootstrapNgBindings()

Inherited from WvrBaseComponent

Defined in WvrBaseComponent:175

Returns : void

getWvrData

getWvrData()

Inherited from WvrBaseComponent

Defined in WvrBaseComponent:262

Returns : string

hasWvrData

hasWvrData()

Inherited from WvrBaseComponent

Defined in WvrBaseComponent:258

Returns : boolean

initializeAnimationElement

initializeAnimationElement()

Inherited from WvrBaseComponent

Defined in WvrBaseComponent:267

Returns : void

initializeAnimationRegistration

initializeAnimationRegistration()

Inherited from WvrBaseComponent

Defined in WvrBaseComponent:273

Returns : void

ngAfterContentInit

ngAfterContentInit()

Inherited from WvrBaseComponent

Defined in WvrBaseComponent:160

Used for post content initialization animation setup.

Returns : void

ngOnDestroy

ngOnDestroy()

Inherited from WvrBaseComponent

Defined in WvrBaseComponent:166

Handles the the unregistering of this component with the component registry.

Returns : void

onAnimationEvent

onAnimationEvent($event: Event)

Inherited from WvrBaseComponent

Defined in WvrBaseComponent:290

Trigger's the animation specified by the incoming event.

Parameters :

Name	Type	Optional
$event	`Event`	No

Returns : void

Private processData

processData()

Inherited from WvrBaseComponent

Defined in WvrBaseComponent:295

Returns : void

triggerAnimations

triggerAnimations(animationTriggerType: string)

Inherited from WvrBaseComponent

Defined in WvrBaseComponent:244

Plays the animation specified by the incoming animation trigger.

Parameters :

Name	Type	Optional
animationTriggerType	`string`	No

Returns : void

Properties

Private Readonly isTabActive

Default value : () => {...}

Defined in projects/wvr-elements/src/lib/wvr-tabs/wvr-tabs.component.ts:74

tabContentID

Default value : `wvr-tab-content-${this.id}`

Defined in projects/wvr-elements/src/lib/wvr-tabs/wvr-tabs.component.ts:16

tabs

Type : Array<HTMLElement>

Defined in projects/wvr-elements/src/lib/wvr-tabs/wvr-tabs.component.ts:18

trackTabById

Default value : () => {...}

Defined in projects/wvr-elements/src/lib/wvr-tabs/wvr-tabs.component.ts:65

Private _animationConfig

Type : any

Default value : {}

Inherited from WvrBaseComponent

Defined in WvrBaseComponent:73

An object representation of the settings specifying the specific behavior of the animation for this component.

Private Readonly _animationService

Type : AnimationService<WvrBaseComponent>

Inherited from WvrBaseComponent

Defined in WvrBaseComponent:93

A reference to the AnimationService

Private _animationSettings

Type : any

Default value : {}

Inherited from WvrBaseComponent

Defined in WvrBaseComponent:65

An object representation of the animation instructions for this component.

Private _ngBindings

Type : literal type

Inherited from WvrBaseComponent

Defined in WvrBaseComponent:114

animationRootElem

Type : ElementRef

Decorators :


                            @ViewChild('animationRoot')

Inherited from WvrBaseComponent

Defined in WvrBaseComponent:90

A view child of the template element containing the #animationRoot identifier.

Private animationStateId

Type : number

Inherited from WvrBaseComponent

Defined in WvrBaseComponent:81

An identifier used to access the animation state for this component.

Readonly appConfig

Type : AppConfig

Inherited from WvrBaseComponent

Defined in WvrBaseComponent:37

A reference to the AppConfig

Readonly cdRef

Type : ChangeDetectorRef

Inherited from WvrBaseComponent

Defined in WvrBaseComponent:34

A reference to the ChangeDetectorRef

Readonly componentRegistry

Type : ComponentRegistryService<WvrBaseComponent>

Inherited from WvrBaseComponent

Defined in WvrBaseComponent:25

A reference to the ComponentRegistryService

data

Type : literal type

Default value : {}

Inherited from WvrBaseComponent

Defined in WvrBaseComponent:42

Readonly eRef

Type : ElementRef

Inherited from WvrBaseComponent

Defined in WvrBaseComponent:31

A reference to the ElementRef

Readonly id

Type : number

Inherited from WvrBaseComponent

Defined in WvrBaseComponent:28

A generated unique identifier for this comonent.

isMobile

Type : Observable<boolean>

Inherited from WvrBaseComponent

Defined in WvrBaseComponent:120

isMobileLayout

Type : boolean

Inherited from WvrBaseComponent

Defined in WvrBaseComponent:112

Private Readonly kebabize

Default value : () => {...}

Inherited from WvrBaseComponent

Defined in WvrBaseComponent:321

Private Readonly ngBindingsService

Type : NgBindingsService

Inherited from WvrBaseComponent

Defined in WvrBaseComponent:99

A reference to the NgBindingsService

Readonly store

Type : Store<RootState>

Inherited from WvrBaseComponent

Defined in WvrBaseComponent:40

A reference to the Store

style

Decorators :


                            @HostBinding('style')

Inherited from WvrBaseComponent

Defined in WvrBaseComponent:60

Protected subscriptions

Type : Array<Subscription>

Inherited from WvrBaseComponent

Defined in WvrBaseComponent:122

themeOverrides

Type : object

Default value : {}

Inherited from WvrBaseComponent

Defined in WvrBaseComponent:47

Private Readonly themeService

Type : ThemeService

Inherited from WvrBaseComponent

Defined in WvrBaseComponent:96

A reference to the ThemeService

variantTypes

Type : []

Default value : []

Inherited from WvrBaseComponent

Defined in WvrBaseComponent:62

wvrBootstrap

Default value : true

Decorators :


                            @HostBinding('class.wvr-bootstrap')

Inherited from WvrBaseComponent

Defined in WvrBaseComponent:58

A host binding used to ensure the presense of the wvr-bootstrap class.

import { ChangeDetectionStrategy, Component, Injector, OnInit } from '@angular/core';
import { preserveContent, projectContent } from '../shared/utility/projection.utility';
import { WvrBaseComponent } from '../shared/wvr-base.component';

/**
 * The principle component for a tabbed presentation.
 */
@Component({
  selector: 'wvr-tabs-component',
  templateUrl: './wvr-tabs.component.html',
  styleUrls: ['./wvr-tabs.component.scss'],
  changeDetection: ChangeDetectionStrategy.Default
})
export class WvrTabsComponent extends WvrBaseComponent implements OnInit {

  tabContentID = `wvr-tab-content-${this.id}`;

  tabs: Array<HTMLElement>;

  constructor(injector: Injector) {
    super(injector);
  }

  ngOnInit(): void {
    super.ngOnInit();

    this.tabs = Array.from(this.eRef.nativeElement.querySelectorAll('template[tab-content]'));

    let count = 0;
    let activeTab = false;

    this.tabs.forEach(tab => {
      if (!tab.id) {
        count += 1;
        tab.id = `tab-${count}`;
      }

      if (this.isTabActive(tab)) {
        this.activate(tab);
        activeTab = true;
      }
    });

    if (!activeTab) {
      if (this.tabs.length) {
        this.activate(this.tabs[0]);
      }
    }
  }

  activate(tab: HTMLElement): boolean {
    this.tabs
      .filter(this.isTabActive)
      .forEach(t => {
        this.deactivate(t);
      });
    tab.setAttribute('active', '');
    if (!!tab.id) {
      projectContent(this.eRef, `template[tab-content]#${tab.id}`, 'div[active-tab]');
    }

    return false;
  }

  trackTabById = (index, tab: HTMLElement): string => tab.id;

  private deactivate(tab: HTMLElement): void {
    if (!!tab.id) {
      preserveContent(this.eRef, `template[tab-content]#${tab.id}`, 'div[active-tab]');
    }
    tab.removeAttribute('active');
  }

  private readonly isTabActive = (tab: HTMLElement): boolean => tab.hasAttribute('active');

}

<ul class="nav nav-tabs bg-{{themeVariant}}" role="tablist">
  <li class="nav-item bg-{{themeVariant}}" *ngFor="let tab of tabs; trackBy:trackTabById">
    <a [id]="tab.id" class="nav-link" href [ngClass]="{ active: !!tab.attributes['active'] }" (click)="activate(tab)" role="tab" [attr.aria-controls]="tabContentID" [attr.active-tab-theme]="!!tab.attributes['active-tab-theme'] ? tab.attributes['active-tab-theme'].value : ''" [attr.inactive-tab-theme]="!!tab.attributes['inactive-tab-theme'] ? tab.attributes['inactive-tab-theme'].value : ''">
      {{ tab.attributes['tab-text'].value }}
    </a>
  </li>
</ul>

<div class="active-tab" active-tab [id]="tabContentID"></div>

<ng-content select="template[tab-content]"></ng-content>

./wvr-tabs.component.scss

@import "../shared/styles/variables";

:host {

  @extend .variables;

  --tab-content-display: block;
  --tab-content-padding: 25px 0px;

  font-family: var(--wvr-font-family-sans-serif);

  .active-tab {
    display: var(--tab-content-display);
    padding: var(--tab-content-padding);
  }

  @each $color, $value in $theme-colors {
    &:is([inactive-tab-theme="#{$color}"]) .nav-tabs .nav-item .nav-link:not(.active):is([inactive-tab-theme=""]),
    & .nav-tabs .nav-item .nav-link:is([inactive-tab-theme="#{$color}"]):not(.active) {
      border-color: var(--#{$color}-button-border);
      border-bottom-color: transparent;
    }

    &:is([inactive-tab-theme="#{$color}"]) .nav-tabs .nav-item .nav-link:not(.active):is([inactive-tab-theme=""]):active,
    & .nav-tabs .nav-item .nav-link:is([inactive-tab-theme="#{$color}"]):not(.active):active {
      border-color: var(--#{$color}-button-active-border);
      border-bottom-color: transparent;
    }

    &:is([inactive-tab-theme="#{$color}"]) .nav-tabs .nav-item .nav-link:not(.active):is([inactive-tab-theme=""]):focus-within,
    & .nav-tabs .nav-item .nav-link:is([inactive-tab-theme="#{$color}"]):not(.active):focus-within {
      border-color: var(--#{$color}-button-focus-border);
      border-bottom-color: transparent;
    }

    &:is([inactive-tab-theme="#{$color}"]) .nav-tabs .nav-item .nav-link:not(.active):is([inactive-tab-theme=""]):hover,
    & .nav-tabs .nav-item .nav-link:is([inactive-tab-theme="#{$color}"]):not(.active):hover {
      border-color: var(--#{$color}-button-hover-border);
      border-bottom-color: transparent;
    }

    &:is([active-tab-theme="#{$color}"]) .nav-tabs .nav-item .nav-link.active:is([active-tab-theme=""]),
    &:is([active-tab-theme="#{$color}"]) .nav-tabs .nav-item .nav-link.active:is([active-tab-theme=""]):active,
    & .nav-tabs .nav-item .nav-link.active:is([active-tab-theme="#{$color}"]),
    & .nav-tabs .nav-item .nav-link.active:is([active-tab-theme="#{$color}"]):active {
      border-color: var(--#{$color}-button-active-border);
      border-bottom-color: transparent;
    }

    &:is([active-tab-theme="#{$color}"]) .nav-tabs .nav-item .nav-link.active:is([active-tab-theme=""]):focus-within,
    & .nav-tabs .nav-item .nav-link.active:is([active-tab-theme="#{$color}"]):focus-within {
      border-color: var(--#{$color}-button-focus-border);
      border-bottom-color: transparent;
    }

    &:is([active-tab-theme="#{$color}"]) .nav-tabs .nav-item .nav-link.active:is([active-tab-theme=""]):focus-within,
    &:is([active-tab-theme="#{$color}"]) .nav-tabs .nav-item .nav-link.active:is([active-tab-theme=""]):hover,
    & .nav-tabs .nav-item .nav-link.active:is([active-tab-theme="#{$color}"]):focus-within,
    & .nav-tabs .nav-item .nav-link.active:is([active-tab-theme="#{$color}"]):hover {
      border-color: var(--#{$color}-button-hover-border);
      border-bottom-color: transparent;
    }
  }
}

Legend

Html element

Component

Html element with directive

File

Description

Extends

Implements

Metadata

Index

Properties

Methods

Inputs

Outputs

HostBindings

Constructor

Inputs

Outputs

HostBindings

Methods

Properties

results matching ""

No results matching ""