You can not select more than 25 topics
Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
261 lines
11 KiB
261 lines
11 KiB
/**
|
|
* @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
|
|
*/
|
|
import { Directionality } from '@angular/cdk/bidi';
|
|
import { BooleanInput, NumberInput } from '@angular/cdk/coercion';
|
|
import { AfterViewInit, ChangeDetectorRef, ElementRef, EventEmitter, InjectionToken, OnChanges, OnDestroy, QueryList, TemplateRef, AfterContentInit } from '@angular/core';
|
|
import { Observable, Subject } from 'rxjs';
|
|
import { CdkStepHeader } from './step-header';
|
|
import { CdkStepLabel } from './step-label';
|
|
/**
|
|
* Position state of the content of each step in stepper that is used for transitioning
|
|
* the content into correct position upon step selection change.
|
|
*/
|
|
import * as ɵngcc0 from '@angular/core';
|
|
export declare type StepContentPositionState = 'previous' | 'current' | 'next';
|
|
/** Possible orientation of a stepper. */
|
|
export declare type StepperOrientation = 'horizontal' | 'vertical';
|
|
/** Change event emitted on selection changes. */
|
|
export declare class StepperSelectionEvent {
|
|
/** Index of the step now selected. */
|
|
selectedIndex: number;
|
|
/** Index of the step previously selected. */
|
|
previouslySelectedIndex: number;
|
|
/** The step instance now selected. */
|
|
selectedStep: CdkStep;
|
|
/** The step instance previously selected. */
|
|
previouslySelectedStep: CdkStep;
|
|
}
|
|
/** The state of each step. */
|
|
export declare type StepState = 'number' | 'edit' | 'done' | 'error' | string;
|
|
/** Enum to represent the different states of the steps. */
|
|
export declare const STEP_STATE: {
|
|
NUMBER: string;
|
|
EDIT: string;
|
|
DONE: string;
|
|
ERROR: string;
|
|
};
|
|
/** InjectionToken that can be used to specify the global stepper options. */
|
|
export declare const STEPPER_GLOBAL_OPTIONS: InjectionToken<StepperOptions>;
|
|
/** Configurable options for stepper. */
|
|
export interface StepperOptions {
|
|
/**
|
|
* Whether the stepper should display an error state or not.
|
|
* Default behavior is assumed to be false.
|
|
*/
|
|
showError?: boolean;
|
|
/**
|
|
* Whether the stepper should display the default indicator type
|
|
* or not.
|
|
* Default behavior is assumed to be true.
|
|
*/
|
|
displayDefaultIndicatorType?: boolean;
|
|
}
|
|
export declare class CdkStep implements OnChanges {
|
|
_stepper: CdkStepper;
|
|
private _stepperOptions;
|
|
_displayDefaultIndicatorType: boolean;
|
|
/** Template for step label if it exists. */
|
|
stepLabel: CdkStepLabel;
|
|
/** Template for step content. */
|
|
content: TemplateRef<any>;
|
|
/** The top level abstract control of the step. */
|
|
stepControl: AbstractControlLike;
|
|
/** Whether user has attempted to move away from the step. */
|
|
interacted: boolean;
|
|
/** Emits when the user has attempted to move away from the step. */
|
|
readonly interactedStream: EventEmitter<CdkStep>;
|
|
/** Plain text label of the step. */
|
|
label: string;
|
|
/** Error message to display when there's an error. */
|
|
errorMessage: string;
|
|
/** Aria label for the tab. */
|
|
ariaLabel: string;
|
|
/**
|
|
* Reference to the element that the tab is labelled by.
|
|
* Will be cleared if `aria-label` is set at the same time.
|
|
*/
|
|
ariaLabelledby: string;
|
|
/** State of the step. */
|
|
state: StepState;
|
|
/** Whether the user can return to this step once it has been marked as completed. */
|
|
get editable(): boolean;
|
|
set editable(value: boolean);
|
|
private _editable;
|
|
/** Whether the completion of step is optional. */
|
|
get optional(): boolean;
|
|
set optional(value: boolean);
|
|
private _optional;
|
|
/** Whether step is marked as completed. */
|
|
get completed(): boolean;
|
|
set completed(value: boolean);
|
|
_completedOverride: boolean | null;
|
|
private _getDefaultCompleted;
|
|
/** Whether step has an error. */
|
|
get hasError(): boolean;
|
|
set hasError(value: boolean);
|
|
private _customError;
|
|
private _getDefaultError;
|
|
constructor(_stepper: CdkStepper, stepperOptions?: StepperOptions);
|
|
/** Selects this step component. */
|
|
select(): void;
|
|
/** Resets the step to its initial state. Note that this includes resetting form data. */
|
|
reset(): void;
|
|
ngOnChanges(): void;
|
|
_markAsInteracted(): void;
|
|
/** Determines whether the error state can be shown. */
|
|
_showError(): boolean;
|
|
static ngAcceptInputType_editable: BooleanInput;
|
|
static ngAcceptInputType_hasError: BooleanInput;
|
|
static ngAcceptInputType_optional: BooleanInput;
|
|
static ngAcceptInputType_completed: BooleanInput;
|
|
static ɵfac: ɵngcc0.ɵɵFactoryDeclaration<CdkStep, [null, { optional: true; }]>;
|
|
static ɵcmp: ɵngcc0.ɵɵComponentDeclaration<CdkStep, "cdk-step", ["cdkStep"], { "editable": "editable"; "optional": "optional"; "completed": "completed"; "hasError": "hasError"; "stepControl": "stepControl"; "label": "label"; "errorMessage": "errorMessage"; "ariaLabel": "aria-label"; "ariaLabelledby": "aria-labelledby"; "state": "state"; }, { "interactedStream": "interacted"; }, ["stepLabel"], ["*"]>;
|
|
}
|
|
export declare class CdkStepper implements AfterContentInit, AfterViewInit, OnDestroy {
|
|
private _dir;
|
|
private _changeDetectorRef;
|
|
private _elementRef;
|
|
/** Emits when the component is destroyed. */
|
|
protected readonly _destroyed: Subject<void>;
|
|
/** Used for managing keyboard focus. */
|
|
private _keyManager;
|
|
/** Full list of steps inside the stepper, including inside nested steppers. */
|
|
_steps: QueryList<CdkStep>;
|
|
/** Steps that belong to the current stepper, excluding ones from nested steppers. */
|
|
readonly steps: QueryList<CdkStep>;
|
|
/** The list of step headers of the steps in the stepper. */
|
|
_stepHeader: QueryList<CdkStepHeader>;
|
|
/** List of step headers sorted based on their DOM order. */
|
|
private _sortedHeaders;
|
|
/** Whether the validity of previous steps should be checked or not. */
|
|
get linear(): boolean;
|
|
set linear(value: boolean);
|
|
private _linear;
|
|
/** The index of the selected step. */
|
|
get selectedIndex(): number;
|
|
set selectedIndex(index: number);
|
|
private _selectedIndex;
|
|
/** The step that is selected. */
|
|
get selected(): CdkStep | undefined;
|
|
set selected(step: CdkStep | undefined);
|
|
/** Event emitted when the selected step has changed. */
|
|
readonly selectionChange: EventEmitter<StepperSelectionEvent>;
|
|
/** Used to track unique ID for each stepper component. */
|
|
_groupId: number;
|
|
/** Orientation of the stepper. */
|
|
get orientation(): StepperOrientation;
|
|
set orientation(value: StepperOrientation);
|
|
/**
|
|
* @deprecated To be turned into a private property. Use `orientation` instead.
|
|
* @breaking-change 13.0.0
|
|
*/
|
|
protected _orientation: StepperOrientation;
|
|
constructor(_dir: Directionality, _changeDetectorRef: ChangeDetectorRef, _elementRef: ElementRef<HTMLElement>,
|
|
/**
|
|
* @deprecated No longer in use, to be removed.
|
|
* @breaking-change 13.0.0
|
|
*/
|
|
_document: any);
|
|
ngAfterContentInit(): void;
|
|
ngAfterViewInit(): void;
|
|
ngOnDestroy(): void;
|
|
/** Selects and focuses the next step in list. */
|
|
next(): void;
|
|
/** Selects and focuses the previous step in list. */
|
|
previous(): void;
|
|
/** Resets the stepper to its initial state. Note that this includes clearing form data. */
|
|
reset(): void;
|
|
/** Returns a unique id for each step label element. */
|
|
_getStepLabelId(i: number): string;
|
|
/** Returns unique id for each step content element. */
|
|
_getStepContentId(i: number): string;
|
|
/** Marks the component to be change detected. */
|
|
_stateChanged(): void;
|
|
/** Returns position state of the step with the given index. */
|
|
_getAnimationDirection(index: number): StepContentPositionState;
|
|
/** Returns the type of icon to be displayed. */
|
|
_getIndicatorType(index: number, state?: StepState): StepState;
|
|
private _getDefaultIndicatorLogic;
|
|
private _getGuidelineLogic;
|
|
private _isCurrentStep;
|
|
/** Returns the index of the currently-focused step header. */
|
|
_getFocusIndex(): number | null;
|
|
private _updateSelectedItemIndex;
|
|
_onKeydown(event: KeyboardEvent): void;
|
|
private _anyControlsInvalidOrPending;
|
|
private _layoutDirection;
|
|
/** Checks whether the stepper contains the focused element. */
|
|
private _containsFocus;
|
|
/** Checks whether the passed-in index is a valid step index. */
|
|
private _isValidIndex;
|
|
static ngAcceptInputType_editable: BooleanInput;
|
|
static ngAcceptInputType_optional: BooleanInput;
|
|
static ngAcceptInputType_completed: BooleanInput;
|
|
static ngAcceptInputType_hasError: BooleanInput;
|
|
static ngAcceptInputType_linear: BooleanInput;
|
|
static ngAcceptInputType_selectedIndex: NumberInput;
|
|
static ɵfac: ɵngcc0.ɵɵFactoryDeclaration<CdkStepper, [{ optional: true; }, null, null, null]>;
|
|
static ɵdir: ɵngcc0.ɵɵDirectiveDeclaration<CdkStepper, "[cdkStepper]", ["cdkStepper"], { "linear": "linear"; "selectedIndex": "selectedIndex"; "selected": "selected"; "orientation": "orientation"; }, { "selectionChange": "selectionChange"; }, ["_steps", "_stepHeader"]>;
|
|
}
|
|
/**
|
|
* Simplified representation of an "AbstractControl" from @angular/forms.
|
|
* Used to avoid having to bring in @angular/forms for a single optional interface.
|
|
* @docs-private
|
|
*/
|
|
interface AbstractControlLike {
|
|
asyncValidator: ((control: any) => any) | null;
|
|
dirty: boolean;
|
|
disabled: boolean;
|
|
enabled: boolean;
|
|
errors: {
|
|
[key: string]: any;
|
|
} | null;
|
|
invalid: boolean;
|
|
parent: any;
|
|
pending: boolean;
|
|
pristine: boolean;
|
|
root: AbstractControlLike;
|
|
status: string;
|
|
readonly statusChanges: Observable<any>;
|
|
touched: boolean;
|
|
untouched: boolean;
|
|
updateOn: any;
|
|
valid: boolean;
|
|
validator: ((control: any) => any) | null;
|
|
value: any;
|
|
readonly valueChanges: Observable<any>;
|
|
clearAsyncValidators(): void;
|
|
clearValidators(): void;
|
|
disable(opts?: any): void;
|
|
enable(opts?: any): void;
|
|
get(path: (string | number)[] | string): AbstractControlLike | null;
|
|
getError(errorCode: string, path?: (string | number)[] | string): any;
|
|
hasError(errorCode: string, path?: (string | number)[] | string): boolean;
|
|
markAllAsTouched(): void;
|
|
markAsDirty(opts?: any): void;
|
|
markAsPending(opts?: any): void;
|
|
markAsPristine(opts?: any): void;
|
|
markAsTouched(opts?: any): void;
|
|
markAsUntouched(opts?: any): void;
|
|
patchValue(value: any, options?: Object): void;
|
|
reset(value?: any, options?: Object): void;
|
|
setAsyncValidators(newValidator: (control: any) => any | ((control: any) => any)[] | null): void;
|
|
setErrors(errors: {
|
|
[key: string]: any;
|
|
} | null, opts?: any): void;
|
|
setParent(parent: any): void;
|
|
setValidators(newValidator: (control: any) => any | ((control: any) => any)[] | null): void;
|
|
setValue(value: any, options?: Object): void;
|
|
updateValueAndValidity(opts?: any): void;
|
|
patchValue(value: any, options?: any): void;
|
|
reset(formState?: any, options?: any): void;
|
|
setValue(value: any, options?: any): void;
|
|
}
|
|
export {};
|
|
|
|
//# sourceMappingURL=stepper.d.ts.map
|