@angular/material 13.0.0-next.8 → 13.0.0-rc.3

package/fesm2015/sort.mjs

@@ -1,8 +1,8 @@
 import * as i0 from '@angular/core';
 import { Injectable, Optional, SkipSelf, InjectionToken, EventEmitter, Directive, Inject, Input, Output, Component, ViewEncapsulation, ChangeDetectionStrategy, NgModule } from '@angular/core';
 import { coerceBooleanProperty } from '@angular/cdk/coercion';
-import { AnimationDurations, AnimationCurves, mixinInitialized, mixinDisabled, MatCommonModule } from '@angular/material/core';
 import { SPACE, ENTER } from '@angular/cdk/keycodes';
+import { AnimationDurations, AnimationCurves, mixinInitialized, mixinDisabled, MatCommonModule } from '@angular/material/core';
 import { Subject, merge } from 'rxjs';
 import { trigger, state, style, transition, animate, keyframes, query, animateChild } from '@angular/animations';
 import * as i3 from '@angular/cdk/a11y';
@@ -16,8 +16,7 @@ import { CommonModule } from '@angular/common';
  * Use of this source code is governed by an MIT-style license that can be
  * found in the LICENSE file at https://angular.io/license
  */
-const SORT_ANIMATION_TRANSITION = AnimationDurations.ENTERING + ' ' +
-    AnimationCurves.STANDARD_CURVE;
+const SORT_ANIMATION_TRANSITION = AnimationDurations.ENTERING + ' ' + AnimationCurves.STANDARD_CURVE;
 /**
  * Animations used by MatSort.
  * @docs-private
@@ -28,24 +27,24 @@ const matSortAnimations = {
         state('active-asc, asc', style({ transform: 'translateY(0px)' })),
         // 10px is the height of the sort indicator, minus the width of the pointers
         state('active-desc, desc', style({ transform: 'translateY(10px)' })),
-        transition('active-asc <=> active-desc', animate(SORT_ANIMATION_TRANSITION))
+        transition('active-asc <=> active-desc', animate(SORT_ANIMATION_TRANSITION)),
     ]),
     /** Animation that rotates the left pointer of the indicator based on the sorting direction. */
     leftPointer: trigger('leftPointer', [
         state('active-asc, asc', style({ transform: 'rotate(-45deg)' })),
         state('active-desc, desc', style({ transform: 'rotate(45deg)' })),
-        transition('active-asc <=> active-desc', animate(SORT_ANIMATION_TRANSITION))
+        transition('active-asc <=> active-desc', animate(SORT_ANIMATION_TRANSITION)),
     ]),
     /** Animation that rotates the right pointer of the indicator based on the sorting direction. */
     rightPointer: trigger('rightPointer', [
         state('active-asc, asc', style({ transform: 'rotate(45deg)' })),
         state('active-desc, desc', style({ transform: 'rotate(-45deg)' })),
-        transition('active-asc <=> active-desc', animate(SORT_ANIMATION_TRANSITION))
+        transition('active-asc <=> active-desc', animate(SORT_ANIMATION_TRANSITION)),
     ]),
     /** Animation that controls the arrow opacity. */
     arrowOpacity: trigger('arrowOpacity', [
         state('desc-to-active, asc-to-active, active', style({ opacity: 1 })),
-        state('desc-to-hint, asc-to-hint, hint', style({ opacity: .54 })),
+        state('desc-to-hint, asc-to-hint, hint', style({ opacity: 0.54 })),
         state('hint-to-desc, active-to-desc, desc, hint-to-asc, active-to-asc, asc, void', style({ opacity: 0 })),
         // Transition between all states except for immediate transitions
         transition('* => asc, * => desc, * => active, * => hint, * => void', animate('0ms')),
@@ -60,34 +59,20 @@ const matSortAnimations = {
      */
     arrowPosition: trigger('arrowPosition', [
         // Hidden Above => Hint Center
-        transition('* => desc-to-hint, * => desc-to-active', animate(SORT_ANIMATION_TRANSITION, keyframes([
-            style({ transform: 'translateY(-25%)' }),
-            style({ transform: 'translateY(0)' })
-        ]))),
+        transition('* => desc-to-hint, * => desc-to-active', animate(SORT_ANIMATION_TRANSITION, keyframes([style({ transform: 'translateY(-25%)' }), style({ transform: 'translateY(0)' })]))),
         // Hint Center => Hidden Below
-        transition('* => hint-to-desc, * => active-to-desc', animate(SORT_ANIMATION_TRANSITION, keyframes([
-            style({ transform: 'translateY(0)' }),
-            style({ transform: 'translateY(25%)' })
-        ]))),
+        transition('* => hint-to-desc, * => active-to-desc', animate(SORT_ANIMATION_TRANSITION, keyframes([style({ transform: 'translateY(0)' }), style({ transform: 'translateY(25%)' })]))),
         // Hidden Below => Hint Center
-        transition('* => asc-to-hint, * => asc-to-active', animate(SORT_ANIMATION_TRANSITION, keyframes([
-            style({ transform: 'translateY(25%)' }),
-            style({ transform: 'translateY(0)' })
-        ]))),
+        transition('* => asc-to-hint, * => asc-to-active', animate(SORT_ANIMATION_TRANSITION, keyframes([style({ transform: 'translateY(25%)' }), style({ transform: 'translateY(0)' })]))),
         // Hint Center => Hidden Above
-        transition('* => hint-to-asc, * => active-to-asc', animate(SORT_ANIMATION_TRANSITION, keyframes([
-            style({ transform: 'translateY(0)' }),
-            style({ transform: 'translateY(-25%)' })
-        ]))),
+        transition('* => hint-to-asc, * => active-to-asc', animate(SORT_ANIMATION_TRANSITION, keyframes([style({ transform: 'translateY(0)' }), style({ transform: 'translateY(-25%)' })]))),
         state('desc-to-hint, asc-to-hint, hint, desc-to-active, asc-to-active, active', style({ transform: 'translateY(0)' })),
         state('hint-to-desc, active-to-desc, desc', style({ transform: 'translateY(-25%)' })),
         state('hint-to-asc, active-to-asc, asc', style({ transform: 'translateY(25%)' })),
     ]),
     /** Necessary trigger that calls animate on children animations. */
     allowChildren: trigger('allowChildren', [
-        transition('* <=> *', [
-            query('@*', animateChild(), { optional: true })
-        ])
+        transition('* <=> *', [query('@*', animateChild(), { optional: true })]),
     ]),
 };
 
@@ -125,8 +110,6 @@ function getSortInvalidDirectionError(direction) {
 /**
  * To modify the labels and text displayed, create a new instance of MatSortHeaderIntl and
  * include it in a custom provider.
- * @deprecated No longer being used. To be removed.
- * @breaking-change 13.0.0
  */
 class MatSortHeaderIntl {
     constructor() {
@@ -137,9 +120,9 @@ class MatSortHeaderIntl {
         this.changes = new Subject();
     }
 }
-MatSortHeaderIntl.ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "13.0.0-next.15", ngImport: i0, type: MatSortHeaderIntl, deps: [], target: i0.ɵɵFactoryTarget.Injectable });
-MatSortHeaderIntl.ɵprov = i0.ɵɵngDeclareInjectable({ minVersion: "12.0.0", version: "13.0.0-next.15", ngImport: i0, type: MatSortHeaderIntl, providedIn: 'root' });
-i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "13.0.0-next.15", ngImport: i0, type: MatSortHeaderIntl, decorators: [{
+MatSortHeaderIntl.ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "13.0.0-rc.3", ngImport: i0, type: MatSortHeaderIntl, deps: [], target: i0.ɵɵFactoryTarget.Injectable });
+MatSortHeaderIntl.ɵprov = i0.ɵɵngDeclareInjectable({ minVersion: "12.0.0", version: "13.0.0-rc.3", ngImport: i0, type: MatSortHeaderIntl, providedIn: 'root' });
+i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "13.0.0-rc.3", ngImport: i0, type: MatSortHeaderIntl, decorators: [{
             type: Injectable,
             args: [{ providedIn: 'root' }]
         }] });
