@mobilize/wms-components documentation
  1. Components
  2. TabControlComponent

File

projects/i-components/src/lib/components/tab-control/tab-control.component.ts

Description

Angular Component for the TabControl Control.

Extends

BaseComponent

Implements

OnInit AfterViewInit AfterViewChecked OnDestroy

Metadata

changeDetection ChangeDetectionStrategy.OnPush
providers ModelProviderService TabItemService
selector wm-tab-control
styleUrls ./tab-control.component.scss
templateUrl ./tab-control.component.html

Index

Properties
Methods
Inputs
Outputs
HostBindings
Accessors

Constructor

Public constructor(injectedModel: TabControlModel, provider: ModelProviderService, cd: ChangeDetectorRef, injector: Injector, componentFactoryResolver: ComponentFactoryResolver, viewRef: ViewContainerRef, tabItemService: TabItemService, renderer: Renderer2)
Defined in projects/i-components/src/lib/components/tab-control/tab-control.component.ts:298

Defines TabControl model.

Parameters :
Name Type Optional Description
injectedModel TabControlModel No
provider ModelProviderService No
cd ChangeDetectorRef No
injector Injector No
componentFactoryResolver ComponentFactoryResolver No

componentFactoryResolver reference
viewRef ViewContainerRef No

viewContainerRef reference
tabItemService TabItemService No
renderer Renderer2 No

Inputs

background
Type : any
Defined in projects/i-components/src/lib/components/tab-control/tab-control.component.ts:284
hideContent
Type : boolean
Defined in projects/i-components/src/lib/components/tab-control/tab-control.component.ts:197

Flag to know if the tabControl have to hide its content when its disabled, this a workaround for bug #455812
keepTabContent
Type : boolean
Default value : true
Defined in projects/i-components/src/lib/components/tab-control/tab-control.component.ts:106

When set to true, the component renders all tabs and they are persisted in the DOM.
model
Type : TabControlModel
Defined in projects/i-components/src/lib/components/tab-control/tab-control.component.ts:97

Tab control model
padding
Type : any
Defined in projects/i-components/src/lib/components/tab-control/tab-control.component.ts:258

Sets the padding to be used in the content in each of the tab items of the tab control
preserveContent
Type : boolean
Default value : false
Defined in projects/i-components/src/lib/components/tab-control/tab-control.component.ts:204

Keeps the tab from removing the tab body content from DOM Workaround since this is already implemented for Material v14, currently v12
selectedIndex
Type : number
Defined in projects/i-components/src/lib/components/tab-control/tab-control.component.ts:213

Set SelectedIndex on model
controlTemplate
Type : any
Inherited from BaseComponent
Defined in BaseComponent:1197

Sets the controlTemplate Input property for changing the model's TemplateProperty
cursor
Inherited from BaseComponent
Defined in BaseComponent:1451

Property used to save the cursor value
dataContext
Type : any
Inherited from BaseComponent
Defined in BaseComponent:952

Gets/sets the dataContext Input property for changing the model's DataContextProperty
dataGridRowHeight
Type : number
Default value : 22
Inherited from BaseComponent
Defined in BaseComponent:507

Represents the row height of both the DataGrid and XamGrid components it affects the css and also an internal function that virtualized data, so do not change directly on css, use this variable instead.
foreground
Type : any
Inherited from BaseComponent
Defined in BaseComponent:1223

Sets the value of the Foreground property
height
Inherited from BaseComponent
Defined in BaseComponent:1394

Sets the height
horizontalAlignment
Inherited from BaseComponent
Defined in BaseComponent:1096

Sets the horizontal alignment.
horizontalContentAlignment
Inherited from BaseComponent
Defined in BaseComponent:1125

Sets the horizontal content alignment.
hostHozSelfAlign
Type : boolean
Default value : false
Inherited from BaseComponent
Defined in BaseComponent:380

Applies horizontal selfalign class. Flags indicates when the control should handle its own horizontal alignment and ignore container alignment.
isEnabled
Inherited from BaseComponent
Defined in BaseComponent:1008

Gets/sets the isEnabled property for the BaseComponent
isTabStop
Type : boolean
Inherited from BaseComponent
Defined in BaseComponent:760

Sets/gets IsTabStop property of the BaseComponent
margin
Type : string
Inherited from BaseComponent
Defined in BaseComponent:782

Sets Margin property of the BaseComponent.
maxHeight
Type : any
Inherited from BaseComponent
Defined in BaseComponent:1325

Sets maxHeight
maxWidth
Type : any
Inherited from BaseComponent
Defined in BaseComponent:1283

Sets maxWidth
minHeight
Type : any
Inherited from BaseComponent
Defined in BaseComponent:1304

Sets minHeight
minWidth
Type : any
Inherited from BaseComponent
Defined in BaseComponent:1262

Sets min Width
name
Type : string
Inherited from BaseComponent
Defined in BaseComponent:1153

Sets the name model property for the control when the name is an input
opacity
Inherited from BaseComponent
Defined in BaseComponent:1336

Sets Opacity value property of the component
spellCheck
Type : boolean
Default value : false
Inherited from BaseComponent
Defined in BaseComponent:186

Flag to determinate if the component should do the spell check or not. Default value is false.
style
Inherited from BaseComponent
Defined in BaseComponent:1434

Sets the style
tabIndex
Type : number
Inherited from BaseComponent
Defined in BaseComponent:733

Sets the property TabIndex of the control model.
tag
Type : any
Inherited from BaseComponent
Defined in BaseComponent:1171

Object used in the Tag property of the Button
useCss
Type : boolean
Default value : false
Inherited from BaseComponent
Defined in BaseComponent:177

Determines if the component uses CSS height/width values, instead of inputs
verticalAlignment
Inherited from BaseComponent
Defined in BaseComponent:1038

Sets the vertical alignment.
verticalContentAlignment
Inherited from BaseComponent
Defined in BaseComponent:1067

Sets the vertical content alignment.
visibility
Type : any
Inherited from BaseComponent
Defined in BaseComponent:980

Gets/sets the visibility property for the BaseComponent
width
Inherited from BaseComponent
Defined in BaseComponent:1365

Sets the width
zindex
Type : number
Inherited from BaseComponent
Defined in BaseComponent:1498

Property used to set the canvas zindex value.

Note: Consider moving this @Input to canvas.direcive.ts, refactoring the directive so all inputs are declared in the directive, and all @HostBindings are declared here in baseComponent, the directive would be responsible for updating the models, while baseComponent will be responsible for binding the values: zIndex, Top, Left...

Outputs

selectionChanged
Type : EventEmitter<literal type>
Defined in projects/i-components/src/lib/components/tab-control/tab-control.component.ts:124

Event Emitter. EventEmitter normally called in the selectionChangedHandler.
bindingValidationError
Type : EventEmitter<any>
Inherited from BaseComponent
Defined in BaseComponent:114

output to emit the new value of the bindingValidationError event
layoutUpdated
Type : EventEmitter<any>
Inherited from BaseComponent
Defined in BaseComponent:140

Output to emit when then component's layout is updated.
loaded
Type : EventEmitter<any>
Inherited from BaseComponent
Defined in BaseComponent:123

Output to emit when then component is loaded.
mouseEnter
Type : EventEmitter<literal type>
Inherited from BaseComponent
Defined in BaseComponent:157

Event Emitter. EventEmitter normally called in the mouseEnterHandler.
mouseLeave
Type : EventEmitter<literal type>
Inherited from BaseComponent
Defined in BaseComponent:167

Event Emitter Called in the mouseLeave handler
mouseLeftButtonUp
Type : EventEmitter<literal type>
Inherited from BaseComponent
Defined in BaseComponent:147

MouseLeftButtonUp event Emitter.
sizeChanged
Type : EventEmitter<any>
Inherited from BaseComponent
Defined in BaseComponent:132

Output to emit when then component size is changed.

HostBindings

class
Type : string
Default value : null
Inherited from BaseComponent
Defined in BaseComponent:407

Applies custom CSS classes
class.defaultFontStyles
Type : boolean
Default value : false
Inherited from BaseComponent
Defined in BaseComponent:398

Applies default font styles class, used to allow specificity for each control css
class.focusable
Type : boolean
Default value : false
Inherited from BaseComponent
Defined in BaseComponent:388

Display if the component is focusable or not
class.hasDefinedCursor
Type : boolean
Default value : false
Inherited from BaseComponent
Defined in BaseComponent:415

Applies Defined Cursor class
class.horizontal-center
Type : boolean
Default value : false
Inherited from BaseComponent
Defined in BaseComponent:308

Applies horizontal alignment left class
class.horizontal-left
Type : boolean
Default value : false
Inherited from BaseComponent
Defined in BaseComponent:298

Applies horizontal alignment left class
class.horizontal-right
Type : boolean
Default value : false
Inherited from BaseComponent
Defined in BaseComponent:368

