1234567891011121314151617181920212223242526272829303132333435363738394041424344454647484950515253545556575859606162636465666768697071727374757677787980818283848586878889909192939495969798991001011021031041051061071081091101111121131141151161171181191201211221231241251261271281291301311321331341351361371381391401411421431441451461471481491501511521531541551561571581591601611621631641651661671681691701711721731741751761771781791801811821831841851861871881891901911921931941951961971981992002012022032042052062072082092102112122132142152162172182192202212222232242252262272282292302312322332342352362372382392402412422432442452462472482492502512522532542552562572582592602612622632642652662672682692702712722732742752762772782792802812822832842852862872882892902912922932942952962972982993003013023033043053063073083093103113123133143153163173183193203213223233243253263273283293303313323333343353363373383393403413423433443453463473483493503513523533543553563573583593603613623633643653663673683693703713723733743753763773783793803813823833843853863873883893903913923933943953963973983994004014024034044054064074084094104114124134144154164174184194204214224234244254264274284294304314324334344354364374384394404414424434444454464474484494504514524534544554564574584594604614624634644654664674684694704714724734744754764774784794804814824834844854864874884894904914924934944954964974984995005015025035045055065075085095105115125135145155165175185195205215225235245255265275285295305315325335345355365375385395405415425435445455465475485495505515525535545555565575585595605615625635645655665675685695705715725735745755765775785795805815825835845855865875885895905915925935945955965975985996006016026036046056066076086096106116126136146156166176186196206216226236246256266276286296306316326336346356366376386396406416426436446456466476486496506516526536546556566576586596606616626636646656666676686696706716726736746756766776786796806816826836846856866876886896906916926936946956966976986997007017027037047057067077087097107117127137147157167177187197207217227237247257267277287297307317327337347357367377387397407417427437447457467477487497507517527537547557567577587597607617627637647657667677687697707717727737747757767777787797807817827837847857867877887897907917927937947957967977987998008018028038048058068078088098108118128138148158168178188198208218228238248258268278288298308318328338348358368378388398408418428438448458468478488498508518528538548558568578588598608618628638648658668678688698708718728738748758768778788798808818828838848858868878888898908918928938948958968978988999009019029039049059069079089099109119129139149159169179189199209219229239249259269279289299309319329339349359369379389399409419429439449459469479489499509519529539549559569579589599609619629639649659669679689699709719729739749759769779789799809819829839849859869879889899909919929939949959969979989991000100110021003100410051006100710081009101010111012101310141015101610171018101910201021102210231024102510261027102810291030103110321033103410351036103710381039104010411042104310441045104610471048104910501051105210531054105510561057105810591060106110621063106410651066106710681069107010711072107310741075107610771078107910801081108210831084108510861087108810891090109110921093109410951096109710981099110011011102110311041105110611071108110911101111111211131114111511161117111811191120112111221123112411251126112711281129113011311132113311341135113611371138113911401141114211431144114511461147114811491150115111521153115411551156115711581159116011611162116311641165116611671168116911701171117211731174117511761177117811791180118111821183118411851186118711881189119011911192119311941195119611971198119912001201120212031204120512061207120812091210121112121213121412151216121712181219122012211222122312241225122612271228122912301231123212331234123512361237123812391240124112421243124412451246124712481249125012511252125312541255125612571258125912601261126212631264126512661267126812691270127112721273127412751276127712781279128012811282128312841285128612871288128912901291129212931294129512961297129812991300130113021303130413051306130713081309131013111312131313141315131613171318131913201321132213231324132513261327132813291330133113321333133413351336133713381339134013411342134313441345134613471348134913501351135213531354135513561357135813591360136113621363136413651366136713681369137013711372137313741375137613771378137913801381138213831384138513861387138813891390139113921393139413951396139713981399140014011402140314041405140614071408140914101411141214131414141514161417141814191420142114221423142414251426142714281429143014311432143314341435143614371438143914401441144214431444144514461447144814491450145114521453145414551456145714581459146014611462146314641465146614671468146914701471147214731474147514761477147814791480148114821483148414851486148714881489149014911492149314941495149614971498149915001501150215031504150515061507150815091510151115121513151415151516151715181519152015211522152315241525152615271528152915301531153215331534153515361537153815391540154115421543154415451546154715481549155015511552155315541555155615571558155915601561156215631564156515661567156815691570157115721573157415751576157715781579158015811582158315841585158615871588158915901591159215931594159515961597159815991600160116021603160416051606160716081609161016111612161316141615161616171618161916201621162216231624162516261627162816291630163116321633163416351636163716381639164016411642164316441645164616471648164916501651165216531654165516561657165816591660166116621663166416651666166716681669167016711672167316741675167616771678167916801681168216831684168516861687168816891690169116921693169416951696169716981699170017011702170317041705170617071708170917101711171217131714171517161717171817191720172117221723172417251726172717281729173017311732173317341735173617371738173917401741174217431744174517461747174817491750175117521753175417551756175717581759176017611762176317641765176617671768176917701771177217731774177517761777177817791780178117821783178417851786178717881789179017911792179317941795179617971798179918001801180218031804180518061807180818091810181118121813181418151816181718181819182018211822182318241825182618271828182918301831183218331834183518361837183818391840184118421843184418451846184718481849185018511852185318541855185618571858185918601861186218631864186518661867186818691870187118721873187418751876187718781879188018811882188318841885188618871888188918901891189218931894189518961897189818991900190119021903190419051906190719081909191019111912191319141915191619171918191919201921192219231924192519261927192819291930193119321933193419351936193719381939194019411942194319441945194619471948194919501951195219531954195519561957195819591960196119621963196419651966196719681969197019711972197319741975197619771978197919801981198219831984198519861987198819891990199119921993199419951996199719981999200020012002200320042005200620072008200920102011201220132014201520162017201820192020202120222023202420252026202720282029203020312032203320342035203620372038203920402041204220432044204520462047204820492050205120522053205420552056205720582059206020612062206320642065206620672068206920702071207220732074207520762077207820792080208120822083208420852086208720882089209020912092209320942095209620972098209921002101210221032104210521062107210821092110211121122113211421152116211721182119212021212122212321242125212621272128212921302131213221332134213521362137213821392140214121422143214421452146214721482149215021512152215321542155215621572158215921602161216221632164216521662167216821692170217121722173217421752176217721782179218021812182218321842185218621872188218921902191219221932194219521962197219821992200220122022203220422052206220722082209221022112212221322142215221622172218221922202221222222232224222522262227222822292230223122322233223422352236223722382239224022412242224322442245224622472248224922502251225222532254225522562257225822592260226122622263226422652266226722682269227022712272227322742275227622772278227922802281228222832284228522862287228822892290229122922293229422952296229722982299230023012302230323042305230623072308230923102311231223132314231523162317231823192320232123222323232423252326232723282329233023312332233323342335233623372338233923402341234223432344234523462347234823492350235123522353235423552356235723582359236023612362236323642365236623672368236923702371237223732374237523762377237823792380238123822383238423852386238723882389239023912392239323942395239623972398239924002401240224032404240524062407240824092410241124122413241424152416241724182419242024212422242324242425242624272428242924302431243224332434243524362437243824392440244124422443244424452446244724482449245024512452245324542455245624572458245924602461246224632464246524662467246824692470247124722473247424752476247724782479248024812482248324842485248624872488248924902491249224932494249524962497249824992500250125022503250425052506250725082509251025112512251325142515251625172518251925202521252225232524252525262527252825292530253125322533253425352536253725382539254025412542254325442545254625472548254925502551255225532554255525562557255825592560256125622563256425652566256725682569257025712572257325742575257625772578257925802581258225832584258525862587258825892590259125922593259425952596259725982599260026012602 |
- import { i as isDataSource } from './data-source-D34wiQZj.mjs';
- export { D as DataSource } from './data-source-D34wiQZj.mjs';
- import { DOCUMENT } from '@angular/common';
- import * as i0 from '@angular/core';
- import { InjectionToken, inject, TemplateRef, Directive, booleanAttribute, Input, ContentChild, ElementRef, NgZone, Injectable, IterableDiffers, ViewContainerRef, Component, ChangeDetectionStrategy, ViewEncapsulation, afterNextRender, ChangeDetectorRef, EventEmitter, Injector, HostAttributeToken, Output, ContentChildren, ViewChild, NgModule } from '@angular/core';
- import { Subject, BehaviorSubject, isObservable, of } from 'rxjs';
- import { takeUntil } from 'rxjs/operators';
- import { b as _VIEW_REPEATER_STRATEGY, _ as _RecycleViewRepeaterStrategy, a as _ViewRepeaterOperation } from './recycle-view-repeater-strategy-DoWdPqVw.mjs';
- import { _ as _DisposeViewRepeaterStrategy } from './dispose-view-repeater-strategy-D_JReLI1.mjs';
- import { D as Directionality } from './directionality-CBXD4hga.mjs';
- import { P as Platform } from './platform-DmdVEw_C.mjs';
- import { ViewportRuler, ScrollingModule } from './scrolling.mjs';
- import { c as coerceBooleanProperty } from './boolean-property-DaaVhX5A.mjs';
- import './element-x4z00URv.mjs';
- import './scrolling-BkvA05C8.mjs';
- import './bidi.mjs';
- /**
- * Used to provide a table to some of the sub-components without causing a circular dependency.
- * @docs-private
- */
- const CDK_TABLE = new InjectionToken('CDK_TABLE');
- /** Injection token that can be used to specify the text column options. */
- const TEXT_COLUMN_OPTIONS = new InjectionToken('text-column-options');
- /**
- * Cell definition for a CDK table.
- * Captures the template of a column's data row cell as well as cell-specific properties.
- */
- class CdkCellDef {
- /** @docs-private */
- template = inject(TemplateRef);
- constructor() { }
- static ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "19.2.6", ngImport: i0, type: CdkCellDef, deps: [], target: i0.ɵɵFactoryTarget.Directive });
- static ɵdir = i0.ɵɵngDeclareDirective({ minVersion: "14.0.0", version: "19.2.6", type: CdkCellDef, isStandalone: true, selector: "[cdkCellDef]", ngImport: i0 });
- }
- i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "19.2.6", ngImport: i0, type: CdkCellDef, decorators: [{
- type: Directive,
- args: [{
- selector: '[cdkCellDef]',
- }]
- }], ctorParameters: () => [] });
- /**
- * Header cell definition for a CDK table.
- * Captures the template of a column's header cell and as well as cell-specific properties.
- */
- class CdkHeaderCellDef {
- /** @docs-private */
- template = inject(TemplateRef);
- constructor() { }
- static ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "19.2.6", ngImport: i0, type: CdkHeaderCellDef, deps: [], target: i0.ɵɵFactoryTarget.Directive });
- static ɵdir = i0.ɵɵngDeclareDirective({ minVersion: "14.0.0", version: "19.2.6", type: CdkHeaderCellDef, isStandalone: true, selector: "[cdkHeaderCellDef]", ngImport: i0 });
- }
- i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "19.2.6", ngImport: i0, type: CdkHeaderCellDef, decorators: [{
- type: Directive,
- args: [{
- selector: '[cdkHeaderCellDef]',
- }]
- }], ctorParameters: () => [] });
- /**
- * Footer cell definition for a CDK table.
- * Captures the template of a column's footer cell and as well as cell-specific properties.
- */
- class CdkFooterCellDef {
- /** @docs-private */
- template = inject(TemplateRef);
- constructor() { }
- static ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "19.2.6", ngImport: i0, type: CdkFooterCellDef, deps: [], target: i0.ɵɵFactoryTarget.Directive });
- static ɵdir = i0.ɵɵngDeclareDirective({ minVersion: "14.0.0", version: "19.2.6", type: CdkFooterCellDef, isStandalone: true, selector: "[cdkFooterCellDef]", ngImport: i0 });
- }
- i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "19.2.6", ngImport: i0, type: CdkFooterCellDef, decorators: [{
- type: Directive,
- args: [{
- selector: '[cdkFooterCellDef]',
- }]
- }], ctorParameters: () => [] });
- /**
- * Column definition for the CDK table.
- * Defines a set of cells available for a table column.
- */
- class CdkColumnDef {
- _table = inject(CDK_TABLE, { optional: true });
- _hasStickyChanged = false;
- /** Unique name for this column. */
- get name() {
- return this._name;
- }
- set name(name) {
- this._setNameInput(name);
- }
- _name;
- /** Whether the cell is sticky. */
- get sticky() {
- return this._sticky;
- }
- set sticky(value) {
- if (value !== this._sticky) {
- this._sticky = value;
- this._hasStickyChanged = true;
- }
- }
- _sticky = false;
- /**
- * Whether this column should be sticky positioned on the end of the row. Should make sure
- * that it mimics the `CanStick` mixin such that `_hasStickyChanged` is set to true if the value
- * has been changed.
- */
- get stickyEnd() {
- return this._stickyEnd;
- }
- set stickyEnd(value) {
- if (value !== this._stickyEnd) {
- this._stickyEnd = value;
- this._hasStickyChanged = true;
- }
- }
- _stickyEnd = false;
- /** @docs-private */
- cell;
- /** @docs-private */
- headerCell;
- /** @docs-private */
- footerCell;
- /**
- * Transformed version of the column name that can be used as part of a CSS classname. Excludes
- * all non-alphanumeric characters and the special characters '-' and '_'. Any characters that
- * do not match are replaced by the '-' character.
- */
- cssClassFriendlyName;
- /**
- * Class name for cells in this column.
- * @docs-private
- */
- _columnCssClassName;
- constructor() { }
- /** Whether the sticky state has changed. */
- hasStickyChanged() {
- const hasStickyChanged = this._hasStickyChanged;
- this.resetStickyChanged();
- return hasStickyChanged;
- }
- /** Resets the sticky changed state. */
- resetStickyChanged() {
- this._hasStickyChanged = false;
- }
- /**
- * Overridable method that sets the css classes that will be added to every cell in this
- * column.
- * In the future, columnCssClassName will change from type string[] to string and this
- * will set a single string value.
- * @docs-private
- */
- _updateColumnCssClassName() {
- this._columnCssClassName = [`cdk-column-${this.cssClassFriendlyName}`];
- }
- /**
- * This has been extracted to a util because of TS 4 and VE.
- * View Engine doesn't support property rename inheritance.
- * TS 4.0 doesn't allow properties to override accessors or vice-versa.
- * @docs-private
- */
- _setNameInput(value) {
- // If the directive is set without a name (updated programmatically), then this setter will
- // trigger with an empty string and should not overwrite the programmatically set value.
- if (value) {
- this._name = value;
- this.cssClassFriendlyName = value.replace(/[^a-z0-9_-]/gi, '-');
- this._updateColumnCssClassName();
- }
- }
- static ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "19.2.6", ngImport: i0, type: CdkColumnDef, deps: [], target: i0.ɵɵFactoryTarget.Directive });
- static ɵdir = i0.ɵɵngDeclareDirective({ minVersion: "16.1.0", version: "19.2.6", type: CdkColumnDef, isStandalone: true, selector: "[cdkColumnDef]", inputs: { name: ["cdkColumnDef", "name"], sticky: ["sticky", "sticky", booleanAttribute], stickyEnd: ["stickyEnd", "stickyEnd", booleanAttribute] }, providers: [{ provide: 'MAT_SORT_HEADER_COLUMN_DEF', useExisting: CdkColumnDef }], queries: [{ propertyName: "cell", first: true, predicate: CdkCellDef, descendants: true }, { propertyName: "headerCell", first: true, predicate: CdkHeaderCellDef, descendants: true }, { propertyName: "footerCell", first: true, predicate: CdkFooterCellDef, descendants: true }], ngImport: i0 });
- }
- i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "19.2.6", ngImport: i0, type: CdkColumnDef, decorators: [{
- type: Directive,
- args: [{
- selector: '[cdkColumnDef]',
- providers: [{ provide: 'MAT_SORT_HEADER_COLUMN_DEF', useExisting: CdkColumnDef }],
- }]
- }], ctorParameters: () => [], propDecorators: { name: [{
- type: Input,
- args: ['cdkColumnDef']
- }], sticky: [{
- type: Input,
- args: [{ transform: booleanAttribute }]
- }], stickyEnd: [{
- type: Input,
- args: [{ transform: booleanAttribute }]
- }], cell: [{
- type: ContentChild,
- args: [CdkCellDef]
- }], headerCell: [{
- type: ContentChild,
- args: [CdkHeaderCellDef]
- }], footerCell: [{
- type: ContentChild,
- args: [CdkFooterCellDef]
- }] } });
- /** Base class for the cells. Adds a CSS classname that identifies the column it renders in. */
- class BaseCdkCell {
- constructor(columnDef, elementRef) {
- elementRef.nativeElement.classList.add(...columnDef._columnCssClassName);
- }
- }
- /** Header cell template container that adds the right classes and role. */
- class CdkHeaderCell extends BaseCdkCell {
- constructor() {
- super(inject(CdkColumnDef), inject(ElementRef));
- }
- static ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "19.2.6", ngImport: i0, type: CdkHeaderCell, deps: [], target: i0.ɵɵFactoryTarget.Directive });
- static ɵdir = i0.ɵɵngDeclareDirective({ minVersion: "14.0.0", version: "19.2.6", type: CdkHeaderCell, isStandalone: true, selector: "cdk-header-cell, th[cdk-header-cell]", host: { attributes: { "role": "columnheader" }, classAttribute: "cdk-header-cell" }, usesInheritance: true, ngImport: i0 });
- }
- i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "19.2.6", ngImport: i0, type: CdkHeaderCell, decorators: [{
- type: Directive,
- args: [{
- selector: 'cdk-header-cell, th[cdk-header-cell]',
- host: {
- 'class': 'cdk-header-cell',
- 'role': 'columnheader',
- },
- }]
- }], ctorParameters: () => [] });
- /** Footer cell template container that adds the right classes and role. */
- class CdkFooterCell extends BaseCdkCell {
- constructor() {
- const columnDef = inject(CdkColumnDef);
- const elementRef = inject(ElementRef);
- super(columnDef, elementRef);
- const role = columnDef._table?._getCellRole();
- if (role) {
- elementRef.nativeElement.setAttribute('role', role);
- }
- }
- static ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "19.2.6", ngImport: i0, type: CdkFooterCell, deps: [], target: i0.ɵɵFactoryTarget.Directive });
- static ɵdir = i0.ɵɵngDeclareDirective({ minVersion: "14.0.0", version: "19.2.6", type: CdkFooterCell, isStandalone: true, selector: "cdk-footer-cell, td[cdk-footer-cell]", host: { classAttribute: "cdk-footer-cell" }, usesInheritance: true, ngImport: i0 });
- }
- i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "19.2.6", ngImport: i0, type: CdkFooterCell, decorators: [{
- type: Directive,
- args: [{
- selector: 'cdk-footer-cell, td[cdk-footer-cell]',
- host: {
- 'class': 'cdk-footer-cell',
- },
- }]
- }], ctorParameters: () => [] });
- /** Cell template container that adds the right classes and role. */
- class CdkCell extends BaseCdkCell {
- constructor() {
- const columnDef = inject(CdkColumnDef);
- const elementRef = inject(ElementRef);
- super(columnDef, elementRef);
- const role = columnDef._table?._getCellRole();
- if (role) {
- elementRef.nativeElement.setAttribute('role', role);
- }
- }
- static ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "19.2.6", ngImport: i0, type: CdkCell, deps: [], target: i0.ɵɵFactoryTarget.Directive });
- static ɵdir = i0.ɵɵngDeclareDirective({ minVersion: "14.0.0", version: "19.2.6", type: CdkCell, isStandalone: true, selector: "cdk-cell, td[cdk-cell]", host: { classAttribute: "cdk-cell" }, usesInheritance: true, ngImport: i0 });
- }
- i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "19.2.6", ngImport: i0, type: CdkCell, decorators: [{
- type: Directive,
- args: [{
- selector: 'cdk-cell, td[cdk-cell]',
- host: {
- 'class': 'cdk-cell',
- },
- }]
- }], ctorParameters: () => [] });
- /**
- * @docs-private
- */
- class _Schedule {
- tasks = [];
- endTasks = [];
- }
- /** Injection token used to provide a coalesced style scheduler. */
- const _COALESCED_STYLE_SCHEDULER = new InjectionToken('_COALESCED_STYLE_SCHEDULER');
- /**
- * Allows grouping up CSSDom mutations after the current execution context.
- * This can significantly improve performance when separate consecutive functions are
- * reading from the CSSDom and then mutating it.
- *
- * @docs-private
- */
- class _CoalescedStyleScheduler {
- _currentSchedule = null;
- _ngZone = inject(NgZone);
- constructor() { }
- /**
- * Schedules the specified task to run at the end of the current VM turn.
- */
- schedule(task) {
- this._createScheduleIfNeeded();
- this._currentSchedule.tasks.push(task);
- }
- /**
- * Schedules the specified task to run after other scheduled tasks at the end of the current
- * VM turn.
- */
- scheduleEnd(task) {
- this._createScheduleIfNeeded();
- this._currentSchedule.endTasks.push(task);
- }
- _createScheduleIfNeeded() {
- if (this._currentSchedule) {
- return;
- }
- this._currentSchedule = new _Schedule();
- this._ngZone.runOutsideAngular(() =>
- // TODO(mmalerba): Scheduling this using something that runs less frequently
- // (e.g. requestAnimationFrame, setTimeout, etc.) causes noticeable jank with the column
- // resizer. We should audit the usages of schedule / scheduleEnd in that component and see
- // if we can refactor it so that we don't need to flush the tasks quite so frequently.
- queueMicrotask(() => {
- while (this._currentSchedule.tasks.length || this._currentSchedule.endTasks.length) {
- const schedule = this._currentSchedule;
- // Capture new tasks scheduled by the current set of tasks.
- this._currentSchedule = new _Schedule();
- for (const task of schedule.tasks) {
- task();
- }
- for (const task of schedule.endTasks) {
- task();
- }
- }
- this._currentSchedule = null;
- }));
- }
- static ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "19.2.6", ngImport: i0, type: _CoalescedStyleScheduler, deps: [], target: i0.ɵɵFactoryTarget.Injectable });
- static ɵprov = i0.ɵɵngDeclareInjectable({ minVersion: "12.0.0", version: "19.2.6", ngImport: i0, type: _CoalescedStyleScheduler });
- }
- i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "19.2.6", ngImport: i0, type: _CoalescedStyleScheduler, decorators: [{
- type: Injectable
- }], ctorParameters: () => [] });
- /**
- * The row template that can be used by the mat-table. Should not be used outside of the
- * material library.
- */
- const CDK_ROW_TEMPLATE = `<ng-container cdkCellOutlet></ng-container>`;
- /**
- * Base class for the CdkHeaderRowDef and CdkRowDef that handles checking their columns inputs
- * for changes and notifying the table.
- */
- class BaseRowDef {
- template = inject(TemplateRef);
- _differs = inject(IterableDiffers);
- /** The columns to be displayed on this row. */
- columns;
- /** Differ used to check if any changes were made to the columns. */
- _columnsDiffer;
- constructor() { }
- ngOnChanges(changes) {
- // Create a new columns differ if one does not yet exist. Initialize it based on initial value
- // of the columns property or an empty array if none is provided.
- if (!this._columnsDiffer) {
- const columns = (changes['columns'] && changes['columns'].currentValue) || [];
- this._columnsDiffer = this._differs.find(columns).create();
- this._columnsDiffer.diff(columns);
- }
- }
- /**
- * Returns the difference between the current columns and the columns from the last diff, or null
- * if there is no difference.
- */
- getColumnsDiff() {
- return this._columnsDiffer.diff(this.columns);
- }
- /** Gets this row def's relevant cell template from the provided column def. */
- extractCellTemplate(column) {
- if (this instanceof CdkHeaderRowDef) {
- return column.headerCell.template;
- }
- if (this instanceof CdkFooterRowDef) {
- return column.footerCell.template;
- }
- else {
- return column.cell.template;
- }
- }
- static ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "19.2.6", ngImport: i0, type: BaseRowDef, deps: [], target: i0.ɵɵFactoryTarget.Directive });
- static ɵdir = i0.ɵɵngDeclareDirective({ minVersion: "14.0.0", version: "19.2.6", type: BaseRowDef, isStandalone: true, usesOnChanges: true, ngImport: i0 });
- }
- i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "19.2.6", ngImport: i0, type: BaseRowDef, decorators: [{
- type: Directive
- }], ctorParameters: () => [] });
- /**
- * Header row definition for the CDK table.
- * Captures the header row's template and other header properties such as the columns to display.
- */
- class CdkHeaderRowDef extends BaseRowDef {
- _table = inject(CDK_TABLE, { optional: true });
- _hasStickyChanged = false;
- /** Whether the row is sticky. */
- get sticky() {
- return this._sticky;
- }
- set sticky(value) {
- if (value !== this._sticky) {
- this._sticky = value;
- this._hasStickyChanged = true;
- }
- }
- _sticky = false;
- constructor() {
- super(inject(TemplateRef), inject(IterableDiffers));
- }
- // Prerender fails to recognize that ngOnChanges in a part of this class through inheritance.
- // Explicitly define it so that the method is called as part of the Angular lifecycle.
- ngOnChanges(changes) {
- super.ngOnChanges(changes);
- }
- /** Whether the sticky state has changed. */
- hasStickyChanged() {
- const hasStickyChanged = this._hasStickyChanged;
- this.resetStickyChanged();
- return hasStickyChanged;
- }
- /** Resets the sticky changed state. */
- resetStickyChanged() {
- this._hasStickyChanged = false;
- }
- static ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "19.2.6", ngImport: i0, type: CdkHeaderRowDef, deps: [], target: i0.ɵɵFactoryTarget.Directive });
- static ɵdir = i0.ɵɵngDeclareDirective({ minVersion: "16.1.0", version: "19.2.6", type: CdkHeaderRowDef, isStandalone: true, selector: "[cdkHeaderRowDef]", inputs: { columns: ["cdkHeaderRowDef", "columns"], sticky: ["cdkHeaderRowDefSticky", "sticky", booleanAttribute] }, usesInheritance: true, usesOnChanges: true, ngImport: i0 });
- }
- i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "19.2.6", ngImport: i0, type: CdkHeaderRowDef, decorators: [{
- type: Directive,
- args: [{
- selector: '[cdkHeaderRowDef]',
- inputs: [{ name: 'columns', alias: 'cdkHeaderRowDef' }],
- }]
- }], ctorParameters: () => [], propDecorators: { sticky: [{
- type: Input,
- args: [{ alias: 'cdkHeaderRowDefSticky', transform: booleanAttribute }]
- }] } });
- /**
- * Footer row definition for the CDK table.
- * Captures the footer row's template and other footer properties such as the columns to display.
- */
- class CdkFooterRowDef extends BaseRowDef {
- _table = inject(CDK_TABLE, { optional: true });
- _hasStickyChanged = false;
- /** Whether the row is sticky. */
- get sticky() {
- return this._sticky;
- }
- set sticky(value) {
- if (value !== this._sticky) {
- this._sticky = value;
- this._hasStickyChanged = true;
- }
- }
- _sticky = false;
- constructor() {
- super(inject(TemplateRef), inject(IterableDiffers));
- }
- // Prerender fails to recognize that ngOnChanges in a part of this class through inheritance.
- // Explicitly define it so that the method is called as part of the Angular lifecycle.
- ngOnChanges(changes) {
- super.ngOnChanges(changes);
- }
- /** Whether the sticky state has changed. */
- hasStickyChanged() {
- const hasStickyChanged = this._hasStickyChanged;
- this.resetStickyChanged();
- return hasStickyChanged;
- }
- /** Resets the sticky changed state. */
- resetStickyChanged() {
- this._hasStickyChanged = false;
- }
- static ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "19.2.6", ngImport: i0, type: CdkFooterRowDef, deps: [], target: i0.ɵɵFactoryTarget.Directive });
- static ɵdir = i0.ɵɵngDeclareDirective({ minVersion: "16.1.0", version: "19.2.6", type: CdkFooterRowDef, isStandalone: true, selector: "[cdkFooterRowDef]", inputs: { columns: ["cdkFooterRowDef", "columns"], sticky: ["cdkFooterRowDefSticky", "sticky", booleanAttribute] }, usesInheritance: true, usesOnChanges: true, ngImport: i0 });
- }
- i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "19.2.6", ngImport: i0, type: CdkFooterRowDef, decorators: [{
- type: Directive,
- args: [{
- selector: '[cdkFooterRowDef]',
- inputs: [{ name: 'columns', alias: 'cdkFooterRowDef' }],
- }]
- }], ctorParameters: () => [], propDecorators: { sticky: [{
- type: Input,
- args: [{ alias: 'cdkFooterRowDefSticky', transform: booleanAttribute }]
- }] } });
- /**
- * Data row definition for the CDK table.
- * Captures the header row's template and other row properties such as the columns to display and
- * a when predicate that describes when this row should be used.
- */
- class CdkRowDef extends BaseRowDef {
- _table = inject(CDK_TABLE, { optional: true });
- /**
- * Function that should return true if this row template should be used for the provided index
- * and row data. If left undefined, this row will be considered the default row template to use
- * when no other when functions return true for the data.
- * For every row, there must be at least one when function that passes or an undefined to default.
- */
- when;
- constructor() {
- // TODO(andrewseguin): Add an input for providing a switch function to determine
- // if this template should be used.
- super(inject(TemplateRef), inject(IterableDiffers));
- }
- static ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "19.2.6", ngImport: i0, type: CdkRowDef, deps: [], target: i0.ɵɵFactoryTarget.Directive });
- static ɵdir = i0.ɵɵngDeclareDirective({ minVersion: "14.0.0", version: "19.2.6", type: CdkRowDef, isStandalone: true, selector: "[cdkRowDef]", inputs: { columns: ["cdkRowDefColumns", "columns"], when: ["cdkRowDefWhen", "when"] }, usesInheritance: true, ngImport: i0 });
- }
- i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "19.2.6", ngImport: i0, type: CdkRowDef, decorators: [{
- type: Directive,
- args: [{
- selector: '[cdkRowDef]',
- inputs: [
- { name: 'columns', alias: 'cdkRowDefColumns' },
- { name: 'when', alias: 'cdkRowDefWhen' },
- ],
- }]
- }], ctorParameters: () => [] });
- /**
- * Outlet for rendering cells inside of a row or header row.
- * @docs-private
- */
- class CdkCellOutlet {
- _viewContainer = inject(ViewContainerRef);
- /** The ordered list of cells to render within this outlet's view container */
- cells;
- /** The data context to be provided to each cell */
- context;
- /**
- * Static property containing the latest constructed instance of this class.
- * Used by the CDK table when each CdkHeaderRow and CdkRow component is created using
- * createEmbeddedView. After one of these components are created, this property will provide
- * a handle to provide that component's cells and context. After init, the CdkCellOutlet will
- * construct the cells with the provided context.
- */
- static mostRecentCellOutlet = null;
- constructor() {
- CdkCellOutlet.mostRecentCellOutlet = this;
- }
- ngOnDestroy() {
- // If this was the last outlet being rendered in the view, remove the reference
- // from the static property after it has been destroyed to avoid leaking memory.
- if (CdkCellOutlet.mostRecentCellOutlet === this) {
- CdkCellOutlet.mostRecentCellOutlet = null;
- }
- }
- static ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "19.2.6", ngImport: i0, type: CdkCellOutlet, deps: [], target: i0.ɵɵFactoryTarget.Directive });
- static ɵdir = i0.ɵɵngDeclareDirective({ minVersion: "14.0.0", version: "19.2.6", type: CdkCellOutlet, isStandalone: true, selector: "[cdkCellOutlet]", ngImport: i0 });
- }
- i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "19.2.6", ngImport: i0, type: CdkCellOutlet, decorators: [{
- type: Directive,
- args: [{
- selector: '[cdkCellOutlet]',
- }]
- }], ctorParameters: () => [] });
- /** Header template container that contains the cell outlet. Adds the right class and role. */
- class CdkHeaderRow {
- static ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "19.2.6", ngImport: i0, type: CdkHeaderRow, deps: [], target: i0.ɵɵFactoryTarget.Component });
- static ɵcmp = i0.ɵɵngDeclareComponent({ minVersion: "14.0.0", version: "19.2.6", type: CdkHeaderRow, isStandalone: true, selector: "cdk-header-row, tr[cdk-header-row]", host: { attributes: { "role": "row" }, classAttribute: "cdk-header-row" }, ngImport: i0, template: "<ng-container cdkCellOutlet></ng-container>", isInline: true, dependencies: [{ kind: "directive", type: CdkCellOutlet, selector: "[cdkCellOutlet]" }], changeDetection: i0.ChangeDetectionStrategy.Default, encapsulation: i0.ViewEncapsulation.None });
- }
- i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "19.2.6", ngImport: i0, type: CdkHeaderRow, decorators: [{
- type: Component,
- args: [{
- selector: 'cdk-header-row, tr[cdk-header-row]',
- template: CDK_ROW_TEMPLATE,
- host: {
- 'class': 'cdk-header-row',
- 'role': 'row',
- },
- // See note on CdkTable for explanation on why this uses the default change detection strategy.
- // tslint:disable-next-line:validate-decorators
- changeDetection: ChangeDetectionStrategy.Default,
- encapsulation: ViewEncapsulation.None,
- imports: [CdkCellOutlet],
- }]
- }] });
- /** Footer template container that contains the cell outlet. Adds the right class and role. */
- class CdkFooterRow {
- static ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "19.2.6", ngImport: i0, type: CdkFooterRow, deps: [], target: i0.ɵɵFactoryTarget.Component });
- static ɵcmp = i0.ɵɵngDeclareComponent({ minVersion: "14.0.0", version: "19.2.6", type: CdkFooterRow, isStandalone: true, selector: "cdk-footer-row, tr[cdk-footer-row]", host: { attributes: { "role": "row" }, classAttribute: "cdk-footer-row" }, ngImport: i0, template: "<ng-container cdkCellOutlet></ng-container>", isInline: true, dependencies: [{ kind: "directive", type: CdkCellOutlet, selector: "[cdkCellOutlet]" }], changeDetection: i0.ChangeDetectionStrategy.Default, encapsulation: i0.ViewEncapsulation.None });
- }
- i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "19.2.6", ngImport: i0, type: CdkFooterRow, decorators: [{
- type: Component,
- args: [{
- selector: 'cdk-footer-row, tr[cdk-footer-row]',
- template: CDK_ROW_TEMPLATE,
- host: {
- 'class': 'cdk-footer-row',
- 'role': 'row',
- },
- // See note on CdkTable for explanation on why this uses the default change detection strategy.
- // tslint:disable-next-line:validate-decorators
- changeDetection: ChangeDetectionStrategy.Default,
- encapsulation: ViewEncapsulation.None,
- imports: [CdkCellOutlet],
- }]
- }] });
- /** Data row template container that contains the cell outlet. Adds the right class and role. */
- class CdkRow {
- static ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "19.2.6", ngImport: i0, type: CdkRow, deps: [], target: i0.ɵɵFactoryTarget.Component });
- static ɵcmp = i0.ɵɵngDeclareComponent({ minVersion: "14.0.0", version: "19.2.6", type: CdkRow, isStandalone: true, selector: "cdk-row, tr[cdk-row]", host: { attributes: { "role": "row" }, classAttribute: "cdk-row" }, ngImport: i0, template: "<ng-container cdkCellOutlet></ng-container>", isInline: true, dependencies: [{ kind: "directive", type: CdkCellOutlet, selector: "[cdkCellOutlet]" }], changeDetection: i0.ChangeDetectionStrategy.Default, encapsulation: i0.ViewEncapsulation.None });
- }
- i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "19.2.6", ngImport: i0, type: CdkRow, decorators: [{
- type: Component,
- args: [{
- selector: 'cdk-row, tr[cdk-row]',
- template: CDK_ROW_TEMPLATE,
- host: {
- 'class': 'cdk-row',
- 'role': 'row',
- },
- // See note on CdkTable for explanation on why this uses the default change detection strategy.
- // tslint:disable-next-line:validate-decorators
- changeDetection: ChangeDetectionStrategy.Default,
- encapsulation: ViewEncapsulation.None,
- imports: [CdkCellOutlet],
- }]
- }] });
- /** Row that can be used to display a message when no data is shown in the table. */
- class CdkNoDataRow {
- templateRef = inject(TemplateRef);
- _contentClassName = 'cdk-no-data-row';
- constructor() { }
- static ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "19.2.6", ngImport: i0, type: CdkNoDataRow, deps: [], target: i0.ɵɵFactoryTarget.Directive });
- static ɵdir = i0.ɵɵngDeclareDirective({ minVersion: "14.0.0", version: "19.2.6", type: CdkNoDataRow, isStandalone: true, selector: "ng-template[cdkNoDataRow]", ngImport: i0 });
- }
- i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "19.2.6", ngImport: i0, type: CdkNoDataRow, decorators: [{
- type: Directive,
- args: [{
- selector: 'ng-template[cdkNoDataRow]',
- }]
- }], ctorParameters: () => [] });
- /**
- * Directions that can be used when setting sticky positioning.
- * @docs-private
- */
- /**
- * List of all possible directions that can be used for sticky positioning.
- * @docs-private
- */
- const STICKY_DIRECTIONS = ['top', 'bottom', 'left', 'right'];
- /**
- * Applies and removes sticky positioning styles to the `CdkTable` rows and columns cells.
- * @docs-private
- */
- class StickyStyler {
- _isNativeHtmlTable;
- _stickCellCss;
- direction;
- _coalescedStyleScheduler;
- _isBrowser;
- _needsPositionStickyOnElement;
- _positionListener;
- _tableInjector;
- _elemSizeCache = new WeakMap();
- _resizeObserver = globalThis?.ResizeObserver
- ? new globalThis.ResizeObserver(entries => this._updateCachedSizes(entries))
- : null;
- _updatedStickyColumnsParamsToReplay = [];
- _stickyColumnsReplayTimeout = null;
- _cachedCellWidths = [];
- _borderCellCss;
- _destroyed = false;
- /**
- * @param _isNativeHtmlTable Whether the sticky logic should be based on a table
- * that uses the native `<table>` element.
- * @param _stickCellCss The CSS class that will be applied to every row/cell that has
- * sticky positioning applied.
- * @param direction The directionality context of the table (ltr/rtl); affects column positioning
- * by reversing left/right positions.
- * @param _isBrowser Whether the table is currently being rendered on the server or the client.
- * @param _needsPositionStickyOnElement Whether we need to specify position: sticky on cells
- * using inline styles. If false, it is assumed that position: sticky is included in
- * the component stylesheet for _stickCellCss.
- * @param _positionListener A listener that is notified of changes to sticky rows/columns
- * and their dimensions.
- * @param _tableInjector The table's Injector.
- */
- constructor(_isNativeHtmlTable, _stickCellCss, direction, _coalescedStyleScheduler, _isBrowser = true, _needsPositionStickyOnElement = true, _positionListener, _tableInjector) {
- this._isNativeHtmlTable = _isNativeHtmlTable;
- this._stickCellCss = _stickCellCss;
- this.direction = direction;
- this._coalescedStyleScheduler = _coalescedStyleScheduler;
- this._isBrowser = _isBrowser;
- this._needsPositionStickyOnElement = _needsPositionStickyOnElement;
- this._positionListener = _positionListener;
- this._tableInjector = _tableInjector;
- this._borderCellCss = {
- 'top': `${_stickCellCss}-border-elem-top`,
- 'bottom': `${_stickCellCss}-border-elem-bottom`,
- 'left': `${_stickCellCss}-border-elem-left`,
- 'right': `${_stickCellCss}-border-elem-right`,
- };
- }
- /**
- * Clears the sticky positioning styles from the row and its cells by resetting the `position`
- * style, setting the zIndex to 0, and unsetting each provided sticky direction.
- * @param rows The list of rows that should be cleared from sticking in the provided directions
- * @param stickyDirections The directions that should no longer be set as sticky on the rows.
- */
- clearStickyPositioning(rows, stickyDirections) {
- if (stickyDirections.includes('left') || stickyDirections.includes('right')) {
- this._removeFromStickyColumnReplayQueue(rows);
- }
- const elementsToClear = [];
- for (const row of rows) {
- // If the row isn't an element (e.g. if it's an `ng-container`),
- // it won't have inline styles or `children` so we skip it.
- if (row.nodeType !== row.ELEMENT_NODE) {
- continue;
- }
- elementsToClear.push(row, ...Array.from(row.children));
- }
- // Coalesce with sticky row/column updates (and potentially other changes like column resize).
- this._afterNextRender({
- write: () => {
- for (const element of elementsToClear) {
- this._removeStickyStyle(element, stickyDirections);
- }
- },
- });
- }
- /**
- * Applies sticky left and right positions to the cells of each row according to the sticky
- * states of the rendered column definitions.
- * @param rows The rows that should have its set of cells stuck according to the sticky states.
- * @param stickyStartStates A list of boolean states where each state represents whether the cell
- * in this index position should be stuck to the start of the row.
- * @param stickyEndStates A list of boolean states where each state represents whether the cell
- * in this index position should be stuck to the end of the row.
- * @param recalculateCellWidths Whether the sticky styler should recalculate the width of each
- * column cell. If `false` cached widths will be used instead.
- * @param replay Whether to enqueue this call for replay after a ResizeObserver update.
- */
- updateStickyColumns(rows, stickyStartStates, stickyEndStates, recalculateCellWidths = true, replay = true) {
- // Don't cache any state if none of the columns are sticky.
- if (!rows.length ||
- !this._isBrowser ||
- !(stickyStartStates.some(state => state) || stickyEndStates.some(state => state))) {
- this._positionListener?.stickyColumnsUpdated({ sizes: [] });
- this._positionListener?.stickyEndColumnsUpdated({ sizes: [] });
- return;
- }
- // Coalesce with sticky row updates (and potentially other changes like column resize).
- const firstRow = rows[0];
- const numCells = firstRow.children.length;
- const isRtl = this.direction === 'rtl';
- const start = isRtl ? 'right' : 'left';
- const end = isRtl ? 'left' : 'right';
- const lastStickyStart = stickyStartStates.lastIndexOf(true);
- const firstStickyEnd = stickyEndStates.indexOf(true);
- let cellWidths;
- let startPositions;
- let endPositions;
- if (replay) {
- this._updateStickyColumnReplayQueue({
- rows: [...rows],
- stickyStartStates: [...stickyStartStates],
- stickyEndStates: [...stickyEndStates],
- });
- }
- this._afterNextRender({
- earlyRead: () => {
- cellWidths = this._getCellWidths(firstRow, recalculateCellWidths);
- startPositions = this._getStickyStartColumnPositions(cellWidths, stickyStartStates);
- endPositions = this._getStickyEndColumnPositions(cellWidths, stickyEndStates);
- },
- write: () => {
- for (const row of rows) {
- for (let i = 0; i < numCells; i++) {
- const cell = row.children[i];
- if (stickyStartStates[i]) {
- this._addStickyStyle(cell, start, startPositions[i], i === lastStickyStart);
- }
- if (stickyEndStates[i]) {
- this._addStickyStyle(cell, end, endPositions[i], i === firstStickyEnd);
- }
- }
- }
- if (this._positionListener && cellWidths.some(w => !!w)) {
- this._positionListener.stickyColumnsUpdated({
- sizes: lastStickyStart === -1
- ? []
- : cellWidths
- .slice(0, lastStickyStart + 1)
- .map((width, index) => (stickyStartStates[index] ? width : null)),
- });
- this._positionListener.stickyEndColumnsUpdated({
- sizes: firstStickyEnd === -1
- ? []
- : cellWidths
- .slice(firstStickyEnd)
- .map((width, index) => (stickyEndStates[index + firstStickyEnd] ? width : null))
- .reverse(),
- });
- }
- },
- });
- }
- /**
- * Applies sticky positioning to the row's cells if using the native table layout, and to the
- * row itself otherwise.
- * @param rowsToStick The list of rows that should be stuck according to their corresponding
- * sticky state and to the provided top or bottom position.
- * @param stickyStates A list of boolean states where each state represents whether the row
- * should be stuck in the particular top or bottom position.
- * @param position The position direction in which the row should be stuck if that row should be
- * sticky.
- *
- */
- stickRows(rowsToStick, stickyStates, position) {
- // Since we can't measure the rows on the server, we can't stick the rows properly.
- if (!this._isBrowser) {
- return;
- }
- // If positioning the rows to the bottom, reverse their order when evaluating the sticky
- // position such that the last row stuck will be "bottom: 0px" and so on. Note that the
- // sticky states need to be reversed as well.
- const rows = position === 'bottom' ? rowsToStick.slice().reverse() : rowsToStick;
- const states = position === 'bottom' ? stickyStates.slice().reverse() : stickyStates;
- // Measure row heights all at once before adding sticky styles to reduce layout thrashing.
- const stickyOffsets = [];
- const stickyCellHeights = [];
- const elementsToStick = [];
- // Coalesce with other sticky row updates (top/bottom), sticky columns updates
- // (and potentially other changes like column resize).
- this._afterNextRender({
- earlyRead: () => {
- for (let rowIndex = 0, stickyOffset = 0; rowIndex < rows.length; rowIndex++) {
- if (!states[rowIndex]) {
- continue;
- }
- stickyOffsets[rowIndex] = stickyOffset;
- const row = rows[rowIndex];
- elementsToStick[rowIndex] = this._isNativeHtmlTable
- ? Array.from(row.children)
- : [row];
- const height = this._retrieveElementSize(row).height;
- stickyOffset += height;
- stickyCellHeights[rowIndex] = height;
- }
- },
- write: () => {
- const borderedRowIndex = states.lastIndexOf(true);
- for (let rowIndex = 0; rowIndex < rows.length; rowIndex++) {
- if (!states[rowIndex]) {
- continue;
- }
- const offset = stickyOffsets[rowIndex];
- const isBorderedRowIndex = rowIndex === borderedRowIndex;
- for (const element of elementsToStick[rowIndex]) {
- this._addStickyStyle(element, position, offset, isBorderedRowIndex);
- }
- }
- if (position === 'top') {
- this._positionListener?.stickyHeaderRowsUpdated({
- sizes: stickyCellHeights,
- offsets: stickyOffsets,
- elements: elementsToStick,
- });
- }
- else {
- this._positionListener?.stickyFooterRowsUpdated({
- sizes: stickyCellHeights,
- offsets: stickyOffsets,
- elements: elementsToStick,
- });
- }
- },
- });
- }
- /**
- * When using the native table in Safari, sticky footer cells do not stick. The only way to stick
- * footer rows is to apply sticky styling to the tfoot container. This should only be done if
- * all footer rows are sticky. If not all footer rows are sticky, remove sticky positioning from
- * the tfoot element.
- */
- updateStickyFooterContainer(tableElement, stickyStates) {
- if (!this._isNativeHtmlTable) {
- return;
- }
- // Coalesce with other sticky updates (and potentially other changes like column resize).
- this._afterNextRender({
- write: () => {
- const tfoot = tableElement.querySelector('tfoot');
- if (tfoot) {
- if (stickyStates.some(state => !state)) {
- this._removeStickyStyle(tfoot, ['bottom']);
- }
- else {
- this._addStickyStyle(tfoot, 'bottom', 0, false);
- }
- }
- },
- });
- }
- /** Triggered by the table's OnDestroy hook. */
- destroy() {
- if (this._stickyColumnsReplayTimeout) {
- clearTimeout(this._stickyColumnsReplayTimeout);
- }
- this._resizeObserver?.disconnect();
- this._destroyed = true;
- }
- /**
- * Removes the sticky style on the element by removing the sticky cell CSS class, re-evaluating
- * the zIndex, removing each of the provided sticky directions, and removing the
- * sticky position if there are no more directions.
- */
- _removeStickyStyle(element, stickyDirections) {
- if (!element.classList.contains(this._stickCellCss)) {
- return;
- }
- for (const dir of stickyDirections) {
- element.style[dir] = '';
- element.classList.remove(this._borderCellCss[dir]);
- }
- // If the element no longer has any more sticky directions, remove sticky positioning and
- // the sticky CSS class.
- // Short-circuit checking element.style[dir] for stickyDirections as they
- // were already removed above.
- const hasDirection = STICKY_DIRECTIONS.some(dir => stickyDirections.indexOf(dir) === -1 && element.style[dir]);
- if (hasDirection) {
- element.style.zIndex = this._getCalculatedZIndex(element);
- }
- else {
- // When not hasDirection, _getCalculatedZIndex will always return ''.
- element.style.zIndex = '';
- if (this._needsPositionStickyOnElement) {
- element.style.position = '';
- }
- element.classList.remove(this._stickCellCss);
- }
- }
- /**
- * Adds the sticky styling to the element by adding the sticky style class, changing position
- * to be sticky (and -webkit-sticky), setting the appropriate zIndex, and adding a sticky
- * direction and value.
- */
- _addStickyStyle(element, dir, dirValue, isBorderElement) {
- element.classList.add(this._stickCellCss);
- if (isBorderElement) {
- element.classList.add(this._borderCellCss[dir]);
- }
- element.style[dir] = `${dirValue}px`;
- element.style.zIndex = this._getCalculatedZIndex(element);
- if (this._needsPositionStickyOnElement) {
- element.style.cssText += 'position: -webkit-sticky; position: sticky; ';
- }
- }
- /**
- * Calculate what the z-index should be for the element, depending on what directions (top,
- * bottom, left, right) have been set. It should be true that elements with a top direction
- * should have the highest index since these are elements like a table header. If any of those
- * elements are also sticky in another direction, then they should appear above other elements
- * that are only sticky top (e.g. a sticky column on a sticky header). Bottom-sticky elements
- * (e.g. footer rows) should then be next in the ordering such that they are below the header
- * but above any non-sticky elements. Finally, left/right sticky elements (e.g. sticky columns)
- * should minimally increment so that they are above non-sticky elements but below top and bottom
- * elements.
- */
- _getCalculatedZIndex(element) {
- const zIndexIncrements = {
- top: 100,
- bottom: 10,
- left: 1,
- right: 1,
- };
- let zIndex = 0;
- // Use `Iterable` instead of `Array` because TypeScript, as of 3.6.3,
- // loses the array generic type in the `for of`. But we *also* have to use `Array` because
- // typescript won't iterate over an `Iterable` unless you compile with `--downlevelIteration`
- for (const dir of STICKY_DIRECTIONS) {
- if (element.style[dir]) {
- zIndex += zIndexIncrements[dir];
- }
- }
- return zIndex ? `${zIndex}` : '';
- }
- /** Gets the widths for each cell in the provided row. */
- _getCellWidths(row, recalculateCellWidths = true) {
- if (!recalculateCellWidths && this._cachedCellWidths.length) {
- return this._cachedCellWidths;
- }
- const cellWidths = [];
- const firstRowCells = row.children;
- for (let i = 0; i < firstRowCells.length; i++) {
- const cell = firstRowCells[i];
- cellWidths.push(this._retrieveElementSize(cell).width);
- }
- this._cachedCellWidths = cellWidths;
- return cellWidths;
- }
- /**
- * Determines the left and right positions of each sticky column cell, which will be the
- * accumulation of all sticky column cell widths to the left and right, respectively.
- * Non-sticky cells do not need to have a value set since their positions will not be applied.
- */
- _getStickyStartColumnPositions(widths, stickyStates) {
- const positions = [];
- let nextPosition = 0;
- for (let i = 0; i < widths.length; i++) {
- if (stickyStates[i]) {
- positions[i] = nextPosition;
- nextPosition += widths[i];
- }
- }
- return positions;
- }
- /**
- * Determines the left and right positions of each sticky column cell, which will be the
- * accumulation of all sticky column cell widths to the left and right, respectively.
- * Non-sticky cells do not need to have a value set since their positions will not be applied.
- */
- _getStickyEndColumnPositions(widths, stickyStates) {
- const positions = [];
- let nextPosition = 0;
- for (let i = widths.length; i > 0; i--) {
- if (stickyStates[i]) {
- positions[i] = nextPosition;
- nextPosition += widths[i];
- }
- }
- return positions;
- }
- /**
- * Retreives the most recently observed size of the specified element from the cache, or
- * meaures it directly if not yet cached.
- */
- _retrieveElementSize(element) {
- const cachedSize = this._elemSizeCache.get(element);
- if (cachedSize) {
- return cachedSize;
- }
- const clientRect = element.getBoundingClientRect();
- const size = { width: clientRect.width, height: clientRect.height };
- if (!this._resizeObserver) {
- return size;
- }
- this._elemSizeCache.set(element, size);
- this._resizeObserver.observe(element, { box: 'border-box' });
- return size;
- }
- /**
- * Conditionally enqueue the requested sticky update and clear previously queued updates
- * for the same rows.
- */
- _updateStickyColumnReplayQueue(params) {
- this._removeFromStickyColumnReplayQueue(params.rows);
- // No need to replay if a flush is pending.
- if (!this._stickyColumnsReplayTimeout) {
- this._updatedStickyColumnsParamsToReplay.push(params);
- }
- }
- /** Remove updates for the specified rows from the queue. */
- _removeFromStickyColumnReplayQueue(rows) {
- const rowsSet = new Set(rows);
- for (const update of this._updatedStickyColumnsParamsToReplay) {
- update.rows = update.rows.filter(row => !rowsSet.has(row));
- }
- this._updatedStickyColumnsParamsToReplay = this._updatedStickyColumnsParamsToReplay.filter(update => !!update.rows.length);
- }
- /** Update _elemSizeCache with the observed sizes. */
- _updateCachedSizes(entries) {
- let needsColumnUpdate = false;
- for (const entry of entries) {
- const newEntry = entry.borderBoxSize?.length
- ? {
- width: entry.borderBoxSize[0].inlineSize,
- height: entry.borderBoxSize[0].blockSize,
- }
- : {
- width: entry.contentRect.width,
- height: entry.contentRect.height,
- };
- if (newEntry.width !== this._elemSizeCache.get(entry.target)?.width &&
- isCell(entry.target)) {
- needsColumnUpdate = true;
- }
- this._elemSizeCache.set(entry.target, newEntry);
- }
- if (needsColumnUpdate && this._updatedStickyColumnsParamsToReplay.length) {
- if (this._stickyColumnsReplayTimeout) {
- clearTimeout(this._stickyColumnsReplayTimeout);
- }
- this._stickyColumnsReplayTimeout = setTimeout(() => {
- if (this._destroyed) {
- return;
- }
- for (const update of this._updatedStickyColumnsParamsToReplay) {
- this.updateStickyColumns(update.rows, update.stickyStartStates, update.stickyEndStates, true, false);
- }
- this._updatedStickyColumnsParamsToReplay = [];
- this._stickyColumnsReplayTimeout = null;
- }, 0);
- }
- }
- /**
- * Invoke afterNextRender with the table's injector, falling back to CoalescedStyleScheduler
- * if the injector was not provided.
- */
- _afterNextRender(spec) {
- if (this._tableInjector) {
- afterNextRender(spec, { injector: this._tableInjector });
- }
- else {
- this._coalescedStyleScheduler.schedule(() => {
- spec.earlyRead?.();
- spec.write();
- });
- }
- }
- }
- function isCell(element) {
- return ['cdk-cell', 'cdk-header-cell', 'cdk-footer-cell'].some(klass => element.classList.contains(klass));
- }
- /**
- * Returns an error to be thrown when attempting to find an nonexistent column.
- * @param id Id whose lookup failed.
- * @docs-private
- */
- function getTableUnknownColumnError(id) {
- return Error(`Could not find column with id "${id}".`);
- }
- /**
- * Returns an error to be thrown when two column definitions have the same name.
- * @docs-private
- */
- function getTableDuplicateColumnNameError(name) {
- return Error(`Duplicate column definition name provided: "${name}".`);
- }
- /**
- * Returns an error to be thrown when there are multiple rows that are missing a when function.
- * @docs-private
- */
- function getTableMultipleDefaultRowDefsError() {
- return Error(`There can only be one default row without a when predicate function.`);
- }
- /**
- * Returns an error to be thrown when there are no matching row defs for a particular set of data.
- * @docs-private
- */
- function getTableMissingMatchingRowDefError(data) {
- return Error(`Could not find a matching row definition for the` +
- `provided row data: ${JSON.stringify(data)}`);
- }
- /**
- * Returns an error to be thrown when there is no row definitions present in the content.
- * @docs-private
- */
- function getTableMissingRowDefsError() {
- return Error('Missing definitions for header, footer, and row; ' +
- 'cannot determine which columns should be rendered.');
- }
- /**
- * Returns an error to be thrown when the data source does not match the compatible types.
- * @docs-private
- */
- function getTableUnknownDataSourceError() {
- return Error(`Provided data source did not match an array, Observable, or DataSource`);
- }
- /**
- * Returns an error to be thrown when the text column cannot find a parent table to inject.
- * @docs-private
- */
- function getTableTextColumnMissingParentTableError() {
- return Error(`Text column could not find a parent table for registration.`);
- }
- /**
- * Returns an error to be thrown when a table text column doesn't have a name.
- * @docs-private
- */
- function getTableTextColumnMissingNameError() {
- return Error(`Table text column must have a name.`);
- }
- /** The injection token used to specify the StickyPositioningListener. */
- const STICKY_POSITIONING_LISTENER = new InjectionToken('CDK_SPL');
- /**
- * Enables the recycle view repeater strategy, which reduces rendering latency. Not compatible with
- * tables that animate rows.
- */
- class CdkRecycleRows {
- static ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "19.2.6", ngImport: i0, type: CdkRecycleRows, deps: [], target: i0.ɵɵFactoryTarget.Directive });
- static ɵdir = i0.ɵɵngDeclareDirective({ minVersion: "14.0.0", version: "19.2.6", type: CdkRecycleRows, isStandalone: true, selector: "cdk-table[recycleRows], table[cdk-table][recycleRows]", providers: [{ provide: _VIEW_REPEATER_STRATEGY, useClass: _RecycleViewRepeaterStrategy }], ngImport: i0 });
- }
- i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "19.2.6", ngImport: i0, type: CdkRecycleRows, decorators: [{
- type: Directive,
- args: [{
- selector: 'cdk-table[recycleRows], table[cdk-table][recycleRows]',
- providers: [{ provide: _VIEW_REPEATER_STRATEGY, useClass: _RecycleViewRepeaterStrategy }],
- }]
- }] });
- /**
- * Provides a handle for the table to grab the view container's ng-container to insert data rows.
- * @docs-private
- */
- class DataRowOutlet {
- viewContainer = inject(ViewContainerRef);
- elementRef = inject(ElementRef);
- constructor() {
- const table = inject(CDK_TABLE);
- table._rowOutlet = this;
- table._outletAssigned();
- }
- static ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "19.2.6", ngImport: i0, type: DataRowOutlet, deps: [], target: i0.ɵɵFactoryTarget.Directive });
- static ɵdir = i0.ɵɵngDeclareDirective({ minVersion: "14.0.0", version: "19.2.6", type: DataRowOutlet, isStandalone: true, selector: "[rowOutlet]", ngImport: i0 });
- }
- i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "19.2.6", ngImport: i0, type: DataRowOutlet, decorators: [{
- type: Directive,
- args: [{
- selector: '[rowOutlet]',
- }]
- }], ctorParameters: () => [] });
- /**
- * Provides a handle for the table to grab the view container's ng-container to insert the header.
- * @docs-private
- */
- class HeaderRowOutlet {
- viewContainer = inject(ViewContainerRef);
- elementRef = inject(ElementRef);
- constructor() {
- const table = inject(CDK_TABLE);
- table._headerRowOutlet = this;
- table._outletAssigned();
- }
- static ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "19.2.6", ngImport: i0, type: HeaderRowOutlet, deps: [], target: i0.ɵɵFactoryTarget.Directive });
- static ɵdir = i0.ɵɵngDeclareDirective({ minVersion: "14.0.0", version: "19.2.6", type: HeaderRowOutlet, isStandalone: true, selector: "[headerRowOutlet]", ngImport: i0 });
- }
- i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "19.2.6", ngImport: i0, type: HeaderRowOutlet, decorators: [{
- type: Directive,
- args: [{
- selector: '[headerRowOutlet]',
- }]
- }], ctorParameters: () => [] });
- /**
- * Provides a handle for the table to grab the view container's ng-container to insert the footer.
- * @docs-private
- */
- class FooterRowOutlet {
- viewContainer = inject(ViewContainerRef);
- elementRef = inject(ElementRef);
- constructor() {
- const table = inject(CDK_TABLE);
- table._footerRowOutlet = this;
- table._outletAssigned();
- }
- static ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "19.2.6", ngImport: i0, type: FooterRowOutlet, deps: [], target: i0.ɵɵFactoryTarget.Directive });
- static ɵdir = i0.ɵɵngDeclareDirective({ minVersion: "14.0.0", version: "19.2.6", type: FooterRowOutlet, isStandalone: true, selector: "[footerRowOutlet]", ngImport: i0 });
- }
- i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "19.2.6", ngImport: i0, type: FooterRowOutlet, decorators: [{
- type: Directive,
- args: [{
- selector: '[footerRowOutlet]',
- }]
- }], ctorParameters: () => [] });
- /**
- * Provides a handle for the table to grab the view
- * container's ng-container to insert the no data row.
- * @docs-private
- */
- class NoDataRowOutlet {
- viewContainer = inject(ViewContainerRef);
- elementRef = inject(ElementRef);
- constructor() {
- const table = inject(CDK_TABLE);
- table._noDataRowOutlet = this;
- table._outletAssigned();
- }
- static ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "19.2.6", ngImport: i0, type: NoDataRowOutlet, deps: [], target: i0.ɵɵFactoryTarget.Directive });
- static ɵdir = i0.ɵɵngDeclareDirective({ minVersion: "14.0.0", version: "19.2.6", type: NoDataRowOutlet, isStandalone: true, selector: "[noDataRowOutlet]", ngImport: i0 });
- }
- i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "19.2.6", ngImport: i0, type: NoDataRowOutlet, decorators: [{
- type: Directive,
- args: [{
- selector: '[noDataRowOutlet]',
- }]
- }], ctorParameters: () => [] });
- /**
- * The table template that can be used by the mat-table. Should not be used outside of the
- * material library.
- * @docs-private
- */
- const CDK_TABLE_TEMPLATE =
- // Note that according to MDN, the `caption` element has to be projected as the **first**
- // element in the table. See https://developer.mozilla.org/en-US/docs/Web/HTML/Element/caption
- `
- <ng-content select="caption"/>
- <ng-content select="colgroup, col"/>
- <!--
- Unprojected content throws a hydration error so we need this to capture it.
- It gets removed on the client so it doesn't affect the layout.
- -->
- @if (_isServer) {
- <ng-content/>
- }
- @if (_isNativeHtmlTable) {
- <thead role="rowgroup">
- <ng-container headerRowOutlet/>
- </thead>
- <tbody role="rowgroup">
- <ng-container rowOutlet/>
- <ng-container noDataRowOutlet/>
- </tbody>
- <tfoot role="rowgroup">
- <ng-container footerRowOutlet/>
- </tfoot>
- } @else {
- <ng-container headerRowOutlet/>
- <ng-container rowOutlet/>
- <ng-container noDataRowOutlet/>
- <ng-container footerRowOutlet/>
- }
- `;
- /**
- * A data table that can render a header row, data rows, and a footer row.
- * Uses the dataSource input to determine the data to be rendered. The data can be provided either
- * as a data array, an Observable stream that emits the data array to render, or a DataSource with a
- * connect function that will return an Observable stream that emits the data array to render.
- */
- class CdkTable {
- _differs = inject(IterableDiffers);
- _changeDetectorRef = inject(ChangeDetectorRef);
- _elementRef = inject(ElementRef);
- _dir = inject(Directionality, { optional: true });
- _platform = inject(Platform);
- _viewRepeater = inject(_VIEW_REPEATER_STRATEGY);
- _coalescedStyleScheduler = inject(_COALESCED_STYLE_SCHEDULER);
- _viewportRuler = inject(ViewportRuler);
- _stickyPositioningListener = inject(STICKY_POSITIONING_LISTENER, { optional: true, skipSelf: true });
- _document = inject(DOCUMENT);
- /** Latest data provided by the data source. */
- _data;
- /** Subject that emits when the component has been destroyed. */
- _onDestroy = new Subject();
- /** List of the rendered rows as identified by their `RenderRow` object. */
- _renderRows;
- /** Subscription that listens for the data provided by the data source. */
- _renderChangeSubscription;
- /**
- * Map of all the user's defined columns (header, data, and footer cell template) identified by
- * name. Collection populated by the column definitions gathered by `ContentChildren` as well as
- * any custom column definitions added to `_customColumnDefs`.
- */
- _columnDefsByName = new Map();
- /**
- * Set of all row definitions that can be used by this table. Populated by the rows gathered by
- * using `ContentChildren` as well as any custom row definitions added to `_customRowDefs`.
- */
- _rowDefs;
- /**
- * Set of all header row definitions that can be used by this table. Populated by the rows
- * gathered by using `ContentChildren` as well as any custom row definitions added to
- * `_customHeaderRowDefs`.
- */
- _headerRowDefs;
- /**
- * Set of all row definitions that can be used by this table. Populated by the rows gathered by
- * using `ContentChildren` as well as any custom row definitions added to
- * `_customFooterRowDefs`.
- */
- _footerRowDefs;
- /** Differ used to find the changes in the data provided by the data source. */
- _dataDiffer;
- /** Stores the row definition that does not have a when predicate. */
- _defaultRowDef;
- /**
- * Column definitions that were defined outside of the direct content children of the table.
- * These will be defined when, e.g., creating a wrapper around the cdkTable that has
- * column definitions as *its* content child.
- */
- _customColumnDefs = new Set();
- /**
- * Data row definitions that were defined outside of the direct content children of the table.
- * These will be defined when, e.g., creating a wrapper around the cdkTable that has
- * built-in data rows as *its* content child.
- */
- _customRowDefs = new Set();
- /**
- * Header row definitions that were defined outside of the direct content children of the table.
- * These will be defined when, e.g., creating a wrapper around the cdkTable that has
- * built-in header rows as *its* content child.
- */
- _customHeaderRowDefs = new Set();
- /**
- * Footer row definitions that were defined outside of the direct content children of the table.
- * These will be defined when, e.g., creating a wrapper around the cdkTable that has a
- * built-in footer row as *its* content child.
- */
- _customFooterRowDefs = new Set();
- /** No data row that was defined outside of the direct content children of the table. */
- _customNoDataRow;
- /**
- * Whether the header row definition has been changed. Triggers an update to the header row after
- * content is checked. Initialized as true so that the table renders the initial set of rows.
- */
- _headerRowDefChanged = true;
- /**
- * Whether the footer row definition has been changed. Triggers an update to the footer row after
- * content is checked. Initialized as true so that the table renders the initial set of rows.
- */
- _footerRowDefChanged = true;
- /**
- * Whether the sticky column styles need to be updated. Set to `true` when the visible columns
- * change.
- */
- _stickyColumnStylesNeedReset = true;
- /**
- * Whether the sticky styler should recalculate cell widths when applying sticky styles. If
- * `false`, cached values will be used instead. This is only applicable to tables with
- * {@link fixedLayout} enabled. For other tables, cell widths will always be recalculated.
- */
- _forceRecalculateCellWidths = true;
- /**
- * Cache of the latest rendered `RenderRow` objects as a map for easy retrieval when constructing
- * a new list of `RenderRow` objects for rendering rows. Since the new list is constructed with
- * the cached `RenderRow` objects when possible, the row identity is preserved when the data
- * and row template matches, which allows the `IterableDiffer` to check rows by reference
- * and understand which rows are added/moved/removed.
- *
- * Implemented as a map of maps where the first key is the `data: T` object and the second is the
- * `CdkRowDef<T>` object. With the two keys, the cache points to a `RenderRow<T>` object that
- * contains an array of created pairs. The array is necessary to handle cases where the data
- * array contains multiple duplicate data objects and each instantiated `RenderRow` must be
- * stored.
- */
- _cachedRenderRowsMap = new Map();
- /** Whether the table is applied to a native `<table>`. */
- _isNativeHtmlTable;
- /**
- * Utility class that is responsible for applying the appropriate sticky positioning styles to
- * the table's rows and cells.
- */
- _stickyStyler;
- /**
- * CSS class added to any row or cell that has sticky positioning applied. May be overridden by
- * table subclasses.
- */
- stickyCssClass = 'cdk-table-sticky';
- /**
- * Whether to manually add position: sticky to all sticky cell elements. Not needed if
- * the position is set in a selector associated with the value of stickyCssClass. May be
- * overridden by table subclasses
- */
- needsPositionStickyOnElement = true;
- /** Whether the component is being rendered on the server. */
- _isServer;
- /** Whether the no data row is currently showing anything. */
- _isShowingNoDataRow = false;
- /** Whether the table has rendered out all the outlets for the first time. */
- _hasAllOutlets = false;
- /** Whether the table is done initializing. */
- _hasInitialized = false;
- /** Aria role to apply to the table's cells based on the table's own role. */
- _getCellRole() {
- // Perform this lazily in case the table's role was updated by a directive after construction.
- if (this._cellRoleInternal === undefined) {
- // Note that we set `role="cell"` even on native `td` elements,
- // because some browsers seem to require it. See #29784.
- const tableRole = this._elementRef.nativeElement.getAttribute('role');
- return tableRole === 'grid' || tableRole === 'treegrid' ? 'gridcell' : 'cell';
- }
- return this._cellRoleInternal;
- }
- _cellRoleInternal = undefined;
- /**
- * Tracking function that will be used to check the differences in data changes. Used similarly
- * to `ngFor` `trackBy` function. Optimize row operations by identifying a row based on its data
- * relative to the function to know if a row should be added/removed/moved.
- * Accepts a function that takes two parameters, `index` and `item`.
- */
- get trackBy() {
- return this._trackByFn;
- }
- set trackBy(fn) {
- if ((typeof ngDevMode === 'undefined' || ngDevMode) && fn != null && typeof fn !== 'function') {
- console.warn(`trackBy must be a function, but received ${JSON.stringify(fn)}.`);
- }
- this._trackByFn = fn;
- }
- _trackByFn;
- /**
- * The table's source of data, which can be provided in three ways (in order of complexity):
- * - Simple data array (each object represents one table row)
- * - Stream that emits a data array each time the array changes
- * - `DataSource` object that implements the connect/disconnect interface.
- *
- * If a data array is provided, the table must be notified when the array's objects are
- * added, removed, or moved. This can be done by calling the `renderRows()` function which will
- * render the diff since the last table render. If the data array reference is changed, the table
- * will automatically trigger an update to the rows.
- *
- * When providing an Observable stream, the table will trigger an update automatically when the
- * stream emits a new array of data.
- *
- * Finally, when providing a `DataSource` object, the table will use the Observable stream
- * provided by the connect function and trigger updates when that stream emits new data array
- * values. During the table's ngOnDestroy or when the data source is removed from the table, the
- * table will call the DataSource's `disconnect` function (may be useful for cleaning up any
- * subscriptions registered during the connect process).
- */
- get dataSource() {
- return this._dataSource;
- }
- set dataSource(dataSource) {
- if (this._dataSource !== dataSource) {
- this._switchDataSource(dataSource);
- }
- }
- _dataSource;
- /**
- * Whether to allow multiple rows per data object by evaluating which rows evaluate their 'when'
- * predicate to true. If `multiTemplateDataRows` is false, which is the default value, then each
- * dataobject will render the first row that evaluates its when predicate to true, in the order
- * defined in the table, or otherwise the default row which does not have a when predicate.
- */
- get multiTemplateDataRows() {
- return this._multiTemplateDataRows;
- }
- set multiTemplateDataRows(value) {
- this._multiTemplateDataRows = value;
- // In Ivy if this value is set via a static attribute (e.g. <table multiTemplateDataRows>),
- // this setter will be invoked before the row outlet has been defined hence the null check.
- if (this._rowOutlet && this._rowOutlet.viewContainer.length) {
- this._forceRenderDataRows();
- this.updateStickyColumnStyles();
- }
- }
- _multiTemplateDataRows = false;
- /**
- * Whether to use a fixed table layout. Enabling this option will enforce consistent column widths
- * and optimize rendering sticky styles for native tables. No-op for flex tables.
- */
- get fixedLayout() {
- return this._fixedLayout;
- }
- set fixedLayout(value) {
- this._fixedLayout = value;
- // Toggling `fixedLayout` may change column widths. Sticky column styles should be recalculated.
- this._forceRecalculateCellWidths = true;
- this._stickyColumnStylesNeedReset = true;
- }
- _fixedLayout = false;
- /**
- * Emits when the table completes rendering a set of data rows based on the latest data from the
- * data source, even if the set of rows is empty.
- */
- contentChanged = new EventEmitter();
- // TODO(andrewseguin): Remove max value as the end index
- // and instead calculate the view on init and scroll.
- /**
- * Stream containing the latest information on what rows are being displayed on screen.
- * Can be used by the data source to as a heuristic of what data should be provided.
- *
- * @docs-private
- */
- viewChange = new BehaviorSubject({
- start: 0,
- end: Number.MAX_VALUE,
- });
- // Outlets in the table's template where the header, data rows, and footer will be inserted.
- _rowOutlet;
- _headerRowOutlet;
- _footerRowOutlet;
- _noDataRowOutlet;
- /**
- * The column definitions provided by the user that contain what the header, data, and footer
- * cells should render for each column.
- */
- _contentColumnDefs;
- /** Set of data row definitions that were provided to the table as content children. */
- _contentRowDefs;
- /** Set of header row definitions that were provided to the table as content children. */
- _contentHeaderRowDefs;
- /** Set of footer row definitions that were provided to the table as content children. */
- _contentFooterRowDefs;
- /** Row definition that will only be rendered if there's no data in the table. */
- _noDataRow;
- _injector = inject(Injector);
- constructor() {
- const role = inject(new HostAttributeToken('role'), { optional: true });
- if (!role) {
- this._elementRef.nativeElement.setAttribute('role', 'table');
- }
- this._isServer = !this._platform.isBrowser;
- this._isNativeHtmlTable = this._elementRef.nativeElement.nodeName === 'TABLE';
- // Set up the trackBy function so that it uses the `RenderRow` as its identity by default. If
- // the user has provided a custom trackBy, return the result of that function as evaluated
- // with the values of the `RenderRow`'s data and index.
- this._dataDiffer = this._differs.find([]).create((_i, dataRow) => {
- return this.trackBy ? this.trackBy(dataRow.dataIndex, dataRow.data) : dataRow;
- });
- }
- ngOnInit() {
- this._setupStickyStyler();
- this._viewportRuler
- .change()
- .pipe(takeUntil(this._onDestroy))
- .subscribe(() => {
- this._forceRecalculateCellWidths = true;
- });
- }
- ngAfterContentInit() {
- this._hasInitialized = true;
- }
- ngAfterContentChecked() {
- // Only start re-rendering in `ngAfterContentChecked` after the first render.
- if (this._canRender()) {
- this._render();
- }
- }
- ngOnDestroy() {
- this._stickyStyler?.destroy();
- [
- this._rowOutlet?.viewContainer,
- this._headerRowOutlet?.viewContainer,
- this._footerRowOutlet?.viewContainer,
- this._cachedRenderRowsMap,
- this._customColumnDefs,
- this._customRowDefs,
- this._customHeaderRowDefs,
- this._customFooterRowDefs,
- this._columnDefsByName,
- ].forEach((def) => {
- def?.clear();
- });
- this._headerRowDefs = [];
- this._footerRowDefs = [];
- this._defaultRowDef = null;
- this._onDestroy.next();
- this._onDestroy.complete();
- if (isDataSource(this.dataSource)) {
- this.dataSource.disconnect(this);
- }
- }
- /**
- * Renders rows based on the table's latest set of data, which was either provided directly as an
- * input or retrieved through an Observable stream (directly or from a DataSource).
- * Checks for differences in the data since the last diff to perform only the necessary
- * changes (add/remove/move rows).
- *
- * If the table's data source is a DataSource or Observable, this will be invoked automatically
- * each time the provided Observable stream emits a new data array. Otherwise if your data is
- * an array, this function will need to be called to render any changes.
- */
- renderRows() {
- this._renderRows = this._getAllRenderRows();
- const changes = this._dataDiffer.diff(this._renderRows);
- if (!changes) {
- this._updateNoDataRow();
- this.contentChanged.next();
- return;
- }
- const viewContainer = this._rowOutlet.viewContainer;
- this._viewRepeater.applyChanges(changes, viewContainer, (record, _adjustedPreviousIndex, currentIndex) => this._getEmbeddedViewArgs(record.item, currentIndex), record => record.item.data, (change) => {
- if (change.operation === _ViewRepeaterOperation.INSERTED && change.context) {
- this._renderCellTemplateForItem(change.record.item.rowDef, change.context);
- }
- });
- // Update the meta context of a row's context data (index, count, first, last, ...)
- this._updateRowIndexContext();
- // Update rows that did not get added/removed/moved but may have had their identity changed,
- // e.g. if trackBy matched data on some property but the actual data reference changed.
- changes.forEachIdentityChange((record) => {
- const rowView = viewContainer.get(record.currentIndex);
- rowView.context.$implicit = record.item.data;
- });
- this._updateNoDataRow();
- this.contentChanged.next();
- this.updateStickyColumnStyles();
- }
- /** Adds a column definition that was not included as part of the content children. */
- addColumnDef(columnDef) {
- this._customColumnDefs.add(columnDef);
- }
- /** Removes a column definition that was not included as part of the content children. */
- removeColumnDef(columnDef) {
- this._customColumnDefs.delete(columnDef);
- }
- /** Adds a row definition that was not included as part of the content children. */
- addRowDef(rowDef) {
- this._customRowDefs.add(rowDef);
- }
- /** Removes a row definition that was not included as part of the content children. */
- removeRowDef(rowDef) {
- this._customRowDefs.delete(rowDef);
- }
- /** Adds a header row definition that was not included as part of the content children. */
- addHeaderRowDef(headerRowDef) {
- this._customHeaderRowDefs.add(headerRowDef);
- this._headerRowDefChanged = true;
- }
- /** Removes a header row definition that was not included as part of the content children. */
- removeHeaderRowDef(headerRowDef) {
- this._customHeaderRowDefs.delete(headerRowDef);
- this._headerRowDefChanged = true;
- }
- /** Adds a footer row definition that was not included as part of the content children. */
- addFooterRowDef(footerRowDef) {
- this._customFooterRowDefs.add(footerRowDef);
- this._footerRowDefChanged = true;
- }
- /** Removes a footer row definition that was not included as part of the content children. */
- removeFooterRowDef(footerRowDef) {
- this._customFooterRowDefs.delete(footerRowDef);
- this._footerRowDefChanged = true;
- }
- /** Sets a no data row definition that was not included as a part of the content children. */
- setNoDataRow(noDataRow) {
- this._customNoDataRow = noDataRow;
- }
- /**
- * Updates the header sticky styles. First resets all applied styles with respect to the cells
- * sticking to the top. Then, evaluating which cells need to be stuck to the top. This is
- * automatically called when the header row changes its displayed set of columns, or if its
- * sticky input changes. May be called manually for cases where the cell content changes outside
- * of these events.
- */
- updateStickyHeaderRowStyles() {
- const headerRows = this._getRenderedRows(this._headerRowOutlet);
- // Hide the thead element if there are no header rows. This is necessary to satisfy
- // overzealous a11y checkers that fail because the `rowgroup` element does not contain
- // required child `row`.
- if (this._isNativeHtmlTable) {
- const thead = closestTableSection(this._headerRowOutlet, 'thead');
- if (thead) {
- thead.style.display = headerRows.length ? '' : 'none';
- }
- }
- const stickyStates = this._headerRowDefs.map(def => def.sticky);
- this._stickyStyler.clearStickyPositioning(headerRows, ['top']);
- this._stickyStyler.stickRows(headerRows, stickyStates, 'top');
- // Reset the dirty state of the sticky input change since it has been used.
- this._headerRowDefs.forEach(def => def.resetStickyChanged());
- }
- /**
- * Updates the footer sticky styles. First resets all applied styles with respect to the cells
- * sticking to the bottom. Then, evaluating which cells need to be stuck to the bottom. This is
- * automatically called when the footer row changes its displayed set of columns, or if its
- * sticky input changes. May be called manually for cases where the cell content changes outside
- * of these events.
- */
- updateStickyFooterRowStyles() {
- const footerRows = this._getRenderedRows(this._footerRowOutlet);
- // Hide the tfoot element if there are no footer rows. This is necessary to satisfy
- // overzealous a11y checkers that fail because the `rowgroup` element does not contain
- // required child `row`.
- if (this._isNativeHtmlTable) {
- const tfoot = closestTableSection(this._footerRowOutlet, 'tfoot');
- if (tfoot) {
- tfoot.style.display = footerRows.length ? '' : 'none';
- }
- }
- const stickyStates = this._footerRowDefs.map(def => def.sticky);
- this._stickyStyler.clearStickyPositioning(footerRows, ['bottom']);
- this._stickyStyler.stickRows(footerRows, stickyStates, 'bottom');
- this._stickyStyler.updateStickyFooterContainer(this._elementRef.nativeElement, stickyStates);
- // Reset the dirty state of the sticky input change since it has been used.
- this._footerRowDefs.forEach(def => def.resetStickyChanged());
- }
- /**
- * Updates the column sticky styles. First resets all applied styles with respect to the cells
- * sticking to the left and right. Then sticky styles are added for the left and right according
- * to the column definitions for each cell in each row. This is automatically called when
- * the data source provides a new set of data or when a column definition changes its sticky
- * input. May be called manually for cases where the cell content changes outside of these events.
- */
- updateStickyColumnStyles() {
- const headerRows = this._getRenderedRows(this._headerRowOutlet);
- const dataRows = this._getRenderedRows(this._rowOutlet);
- const footerRows = this._getRenderedRows(this._footerRowOutlet);
- // For tables not using a fixed layout, the column widths may change when new rows are rendered.
- // In a table using a fixed layout, row content won't affect column width, so sticky styles
- // don't need to be cleared unless either the sticky column config changes or one of the row
- // defs change.
- if ((this._isNativeHtmlTable && !this._fixedLayout) || this._stickyColumnStylesNeedReset) {
- // Clear the left and right positioning from all columns in the table across all rows since
- // sticky columns span across all table sections (header, data, footer)
- this._stickyStyler.clearStickyPositioning([...headerRows, ...dataRows, ...footerRows], ['left', 'right']);
- this._stickyColumnStylesNeedReset = false;
- }
- // Update the sticky styles for each header row depending on the def's sticky state
- headerRows.forEach((headerRow, i) => {
- this._addStickyColumnStyles([headerRow], this._headerRowDefs[i]);
- });
- // Update the sticky styles for each data row depending on its def's sticky state
- this._rowDefs.forEach(rowDef => {
- // Collect all the rows rendered with this row definition.
- const rows = [];
- for (let i = 0; i < dataRows.length; i++) {
- if (this._renderRows[i].rowDef === rowDef) {
- rows.push(dataRows[i]);
- }
- }
- this._addStickyColumnStyles(rows, rowDef);
- });
- // Update the sticky styles for each footer row depending on the def's sticky state
- footerRows.forEach((footerRow, i) => {
- this._addStickyColumnStyles([footerRow], this._footerRowDefs[i]);
- });
- // Reset the dirty state of the sticky input change since it has been used.
- Array.from(this._columnDefsByName.values()).forEach(def => def.resetStickyChanged());
- }
- /** Invoked whenever an outlet is created and has been assigned to the table. */
- _outletAssigned() {
- // Trigger the first render once all outlets have been assigned. We do it this way, as
- // opposed to waiting for the next `ngAfterContentChecked`, because we don't know when
- // the next change detection will happen.
- // Also we can't use queries to resolve the outlets, because they're wrapped in a
- // conditional, so we have to rely on them being assigned via DI.
- if (!this._hasAllOutlets &&
- this._rowOutlet &&
- this._headerRowOutlet &&
- this._footerRowOutlet &&
- this._noDataRowOutlet) {
- this._hasAllOutlets = true;
- // In some setups this may fire before `ngAfterContentInit`
- // so we need a check here. See #28538.
- if (this._canRender()) {
- this._render();
- }
- }
- }
- /** Whether the table has all the information to start rendering. */
- _canRender() {
- return this._hasAllOutlets && this._hasInitialized;
- }
- /** Renders the table if its state has changed. */
- _render() {
- // Cache the row and column definitions gathered by ContentChildren and programmatic injection.
- this._cacheRowDefs();
- this._cacheColumnDefs();
- // Make sure that the user has at least added header, footer, or data row def.
- if (!this._headerRowDefs.length &&
- !this._footerRowDefs.length &&
- !this._rowDefs.length &&
- (typeof ngDevMode === 'undefined' || ngDevMode)) {
- throw getTableMissingRowDefsError();
- }
- // Render updates if the list of columns have been changed for the header, row, or footer defs.
- const columnsChanged = this._renderUpdatedColumns();
- const rowDefsChanged = columnsChanged || this._headerRowDefChanged || this._footerRowDefChanged;
- // Ensure sticky column styles are reset if set to `true` elsewhere.
- this._stickyColumnStylesNeedReset = this._stickyColumnStylesNeedReset || rowDefsChanged;
- this._forceRecalculateCellWidths = rowDefsChanged;
- // If the header row definition has been changed, trigger a render to the header row.
- if (this._headerRowDefChanged) {
- this._forceRenderHeaderRows();
- this._headerRowDefChanged = false;
- }
- // If the footer row definition has been changed, trigger a render to the footer row.
- if (this._footerRowDefChanged) {
- this._forceRenderFooterRows();
- this._footerRowDefChanged = false;
- }
- // If there is a data source and row definitions, connect to the data source unless a
- // connection has already been made.
- if (this.dataSource && this._rowDefs.length > 0 && !this._renderChangeSubscription) {
- this._observeRenderChanges();
- }
- else if (this._stickyColumnStylesNeedReset) {
- // In the above case, _observeRenderChanges will result in updateStickyColumnStyles being
- // called when it row data arrives. Otherwise, we need to call it proactively.
- this.updateStickyColumnStyles();
- }
- this._checkStickyStates();
- }
- /**
- * Get the list of RenderRow objects to render according to the current list of data and defined
- * row definitions. If the previous list already contained a particular pair, it should be reused
- * so that the differ equates their references.
- */
- _getAllRenderRows() {
- const renderRows = [];
- // Store the cache and create a new one. Any re-used RenderRow objects will be moved into the
- // new cache while unused ones can be picked up by garbage collection.
- const prevCachedRenderRows = this._cachedRenderRowsMap;
- this._cachedRenderRowsMap = new Map();
- if (!this._data) {
- return renderRows;
- }
- // For each data object, get the list of rows that should be rendered, represented by the
- // respective `RenderRow` object which is the pair of `data` and `CdkRowDef`.
- for (let i = 0; i < this._data.length; i++) {
- let data = this._data[i];
- const renderRowsForData = this._getRenderRowsForData(data, i, prevCachedRenderRows.get(data));
- if (!this._cachedRenderRowsMap.has(data)) {
- this._cachedRenderRowsMap.set(data, new WeakMap());
- }
- for (let j = 0; j < renderRowsForData.length; j++) {
- let renderRow = renderRowsForData[j];
- const cache = this._cachedRenderRowsMap.get(renderRow.data);
- if (cache.has(renderRow.rowDef)) {
- cache.get(renderRow.rowDef).push(renderRow);
- }
- else {
- cache.set(renderRow.rowDef, [renderRow]);
- }
- renderRows.push(renderRow);
- }
- }
- return renderRows;
- }
- /**
- * Gets a list of `RenderRow<T>` for the provided data object and any `CdkRowDef` objects that
- * should be rendered for this data. Reuses the cached RenderRow objects if they match the same
- * `(T, CdkRowDef)` pair.
- */
- _getRenderRowsForData(data, dataIndex, cache) {
- const rowDefs = this._getRowDefs(data, dataIndex);
- return rowDefs.map(rowDef => {
- const cachedRenderRows = cache && cache.has(rowDef) ? cache.get(rowDef) : [];
- if (cachedRenderRows.length) {
- const dataRow = cachedRenderRows.shift();
- dataRow.dataIndex = dataIndex;
- return dataRow;
- }
- else {
- return { data, rowDef, dataIndex };
- }
- });
- }
- /** Update the map containing the content's column definitions. */
- _cacheColumnDefs() {
- this._columnDefsByName.clear();
- const columnDefs = mergeArrayAndSet(this._getOwnDefs(this._contentColumnDefs), this._customColumnDefs);
- columnDefs.forEach(columnDef => {
- if (this._columnDefsByName.has(columnDef.name) &&
- (typeof ngDevMode === 'undefined' || ngDevMode)) {
- throw getTableDuplicateColumnNameError(columnDef.name);
- }
- this._columnDefsByName.set(columnDef.name, columnDef);
- });
- }
- /** Update the list of all available row definitions that can be used. */
- _cacheRowDefs() {
- this._headerRowDefs = mergeArrayAndSet(this._getOwnDefs(this._contentHeaderRowDefs), this._customHeaderRowDefs);
- this._footerRowDefs = mergeArrayAndSet(this._getOwnDefs(this._contentFooterRowDefs), this._customFooterRowDefs);
- this._rowDefs = mergeArrayAndSet(this._getOwnDefs(this._contentRowDefs), this._customRowDefs);
- // After all row definitions are determined, find the row definition to be considered default.
- const defaultRowDefs = this._rowDefs.filter(def => !def.when);
- if (!this.multiTemplateDataRows &&
- defaultRowDefs.length > 1 &&
- (typeof ngDevMode === 'undefined' || ngDevMode)) {
- throw getTableMultipleDefaultRowDefsError();
- }
- this._defaultRowDef = defaultRowDefs[0];
- }
- /**
- * Check if the header, data, or footer rows have changed what columns they want to display or
- * whether the sticky states have changed for the header or footer. If there is a diff, then
- * re-render that section.
- */
- _renderUpdatedColumns() {
- const columnsDiffReducer = (acc, def) => {
- // The differ should be run for every column, even if `acc` is already
- // true (see #29922)
- const diff = !!def.getColumnsDiff();
- return acc || diff;
- };
- // Force re-render data rows if the list of column definitions have changed.
- const dataColumnsChanged = this._rowDefs.reduce(columnsDiffReducer, false);
- if (dataColumnsChanged) {
- this._forceRenderDataRows();
- }
- // Force re-render header/footer rows if the list of column definitions have changed.
- const headerColumnsChanged = this._headerRowDefs.reduce(columnsDiffReducer, false);
- if (headerColumnsChanged) {
- this._forceRenderHeaderRows();
- }
- const footerColumnsChanged = this._footerRowDefs.reduce(columnsDiffReducer, false);
- if (footerColumnsChanged) {
- this._forceRenderFooterRows();
- }
- return dataColumnsChanged || headerColumnsChanged || footerColumnsChanged;
- }
- /**
- * Switch to the provided data source by resetting the data and unsubscribing from the current
- * render change subscription if one exists. If the data source is null, interpret this by
- * clearing the row outlet. Otherwise start listening for new data.
- */
- _switchDataSource(dataSource) {
- this._data = [];
- if (isDataSource(this.dataSource)) {
- this.dataSource.disconnect(this);
- }
- // Stop listening for data from the previous data source.
- if (this._renderChangeSubscription) {
- this._renderChangeSubscription.unsubscribe();
- this._renderChangeSubscription = null;
- }
- if (!dataSource) {
- if (this._dataDiffer) {
- this._dataDiffer.diff([]);
- }
- if (this._rowOutlet) {
- this._rowOutlet.viewContainer.clear();
- }
- }
- this._dataSource = dataSource;
- }
- /** Set up a subscription for the data provided by the data source. */
- _observeRenderChanges() {
- // If no data source has been set, there is nothing to observe for changes.
- if (!this.dataSource) {
- return;
- }
- let dataStream;
- if (isDataSource(this.dataSource)) {
- dataStream = this.dataSource.connect(this);
- }
- else if (isObservable(this.dataSource)) {
- dataStream = this.dataSource;
- }
- else if (Array.isArray(this.dataSource)) {
- dataStream = of(this.dataSource);
- }
- if (dataStream === undefined && (typeof ngDevMode === 'undefined' || ngDevMode)) {
- throw getTableUnknownDataSourceError();
- }
- this._renderChangeSubscription = dataStream
- .pipe(takeUntil(this._onDestroy))
- .subscribe(data => {
- this._data = data || [];
- this.renderRows();
- });
- }
- /**
- * Clears any existing content in the header row outlet and creates a new embedded view
- * in the outlet using the header row definition.
- */
- _forceRenderHeaderRows() {
- // Clear the header row outlet if any content exists.
- if (this._headerRowOutlet.viewContainer.length > 0) {
- this._headerRowOutlet.viewContainer.clear();
- }
- this._headerRowDefs.forEach((def, i) => this._renderRow(this._headerRowOutlet, def, i));
- this.updateStickyHeaderRowStyles();
- }
- /**
- * Clears any existing content in the footer row outlet and creates a new embedded view
- * in the outlet using the footer row definition.
- */
- _forceRenderFooterRows() {
- // Clear the footer row outlet if any content exists.
- if (this._footerRowOutlet.viewContainer.length > 0) {
- this._footerRowOutlet.viewContainer.clear();
- }
- this._footerRowDefs.forEach((def, i) => this._renderRow(this._footerRowOutlet, def, i));
- this.updateStickyFooterRowStyles();
- }
- /** Adds the sticky column styles for the rows according to the columns' stick states. */
- _addStickyColumnStyles(rows, rowDef) {
- const columnDefs = Array.from(rowDef?.columns || []).map(columnName => {
- const columnDef = this._columnDefsByName.get(columnName);
- if (!columnDef && (typeof ngDevMode === 'undefined' || ngDevMode)) {
- throw getTableUnknownColumnError(columnName);
- }
- return columnDef;
- });
- const stickyStartStates = columnDefs.map(columnDef => columnDef.sticky);
- const stickyEndStates = columnDefs.map(columnDef => columnDef.stickyEnd);
- this._stickyStyler.updateStickyColumns(rows, stickyStartStates, stickyEndStates, !this._fixedLayout || this._forceRecalculateCellWidths);
- }
- /** Gets the list of rows that have been rendered in the row outlet. */
- _getRenderedRows(rowOutlet) {
- const renderedRows = [];
- for (let i = 0; i < rowOutlet.viewContainer.length; i++) {
- const viewRef = rowOutlet.viewContainer.get(i);
- renderedRows.push(viewRef.rootNodes[0]);
- }
- return renderedRows;
- }
- /**
- * Get the matching row definitions that should be used for this row data. If there is only
- * one row definition, it is returned. Otherwise, find the row definitions that has a when
- * predicate that returns true with the data. If none return true, return the default row
- * definition.
- */
- _getRowDefs(data, dataIndex) {
- if (this._rowDefs.length == 1) {
- return [this._rowDefs[0]];
- }
- let rowDefs = [];
- if (this.multiTemplateDataRows) {
- rowDefs = this._rowDefs.filter(def => !def.when || def.when(dataIndex, data));
- }
- else {
- let rowDef = this._rowDefs.find(def => def.when && def.when(dataIndex, data)) || this._defaultRowDef;
- if (rowDef) {
- rowDefs.push(rowDef);
- }
- }
- if (!rowDefs.length && (typeof ngDevMode === 'undefined' || ngDevMode)) {
- throw getTableMissingMatchingRowDefError(data);
- }
- return rowDefs;
- }
- _getEmbeddedViewArgs(renderRow, index) {
- const rowDef = renderRow.rowDef;
- const context = { $implicit: renderRow.data };
- return {
- templateRef: rowDef.template,
- context,
- index,
- };
- }
- /**
- * Creates a new row template in the outlet and fills it with the set of cell templates.
- * Optionally takes a context to provide to the row and cells, as well as an optional index
- * of where to place the new row template in the outlet.
- */
- _renderRow(outlet, rowDef, index, context = {}) {
- // TODO(andrewseguin): enforce that one outlet was instantiated from createEmbeddedView
- const view = outlet.viewContainer.createEmbeddedView(rowDef.template, context, index);
- this._renderCellTemplateForItem(rowDef, context);
- return view;
- }
- _renderCellTemplateForItem(rowDef, context) {
- for (let cellTemplate of this._getCellTemplates(rowDef)) {
- if (CdkCellOutlet.mostRecentCellOutlet) {
- CdkCellOutlet.mostRecentCellOutlet._viewContainer.createEmbeddedView(cellTemplate, context);
- }
- }
- this._changeDetectorRef.markForCheck();
- }
- /**
- * Updates the index-related context for each row to reflect any changes in the index of the rows,
- * e.g. first/last/even/odd.
- */
- _updateRowIndexContext() {
- const viewContainer = this._rowOutlet.viewContainer;
- for (let renderIndex = 0, count = viewContainer.length; renderIndex < count; renderIndex++) {
- const viewRef = viewContainer.get(renderIndex);
- const context = viewRef.context;
- context.count = count;
- context.first = renderIndex === 0;
- context.last = renderIndex === count - 1;
- context.even = renderIndex % 2 === 0;
- context.odd = !context.even;
- if (this.multiTemplateDataRows) {
- context.dataIndex = this._renderRows[renderIndex].dataIndex;
- context.renderIndex = renderIndex;
- }
- else {
- context.index = this._renderRows[renderIndex].dataIndex;
- }
- }
- }
- /** Gets the column definitions for the provided row def. */
- _getCellTemplates(rowDef) {
- if (!rowDef || !rowDef.columns) {
- return [];
- }
- return Array.from(rowDef.columns, columnId => {
- const column = this._columnDefsByName.get(columnId);
- if (!column && (typeof ngDevMode === 'undefined' || ngDevMode)) {
- throw getTableUnknownColumnError(columnId);
- }
- return rowDef.extractCellTemplate(column);
- });
- }
- /**
- * Forces a re-render of the data rows. Should be called in cases where there has been an input
- * change that affects the evaluation of which rows should be rendered, e.g. toggling
- * `multiTemplateDataRows` or adding/removing row definitions.
- */
- _forceRenderDataRows() {
- this._dataDiffer.diff([]);
- this._rowOutlet.viewContainer.clear();
- this.renderRows();
- }
- /**
- * Checks if there has been a change in sticky states since last check and applies the correct
- * sticky styles. Since checking resets the "dirty" state, this should only be performed once
- * during a change detection and after the inputs are settled (after content check).
- */
- _checkStickyStates() {
- const stickyCheckReducer = (acc, d) => {
- return acc || d.hasStickyChanged();
- };
- // Note that the check needs to occur for every definition since it notifies the definition
- // that it can reset its dirty state. Using another operator like `some` may short-circuit
- // remaining definitions and leave them in an unchecked state.
- if (this._headerRowDefs.reduce(stickyCheckReducer, false)) {
- this.updateStickyHeaderRowStyles();
- }
- if (this._footerRowDefs.reduce(stickyCheckReducer, false)) {
- this.updateStickyFooterRowStyles();
- }
- if (Array.from(this._columnDefsByName.values()).reduce(stickyCheckReducer, false)) {
- this._stickyColumnStylesNeedReset = true;
- this.updateStickyColumnStyles();
- }
- }
- /**
- * Creates the sticky styler that will be used for sticky rows and columns. Listens
- * for directionality changes and provides the latest direction to the styler. Re-applies column
- * stickiness when directionality changes.
- */
- _setupStickyStyler() {
- const direction = this._dir ? this._dir.value : 'ltr';
- this._stickyStyler = new StickyStyler(this._isNativeHtmlTable, this.stickyCssClass, direction, this._coalescedStyleScheduler, this._platform.isBrowser, this.needsPositionStickyOnElement, this._stickyPositioningListener, this._injector);
- (this._dir ? this._dir.change : of())
- .pipe(takeUntil(this._onDestroy))
- .subscribe(value => {
- this._stickyStyler.direction = value;
- this.updateStickyColumnStyles();
- });
- }
- /** Filters definitions that belong to this table from a QueryList. */
- _getOwnDefs(items) {
- return items.filter(item => !item._table || item._table === this);
- }
- /** Creates or removes the no data row, depending on whether any data is being shown. */
- _updateNoDataRow() {
- const noDataRow = this._customNoDataRow || this._noDataRow;
- if (!noDataRow) {
- return;
- }
- const shouldShow = this._rowOutlet.viewContainer.length === 0;
- if (shouldShow === this._isShowingNoDataRow) {
- return;
- }
- const container = this._noDataRowOutlet.viewContainer;
- if (shouldShow) {
- const view = container.createEmbeddedView(noDataRow.templateRef);
- const rootNode = view.rootNodes[0];
- // Only add the attributes if we have a single root node since it's hard
- // to figure out which one to add it to when there are multiple.
- if (view.rootNodes.length === 1 && rootNode?.nodeType === this._document.ELEMENT_NODE) {
- rootNode.setAttribute('role', 'row');
- rootNode.classList.add(noDataRow._contentClassName);
- }
- }
- else {
- container.clear();
- }
- this._isShowingNoDataRow = shouldShow;
- this._changeDetectorRef.markForCheck();
- }
- static ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "19.2.6", ngImport: i0, type: CdkTable, deps: [], target: i0.ɵɵFactoryTarget.Component });
- static ɵcmp = i0.ɵɵngDeclareComponent({ minVersion: "17.0.0", version: "19.2.6", type: CdkTable, isStandalone: true, selector: "cdk-table, table[cdk-table]", inputs: { trackBy: "trackBy", dataSource: "dataSource", multiTemplateDataRows: ["multiTemplateDataRows", "multiTemplateDataRows", booleanAttribute], fixedLayout: ["fixedLayout", "fixedLayout", booleanAttribute] }, outputs: { contentChanged: "contentChanged" }, host: { properties: { "class.cdk-table-fixed-layout": "fixedLayout" }, classAttribute: "cdk-table" }, providers: [
- { provide: CDK_TABLE, useExisting: CdkTable },
- { provide: _VIEW_REPEATER_STRATEGY, useClass: _DisposeViewRepeaterStrategy },
- { provide: _COALESCED_STYLE_SCHEDULER, useClass: _CoalescedStyleScheduler },
- // Prevent nested tables from seeing this table's StickyPositioningListener.
- { provide: STICKY_POSITIONING_LISTENER, useValue: null },
- ], queries: [{ propertyName: "_noDataRow", first: true, predicate: CdkNoDataRow, descendants: true }, { propertyName: "_contentColumnDefs", predicate: CdkColumnDef, descendants: true }, { propertyName: "_contentRowDefs", predicate: CdkRowDef, descendants: true }, { propertyName: "_contentHeaderRowDefs", predicate: CdkHeaderRowDef, descendants: true }, { propertyName: "_contentFooterRowDefs", predicate: CdkFooterRowDef, descendants: true }], exportAs: ["cdkTable"], ngImport: i0, template: "\n <ng-content select=\"caption\"/>\n <ng-content select=\"colgroup, col\"/>\n\n <!--\n Unprojected content throws a hydration error so we need this to capture it.\n It gets removed on the client so it doesn't affect the layout.\n -->\n @if (_isServer) {\n <ng-content/>\n }\n\n @if (_isNativeHtmlTable) {\n <thead role=\"rowgroup\">\n <ng-container headerRowOutlet/>\n </thead>\n <tbody role=\"rowgroup\">\n <ng-container rowOutlet/>\n <ng-container noDataRowOutlet/>\n </tbody>\n <tfoot role=\"rowgroup\">\n <ng-container footerRowOutlet/>\n </tfoot>\n } @else {\n <ng-container headerRowOutlet/>\n <ng-container rowOutlet/>\n <ng-container noDataRowOutlet/>\n <ng-container footerRowOutlet/>\n }\n", isInline: true, styles: [".cdk-table-fixed-layout{table-layout:fixed}\n"], dependencies: [{ kind: "directive", type: HeaderRowOutlet, selector: "[headerRowOutlet]" }, { kind: "directive", type: DataRowOutlet, selector: "[rowOutlet]" }, { kind: "directive", type: NoDataRowOutlet, selector: "[noDataRowOutlet]" }, { kind: "directive", type: FooterRowOutlet, selector: "[footerRowOutlet]" }], changeDetection: i0.ChangeDetectionStrategy.Default, encapsulation: i0.ViewEncapsulation.None });
- }
- i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "19.2.6", ngImport: i0, type: CdkTable, decorators: [{
- type: Component,
- args: [{ selector: 'cdk-table, table[cdk-table]', exportAs: 'cdkTable', template: CDK_TABLE_TEMPLATE, host: {
- 'class': 'cdk-table',
- '[class.cdk-table-fixed-layout]': 'fixedLayout',
- }, encapsulation: ViewEncapsulation.None, changeDetection: ChangeDetectionStrategy.Default, providers: [
- { provide: CDK_TABLE, useExisting: CdkTable },
- { provide: _VIEW_REPEATER_STRATEGY, useClass: _DisposeViewRepeaterStrategy },
- { provide: _COALESCED_STYLE_SCHEDULER, useClass: _CoalescedStyleScheduler },
- // Prevent nested tables from seeing this table's StickyPositioningListener.
- { provide: STICKY_POSITIONING_LISTENER, useValue: null },
- ], imports: [HeaderRowOutlet, DataRowOutlet, NoDataRowOutlet, FooterRowOutlet], styles: [".cdk-table-fixed-layout{table-layout:fixed}\n"] }]
- }], ctorParameters: () => [], propDecorators: { trackBy: [{
- type: Input
- }], dataSource: [{
- type: Input
- }], multiTemplateDataRows: [{
- type: Input,
- args: [{ transform: booleanAttribute }]
- }], fixedLayout: [{
- type: Input,
- args: [{ transform: booleanAttribute }]
- }], contentChanged: [{
- type: Output
- }], _contentColumnDefs: [{
- type: ContentChildren,
- args: [CdkColumnDef, { descendants: true }]
- }], _contentRowDefs: [{
- type: ContentChildren,
- args: [CdkRowDef, { descendants: true }]
- }], _contentHeaderRowDefs: [{
- type: ContentChildren,
- args: [CdkHeaderRowDef, {
- descendants: true,
- }]
- }], _contentFooterRowDefs: [{
- type: ContentChildren,
- args: [CdkFooterRowDef, {
- descendants: true,
- }]
- }], _noDataRow: [{
- type: ContentChild,
- args: [CdkNoDataRow]
- }] } });
- /** Utility function that gets a merged list of the entries in an array and values of a Set. */
- function mergeArrayAndSet(array, set) {
- return array.concat(Array.from(set));
- }
- /**
- * Finds the closest table section to an outlet. We can't use `HTMLElement.closest` for this,
- * because the node representing the outlet is a comment.
- */
- function closestTableSection(outlet, section) {
- const uppercaseSection = section.toUpperCase();
- let current = outlet.viewContainer.element.nativeElement;
- while (current) {
- // 1 is an element node.
- const nodeName = current.nodeType === 1 ? current.nodeName : null;
- if (nodeName === uppercaseSection) {
- return current;
- }
- else if (nodeName === 'TABLE') {
- // Stop traversing past the `table` node.
- break;
- }
- current = current.parentNode;
- }
- return null;
- }
- /**
- * Column that simply shows text content for the header and row cells. Assumes that the table
- * is using the native table implementation (`<table>`).
- *
- * By default, the name of this column will be the header text and data property accessor.
- * The header text can be overridden with the `headerText` input. Cell values can be overridden with
- * the `dataAccessor` input. Change the text justification to the start or end using the `justify`
- * input.
- */
- class CdkTextColumn {
- _table = inject(CdkTable, { optional: true });
- _options = inject(TEXT_COLUMN_OPTIONS, { optional: true });
- /** Column name that should be used to reference this column. */
- get name() {
- return this._name;
- }
- set name(name) {
- this._name = name;
- // With Ivy, inputs can be initialized before static query results are
- // available. In that case, we defer the synchronization until "ngOnInit" fires.
- this._syncColumnDefName();
- }
- _name;
- /**
- * Text label that should be used for the column header. If this property is not
- * set, the header text will default to the column name with its first letter capitalized.
- */
- headerText;
- /**
- * Accessor function to retrieve the data rendered for each cell. If this
- * property is not set, the data cells will render the value found in the data's property matching
- * the column's name. For example, if the column is named `id`, then the rendered value will be
- * value defined by the data's `id` property.
- */
- dataAccessor;
- /** Alignment of the cell values. */
- justify = 'start';
- /** @docs-private */
- columnDef;
- /**
- * The column cell is provided to the column during `ngOnInit` with a static query.
- * Normally, this will be retrieved by the column using `ContentChild`, but that assumes the
- * column definition was provided in the same view as the table, which is not the case with this
- * component.
- * @docs-private
- */
- cell;
- /**
- * The column headerCell is provided to the column during `ngOnInit` with a static query.
- * Normally, this will be retrieved by the column using `ContentChild`, but that assumes the
- * column definition was provided in the same view as the table, which is not the case with this
- * component.
- * @docs-private
- */
- headerCell;
- constructor() {
- this._options = this._options || {};
- }
- ngOnInit() {
- this._syncColumnDefName();
- if (this.headerText === undefined) {
- this.headerText = this._createDefaultHeaderText();
- }
- if (!this.dataAccessor) {
- this.dataAccessor =
- this._options.defaultDataAccessor || ((data, name) => data[name]);
- }
- if (this._table) {
- // Provide the cell and headerCell directly to the table with the static `ViewChild` query,
- // since the columnDef will not pick up its content by the time the table finishes checking
- // its content and initializing the rows.
- this.columnDef.cell = this.cell;
- this.columnDef.headerCell = this.headerCell;
- this._table.addColumnDef(this.columnDef);
- }
- else if (typeof ngDevMode === 'undefined' || ngDevMode) {
- throw getTableTextColumnMissingParentTableError();
- }
- }
- ngOnDestroy() {
- if (this._table) {
- this._table.removeColumnDef(this.columnDef);
- }
- }
- /**
- * Creates a default header text. Use the options' header text transformation function if one
- * has been provided. Otherwise simply capitalize the column name.
- */
- _createDefaultHeaderText() {
- const name = this.name;
- if (!name && (typeof ngDevMode === 'undefined' || ngDevMode)) {
- throw getTableTextColumnMissingNameError();
- }
- if (this._options && this._options.defaultHeaderTextTransform) {
- return this._options.defaultHeaderTextTransform(name);
- }
- return name[0].toUpperCase() + name.slice(1);
- }
- /** Synchronizes the column definition name with the text column name. */
- _syncColumnDefName() {
- if (this.columnDef) {
- this.columnDef.name = this.name;
- }
- }
- static ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "19.2.6", ngImport: i0, type: CdkTextColumn, deps: [], target: i0.ɵɵFactoryTarget.Component });
- static ɵcmp = i0.ɵɵngDeclareComponent({ minVersion: "14.0.0", version: "19.2.6", type: CdkTextColumn, isStandalone: true, selector: "cdk-text-column", inputs: { name: "name", headerText: "headerText", dataAccessor: "dataAccessor", justify: "justify" }, viewQueries: [{ propertyName: "columnDef", first: true, predicate: CdkColumnDef, descendants: true, static: true }, { propertyName: "cell", first: true, predicate: CdkCellDef, descendants: true, static: true }, { propertyName: "headerCell", first: true, predicate: CdkHeaderCellDef, descendants: true, static: true }], ngImport: i0, template: `
- <ng-container cdkColumnDef>
- <th cdk-header-cell *cdkHeaderCellDef [style.text-align]="justify">
- {{headerText}}
- </th>
- <td cdk-cell *cdkCellDef="let data" [style.text-align]="justify">
- {{dataAccessor(data, name)}}
- </td>
- </ng-container>
- `, isInline: true, dependencies: [{ kind: "directive", type: CdkColumnDef, selector: "[cdkColumnDef]", inputs: ["cdkColumnDef", "sticky", "stickyEnd"] }, { kind: "directive", type: CdkHeaderCellDef, selector: "[cdkHeaderCellDef]" }, { kind: "directive", type: CdkHeaderCell, selector: "cdk-header-cell, th[cdk-header-cell]" }, { kind: "directive", type: CdkCellDef, selector: "[cdkCellDef]" }, { kind: "directive", type: CdkCell, selector: "cdk-cell, td[cdk-cell]" }], changeDetection: i0.ChangeDetectionStrategy.Default, encapsulation: i0.ViewEncapsulation.None });
- }
- i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "19.2.6", ngImport: i0, type: CdkTextColumn, decorators: [{
- type: Component,
- args: [{
- selector: 'cdk-text-column',
- template: `
- <ng-container cdkColumnDef>
- <th cdk-header-cell *cdkHeaderCellDef [style.text-align]="justify">
- {{headerText}}
- </th>
- <td cdk-cell *cdkCellDef="let data" [style.text-align]="justify">
- {{dataAccessor(data, name)}}
- </td>
- </ng-container>
- `,
- encapsulation: ViewEncapsulation.None,
- // Change detection is intentionally not set to OnPush. This component's template will be provided
- // to the table to be inserted into its view. This is problematic when change detection runs since
- // the bindings in this template will be evaluated _after_ the table's view is evaluated, which
- // mean's the template in the table's view will not have the updated value (and in fact will cause
- // an ExpressionChangedAfterItHasBeenCheckedError).
- // tslint:disable-next-line:validate-decorators
- changeDetection: ChangeDetectionStrategy.Default,
- imports: [CdkColumnDef, CdkHeaderCellDef, CdkHeaderCell, CdkCellDef, CdkCell],
- }]
- }], ctorParameters: () => [], propDecorators: { name: [{
- type: Input
- }], headerText: [{
- type: Input
- }], dataAccessor: [{
- type: Input
- }], justify: [{
- type: Input
- }], columnDef: [{
- type: ViewChild,
- args: [CdkColumnDef, { static: true }]
- }], cell: [{
- type: ViewChild,
- args: [CdkCellDef, { static: true }]
- }], headerCell: [{
- type: ViewChild,
- args: [CdkHeaderCellDef, { static: true }]
- }] } });
- const EXPORTED_DECLARATIONS = [
- CdkTable,
- CdkRowDef,
- CdkCellDef,
- CdkCellOutlet,
- CdkHeaderCellDef,
- CdkFooterCellDef,
- CdkColumnDef,
- CdkCell,
- CdkRow,
- CdkHeaderCell,
- CdkFooterCell,
- CdkHeaderRow,
- CdkHeaderRowDef,
- CdkFooterRow,
- CdkFooterRowDef,
- DataRowOutlet,
- HeaderRowOutlet,
- FooterRowOutlet,
- CdkTextColumn,
- CdkNoDataRow,
- CdkRecycleRows,
- NoDataRowOutlet,
- ];
- class CdkTableModule {
- static ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "19.2.6", ngImport: i0, type: CdkTableModule, deps: [], target: i0.ɵɵFactoryTarget.NgModule });
- static ɵmod = i0.ɵɵngDeclareNgModule({ minVersion: "14.0.0", version: "19.2.6", ngImport: i0, type: CdkTableModule, imports: [ScrollingModule, CdkTable,
- CdkRowDef,
- CdkCellDef,
- CdkCellOutlet,
- CdkHeaderCellDef,
- CdkFooterCellDef,
- CdkColumnDef,
- CdkCell,
- CdkRow,
- CdkHeaderCell,
- CdkFooterCell,
- CdkHeaderRow,
- CdkHeaderRowDef,
- CdkFooterRow,
- CdkFooterRowDef,
- DataRowOutlet,
- HeaderRowOutlet,
- FooterRowOutlet,
- CdkTextColumn,
- CdkNoDataRow,
- CdkRecycleRows,
- NoDataRowOutlet], exports: [CdkTable,
- CdkRowDef,
- CdkCellDef,
- CdkCellOutlet,
- CdkHeaderCellDef,
- CdkFooterCellDef,
- CdkColumnDef,
- CdkCell,
- CdkRow,
- CdkHeaderCell,
- CdkFooterCell,
- CdkHeaderRow,
- CdkHeaderRowDef,
- CdkFooterRow,
- CdkFooterRowDef,
- DataRowOutlet,
- HeaderRowOutlet,
- FooterRowOutlet,
- CdkTextColumn,
- CdkNoDataRow,
- CdkRecycleRows,
- NoDataRowOutlet] });
- static ɵinj = i0.ɵɵngDeclareInjector({ minVersion: "12.0.0", version: "19.2.6", ngImport: i0, type: CdkTableModule, imports: [ScrollingModule] });
- }
- i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "19.2.6", ngImport: i0, type: CdkTableModule, decorators: [{
- type: NgModule,
- args: [{
- exports: EXPORTED_DECLARATIONS,
- imports: [ScrollingModule, ...EXPORTED_DECLARATIONS],
- }]
- }] });
- /**
- * Mixin to provide a directive with a function that checks if the sticky input has been
- * changed since the last time the function was called. Essentially adds a dirty-check to the
- * sticky value.
- * @docs-private
- * @deprecated Implement the `CanStick` interface instead.
- * @breaking-change 19.0.0
- */
- function mixinHasStickyInput(base) {
- return class extends base {
- /** Whether sticky positioning should be applied. */
- get sticky() {
- return this._sticky;
- }
- set sticky(v) {
- const prevValue = this._sticky;
- this._sticky = coerceBooleanProperty(v);
- this._hasStickyChanged = prevValue !== this._sticky;
- }
- _sticky = false;
- /** Whether the sticky input has changed since it was last checked. */
- _hasStickyChanged = false;
- /** Whether the sticky value has changed since this was last called. */
- hasStickyChanged() {
- const hasStickyChanged = this._hasStickyChanged;
- this._hasStickyChanged = false;
- return hasStickyChanged;
- }
- /** Resets the dirty check for cases where the sticky state has been used without checking. */
- resetStickyChanged() {
- this._hasStickyChanged = false;
- }
- constructor(...args) {
- super(...args);
- }
- };
- }
- export { BaseCdkCell, BaseRowDef, CDK_ROW_TEMPLATE, CDK_TABLE, CDK_TABLE_TEMPLATE, CdkCell, CdkCellDef, CdkCellOutlet, CdkColumnDef, CdkFooterCell, CdkFooterCellDef, CdkFooterRow, CdkFooterRowDef, CdkHeaderCell, CdkHeaderCellDef, CdkHeaderRow, CdkHeaderRowDef, CdkNoDataRow, CdkRecycleRows, CdkRow, CdkRowDef, CdkTable, CdkTableModule, CdkTextColumn, DataRowOutlet, FooterRowOutlet, HeaderRowOutlet, NoDataRowOutlet, STICKY_DIRECTIONS, STICKY_POSITIONING_LISTENER, StickyStyler, TEXT_COLUMN_OPTIONS, _COALESCED_STYLE_SCHEDULER, _CoalescedStyleScheduler, _Schedule, mixinHasStickyInput };
- //# sourceMappingURL=table.mjs.map
|