@@ -152,7 +135,7 @@ const MAT_SORT_HEADER_INTL_PROVIDER = {
     // If there is already an MatSortHeaderIntl available, use that. Otherwise, provide a new one.
     provide: MatSortHeaderIntl,
     deps: [[new Optional(), new SkipSelf(), MatSortHeaderIntl]],
-    useFactory: MAT_SORT_HEADER_INTL_PROVIDER_FACTORY
+    useFactory: MAT_SORT_HEADER_INTL_PROVIDER_FACTORY,
 };
 
 /**
@@ -187,9 +170,13 @@ class MatSort extends _MatSortBase {
         this.sortChange = new EventEmitter();
     }
     /** The sort direction of the currently active MatSortable. */
-    get direction() { return this._direction; }
+    get direction() {
+        return this._direction;
+    }
     set direction(direction) {
-        if (direction && direction !== 'asc' && direction !== 'desc' &&
+        if (direction &&
+            direction !== 'asc' &&
+            direction !== 'desc' &&
             (typeof ngDevMode === 'undefined' || ngDevMode)) {
             throw getSortInvalidDirectionError(direction);
         }
@@ -199,8 +186,12 @@ class MatSort extends _MatSortBase {
      * Whether to disable the user from clearing the sort by finishing the sort direction cycle.
      * May be overriden by the MatSortable's disable clear input.
      */
-    get disableClear() { return this._disableClear; }
-    set disableClear(v) { this._disableClear = coerceBooleanProperty(v); }
+    get disableClear() {
+        return this._disableClear;
+    }
+    set disableClear(v) {
+        this._disableClear = coerceBooleanProperty(v);
+    }
     /**
      * Register function to be used by the contained MatSortables. Adds the MatSortable to the
      * collection of MatSortables.
@@ -260,15 +251,15 @@ class MatSort extends _MatSortBase {
         this._stateChanges.complete();
     }
 }
-MatSort.ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "13.0.0-next.15", ngImport: i0, type: MatSort, deps: [{ token: MAT_SORT_DEFAULT_OPTIONS, optional: true }], target: i0.ɵɵFactoryTarget.Directive });
-MatSort.ɵdir = i0.ɵɵngDeclareDirective({ minVersion: "12.0.0", version: "13.0.0-next.15", type: MatSort, selector: "[matSort]", inputs: { disabled: ["matSortDisabled", "disabled"], active: ["matSortActive", "active"], start: ["matSortStart", "start"], direction: ["matSortDirection", "direction"], disableClear: ["matSortDisableClear", "disableClear"] }, outputs: { sortChange: "matSortChange" }, host: { classAttribute: "mat-sort" }, exportAs: ["matSort"], usesInheritance: true, usesOnChanges: true, ngImport: i0 });
-i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "13.0.0-next.15", ngImport: i0, type: MatSort, decorators: [{
+MatSort.ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "13.0.0-rc.3", ngImport: i0, type: MatSort, deps: [{ token: MAT_SORT_DEFAULT_OPTIONS, optional: true }], target: i0.ɵɵFactoryTarget.Directive });
+MatSort.ɵdir = i0.ɵɵngDeclareDirective({ minVersion: "12.0.0", version: "13.0.0-rc.3", type: MatSort, selector: "[matSort]", inputs: { disabled: ["matSortDisabled", "disabled"], active: ["matSortActive", "active"], start: ["matSortStart", "start"], direction: ["matSortDirection", "direction"], disableClear: ["matSortDisableClear", "disableClear"] }, outputs: { sortChange: "matSortChange" }, host: { classAttribute: "mat-sort" }, exportAs: ["matSort"], usesInheritance: true, usesOnChanges: true, ngImport: i0 });
+i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "13.0.0-rc.3", ngImport: i0, type: MatSort, decorators: [{
             type: Directive,
             args: [{
                     selector: '[matSort]',
                     exportAs: 'matSort',
                     host: { 'class': 'mat-sort' },
-                    inputs: ['disabled: matSortDisabled']
+                    inputs: ['disabled: matSortDisabled'],
                 }]
         }], ctorParameters: function () {
         return [{ type: undefined, decorators: [{
@@ -305,13 +296,6 @@ function getSortDirectionCycle(start, disableClear) {
     return sortOrder;
 }
 
-/**
- * @license
- * Copyright Google LLC All Rights Reserved.
- *
- * Use of this source code is governed by an MIT-style license that can be
- * found in the LICENSE file at https://angular.io/license
- */
 // Boilerplate for applying mixins to the sort header.
 /** @docs-private */
 const _MatSortHeaderBase = mixinDisabled(class {
@@ -334,7 +318,9 @@ class MatSortHeader extends _MatSortHeaderBase {
     _intl, _changeDetectorRef, 
     // `MatSort` is not optionally injected, but just asserted manually w/ better error.
     // tslint:disable-next-line: lightweight-tokens
-    _sort, _columnDef, _focusMonitor, _elementRef) {
+    _sort, _columnDef, _focusMonitor, _elementRef, 
+    /** @breaking-change 14.0.0 _ariaDescriber will be required. */
+    _ariaDescriber) {
         // Note that we use a string token for the `_columnDef`, because the value is provided both by
         // `material/table` and `cdk/table` and we can't have the CDK depending on Material,
         // and we want to avoid having the sort header depending on the CDK table because
@@ -346,6 +332,7 @@ class MatSortHeader extends _MatSortHeaderBase {
         this._columnDef = _columnDef;
         this._focusMonitor = _focusMonitor;
         this._elementRef = _elementRef;
+        this._ariaDescriber = _ariaDescriber;
         /**
          * Flag set to true when the indicator should be displayed while the sort is not active. Used to
          * provide an affordance that the header is sortable by showing on focus and hover.
@@ -365,22 +352,44 @@ class MatSortHeader extends _MatSortHeaderBase {
         this._disableViewStateAnimation = false;
         /** Sets the position of the arrow that displays when sorted. */
         this.arrowPosition = 'after';
+        // Default the action description to "Sort" because it's better than nothing.
+        // Without a description, the button's label comes from the sort header text content,
+        // which doesn't give any indication that it performs a sorting operation.
+        this._sortActionDescription = 'Sort';
         if (!_sort && (typeof ngDevMode === 'undefined' || ngDevMode)) {
             throw getSortHeaderNotContainedWithinSortError();
         }
         this._handleStateChanges();
     }
+    /**
+     * Description applied to MatSortHeader's button element with aria-describedby. This text should
+     * describe the action that will occur when the user clicks the sort header.
+     */
+    get sortActionDescription() {
+        return this._sortActionDescription;
+    }
+    set sortActionDescription(value) {
+        this._updateSortActionDescription(value);
+    }
     /** Overrides the disable clear value of the containing MatSort for this MatSortable. */
-    get disableClear() { return this._disableClear; }
-    set disableClear(v) { this._disableClear = coerceBooleanProperty(v); }
+    get disableClear() {
+        return this._disableClear;
+    }
+    set disableClear(v) {
+        this._disableClear = coerceBooleanProperty(v);
+    }
     ngOnInit() {
         if (!this.id && this._columnDef) {
             this.id = this._columnDef.name;
         }
         // Initialize the direction of the arrow and set the view state to be immediately that state.
         this._updateArrowDirection();
-        this._setAnimationTransitionState({ toState: this._isSorted() ? 'active' : this._arrowDirection });
+        this._setAnimationTransitionState({
+            toState: this._isSorted() ? 'active' : this._arrowDirection,
+        });
         this._sort.register(this);
+        this._sortButton = this._elementRef.nativeElement.querySelector('[role="button"]');
+        this._updateSortActionDescription(this._sortActionDescription);
     }
     ngAfterViewInit() {
         // We use the focus monitor because we also want to style
@@ -452,8 +461,8 @@ class MatSortHeader extends _MatSortHeaderBase {
     }
     /** Whether this MatSortHeader is currently sorted in either ascending or descending order. */
     _isSorted() {
-        return this._sort.active == this.id &&
-            (this._sort.direction === 'asc' || this._sort.direction === 'desc');
+        return (this._sort.active == this.id &&
+            (this._sort.direction === 'asc' || this._sort.direction === 'desc'));
     }
     /** Returns the animation state for the arrow direction (indicator and pointers). */
     _getArrowDirectionState() {
@@ -475,9 +484,7 @@ class MatSortHeader extends _MatSortHeaderBase {
      * only be changed once the arrow displays again (hint or activation).
      */
     _updateArrowDirection() {
-        this._arrowDirection = this._isSorted() ?
-            this._sort.direction :
-            (this.start || this._sort.start);
+        this._arrowDirection = this._isSorted() ? this._sort.direction : this.start || this._sort.start;
     }
     _isDisabled() {
         return this._sort.disabled || this.disabled;
@@ -498,30 +505,44 @@ class MatSortHeader extends _MatSortHeaderBase {
     _renderArrow() {
         return !this._isDisabled() || this._isSorted();
     }
+    _updateSortActionDescription(newDescription) {
+        var _a, _b;
+        // We use AriaDescriber for the sort button instead of setting an `aria-label` because some
+        // screen readers (notably VoiceOver) will read both the column header *and* the button's label
+        // for every *cell* in the table, creating a lot of unnecessary noise.
+        // If _sortButton is undefined, the component hasn't been initialized yet so there's
+        // nothing to update in the DOM.
+        if (this._sortButton) {
+            // removeDescription will no-op if there is no existing message.
+            // TODO(jelbourn): remove optional chaining when AriaDescriber is required.
+            (_a = this._ariaDescriber) === null || _a === void 0 ? void 0 : _a.removeDescription(this._sortButton, this._sortActionDescription);
+            (_b = this._ariaDescriber) === null || _b === void 0 ? void 0 : _b.describe(this._sortButton, newDescription);
+        }
+        this._sortActionDescription = newDescription;
+    }
     /** Handles changes in the sorting state. */
     _handleStateChanges() {
-        this._rerenderSubscription =
-            merge(this._sort.sortChange, this._sort._stateChanges, this._intl.changes).subscribe(() => {
-                if (this._isSorted()) {
-                    this._updateArrowDirection();
-                    // Do not show the animation if the header was already shown in the right position.
-                    if (this._viewState.toState === 'hint' || this._viewState.toState === 'active') {
-                        this._disableViewStateAnimation = true;
-                    }
-                    this._setAnimationTransitionState({ fromState: this._arrowDirection, toState: 'active' });
-                    this._showIndicatorHint = false;
-                }
-                // If this header was recently active and now no longer sorted, animate away the arrow.
-                if (!this._isSorted() && this._viewState && this._viewState.toState === 'active') {
-                    this._disableViewStateAnimation = false;
-                    this._setAnimationTransitionState({ fromState: 'active', toState: this._arrowDirection });
+        this._rerenderSubscription = merge(this._sort.sortChange, this._sort._stateChanges, this._intl.changes).subscribe(() => {
+            if (this._isSorted()) {
+                this._updateArrowDirection();
+                // Do not show the animation if the header was already shown in the right position.
+                if (this._viewState.toState === 'hint' || this._viewState.toState === 'active') {
+                    this._disableViewStateAnimation = true;
                 }
-                this._changeDetectorRef.markForCheck();
-            });
+                this._setAnimationTransitionState({ fromState: this._arrowDirection, toState: 'active' });
+                this._showIndicatorHint = false;
+            }
+            // If this header was recently active and now no longer sorted, animate away the arrow.
+            if (!this._isSorted() && this._viewState && this._viewState.toState === 'active') {
+                this._disableViewStateAnimation = false;
+                this._setAnimationTransitionState({ fromState: 'active', toState: this._arrowDirection });
+            }
+            this._changeDetectorRef.markForCheck();
+        });
     }
 }
-MatSortHeader.ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "13.0.0-next.15", ngImport: i0, type: MatSortHeader, deps: [{ token: MatSortHeaderIntl }, { token: i0.ChangeDetectorRef }, { token: MatSort, optional: true }, { token: 'MAT_SORT_HEADER_COLUMN_DEF', optional: true }, { token: i3.FocusMonitor }, { token: i0.ElementRef }], target: i0.ɵɵFactoryTarget.Component });
-MatSortHeader.ɵcmp = i0.ɵɵngDeclareComponent({ minVersion: "12.0.0", version: "13.0.0-next.15", type: MatSortHeader, selector: "[mat-sort-header]", inputs: { disabled: "disabled", id: ["mat-sort-header", "id"], arrowPosition: "arrowPosition", start: "start", disableClear: "disableClear" }, host: { listeners: { "click": "_handleClick()", "keydown": "_handleKeydown($event)", "mouseenter": "_setIndicatorHintVisible(true)", "mouseleave": "_setIndicatorHintVisible(false)" }, properties: { "attr.aria-sort": "_getAriaSortAttribute()", "class.mat-sort-header-disabled": "_isDisabled()" }, classAttribute: "mat-sort-header" }, exportAs: ["matSortHeader"], usesInheritance: true, ngImport: i0, template: "<!--\n  We set the `tabindex` on an element inside the table header, rather than the header itself,\n  because of a bug in NVDA where having a `tabindex` on a `th` breaks keyboard navigation in the\n  table (see https://github.com/nvaccess/nvda/issues/7718). This allows for the header to both\n  be focusable, and have screen readers read out its `aria-sort` state. We prefer this approach\n  over having a button with an `aria-label` inside the header, because the button's `aria-label`\n  will be read out as the user is navigating the table's cell (see #13012).\n\n  The approach is based off of: https://dequeuniversity.com/library/aria/tables/sf-sortable-grid\n-->\n<div class=\"mat-sort-header-container mat-focus-indicator\"\n     [class.mat-sort-header-sorted]=\"_isSorted()\"\n     [class.mat-sort-header-position-before]=\"arrowPosition == 'before'\"\n     [attr.tabindex]=\"_isDisabled() ? null : 0\"\n     role=\"button\">\n\n  <!--\n    TODO(crisbeto): this div isn't strictly necessary, but we have to keep it due to a large\n    number of screenshot diff failures. It should be removed eventually. Note that the difference\n    isn't visible with a shorter header, but once it breaks up into multiple lines, this element\n    causes it to be center-aligned, whereas removing it will keep the text to the left.\n  -->\n  <div class=\"mat-sort-header-content\">\n    <ng-content></ng-content>\n  </div>\n\n  <!-- Disable animations while a current animation is running -->\n  <div class=\"mat-sort-header-arrow\"\n       *ngIf=\"_renderArrow()\"\n       [@arrowOpacity]=\"_getArrowViewState()\"\n       [@arrowPosition]=\"_getArrowViewState()\"\n       [@allowChildren]=\"_getArrowDirectionState()\"\n       (@arrowPosition.start)=\"_disableViewStateAnimation = true\"\n       (@arrowPosition.done)=\"_disableViewStateAnimation = false\">\n    <div class=\"mat-sort-header-stem\"></div>\n    <div class=\"mat-sort-header-indicator\" [@indicator]=\"_getArrowDirectionState()\">\n      <div class=\"mat-sort-header-pointer-left\" [@leftPointer]=\"_getArrowDirectionState()\"></div>\n      <div class=\"mat-sort-header-pointer-right\" [@rightPointer]=\"_getArrowDirectionState()\"></div>\n      <div class=\"mat-sort-header-pointer-middle\"></div>\n    </div>\n  </div>\n</div>\n", styles: [".mat-sort-header-container{display:flex;cursor:pointer;align-items:center;letter-spacing:normal;outline:0}[mat-sort-header].cdk-keyboard-focused .mat-sort-header-container,[mat-sort-header].cdk-program-focused .mat-sort-header-container{border-bottom:solid 1px currentColor}.mat-sort-header-disabled .mat-sort-header-container{cursor:default}.mat-sort-header-content{text-align:center;display:flex;align-items:center}.mat-sort-header-position-before{flex-direction:row-reverse}.mat-sort-header-arrow{height:12px;width:12px;min-width:12px;position:relative;display:flex;opacity:0}.mat-sort-header-arrow,[dir=rtl] .mat-sort-header-position-before .mat-sort-header-arrow{margin:0 0 0 6px}.mat-sort-header-position-before .mat-sort-header-arrow,[dir=rtl] .mat-sort-header-arrow{margin:0 6px 0 0}.mat-sort-header-stem{background:currentColor;height:10px;width:2px;margin:auto;display:flex;align-items:center}.cdk-high-contrast-active .mat-sort-header-stem{width:0;border-left:solid 2px}.mat-sort-header-indicator{width:100%;height:2px;display:flex;align-items:center;position:absolute;top:0;left:0}.mat-sort-header-pointer-middle{margin:auto;height:2px;width:2px;background:currentColor;transform:rotate(45deg)}.cdk-high-contrast-active .mat-sort-header-pointer-middle{width:0;height:0;border-top:solid 2px;border-left:solid 2px}.mat-sort-header-pointer-left,.mat-sort-header-pointer-right{background:currentColor;width:6px;height:2px;position:absolute;top:0}.cdk-high-contrast-active .mat-sort-header-pointer-left,.cdk-high-contrast-active .mat-sort-header-pointer-right{width:0;height:0;border-left:solid 6px;border-top:solid 2px}.mat-sort-header-pointer-left{transform-origin:right;left:0}.mat-sort-header-pointer-right{transform-origin:left;right:0}\n"], directives: [{ type: i4.NgIf, selector: "[ngIf]", inputs: ["ngIf", "ngIfThen", "ngIfElse"] }], animations: [
+MatSortHeader.ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "13.0.0-rc.3", ngImport: i0, type: MatSortHeader, deps: [{ token: MatSortHeaderIntl }, { token: i0.ChangeDetectorRef }, { token: MatSort, optional: true }, { token: 'MAT_SORT_HEADER_COLUMN_DEF', optional: true }, { token: i3.FocusMonitor }, { token: i0.ElementRef }, { token: i3.AriaDescriber, optional: true }], target: i0.ɵɵFactoryTarget.Component });
+MatSortHeader.ɵcmp = i0.ɵɵngDeclareComponent({ minVersion: "12.0.0", version: "13.0.0-rc.3", type: MatSortHeader, selector: "[mat-sort-header]", inputs: { disabled: "disabled", id: ["mat-sort-header", "id"], arrowPosition: "arrowPosition", start: "start", sortActionDescription: "sortActionDescription", disableClear: "disableClear" }, host: { listeners: { "click": "_handleClick()", "keydown": "_handleKeydown($event)", "mouseenter": "_setIndicatorHintVisible(true)", "mouseleave": "_setIndicatorHintVisible(false)" }, properties: { "attr.aria-sort": "_getAriaSortAttribute()", "class.mat-sort-header-disabled": "_isDisabled()" }, classAttribute: "mat-sort-header" }, exportAs: ["matSortHeader"], usesInheritance: true, ngImport: i0, template: "<!--\n  We set the `tabindex` on an element inside the table header, rather than the header itself,\n  because of a bug in NVDA where having a `tabindex` on a `th` breaks keyboard navigation in the\n  table (see https://github.com/nvaccess/nvda/issues/7718). This allows for the header to both\n  be focusable, and have screen readers read out its `aria-sort` state. We prefer this approach\n  over having a button with an `aria-label` inside the header, because the button's `aria-label`\n  will be read out as the user is navigating the table's cell (see #13012).\n\n  The approach is based off of: https://dequeuniversity.com/library/aria/tables/sf-sortable-grid\n-->\n<div class=\"mat-sort-header-container mat-focus-indicator\"\n     [class.mat-sort-header-sorted]=\"_isSorted()\"\n     [class.mat-sort-header-position-before]=\"arrowPosition == 'before'\"\n     [attr.tabindex]=\"_isDisabled() ? null : 0\"\n     role=\"button\">\n\n  <!--\n    TODO(crisbeto): this div isn't strictly necessary, but we have to keep it due to a large\n    number of screenshot diff failures. It should be removed eventually. Note that the difference\n    isn't visible with a shorter header, but once it breaks up into multiple lines, this element\n    causes it to be center-aligned, whereas removing it will keep the text to the left.\n  -->\n  <div class=\"mat-sort-header-content\">\n    <ng-content></ng-content>\n  </div>\n\n  <!-- Disable animations while a current animation is running -->\n  <div class=\"mat-sort-header-arrow\"\n       *ngIf=\"_renderArrow()\"\n       [@arrowOpacity]=\"_getArrowViewState()\"\n       [@arrowPosition]=\"_getArrowViewState()\"\n       [@allowChildren]=\"_getArrowDirectionState()\"\n       (@arrowPosition.start)=\"_disableViewStateAnimation = true\"\n       (@arrowPosition.done)=\"_disableViewStateAnimation = false\">\n    <div class=\"mat-sort-header-stem\"></div>\n    <div class=\"mat-sort-header-indicator\" [@indicator]=\"_getArrowDirectionState()\">\n      <div class=\"mat-sort-header-pointer-left\" [@leftPointer]=\"_getArrowDirectionState()\"></div>\n      <div class=\"mat-sort-header-pointer-right\" [@rightPointer]=\"_getArrowDirectionState()\"></div>\n      <div class=\"mat-sort-header-pointer-middle\"></div>\n    </div>\n  </div>\n</div>\n", styles: [".mat-sort-header-container{display:flex;cursor:pointer;align-items:center;letter-spacing:normal;outline:0}[mat-sort-header].cdk-keyboard-focused .mat-sort-header-container,[mat-sort-header].cdk-program-focused .mat-sort-header-container{border-bottom:solid 1px currentColor}.mat-sort-header-disabled .mat-sort-header-container{cursor:default}.mat-sort-header-content{text-align:center;display:flex;align-items:center}.mat-sort-header-position-before{flex-direction:row-reverse}.mat-sort-header-arrow{height:12px;width:12px;min-width:12px;position:relative;display:flex;opacity:0}.mat-sort-header-arrow,[dir=rtl] .mat-sort-header-position-before .mat-sort-header-arrow{margin:0 0 0 6px}.mat-sort-header-position-before .mat-sort-header-arrow,[dir=rtl] .mat-sort-header-arrow{margin:0 6px 0 0}.mat-sort-header-stem{background:currentColor;height:10px;width:2px;margin:auto;display:flex;align-items:center}.cdk-high-contrast-active .mat-sort-header-stem{width:0;border-left:solid 2px}.mat-sort-header-indicator{width:100%;height:2px;display:flex;align-items:center;position:absolute;top:0;left:0}.mat-sort-header-pointer-middle{margin:auto;height:2px;width:2px;background:currentColor;transform:rotate(45deg)}.cdk-high-contrast-active .mat-sort-header-pointer-middle{width:0;height:0;border-top:solid 2px;border-left:solid 2px}.mat-sort-header-pointer-left,.mat-sort-header-pointer-right{background:currentColor;width:6px;height:2px;position:absolute;top:0}.cdk-high-contrast-active .mat-sort-header-pointer-left,.cdk-high-contrast-active .mat-sort-header-pointer-right{width:0;height:0;border-left:solid 6px;border-top:solid 2px}.mat-sort-header-pointer-left{transform-origin:right;left:0}.mat-sort-header-pointer-right{transform-origin:left;right:0}\n"], directives: [{ type: i4.NgIf, selector: "[ngIf]", inputs: ["ngIf", "ngIfThen", "ngIfElse"] }], animations: [
         matSortAnimations.indicator,
         matSortAnimations.leftPointer,
         matSortAnimations.rightPointer,
@@ -529,7 +550,7 @@ MatSortHeader.ɵcmp = i0.ɵɵngDeclareComponent({ minVersion: "12.0.0", version:
         matSortAnimations.arrowPosition,
         matSortAnimations.allowChildren,
     ], changeDetection: i0.ChangeDetectionStrategy.OnPush, encapsulation: i0.ViewEncapsulation.None });
-i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "13.0.0-next.15", ngImport: i0, type: MatSortHeader, decorators: [{
+i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "13.0.0-rc.3", ngImport: i0, type: MatSortHeader, decorators: [{
             type: Component,
             args: [{ selector: '[mat-sort-header]', exportAs: 'matSortHeader', host: {
                         'class': 'mat-sort-header',
@@ -555,7 +576,9 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "13.0.0-next.15",
                         args: ['MAT_SORT_HEADER_COLUMN_DEF']
                     }, {
                         type: Optional
-                    }] }, { type: i3.FocusMonitor }, { type: i0.ElementRef }];
+                    }] }, { type: i3.FocusMonitor }, { type: i0.ElementRef }, { type: i3.AriaDescriber, decorators: [{
+                        type: Optional
+                    }] }];
     }, propDecorators: { id: [{
                 type: Input,
                 args: ['mat-sort-header']
@@ -563,6 +586,8 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "13.0.0-next.15",
                 type: Input
             }], start: [{
                 type: Input
+            }], sortActionDescription: [{
+                type: Input
             }], disableClear: [{
                 type: Input
             }] } });
@@ -576,16 +601,16 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "13.0.0-next.15",
  */
 class MatSortModule {
 }
-MatSortModule.ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "13.0.0-next.15", ngImport: i0, type: MatSortModule, deps: [], target: i0.ɵɵFactoryTarget.NgModule });
-MatSortModule.ɵmod = i0.ɵɵngDeclareNgModule({ minVersion: "12.0.0", version: "13.0.0-next.15", ngImport: i0, type: MatSortModule, declarations: [MatSort, MatSortHeader], imports: [CommonModule, MatCommonModule], exports: [MatSort, MatSortHeader] });
-MatSortModule.ɵinj = i0.ɵɵngDeclareInjector({ minVersion: "12.0.0", version: "13.0.0-next.15", ngImport: i0, type: MatSortModule, providers: [MAT_SORT_HEADER_INTL_PROVIDER], imports: [[CommonModule, MatCommonModule]] });
-i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "13.0.0-next.15", ngImport: i0, type: MatSortModule, decorators: [{
+MatSortModule.ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "13.0.0-rc.3", ngImport: i0, type: MatSortModule, deps: [], target: i0.ɵɵFactoryTarget.NgModule });
+MatSortModule.ɵmod = i0.ɵɵngDeclareNgModule({ minVersion: "12.0.0", version: "13.0.0-rc.3", ngImport: i0, type: MatSortModule, declarations: [MatSort, MatSortHeader], imports: [CommonModule, MatCommonModule], exports: [MatSort, MatSortHeader] });
+MatSortModule.ɵinj = i0.ɵɵngDeclareInjector({ minVersion: "12.0.0", version: "13.0.0-rc.3", ngImport: i0, type: MatSortModule, providers: [MAT_SORT_HEADER_INTL_PROVIDER], imports: [[CommonModule, MatCommonModule]] });
+i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "13.0.0-rc.3", ngImport: i0, type: MatSortModule, decorators: [{
             type: NgModule,
             args: [{
                     imports: [CommonModule, MatCommonModule],
                     exports: [MatSort, MatSortHeader],
                     declarations: [MatSort, MatSortHeader],
-                    providers: [MAT_SORT_HEADER_INTL_PROVIDER]
+                    providers: [MAT_SORT_HEADER_INTL_PROVIDER],
                 }]
         }] });
 
@@ -597,6 +622,14 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "13.0.0-next.15",
  * found in the LICENSE file at https://angular.io/license
  */
 
+/**
+ * @license
+ * Copyright Google LLC All Rights Reserved.
+ *
+ * Use of this source code is governed by an MIT-style license that can be
+ * found in the LICENSE file at https://angular.io/license
+ */
+
 /**
  * Generated bundle index. Do not edit.
  */