Applies horizontal alignment right class
class.horizontal-stretch
Type : boolean
Default value : false
Inherited from BaseComponent
Defined in BaseComponent:358

Applies horizontal alignment stretch class
class.vertical-bottom
Type : boolean
Default value : false
Inherited from BaseComponent
Defined in BaseComponent:328

Applies vertical alignment bottom class
class.vertical-center
Type : boolean
Default value : false
Inherited from BaseComponent
Defined in BaseComponent:338

Applies vertical alignment center class
class.vertical-stretch
Type : boolean
Default value : false
Inherited from BaseComponent
Defined in BaseComponent:318

Applies horizontal alignment stretch class
class.vertical-top
Type : boolean
Default value : false
Inherited from BaseComponent
Defined in BaseComponent:348

Applies vertical alignment top class
style.display
Type : any
Default value : null
Inherited from BaseComponent
Defined in BaseComponent:243

Property use it to apply the host binding for the visibility
style.font-family
Type : any
Default value : null
Inherited from BaseComponent
Defined in BaseComponent:261

Property use it to apply the host binding for the font-family
style.font-size
Type : any
Default value : null
Inherited from BaseComponent
Defined in BaseComponent:270

Property use it to apply the host binding for the font-size
style.font-style
Type : any
Default value : null
Inherited from BaseComponent
Defined in BaseComponent:279

Property use it to apply the host binding for the font-style
style.font-weight
Type : any
Default value : null
Inherited from BaseComponent
Defined in BaseComponent:288

Property use it to apply the host binding for the font-weight
style.height
Type : string
Default value : null
Inherited from BaseComponent
Defined in BaseComponent:218

Property use it to apply the host binding for the height
style.max-height.px
Type : number
Inherited from BaseComponent
Defined in BaseComponent:234

Property used to apply the host binding for max-height
style.max-width.px
Type : number
Inherited from BaseComponent
Defined in BaseComponent:210

Property used to apply the host binding for max-width
style.min-height.px
Type : number
Inherited from BaseComponent
Defined in BaseComponent:226

Property used to apply the host binding for min-height
style.min-width.px
Type : number
Inherited from BaseComponent
Defined in BaseComponent:202

Property used to apply the host binding for min-width
style.opacity
Type : any
Default value : null
Inherited from BaseComponent
Defined in BaseComponent:252

Property use it to apply the host binding for the opacity
style.width
Type : string
Default value : null
Inherited from BaseComponent
Defined in BaseComponent:194

Property use it to apply the host binding for the width
style.z-index
Type : string
Default value : null
Inherited from BaseComponent
Defined in BaseComponent:424

Sets the z-index style.

Methods

addControl
addControl(newElement: any)
Defined in projects/i-components/src/lib/components/tab-control/tab-control.component.ts:485

Method used to create the tab-item inside the tab-control.

Parameters :
Name Type Optional Description
newElement any No
  • element to render
Returns : any
applyInvisibleTabItems
applyInvisibleTabItems(itemsToApply: any)
Defined in projects/i-components/src/lib/components/tab-control/tab-control.component.ts:552

Executes the visibility effect for each tabItem to apply

Parameters :
Name Type Optional Description
itemsToApply any No

TabItems to apply visibility
Returns : boolean

boolean True if visibility was applied, otherwise false
applyVisibilityItem
applyVisibilityItem(tabIdx: number, argument: any)
Defined in projects/i-components/src/lib/components/tab-control/tab-control.component.ts:600

Applies the visibility class to the tabItem and also applies style in header

Parameters :
Name Type Optional Description
tabIdx number No

Index of the argument in the igx control
argument any No

The tabItemModel
Returns : void
assignStaticItems
assignStaticItems()
Defined in projects/i-components/src/lib/components/tab-control/tab-control.component.ts:425

Assign static set of items to be rendered.

Returns : void
collectionModifiedHandler
collectionModifiedHandler(e: any, a: any)
Defined in projects/i-components/src/lib/components/tab-control/tab-control.component.ts:536

Handler when the items collection changes

Parameters :
Name Type Optional Description
e any No

any
a any No

CollectionChangeInfo
Returns : void

void
Private getHeaderInstance
getHeaderInstance()
Defined in projects/i-components/src/lib/components/tab-control/tab-control.component.ts:638

Return the header container instance for the tab control

Returns : any
Private getTabItems
getTabItems()
Defined in projects/i-components/src/lib/components/tab-control/tab-control.component.ts:649

returns the query list for the tabs in the control

Returns : QueryList<any>
ngAfterContentChecked
ngAfterContentChecked()
Inherited from BaseComponent
Defined in BaseComponent:386

Angular lifecycle hook

Returns : void
ngAfterViewInit
ngAfterViewInit()
Inherited from BaseComponent
Defined in BaseComponent:352

Sets rendering flag to true

Returns : void
ngOnDestroy
ngOnDestroy()
Inherited from BaseComponent
Defined in BaseComponent:411

Angular lifecycle hook

Returns : void
ngOnInit
ngOnInit()
Inherited from BaseComponent
Defined in BaseComponent:327

Angular lifecycle, creates modelProxy copy.

Returns : void
returnItemHeader
returnItemHeader(header: any)
Defined in projects/i-components/src/lib/components/tab-control/tab-control.component.ts:503

Returns a valid header variable

Parameters :
Name Type Optional
header any No
Returns : any
selectionChangedHandler
selectionChangedHandler(event: any)
Defined in projects/i-components/src/lib/components/tab-control/tab-control.component.ts:523

Event Handler for when the user selects a tabItem

Parameters :
Name Type Optional Description
event any No
  • event from the DOM event
Returns : void
Private setupHeaderCustomInjector
setupHeaderCustomInjector(component: TabItemComponent)
Defined in projects/i-components/src/lib/components/tab-control/tab-control.component.ts:660

If there is a header template in the model, setup a custom injector for it.

Parameters :
Name Type Optional Description
component TabItemComponent No

The component where the custom injector will be stored.
Returns : void
shouldBeVisible
shouldBeVisible(i: number, tab: TabItemComponent, selectedIndex: number)
Defined in projects/i-components/src/lib/components/tab-control/tab-control.component.ts:682

Returns true if the tab was previously selected and its content have been already loaded on the screen

Parameters :
Name Type Optional
i number No
tab TabItemComponent No
selectedIndex number No
Returns : boolean
shouldResetTabItemsToApplyVisibility
shouldResetTabItemsToApplyVisibility()
Defined in projects/i-components/src/lib/components/tab-control/tab-control.component.ts:398

Verifies if the Visibility effect was applied successfully to the tabItems

Returns : boolean

boolean
tabElements
tabElements()
Defined in projects/i-components/src/lib/components/tab-control/tab-control.component.ts:444

Checks array of items looking for new dynamic elements to be renderer

Returns : any

{*}
visibilityClassToTabItem
visibilityClassToTabItem(argument: any)
Defined in projects/i-components/src/lib/components/tab-control/tab-control.component.ts:570

Applies visibility effect for a tabItem and also visibility effect for the tab header

Parameters :
Name Type Optional Description
argument any No

TabItem to apply visibility
Returns : boolean

boolean True if visibility was applied, otherwise false
Protected alignmentHandler
alignmentHandler()
Inherited from BaseComponent
Defined in BaseComponent:2346

Calculate the values for the grid size behavior from the alignments

Returns : void
Protected assignPendingPropertyValues
assignPendingPropertyValues()
Inherited from BaseComponent
Defined in BaseComponent:2057

Apply pending assignments to properties with property values

Returns : void
calculateActualSize
calculateActualSize(name?: string)
Inherited from BaseComponent
Defined in BaseComponent:1674

If the name is equal to 'calculateActualSize', then call the handlerCalcActualSize function and pass in false to avoid the timer in the function.

memberof BaseComponent

Parameters :
Name Type Optional Description
name string Yes
  • The name of the event. memberof BaseComponent
Returns : void
Protected checkAndRegisterCompatibilityBinding
checkAndRegisterCompatibilityBinding(property: DependencyProperty, bindingObjectCandidate: any)
Inherited from BaseComponent
Defined in BaseComponent:2023

Verifies if the given object (bindingObjectCandidate) is a binding object. If so the binding will be registered.

Parameters :
Name Type Optional
property DependencyProperty No
bindingObjectCandidate any No
Returns : boolean

{boolean} true if the value is a binding info object and if the binding was registered, false if not
Protected checkForStaticResource
checkForStaticResource(property: string, value: any)
Inherited from BaseComponent
Defined in BaseComponent:2043

Checks if the given value is a static resource reference or not, if a reference then the value is queue for later assignment.

Parameters :
Name Type Optional Description
property string No

the name of the property to check for
value any No

the property value
Returns : boolean

true if the value is a static resource reference, otherwise false
checkStaticItemInModelCollection
checkStaticItemInModelCollection(collection: any, itemToCheck: any)
Inherited from BaseComponent
Defined in BaseComponent:1889

