/**-----------------------------------------------------------------------------------------
* Copyright © 2024 Progress Software Corporation. All rights reserved.
* Licensed under commercial license. See LICENSE.md in the project root for more information
*-------------------------------------------------------------------------------------------*/
import { ElementRef, EventEmitter, OnChanges, Renderer2, SimpleChanges, NgZone, Injector, ChangeDetectorRef } from '@angular/core';
import { AbstractControl, ControlValueAccessor, Validator } from '@angular/forms';
import { PrefixTemplateDirective, SuffixTemplateDirective } from '@progress/kendo-angular-common';
import { MaskingService } from './masking.service';
import { InputSize } from '../common/models';
import { InputRounded } from '../common/models/rounded';
import { InputFillMode } from '../common/models/fillmode';
import * as i0 from "@angular/core";
/**
* Represents the [Kendo UI MaskedTextBox component for Angular]({% slug overview_maskedtextbox %}).
*
* @example
* ```ts-no-run
*
* _@Component({
* selector: 'my-app',
* template: `
*
*
* `
* })
*
* class AppComponent {
* public value: string = "9580128055807792";
* public mask: string = "0000-0000-0000-0000";
* }
* ```
*/
export declare class MaskedTextBoxComponent implements ControlValueAccessor, OnChanges, Validator {
private service;
private renderer;
hostElement: ElementRef;
private ngZone;
private injector;
private changeDetector;
/**
* @hidden
*/
focusableId: string;
/**
* Determines whether the MaskedTextBox is disabled ([see example]({% slug disabled_maskedtextbox %})). To learn how to disable the component in reactive forms, refer to the article on [Forms Support](slug:formssupport_maskedtextbox#toc-managing-the-maskedtextbox-disabled-state-in-reactive-forms).
*/
disabled: boolean;
/**
* Determines whether the MaskedTextBox is in its read-only state ([see example]({% slug readonly_maskedtextbox %})).
*
* @default false
*/
readonly: boolean;
/**
* Sets the title of the `input` element.
*/
title: string;
/**
* The size property specifies the padding of the MaskedTextBox internal input element
* ([see example]({% slug appearance_maskedtextbox %}#toc-size)).
* The possible values are:
* * `small`
* * `medium` (default)
* * `large`
* * `none`
*/
set size(size: InputSize);
get size(): InputSize;
/**
* The rounded property specifies the border radius of the MaskedTextBox
* ([see example](slug:appearance_maskedtextbox#toc-roundness)).
* The possible values are:
* * `small`
* * `medium` (default)
* * `large`
* * `none`
*/
set rounded(rounded: InputRounded);
get rounded(): InputRounded;
/**
* The `fillMode` property specifies the background and border styles of the MaskedTexBox
* ([see example]({% slug appearance_maskedtextbox %}#toc-fill-mode)).
* The possible values are:
* * `flat`
* * `solid` (default)
* * `outline`
* * `none`
*/
set fillMode(fillMode: InputFillMode);
get fillMode(): InputFillMode;
/**
* Represents the current mask ([see example]({% slug value_maskedtextbox %})).
* If no mask is set, the component behaves as a standard `type="text"` input.
*
* > If the mask allows for spaces, set the [promptPlaceholder]({% slug api_inputs_maskedtextboxcomponent %}#toc-promptplaceholder)
* to a character that is not accepted by the mask.
*/
mask: string;
/**
* Provides a value for the MaskedTextBox.
*/
value: string;
/**
* Exposes the RegExp-based mask validation array ([see example]({% slug masks_maskedtextbox %})).
*/
set rules(value: {
[key: string]: RegExp;
});
get rules(): {
[key: string]: RegExp;
};
/**
* Represents a prompt character for the masked value.
* @default `_`
*/
prompt: string;
/**
* Indicates a character which represents an empty position in the raw value.
* @default ' '
*/
promptPlaceholder: string;
/**
* Indicates whether to include literals in the raw value ([see example]({% slug value_maskedtextbox %})).
* @default false
*/
includeLiterals: boolean;
/**
* Specifies if the mask should be shown on focus for empty value.
*/
maskOnFocus: boolean;
/**
* Determines whether the built-in mask validator is enforced when a form is validated
* ([see example]({% slug validation_maskedtextbox %})).
* @default true
*/
maskValidation: boolean;
/**
* Specifies the [tabindex](https://developer.mozilla.org/en-US/docs/Web/HTML/Global_attributes/tabindex) of the component.
*/
tabindex: number;
/**
* @hidden
*/
set tabIndex(tabIndex: number);
get tabIndex(): number;
/**
* Sets the HTML attributes of the inner focusable input element. Attributes which are essential for certain component functionalities cannot be changed.
*/
set inputAttributes(attributes: {
[key: string]: string;
});
get inputAttributes(): {
[key: string]: string;
};
private get defaultAttributes();
private get mutableAttributes();
/**
* Fires each time the user focuses the MaskedTextBox component.
*
* > To wire the event programmatically, use the `onFocus` property.
*
* @example
* ```ts-no-run
* _@Component({
* selector: 'my-app',
* template: `
*
* `
* })
* class AppComponent {
* public handleFocus(): void {
* console.log("Component is focused");
* }
* }
* ```
*/
onFocus: EventEmitter;
/**
* Fires each time the MaskedTextBox component gets blurred.
*
* > To wire the event programmatically, use the `onBlur` property.
*
* @example
* ```ts-no-run
* _@Component({
* selector: 'my-app',
* template: `
*
* `
* })
* class AppComponent {
* public handleBlur(): void {
* console.log("Component is blurred");
* }
* }
* ```
*/
onBlur: EventEmitter;
/**
* Fires each time the user focuses the `input` element.
*/
inputFocus: EventEmitter;
/**
* Fires each time the `input` element gets blurred.
*/
inputBlur: EventEmitter;
/**
* Fires each time the value changes.
*/
valueChange: EventEmitter;
direction: string;
hostClasses: boolean;
get hostDisabledClass(): boolean;
/**
* Represents the `ElementRef` of the visible `input` element.
*/
input: ElementRef;
/**
* @hidden
*/
suffixTemplate: SuffixTemplateDirective;
/**
* @hidden
*/
prefixTemplate: PrefixTemplateDirective;
protected isFocused: boolean;
private maskedValue;
private focusClick;
private defaultRules;
private _rules;
private isPasted;
private selection;
private control;
private _size;
private _rounded;
private _fillMode;
private _inputAttributes;
private parsedAttributes;
constructor(service: MaskingService, renderer: Renderer2, hostElement: ElementRef, ngZone: NgZone, injector: Injector, changeDetector: ChangeDetectorRef, rtl: boolean);
ngOnInit(): void;
ngAfterViewInit(): void;
/**
* @hidden
* Used by the FloatingLabel to determine if the MaskedTextBox is empty.
*/
isEmpty(): boolean;
/**
* @hidden
*/
handleFocus: () => void;
/**
* @hidden
*/
handleInputFocus: () => void;
/**
* @hidden
*/
handleClick: () => void;
/**
* @hidden
*/
handleBlur: () => void;
/**
* @hidden
*/
handleInputBlur: () => void;
/**
* @hidden
*/
handleDragDrop(): boolean;
/**
* Focuses the MaskedTextBox.
*
* @example
* ```ts-no-run
* _@Component({
* selector: 'my-app',
* template: `
*
*
* `
* })
* class AppComponent { }
* ```
*/
focus(): void;
/**
* Blurs the MaskedTextBox.
*/
blur(): void;
/**
* @hidden
*/
pasteHandler(e: any): void;
/**
* @hidden
*/
inputHandler(e: any): void;
/**
* @hidden
*/
ngOnChanges(changes: SimpleChanges): void;
/**
* @hidden
* Writes a new value to the element.
*/
writeValue(value: string): void;
/**
* @hidden
* Sets the function that will be called when a `change` event is triggered.
*/
registerOnChange(fn: (_: any) => void): void;
/**
* @hidden
* Sets the function that will be called when a `touch` event is triggered.
*/
registerOnTouched(fn: () => void): void;
/**
* @hidden
* Called when the status of the component changes to or from `disabled`.
* Depending on the value, it enables or disables the appropriate DOM element.
*
* @param isDisabled
*/
setDisabledState(isDisabled: boolean): void;
/**
* @hidden
*/
validate(_?: AbstractControl): any;
/**
* @hidden
*/
get isControlInvalid(): boolean;
/**
* @hidden
*/
get isControlRequired(): boolean;
/**
* @hidden
*/
updateValueWithEvents(maskedValue: string, callOnChange?: boolean): void;
protected onChange: (_: any) => void;
protected onTouched: () => void;
private updateValue;
private updateInput;
private extractChanges;
private updateService;
private setSelection;
private get emptyMask();
private setFocusSelection;
/**
* @hidden
*/
get focused(): boolean;
/**
* @hidden
*/
set focused(value: boolean);
private normalizeValue;
private handleClasses;
private setInputAttributes;
static ɵfac: i0.ɵɵFactoryDeclaration;
static ɵcmp: i0.ɵɵComponentDeclaration;
}