Checks if the element exists previously in the items collection

Parameters :
Name Type Optional Description
collection any No

The control items collection
itemToCheck any No

The static element to be reviewed
Returns : number

number Returns -1 if the item is not present in the items collection otherwise the index value
createElementInRoot
createElementInRoot(injector: Injector, componentToCreate: any)
Inherited from BaseComponent
Defined in BaseComponent:2698

Create a given component on the HTML body.

Parameters :
Name Type Optional
injector Injector No
componentToCreate any No
Returns : ComponentRef<any>
cursorStyle
cursorStyle()
Inherited from BaseComponent
Defined in BaseComponent:1549

Returns the correct CSS cursor style and sets the definedCursor flag if necessary

Returns : string

{string}
detectChanges
detectChanges()
Inherited from BaseComponent
Defined in BaseComponent:813

Performs a single detect Changes over the component

Returns : void
detectChangesAction
detectChangesAction()
Inherited from BaseComponent
Defined in BaseComponent:1686

Handle subscription to the notifyDetectChanges action Refresh the component whenever a model modification was performed

Returns : void
getForeground
getForeground()
Inherited from BaseComponent
Defined in BaseComponent:1966

Calculates the Foreground color to be applied

Returns : string

string
getImageString
getImageString(value: any)
Inherited from BaseComponent
Defined in BaseComponent:2221

Returns string path to the image.

Parameters :
Name Type Optional
value any No
Returns : any
getTargetValue
getTargetValue(e: Event)
Inherited from BaseComponent
Defined in BaseComponent:2239

Returns the value from a $event

Parameters :
Name Type Optional
e Event No
Returns : string
Protected handlerCalcActualSize
handlerCalcActualSize(async: boolean)
Inherited from BaseComponent
Defined in BaseComponent:2391

Handler that calculates ActualHeight & ActualWidth based on its inner content.

Parameters :
Name Type Optional
async boolean No
Returns : void
heightCalc
heightCalc()
Inherited from BaseComponent
Defined in BaseComponent:1939

Applies the height CSS value

Returns : any
heightDefaultStyle
heightDefaultStyle()
Inherited from BaseComponent
Defined in BaseComponent:1914

Calculates the auto height value

Returns : string

{string}
Protected hostHorizontalAlignmentCall
hostHorizontalAlignmentCall()
Inherited from BaseComponent
Defined in BaseComponent:2374

Assign all the horizontal bindings for the control

Returns : void
Protected hostVerticalAlignmentCall
hostVerticalAlignmentCall()
Inherited from BaseComponent
Defined in BaseComponent:2357

Assign all the vertical bindings for the control

Returns : void
imageToPath
imageToPath(value: any)
Inherited from BaseComponent
Defined in BaseComponent:2202

Returns the path of the given image.

Parameters :
Name Type Optional
value any No
Returns : any
loadStaticItems
loadStaticItems(staticItems: any, itemsCollection: any)
Inherited from BaseComponent
Defined in BaseComponent:1634
Parameters :
Name Type Optional Description
staticItems any No

The static elements to be added
itemsCollection any No

The control items collection
Returns : void

void
Private markForCheckComp
markForCheckComp()
Inherited from BaseComponent
Defined in BaseComponent:2451

Marks current component

Returns : void
modelChangeHandler
modelChangeHandler(name?: string)
Inherited from BaseComponent
Defined in BaseComponent:1650

Method to handle the model's change

Parameters :
Name Type Optional Description
name string Yes
  • property name that change
Returns : void
mouseEnterHandler
mouseEnterHandler(event: any)
Inherited from BaseComponent
Defined in BaseComponent:1982

Event Handler for when the mouse enter the Image component.

Parameters :
Name Type Optional Description
event any No
  • event from the DOM event
Returns : void
mouseLeaveHandler
mouseLeaveHandler(event: any)
Inherited from BaseComponent
Defined in BaseComponent:2001

Event Handler for when the mouse enter the Image component.

Parameters :
Name Type Optional Description
event any No
  • event from the DOM event
Returns : void
Public ngAfterContentInit
ngAfterContentInit()
Inherited from BaseComponent
Defined in BaseComponent:857

Angular Lifecycle Hooks

Returns : void
Public ngAfterViewChecked
ngAfterViewChecked()
Inherited from BaseComponent
Defined in BaseComponent:893

Angular Lifecycle Hooks

Returns : void
Public ngDoCheck
ngDoCheck()
Inherited from BaseComponent
Defined in BaseComponent:847

Angular Lifecycle Hooks

Returns : void
Public ngOnChanges
ngOnChanges()
Inherited from BaseComponent
Defined in BaseComponent:824

Angular Lifecycle Hooks

Returns : void
preventItemsDuplication
preventItemsDuplication(itemsToRender: any, items: any, contentChildTemplate: any, afterContentInitCalled: boolean, injector: Injector)
Inherited from BaseComponent
Defined in BaseComponent:2170

Validates if coming models are the same, and prevents to be recreated on Ribbon DOM. (Needs to be checked, in some statics scenarios RibbonTab, RibbonGroup duplicates items)

Parameters :
Name Type Optional
itemsToRender any No
items any No
contentChildTemplate any No
afterContentInitCalled boolean No
injector Injector No
Returns : any[]
processAlignments
processAlignments(name: string)
Inherited from BaseComponent
Defined in BaseComponent:1704

Method to check if the component should assign a alignment property

Parameters :
Name Type Optional
name string No
Returns : void

{void}
processCursor
processCursor(name: string)
Inherited from BaseComponent
Defined in BaseComponent:1850

Method to set the cursor style of the component

Parameters :
Name Type Optional
name string No
Returns : void
processCustomCssClasses
processCustomCssClasses(name: string)
Inherited from BaseComponent
Defined in BaseComponent:1723

Method to set custom CSS Clases

Parameters :
Name Type Optional
name string No
Returns : void

{void}
processFocusable
processFocusable(name: string)
Inherited from BaseComponent
Defined in BaseComponent:1816

Method to check and set the height of the grid

Parameters :
Name Type Optional
name string No
Returns : void
Private processFontFamily
processFontFamily(name: string)
Inherited from BaseComponent
Defined in BaseComponent:2784

Process the FontFamily property

Parameters :
Name Type Optional
name string No
Returns : any
processFonts
processFonts(name: string)
Inherited from BaseComponent
Defined in BaseComponent:1778

Method to apply the font styles for the component.

Parameters :
Name Type Optional
name string No
Returns : void
Private processFontSize
processFontSize(name: string)
Inherited from BaseComponent
Defined in BaseComponent:2798

Process the FontSize property

Parameters :
Name Type Optional
name string No
Returns : any
Private processFontStyle
processFontStyle(name: string)
Inherited from BaseComponent
Defined in BaseComponent:2815

Process the FontStyle property

Parameters :
Name Type Optional
name string No
Returns : any
Private processFontWeight
processFontWeight(name: string)
Inherited from BaseComponent
Defined in BaseComponent:2832

Process the FontWeight property

Parameters :
Name Type Optional
name string No
Returns : any
processHeights
processHeights(name: string)
Inherited from BaseComponent
Defined in BaseComponent:1797

Method to check and set the height of the grid

Parameters :
Name Type Optional
name string No
Returns : void
processIsEnabled
processIsEnabled(name: string)
Inherited from BaseComponent
Defined in BaseComponent:1764

Process changes to IsEnabled property.

Parameters :
Name Type Optional
name string No
Returns : void
processOpacity
processOpacity(name: string)
Inherited from BaseComponent
Defined in BaseComponent:1751

Method to apply the opacity for the component.

Parameters :
Name Type Optional
name string No
Returns : void
processVisibility
processVisibility(name: string)
Inherited from BaseComponent
Defined in BaseComponent:1737

Method to check if the component should be show or hide.

Parameters :
Name Type Optional
name string No
Returns : void
processWidths
processWidths(name: string)
Inherited from BaseComponent
Defined in BaseComponent:1829

Method to check and set the width of the grid

Parameters :
Name Type Optional
name string No
Returns : void
Private processZIndex
processZIndex(name: string)
Inherited from BaseComponent
Defined in BaseComponent:1872

Method to process the ZIndex when set through the model

Parameters :
Name Type Optional
name string No
Returns : void
Private recreateInvalidBindings
recreateInvalidBindings()
Inherited from BaseComponent
Defined in BaseComponent:2756

Execution of removeModelProxyHandlers in a previous instance of the component (that used the same model) could have set some bindings in an invalid state, this will check if some of them has to be recreated

Returns : void
Private registerContextMenuActions
registerContextMenuActions(ctxMenu: ContextMenuManager)
Inherited from BaseComponent
Defined in BaseComponent:2533

Enable the contextMenu actions to be displayed when the user perform an action Creates dinamically a new instance of XamContextMenu to be displayed in the screen

Parameters :
Name Type Optional
ctxMenu ContextMenuManager No
Returns : void
Protected registerDomEventListenerOnElement
registerDomEventListenerOnElement(eventName: string, handler: any)
Inherited from BaseComponent
Defined in BaseComponent:2316

Registers a DOM handler on the current element

Parameters :
Name Type Optional
eventName string No
handler any No
Returns : void
Protected registerHandler
registerHandler(event: SubscriptionEvent<void>, arrowHandler: (s: any,a: any) => void)
Inherited from BaseComponent
Defined in BaseComponent:2298

Register arrow handler into the given SubscriptionEvent with unregister handling when component destroy.

Parameters :
Name Type Optional
event SubscriptionEvent<void> No
arrowHandler function No
Returns : void
Protected registerMouseEvents
registerMouseEvents()
Inherited from BaseComponent
Defined in BaseComponent:2272

Registers mouse events if required

Returns : void
Protected registerObservers
registerObservers(emitter: EventEmitter, model: FrameworkElement, event: SubscriptionEvent<void>)
Inherited from BaseComponent
Defined in BaseComponent:2252

Register observers from the given EventEmitter into the given SubscriptionEvent.

Parameters :
Name Type Optional
emitter EventEmitter<any> No
model FrameworkElement No
event SubscriptionEvent<void> No
Returns : void
Private registerToolTip
registerToolTip(element: ElementRef, tooltip: ToolTipModel)
Inherited from BaseComponent
Defined in BaseComponent:2607

Registers a tooltip to a component

Parameters :
Name Type Optional
element ElementRef<any> No
tooltip ToolTipModel No
Returns : void
Private removeModelProxyHandlers
removeModelProxyHandlers()
Inherited from BaseComponent
Defined in BaseComponent:2738

Clean up the handlers when the component is destroyed

Returns : void
Private setComponentForDirectives
setComponentForDirectives()
Inherited from BaseComponent
Defined in BaseComponent:2512

Sets an internal reference through the element ref to access the component in a directive

Returns : void
Protected setPendingPropertyValue
setPendingPropertyValue(property: string, value: any)
Inherited from BaseComponent
Defined in BaseComponent:2336

Stores the pending property values for instance attach properties. Which will be applied when the model is available

Parameters :
Name Type Optional
property string No
value any No
Returns : void
setupDependencyComponents
setupDependencyComponents(model: FrameworkElement)
Inherited from BaseComponent
Defined in BaseComponent:1612

Adds the references to the dependency components

Parameters :
Name Type Optional
model FrameworkElement No
Returns : void
setupModel
setupModel(model: FrameworkElement)
Inherited from BaseComponent
Defined in BaseComponent:1559

Syncs the modelProxy with model

Parameters :
Name Type Optional
model FrameworkElement No
Returns : void

void
Private syncToolTip
syncToolTip(tooltip: ToolTipModel)
Inherited from BaseComponent
Defined in BaseComponent:2587

Updates the tooltip associated to a component

Parameters :
Name Type Optional
tooltip ToolTipModel No
Returns : void
Private syncValidationError
syncValidationError(name?: string)
Inherited from BaseComponent
Defined in BaseComponent:2766

Syncs validation information with component properties

Parameters :
Name Type Optional
name string Yes
Returns : void
Private tabSelectionSubscription
tabSelectionSubscription()
Inherited from BaseComponent
Defined in BaseComponent:2471

Subscribe to the tabhandler event if Required When the component is inside a tab control it should trigger the load event every time the tab is selected

Returns : void
trackByFn
trackByFn(index: any, item: any)
Inherited from BaseComponent
Defined in BaseComponent:1904

Function used by Angular to track elements in the ngFor directive. We use the GUID property to compare elements.

Parameters :
Name Type Optional Description
index any No
  • index of the array
item any No
  • item of the array
Returns : any

{*} -return the model or object itself
Private unregisterToolTip
unregisterToolTip(element: ElementRef)
Inherited from BaseComponent
Defined in BaseComponent:2719

Unregisters a tooltip to a component

Parameters :
Name Type Optional
element ElementRef<any> No
Returns : void
Private updateSizePropertiesForActualSizeChange
updateSizePropertiesForActualSizeChange(element: Element)
Inherited from BaseComponent
Defined in BaseComponent:2421

Updates the size properties of the component based on the initial size change

Parameters :
Name Type Optional Description
element Element No

HTML element
Returns : void
validatesLoadingFlag
validatesLoadingFlag()
Inherited from BaseComponent
Defined in BaseComponent:1519

Validates loading flag for components outside current tab index TabIndexService should be only tabItem provider, and when currentTabId is different from selectedTab IsFirstTimeLoad is set to false because tabService is going to be one in charge to trigger only one time when tab changes.

Returns : void
widthCalc
widthCalc()
Inherited from BaseComponent
Defined in BaseComponent:1953

Applies the width CSS value

Returns : any
widthDefaultStyle
widthDefaultStyle()
Inherited from BaseComponent
Defined in BaseComponent:1926

Calculates the auto width value

Returns : string

{string}

Properties

collectionModifiedSubscription
Type : any
Defined in projects/i-components/src/lib/components/tab-control/tab-control.component.ts:159

Subscription handler when item collection changes
Public componentFactoryResolver
Type : ComponentFactoryResolver
Defined in projects/i-components/src/lib/components/tab-control/tab-control.component.ts:312
componentFactoryResolver reference
controlRef
Type : any
Decorators :
@ViewChild('controlRef', {static: false})
Defined in projects/i-components/src/lib/components/tab-control/tab-control.component.ts:89

Reference the HTMLElement of the component
Private Static defaultPadding
Type : ThicknessModel
Default value : ThicknessModel.parse('5')
Defined in projects/i-components/src/lib/components/tab-control/tab-control.component.ts:81

Default padding of the component
hideContent
Type : boolean
Decorators :
@Input()
Defined in projects/i-components/src/lib/components/tab-control/tab-control.component.ts:197

Flag to know if the tabControl have to hide its content when its disabled, this a workaround for bug #455812
Parameters :
Name
value
itemsToRender
Type : TabItemComponent[]
Default value : []
Defined in projects/i-components/src/lib/components/tab-control/tab-control.component.ts:167

Internal collection of TabItems that should be render
keepTabContent
Default value : true
Decorators :
@Input()
Defined in projects/i-components/src/lib/components/tab-control/tab-control.component.ts:106

When set to true, the component renders all tabs and they are persisted in the DOM.
model
Type : TabControlModel
Decorators :
@Input()
Defined in projects/i-components/src/lib/components/tab-control/tab-control.component.ts:97

Tab control model
modelProxy
Type : TabControlModel
Default value : ModelProxy.create<TabControlModel>()
Inherited from BaseComponent
Defined in BaseComponent:135

ModelProxy is a copy of the model, used on the component initial building to prevent crashes with external bindings.
preserveContent
Default value : false
Decorators :
@Input()
Defined in projects/i-components/src/lib/components/tab-control/tab-control.component.ts:204

Keeps the tab from removing the tab body content from DOM Workaround since this is already implemented for Material v14, currently v12
selectionChanged
Type : EventEmitter<literal type>
Default value : new EventEmitter()
Decorators :
@Output()
Defined in projects/i-components/src/lib/components/tab-control/tab-control.component.ts:124

Event Emitter. EventEmitter normally called in the selectionChangedHandler.
tabItems
Type : QueryList<any>
Decorators :
@ContentChildren(TabItemComponent)
Defined in projects/i-components/src/lib/components/tab-control/tab-control.component.ts:115

TabItems query.
tabItemsToApplyVisibilityEffect
Type : any
Default value : null
Defined in projects/i-components/src/lib/components/tab-control/tab-control.component.ts:143

Stores the tabItems to apply the Visibility
tabItemVisibilitySubscription
Type : any
Defined in projects/i-components/src/lib/components/tab-control/tab-control.component.ts:151

Subscription variable to TabItem service
Public viewRef
Type : ViewContainerRef
Defined in projects/i-components/src/lib/components/tab-control/tab-control.component.ts:313
viewContainerRef reference
Private visibleTabsCache
Type : Set<TabItemComponent>
Default value : new Set()
Defined in projects/i-components/src/lib/components/tab-control/tab-control.component.ts:176

Keeps the previous selected tabs to avoid loading the template again if already been loaded previously
actualSizeCalled
Default value : false
Inherited from BaseComponent
Defined in BaseComponent:481

Flag to know if the Angular event was called
afterContentInitCalled
Default value : false
Inherited from BaseComponent
Defined in BaseComponent:465

Flag to know if the Angular event was called
afterViewCheckedCalled
Default value : false
Inherited from BaseComponent
Defined in BaseComponent:473

Flag to know if the Angular event was called
afterViewInitCalled
Default value : false
Inherited from BaseComponent
Defined in BaseComponent:457

Flag to know if the Angular event was called
Private bindingValidationCallback
Type : function
Inherited from BaseComponent
Defined in BaseComponent:618

Callback for binding validation
bindingValidationError
Type : EventEmitter<any>
Default value : new EventEmitter()
Decorators :
@Output()
Inherited from BaseComponent
Defined in BaseComponent:114

output to emit the new value of the bindingValidationError event
Private cdRefInjection
Type : ChangeDetectorRef
Inherited from BaseComponent
Defined in BaseComponent:659

Change Detector Reference for the component
Private changeDetectionTimer
Type : any
Inherited from BaseComponent
Defined in BaseComponent:668

A timer to debounce changedetection actions
Protected changeDetectorNotifier
Type : ChangeDectionNotifierService
Inherited from BaseComponent
Defined in BaseComponent:576

Change Detection Notifier Service instace.
Private contextMenuUnlistener
Type : function
Inherited from BaseComponent
Defined in BaseComponent:676

Context Menu event unlisten action.
Private ctxMenuInstance
Type : any
Inherited from BaseComponent
Defined in BaseComponent:630

Reference to the ctxMenuInstance
customCssClasses
Type : string
Default value : null
Decorators :
@HostBinding('class')
Inherited from BaseComponent
Defined in BaseComponent:407

Applies custom CSS classes
Private customTooltipInstance
Type : any
Default value : null
Inherited from BaseComponent
Defined in BaseComponent:641

Reference to the custom tooltip instance this is used to render a popup with custom elements used when the content value is not a string
dataGridRowHeight
Type : number
Default value : 22
Decorators :
@Input()
Inherited from BaseComponent
Defined in BaseComponent:507

Represents the row height of both the DataGrid and XamGrid components it affects the css and also an internal function that virtualized data, so do not change directly on css, use this variable instead.
Protected domHandlerUnListeners
Type : Array<void>
Inherited from BaseComponent
Defined in BaseComponent:567

A collection (possible undefined) of DOM unlistener functions . That is, functions to de register handlers
fireLoadedSubscription
Type : Subscription
Default value : null
Inherited from BaseComponent
Defined in BaseComponent:449

Flag to control load event for components inside tab control
focusable
Default value : false
Decorators :
@HostBinding('class.focusable')
Inherited from BaseComponent
Defined in BaseComponent:388

Display if the component is focusable or not
Protected handlersToUnregister
Type : Array<>
Default value : []
Inherited from BaseComponent
Defined in BaseComponent:558

handlers to unregister when the component is destroyed
hasDefinedCursor
Default value : false
Decorators :
@HostBinding('class.hasDefinedCursor')
Inherited from BaseComponent
Defined in BaseComponent:415

Applies Defined Cursor class
hostFontFamily
Type : any
Default value : null
Decorators :
@HostBinding('style.font-family')
Inherited from BaseComponent
Defined in BaseComponent:261

Property use it to apply the host binding for the font-family
hostFontSize
Type : any
Default value : null
Decorators :
@HostBinding('style.font-size')
Inherited from BaseComponent
Defined in BaseComponent:270

Property use it to apply the host binding for the font-size
hostFontStyle
Type : any
Default value : null
Decorators :
@HostBinding('style.font-style')
Inherited from BaseComponent
Defined in BaseComponent:279

Property use it to apply the host binding for the font-style
hostFontStyles
Default value : false
Decorators :
@HostBinding('class.defaultFontStyles')
Inherited from BaseComponent
Defined in BaseComponent:398

Applies default font styles class, used to allow specificity for each control css
hostFontWeight
Type : any
Default value : null
Decorators :
@HostBinding('style.font-weight')
Inherited from BaseComponent
Defined in BaseComponent:288

Property use it to apply the host binding for the font-weight
hostHeight
Type : string
Default value : null
Decorators :
@HostBinding('style.height')
Inherited from BaseComponent
Defined in BaseComponent:218

Property use it to apply the host binding for the height
hostHozCenter
Default value : false
Decorators :
@HostBinding('class.horizontal-center')
Inherited from BaseComponent
Defined in BaseComponent:308

Applies horizontal alignment left class
hostHozLeft
Default value : false
Decorators :
@HostBinding('class.horizontal-left')
Inherited from BaseComponent
Defined in BaseComponent:298

Applies horizontal alignment left class
hostHozRight
Default value : false
Decorators :
@HostBinding('class.horizontal-right')
Inherited from BaseComponent
Defined in BaseComponent:368

Applies horizontal alignment right class
hostHozSelfAlign
Default value : false
Decorators :
@HostBinding('class.horizontal-selfalign')
@Input()
Inherited from BaseComponent
Defined in BaseComponent:380

Applies horizontal selfalign class. Flags indicates when the control should handle its own horizontal alignment and ignore container alignment.
hostHozStretch
Default value : false
Decorators :
@HostBinding('class.horizontal-stretch')
Inherited from BaseComponent
Defined in BaseComponent:358

Applies horizontal alignment stretch class
hostMaxHeight
Type : number
Decorators :
@HostBinding('style.max-height.px')
Inherited from BaseComponent
Defined in BaseComponent:234

Property used to apply the host binding for max-height
hostMaxWidth
Type : number
Decorators :
@HostBinding('style.max-width.px')
Inherited from BaseComponent
Defined in BaseComponent:210

Property used to apply the host binding for max-width
hostMinHeight
Type : number
Decorators :
@HostBinding('style.min-height.px')
Inherited from BaseComponent
Defined in BaseComponent:226

Property used to apply the host binding for min-height
hostMinWidth
Type : number
Decorators :
@HostBinding('style.min-width.px')
Inherited from BaseComponent
Defined in BaseComponent:202

Property used to apply the host binding for min-width
hostOpacity
Type : any
Default value : null
Decorators :
@HostBinding('style.opacity')
Inherited from BaseComponent
Defined in BaseComponent:252

Property use it to apply the host binding for the opacity
hostVerBottom
Default value : false
Decorators :
@HostBinding('class.vertical-bottom')
Inherited from BaseComponent
Defined in BaseComponent:328

Applies vertical alignment bottom class
hostVerCenter
Default value : false
Decorators :
@HostBinding('class.vertical-center')
Inherited from BaseComponent
Defined in BaseComponent:338

Applies vertical alignment center class
hostVerStretch
Default value : false
Decorators :
@HostBinding('class.vertical-stretch')
Inherited from BaseComponent
Defined in BaseComponent:318

Applies horizontal alignment stretch class
hostVerTop
Default value : false
Decorators :
@HostBinding('class.vertical-top')
Inherited from BaseComponent
Defined in BaseComponent:348

Applies vertical alignment top class
hostVisibility
Type : any
Default value : null
Decorators :
@HostBinding('style.display')
Inherited from BaseComponent
Defined in BaseComponent:243

Property use it to apply the host binding for the visibility
hostWidth
Type : string
Default value : null
Decorators :
@HostBinding('style.width')
Inherited from BaseComponent
Defined in BaseComponent:194

Property use it to apply the host binding for the width
hostZIndex
Type : string
Default value : null
Decorators :
@HostBinding('style.z-index')
Inherited from BaseComponent
Defined in BaseComponent:424

Sets the z-index style.
isInitialized
Type : any
Default value : undefined
Inherited from BaseComponent
Defined in BaseComponent:523

Flag to know if the component is ready to render
isInternalInherit
Default value : false
Inherited from BaseComponent
Defined in BaseComponent:515

Flag which indicates that the component is an internal use for inheritance
layoutUpdated
Type : EventEmitter<any>
Default value : new EventEmitter()
Decorators :
@Output()
Inherited from BaseComponent
Defined in BaseComponent:140

Output to emit when then component's layout is updated.
loaded
Type : EventEmitter<any>
Default value : new EventEmitter()
Decorators :
@Output()
Inherited from BaseComponent
Defined in BaseComponent:123

Output to emit when then component is loaded.
Protected modelChangeRef
Type : function
Inherited from BaseComponent
Defined in BaseComponent:601

Contains the reference of the function added for handle the model's change
mouseEnter
Type : EventEmitter<literal type>
Default value : new EventEmitter()
Decorators :
@Output()
Inherited from BaseComponent
Defined in BaseComponent:157

Event Emitter. EventEmitter normally called in the mouseEnterHandler.
mouseLeave
Type : EventEmitter<literal type>
Default value : new EventEmitter()
Decorators :
@Output()
Inherited from BaseComponent
Defined in BaseComponent:167

Event Emitter Called in the mouseLeave handler
Private mouseLeaveTooltipUnlistener
Type : function
Default value : null
Inherited from BaseComponent
Defined in BaseComponent:684

Mouse over event for tooltip unlisten action.
mouseLeftButtonUp
Type : EventEmitter<literal type>
Default value : new EventEmitter<any>()
Decorators :
@Output()
Inherited from BaseComponent
Defined in BaseComponent:147

MouseLeftButtonUp event Emitter.
Private mouseMoveTooltipUnlistener
Type : function
Default value : null
Inherited from BaseComponent
Defined in BaseComponent:701

Mouse move event for tooltip unlisten action. This should have a short lifespan, as much as it takes for the tooltip to be shown
Private mouseOverTooltipUnlistener
Type : function
Default value : null
Inherited from BaseComponent
Defined in BaseComponent:692

Mouse over event for tooltip unlisten action.
Protected ngZone
Type : NgZone
Inherited from BaseComponent
Defined in BaseComponent:585

Angular´s NgZone accessor
Protected pendingDependencyPropertyValue
Type : Array<>
Default value : []
Inherited from BaseComponent
Defined in BaseComponent:549

A collection of pending dependency properties values to assign to the model
Protected pendingSetValues
Type : Array<>
Default value : []
Inherited from BaseComponent
Defined in BaseComponent:540

A collection of pending values to assign to the model
Protected renderer2
Type : Renderer2
Inherited from BaseComponent
Defined in BaseComponent:594

Angular´s Renderer2
sizeChanged
Type : EventEmitter<any>
Default value : new EventEmitter()
Decorators :
@Output()
Inherited from BaseComponent
Defined in BaseComponent:132

Output to emit when then component size is changed.
Private sizeChangedPendingTimeout
Type : any
Inherited from BaseComponent
Defined in BaseComponent:610

Timeout id for triggering the sizechanged event
spellCheck
Default value : false
Decorators :
@Input()
Inherited from BaseComponent
Defined in BaseComponent:186

Flag to determinate if the component should do the spell check or not. Default value is false.
staticContent
Type : any
Default value : null
Inherited from BaseComponent
Defined in BaseComponent:432

cache the static content of the control to validate if the current data is not equals.
tabSubscription
Type : Subscription
Default value : null
Inherited from BaseComponent
Defined in BaseComponent:440

TabSelection event subscription
Private tooltipMousePosition
Type : DOMRect
Default value : null
Inherited from BaseComponent
Defined in BaseComponent:710

To track the position of the mouse while the tooltip is being displayed
Private toolTipTimeout
Type : any
Default value : null
Inherited from BaseComponent
Defined in BaseComponent:650

To control the timer to show the tooltip
useCss
Default value : false
Decorators :
@Input()
Inherited from BaseComponent
Defined in BaseComponent:177

Determines if the component uses CSS height/width values, instead of inputs
validationError
Default value : false
Inherited from BaseComponent
Defined in BaseComponent:488

Property to set the validationError class in the component
validationErrorMessage
Type : string
Default value : ''
Inherited from BaseComponent
Defined in BaseComponent:496

Property for specifying validation error message

Accessors

items
getitems()
Defined in projects/i-components/src/lib/components/tab-control/tab-control.component.ts:185

Get the collection of Items from model

Returns : any
selectedIndex
getselectedIndex()
Defined in projects/i-components/src/lib/components/tab-control/tab-control.component.ts:224

Gets SelectedIndex from model.

Returns : number
setselectedIndex(value: number)
Defined in projects/i-components/src/lib/components/tab-control/tab-control.component.ts:213

Set SelectedIndex on model

Parameters :
Name Type Optional
value number No
Returns : void
hasTabs
gethasTabs()
Defined in projects/i-components/src/lib/components/tab-control/tab-control.component.ts:235

Gets if component has tabItems.

Returns : boolean
tabItemPadding
gettabItemPadding()
Defined in projects/i-components/src/lib/components/tab-control/tab-control.component.ts:246

Calculates the padding to apply to the tab items

Returns : string
padding
getpadding()
Defined in projects/i-components/src/lib/components/tab-control/tab-control.component.ts:277

Gets the padding to use in the content of each tab item

Returns : any
setpadding(value: any)
Defined in projects/i-components/src/lib/components/tab-control/tab-control.component.ts:258

Sets the padding to be used in the content in each of the tab items of the tab control

Parameters :
Name Type Optional
value any No
Returns : void
background
getbackground()
Defined in projects/i-components/src/lib/components/tab-control/tab-control.component.ts:296
setbackground(value: any)
Defined in projects/i-components/src/lib/components/tab-control/tab-control.component.ts:284
Parameters :
Name Type Optional
value any No
Returns : void
isHidingContent
getisHidingContent()
Defined in projects/i-components/src/lib/components/tab-control/tab-control.component.ts:627

Return the header container instance for the tab control

Returns : boolean 
import {
  AfterViewInit,
  ChangeDetectorRef,
  Component,
  Renderer2,
  ContentChildren,
  Injector,
  Input,
  OnInit,
  Optional,
  QueryList,
  ComponentFactoryResolver,
  ViewContainerRef,
  ComponentRef,
  Output,
  EventEmitter,
  OnDestroy,
  ViewChild,
  ChangeDetectionStrategy,
  AfterViewChecked,
} from '@angular/core';
import {
  AngularComponentId,
  ComponentId,
  ModelProxy,
  ModelProviderService,
  TabControlModel,
  TabItemModel,
  TabItemService,
  ThicknessModel,
} from '@mobilize/wms-framework';
import { Utils } from '../../utils/utilities';
import { TabItemComponent } from '../tab-item/tab-item.component';
import { BaseComponent } from '../base/base.component';
import { ToInjectorPurePipe } from '../../pipes/toinjector.pipe';

/*eslint no-underscore-dangle: ["error", { "allow": ["_items", "_tabHeader", "_elementRef"]}]*/
/**
 * Angular Component for the TabControl Control.
 *
 * @export
 * @class TabControlComponent
 * @extends {BaseComponent}
 * @implements {OnInit, AfterViewInit}
 */
@Component({
  selector: 'wm-tab-control',
  templateUrl: './tab-control.component.html',
  styleUrls: ['./tab-control.component.scss'],
  providers: [ModelProviderService, TabItemService],
  changeDetection: ChangeDetectionStrategy.OnPush,
})
@ComponentId([AngularComponentId.tabControl])
export class TabControlComponent
  extends BaseComponent
  implements OnInit, AfterViewInit, AfterViewChecked, OnDestroy
{
  /**
   * Default padding of the component
   *
   * @private
   * @static
   * @type {ThicknessModel}
   * @memberof TabControlComponent
   */
  private static defaultPadding: ThicknessModel = ThicknessModel.parse('5');

  /**
   * Reference the HTMLElement of the component
   *
   * @type {ElementRef}
   * @memberof PasswordBoxComponent
   */
  @ViewChild('controlRef', { static: false }) controlRef: any;

  /**
   * Tab control model
   *
   * @type {TabControlModel}
   * @memberof TabControlComponent
   */
  @Input() model: TabControlModel;

  /**
   * When set to true, the component renders all tabs and they are
   * persisted in the DOM.
   *
   * @type {boolean}
   * @memberof TabControlComponent
   */
  @Input() keepTabContent = true;

  /**
   * TabItems query.
   *
   * @type {QueryList<any>}
   * @memberof TabControlComponent
   */
  @ContentChildren(TabItemComponent)
  tabItems: QueryList<any>;

  /**
   * Event Emitter.
   * EventEmitter normally called in the selectionChangedHandler.
   *
   * @type {EventEmitter<TabControlModel>}
   * @memberof TabControlComponent
   */
  @Output() selectionChanged: EventEmitter<{
    sender: TabControlModel;
    e: any;
  }> = new EventEmitter();

  /**
   * ModelProxy is a copy of the model, used on the component initial building to prevent crashes with external bindings.
   *
   * @type {*}
   * @memberof TabControlComponent
   */
  modelProxy: TabControlModel = ModelProxy.create<TabControlModel>();

  /**
   * Stores the tabItems to apply the Visibility
   *
   * @type {any}
   * @memberof TabControlComponent
   */
  tabItemsToApplyVisibilityEffect: any = null;

  /**
   * Subscription variable to TabItem service
   *
   * @type {any}
   * @memberof TabControlComponent
   */
  tabItemVisibilitySubscription: any;

  /**
   * Subscription handler when item collection changes
   *
   * @type {any}
   * @memberof TabControlComponent
   */
  collectionModifiedSubscription: any;

  /**
   * Internal collection of TabItems that should be render
   *
   * @type {*}
   * @memberof TabControlComponent
   */
  itemsToRender: TabItemComponent[] = [];

  /**
   * Keeps the previous selected tabs to avoid
   * loading the template again if already been loaded previously
   *
   * @private
   * @memberof TabControlComponent
   */
  private visibleTabsCache: Set<TabItemComponent> = new Set();

  /**
   * Get the collection of Items from model
   *
   * @readonly
   * @type {*}
   * @memberof TabControlComponent
   */
  get items(): any {
    return this.model.items?.internalArray;
  }

  /**
   * Flag to know if the tabControl have to hide its content
   * when its disabled, this a workaround for bug #455812
   *
   * @param  {boolean} value
   * @memberof TabControlComponent
   */
  @Input()
  hideContent: boolean;

  /**
   * Keeps the tab from removing the tab body content from DOM
   * Workaround since this is already implemented for Material v14, currently v12
   */
  @Input()
  preserveContent = false;

  /**
   * Set SelectedIndex on model
   *
   * @param  {number} value
   * @memberof TabControlComponent
   */
  @Input()
  set selectedIndex(value: number) {
    this.modelProxy.SelectedIndex = value;
  }

  /**
   * Gets SelectedIndex from model.
   *
   * @readonly
   * @type {number}
   * @memberof TabControlComponent
   */
  get selectedIndex(): number {
    return this.model.SelectedIndex;
  }

  /**
   * Gets if component has tabItems.
   *
   * @readonly
   * @type {boolean}
   * @memberof TabControlComponent
   */
  get hasTabs(): boolean {
    return this.items?.length > 0 ? true : false;
  }

  /**
   * Calculates the padding to apply to the tab items
   *
   * @readonly
   * @type {string}
   * @memberof TabControlComponent
   */
  get tabItemPadding(): string {
    const padding: ThicknessModel =
      this.model?.Padding ?? TabControlComponent.defaultPadding;
    return `${padding.Top}px ${padding.Right}px ${padding.Bottom}px ${padding.Left}px`;
  }

  /**
   * Sets the padding to be used in the content in each of the tab items of the tab control
   *
   * @memberof TabControlComponent
   */
  @Input()
  set padding(value: any) {
    /* istanbul ignore else */
    if (
      !this.checkAndRegisterCompatibilityBinding(
        TabControlModel.PaddingProperty,
        value
      )
    ) {
      this.modelProxy.Padding = ThicknessModel.parse(value.toString());
    }
  }

  /**
   * Gets the padding to use in the content of each tab item
   *
   * @readonly
   * @type {*}
   * @memberof TabControlComponent
   */
  get padding(): any {
    return this.model.Padding
      ? this.model.Padding
      : TabControlComponent.defaultPadding;
  }

  @Input()
  set background(value: any) {
    /* istanbul ignore else */
    if (
      !this.checkAndRegisterCompatibilityBinding(
        TabControlModel.BackgroundProperty,
        value
      )
    ) {
      this.modelProxy.Background = Utils.createSolidBrush(value);
    }
  }

  get background(): any {
    return Utils.getCssColor(this.model.Background);
  }

  /**
   * Defines TabControl model.
   *
   * @param {componentFactoryResolver} componentFactoryResolver componentFactoryResolver reference
   * @param {viewRef} viewRef viewContainerRef reference
   * @memberof TabControlComponent
   */
  public constructor(
    @Optional() private injectedModel: TabControlModel,
    private provider: ModelProviderService,
    private cd: ChangeDetectorRef,
    private injector: Injector,
    public componentFactoryResolver: ComponentFactoryResolver,
    public viewRef: ViewContainerRef,
    private tabItemService: TabItemService,
    private renderer: Renderer2
  ) {
    super(cd, injector);
    this.model = injectedModel;
  }

  /**
   * Angular lifecycle, creates modelProxy copy.
   *
   * @memberof TabControlComponent
   */
  /* istanbul ignore next */
  ngOnInit(): void {
    this.model = this.model || this.injectedModel || new TabControlModel();
    ModelProxy.copy(this.modelProxy, this.model);
    this.setupModel(this.model);
    super.ngOnInit();
    this.provider.model = this.model;
    this.visibleTabsCache = new Set();
    if (this.selectionChanged?.observers?.length > 0) {
      this.handlersToUnregister.push([
        this.model.SelectionChanged,
        this.model.SelectionChanged.addHandler((e, a) =>
          this.selectionChanged.emit({ sender: this.model, e: a })
        ),
      ]);
    }
    this.tabItemVisibilitySubscription = this.tabItemService.events.subscribe(
      (argument) => this.visibilityClassToTabItem(argument)
    );
  }

  /**
   * Sets rendering flag to true
   *
   * @memberof TabControlComponent
   */
  ngAfterViewInit(): void {
    super.ngAfterViewInit();
    setTimeout(() => {
      this.assignStaticItems();
      this.isInitialized = true;
      const params = {
        staticTabItems: this.tabItems,
        isEnabled: this.isEnabled,
      };
      this.model.SyncModelWithComponent(params);
      this.collectionModifiedSubscription =
        this.model.items?.CollectionChanged_INotifyCollectionChanged.addHandler(
          (e, a) => this.collectionModifiedHandler(e, a)
        );
      // Check if the SelectedItem is the same TabItem that is currently selected.
      this.model.checkSelectedItem();
      // TabItems to apply the visibility effect when component loads the first time
      this.tabItemsToApplyVisibilityEffect = this.items;
      // Trigger load event on first tab load
      this.tabItemService.emitClearLoadFlag();
      this.tabItemService.emitTabSelectionChanged(this.selectedIndex);
      /* istanbul ignore else */
      if (this.isInitialized) {
        this.tabElements();
      }
      this.detectChangesAction();
    }, 100);
  }

  /**
   * Angular lifecycle hook
   *
   * @memberof TabControlComponent
   */
  ngAfterContentChecked(): void {
    /* istanbul ignore else */
    if (this.shouldResetTabItemsToApplyVisibility()) {
      this.tabItemsToApplyVisibilityEffect = null;
    }
  }

  /**
   * Verifies if the Visibility effect was applied successfully to the tabItems
   *
   * @returns boolean
   */
  shouldResetTabItemsToApplyVisibility(): boolean {
    return (
      this.tabItemsToApplyVisibilityEffect !== null &&
      this.getTabItems()?.length > 0 &&
      this.applyInvisibleTabItems(this.tabItemsToApplyVisibilityEffect)
    );
  }

  /**
   * Angular lifecycle hook
   *
   * @memberof TabControlComponent
   */
  ngOnDestroy(): void {
    super.ngOnDestroy();
    this.visibleTabsCache.clear();
    this.tabItemVisibilitySubscription.unsubscribe();
    this.model.items?.CollectionChanged_INotifyCollectionChanged.removeHandler(
      this.collectionModifiedSubscription
    );
  }

  /**
   * Assign static set of items to be rendered.
   *
   * @memberof TabControlComponent
   */
  assignStaticItems(): void {
    const arrayItems = this.tabItems.toArray();
    // Adding static items in collection
    this.loadStaticItems(arrayItems, this.model.items);
    for (const [index, item] of arrayItems.entries()) {
      /* istanbul ignore else */
      if (item['tabIndexService']) {
        item['tabIndexService'].currentTabId = index;
      }
      this.itemsToRender.push(item);
    }
  }

  /**
   * Checks array of items looking for new dynamic elements to be renderer
   *
   * @return {*}  {*}
   * @memberof TabControlComponent
   */
  tabElements(): any {
    this.itemsToRender = this.itemsToRender.filter((item) => {
      if (this.items.indexOf(item.model) === -1) {
        this.visibleTabsCache.delete(item);
        return false;
      }
      return true;
    }); // Remove elements not present in model
    this.items.forEach((element, index) => {
      const isEqual = this.itemsToRender.findIndex((x) => x.model === element);
      /* istanbul ignore else */
      if (isEqual === -1) {
        /* istanbul ignore else */
        if (element instanceof TabItemModel) {
          const newControlsToRender = [];
          this.model.UpdateTabItemProps(element);
          newControlsToRender.push(element);
          const newElement = Utils.getUIControls(
            newControlsToRender,
            this.injector
          )[0];
          const component = this.addControl(newElement);
          component.instance.model = element;
          component.instance['tabIndexService'].currentTabId = index;
          component.instance.ngOnInit();
          component.changeDetectorRef.detectChanges();
          this.setupHeaderCustomInjector(component.instance);
          this.itemsToRender.push(component.instance);
        }
      }
    });
  }

  /**
   * Method used to create the tab-item inside the tab-control.
   *
   * @param {*} newElement - element to render
   * @return {*}
   * @memberof TabControlComponent
   */
  /* istanbul ignore next */
  addControl(newElement: any) {
    const componentFactory =
      this.componentFactoryResolver.resolveComponentFactory(
        newElement.component
      );
    const componentRef = componentFactory.create(
      newElement.customInjector
    ) as ComponentRef<any>;
    return componentRef;
  }

  /**
   * Returns a valid header variable
   *
   * @param {*} header
   * @return {*}
   * @memberof TabControlComponent
   */
  returnItemHeader(header: any): any {
    if (header != null) {
      if (typeof header === 'object' && header.constructor != null) {
        return header.constructor.name !== 'Object'
          ? header.constructor.name
          : '';
      }
      return typeof header === 'string' || header instanceof String
        ? header
        : '';
    }
    return '';
  }

  /**
   * Event Handler for when the user selects a tabItem
   *
   * @param {*} event - event from the DOM event
   * @memberof TabControlComponent
   */
  selectionChangedHandler(event: any): void {
    // The model.SelectedIndex prop will invoke the selectionChanged handler internally
    this.tabItemService.emitClearLoadFlag();
    this.tabItemService.emitTabSelectionChanged(this.selectedIndex);
  }

  /**
   * Handler when the items collection changes
   *
   * @param  {any} e any
   * @param  {any} a CollectionChangeInfo
   * @returns void
   */
  collectionModifiedHandler(e: any, a: any): void {
    /* istanbul ignore else */
    if (a.action === 0 && a.NewItems?.internalArray.length > 0) {
      // Setting the new tabItems to apply the visibility effect
      this.tabItemsToApplyVisibilityEffect = a.NewItems.internalArray;
    }
    this.tabElements();
    this.detectChangesAction();
  }

  /**
   * Executes the visibility effect for each tabItem to apply
   *
   * @param  {any} itemsToApply TabItems to apply visibility
   * @returns boolean True if visibility was applied, otherwise false
   */
  applyInvisibleTabItems(itemsToApply: any): boolean {
    let returnValue = true;
    for (const itm of itemsToApply) {
      if (!this.visibilityClassToTabItem(itm)) {
        returnValue = false;
        break;
      }
    }
    return returnValue;
  }

  /**
   * Applies visibility effect for a tabItem and also visibility effect
   * for the tab header
   *
   * @param  {any} argument TabItem to apply visibility
   * @returns boolean True if visibility was applied, otherwise false
   */
  visibilityClassToTabItem(argument: any): boolean {
    /* istanbul ignore else */
    if (argument !== 'IsEnabled') {
      const qtyItems = this.items ? this.items.length : 0;
      if (qtyItems === 0 && this.controlRef === undefined) {
        return false;
      }
      const tabIdx = this.items.indexOf(argument);
      if (tabIdx === -1) {
        return false;
      }
      if (
        this.controlRef?._tabHeader?._items?.toArray()[tabIdx] === undefined
      ) {
        return false;
      }

      this.applyVisibilityItem(tabIdx, argument);
    }
    this.detectChangesAction();
    return true;
  }

  /**
   * Applies the visibility class to the tabItem and also applies style in header
   *
   * @param  {number} tabIdx Index of the argument in the igx control
   * @param  {any} argument The tabItemModel
   */
  /* istanbul ignore next */
  applyVisibilityItem(tabIdx: number, argument: any) {
    const tab = this.getTabItems()?.toArray()[tabIdx].elementRef.nativeElement;
    // Finding igx tab header dom element
    const headerContainer = this.getHeaderInstance()?._elementRef.nativeElement;
    const qytItemsVisibiles = this.items.filter((x) => x.Visibility).length;
    if (argument.Visibility) {
      this.renderer.removeClass(tab, 'hideTab');
      /* istanbul ignore else */
      if (qytItemsVisibiles > 0) {
        this.renderer.removeClass(headerContainer, 'hideTabHeader');
      }
    } else {
      this.renderer.addClass(tab, 'hideTab');
      /* istanbul ignore else */
      if (qytItemsVisibiles === 0) {
        // Hides the entire header to simulate the silverlight behavior
        this.renderer.addClass(headerContainer, 'hideTabHeader');
      }
    }
  }

  /**
   * Return the header container instance for the tab control
   *
   * @return {boolean}
   * @memberof TabControlComponent
   */
  get isHidingContent(): boolean {
    return !this.isEnabled && this.hideContent;
  }

  /**
   * Return the header container instance for the tab control
   *
   * @private
   * @return {*}
   * @memberof TabControlComponent
   */
  private getHeaderInstance(): any {
    return this.controlRef?._tabHeader;
  }

  /**
   * returns the query list for the tabs in the control
   *
   * @private
   * @return {*}
   * @memberof TabControlComponent
   */
  private getTabItems(): QueryList<any> {
    return this.controlRef?._tabHeader?._items;
  }

  /**
   * If there is a header template in the model, setup a custom injector for it.
   *
   * @private
   * @param {TabItemComponent} component The component where the custom injector will be stored.
   * @memberof TabControlComponent
   */
  private setupHeaderCustomInjector(component: TabItemComponent): void {
    /* istanbul ignore else */
    if (component.model.HeaderTemplate) {
      const toInjectorPipe = new ToInjectorPurePipe(this.injector);
      component.headerCustomInjector = toInjectorPipe.transform(
        component.model.DataContext,
        component.model.HeaderTemplate.declaringContext
      );
    }
  }

  /**
   * Returns true if the tab was previously selected
   * and its content have been already loaded on the screen
   *
   * @private
   * @param {number} i
   * @param {TabItemComponent} tab
   * @param {number} selectedIndex
   * @return {*}
   * @memberof TabControlComponent
   */
  shouldBeVisible(
    i: number,
    tab: TabItemComponent,
    selectedIndex: number
  ): boolean {
    if (this.keepTabContent) {
      return true;
    }
    if (this.visibleTabsCache.has(tab)) {
      return true;
    } else if (i === selectedIndex) {
      this.visibleTabsCache.add(tab);
      return true;
    }
    return false;
  }
}

<mat-tab-group
  #controlRef
  *ngIf="isInitialized && visibility"
  (selectedTabChange)="selectionChangedHandler($event)"
  [(selectedIndex)]="selectedIndex"
  [attr.enabled]="isEnabled"
  [attr.data-hastabs]="hasTabs"
  [animationDuration]="0"
  [disableRipple]="true"
  [preserveContent]="preserveContent"
  class="autoHeightWidth"
>
  <mat-tab
    *ngFor="let tab of itemsToRender; let i = index; trackBy: trackByFn"
    [label]="returnItemHeader(tab.model.header)"
    [disabled]="!tab.isEnabled || !isEnabled"
  >
    <div
      [ngClass]="{
        isDisabled: !tab.isEnabled || !isEnabled,
        hideContent: (!tab.isEnabled || !isEnabled) && hideContent
      }"
      [style.padding]="tabItemPadding"
      [style.background-color]="background"
      class="tabItemContainer"
    >
      <ng-template
        mat-tab-label
        *ngIf="tab.model.HeaderTemplate && !tab.model.templateModel"
      >
        <ng-container
          *ngComponentOutlet="
            tab.model.HeaderTemplate.TemplateComponentConstructor;
            injector: tab.headerCustomInjector
          "
        >
        </ng-container>
      </ng-template>
      <ng-template mat-tab-label *ngIf="tab.model.templateModel">
        <wm-content-control
          [content]="tab.model.templateModel"
        ></wm-content-control>
      </ng-template>
      <ng-container
        *ngIf="tab.template && (shouldBeVisible | memoize: i:tab:selectedIndex)"
      >
        <ng-container *ngTemplateOutlet="tab.template"></ng-container>
      </ng-container>
      <ng-container
        *ngIf="
          tab.dynamicControl && (shouldBeVisible | memoize: i:tab:selectedIndex)
        "
      >
        <ng-container
          *ngComponentOutlet="
            tab.dynamicControl.component;
            injector: tab.dynamicControl.customInjector
          "
        >
        </ng-container>
      </ng-container>
    </div>
  </mat-tab>
</mat-tab-group>

./tab-control.component.scss 

@import '../../scss/variables';

div {
  height: 100%;
  width: 100%;
}

.isDisabled,
mat-tab-header[enabled='false'] {
  @extend %default-control-disabled-state;
}

.hideContent {
  opacity: 0;
}

.tabItemContainer {
  box-sizing: border-box;
  background-color: $tab-control-background-color;
}

:host ::ng-deep {
  mat-tab-header {
    background-color: inherit;
    margin-bottom: -1px;
    z-index: 2;

    .mat-tab-label {
      background: $tab-default-background-color;
      border: $default-control-border;
      border-top-left-radius: $tab-control-border-radius;
      border-top-right-radius: $tab-control-border-radius;
      color: $tab-default-font-color;
      height: $tab-header-height;
      padding: $tab-header-padding;
      margin-top: $tab-header-active-height - $tab-header-height;
      min-width: unset;
      opacity: unset;
      cursor: default;
      user-select: none;

      &:hover {
        background: $telerik-control-border-hover-color;
      }

      &-active {
        background: none $tab-control-background-color-selected !important; // Added `!important` to overwrite Material theme.
        border-bottom: none;
        color: $tab-header-color;
        height: $tab-header-active-height;
        margin-top: 0;

        &:focus {
          border: $default-control-item-border-selected;
          border-bottom: none;
        }

        &:hover {
          background: none $tab-control-background-color-selected;
        }
      }

      &.mat-tab-disabled {
        @extend %default-control-disabled-state;
      }
    }
  }

  mat-tab-body {
    border: $default-control-border;
    border-radius: $tab-control-border-radius;

    .tabItemContainer {
      display: grid;
    }
  }
}
Legend
Html element
Component
Html element with directive

result-matching ""

    No results matching ""