@syncfusion/ej2-buttons
Version:
A package of feature-rich Essential JS 2 components such as Button, CheckBox, RadioButton and Switch.
193 lines (192 loc) • 5.22 kB
TypeScript
import { Component, INotifyPropertyChanged } from '@syncfusion/ej2-base';
import { EmitType } from '@syncfusion/ej2-base';
import { SwitchModel } from './switch-model';
import { ChangeEventArgs, BeforeChangeEventArgs } from './../common/common';
/**
* The Switch is a graphical user interface element that allows you to toggle between checked and unchecked states.
* ```html
* <input type="checkbox" id="switch"/>
* <script>
* var switchObj = new Switch({});
* switchObj.appendTo("#switch");
* </script>
* ```
*/
export declare class Switch extends Component<HTMLInputElement> implements INotifyPropertyChanged {
private tagName;
private isFocused;
private isDrag;
private isWireEvents;
private delegateMouseUpHandler;
private delegateKeyUpHandler;
private formElement;
private initialSwitchCheckedValue;
private bTouchY;
private bTouchX;
/**
* This event is triggered before the state of the switch is changed in the Switch component.
* @event beforeChange
* @remarks
* The `beforeChange` event allows developers to intercept and cancel the switch state change before it is applied.
*/
beforeChange: EmitType<BeforeChangeEventArgs>;
/**
* Triggers when Switch state has been changed by user interaction.
*
* @event change
*/
change: EmitType<ChangeEventArgs>;
/**
* Triggers once the component rendering is completed.
*
* @event created
*/
created: EmitType<Event>;
/**
* Specifies a value that indicates whether the Switch is `checked` or not.
* When set to `true`, the Switch will be in `checked` state.
*
* @default false
*/
checked: boolean;
/**
* You can add custom styles to the Switch by using this property.
*
* @default ''
*/
cssClass: string;
/**
* Specifies a value that indicates whether the Switch is `disabled` or not.
* When set to `true`, the Switch will be in `disabled` state.
*
* @default false
*/
disabled: boolean;
/**
* Defines `name` attribute for the Switch.
* It is used to reference form data (Switch value) after a form is submitted.
*
* @default ''
*/
name: string;
/**
* Specifies a text that indicates the Switch is in checked state.
*
* @default ''
*/
onLabel: string;
/**
* Specifies a text that indicates the Switch is in unchecked state.
*
* @default ''
*/
offLabel: string;
/**
* Defines `value` attribute for the Switch.
* It is a form data passed to the server when submitting the form.
*
* @default ''
*/
value: string;
/**
* You can add the additional html attributes such as disabled, value etc., to the element.
* If you configured both property and equivalent html attribute then the component considers the property value.
*
* @default {}
*/
htmlAttributes: {
[key: string]: string;
};
/**
* Constructor for creating the widget.
*
* @private
*
* @param {SwitchModel} options switch model
* @param {string | HTMLInputElement} element target element
*
*/
constructor(options?: SwitchModel, element?: string | HTMLInputElement);
private changeState;
private clickHandler;
/**
* Destroys the Switch widget.
*
* @returns {void}
*/
destroy(): void;
private focusHandler;
private focusOutHandler;
/**
* Gets the module name.
*
* @private
* @returns {string} - Module Name
*/
protected getModuleName(): string;
/**
* Gets the properties to be maintained in the persistence state.
*
* @private
* @returns {string} - Persist data
*/
getPersistData(): string;
private getWrapper;
private initialize;
private initWrapper;
/**
* Called internally if any of the property value changes.
*
* @private
* @param {SwitchModel} newProp - Specifies New Properties
* @param {SwitchModel} oldProp - Specifies Old Properties
* @returns {void}
*/
onPropertyChanged(newProp: SwitchModel, oldProp: SwitchModel): void;
/**
* Initialize Angular, React and Unique ID support.
*
* @private
* @returns {void}
*/
protected preRender(): void;
/**
* Initialize control rendering.
*
* @private
* @returns {void}
*/
protected render(): void;
private rippleHandler;
private mouseLeaveHandler;
private rippleTouchHandler;
private setDisabled;
private setLabel;
private updateHtmlAttribute;
private switchFocusHandler;
private switchMouseUp;
private formResetHandler;
/**
* Toggle the Switch component state into checked/unchecked.
*
* @returns {void}
*/
toggle(): void;
private wireEvents;
private unWireEvents;
/**
* Click the switch element
* its native method
*
* @public
* @returns {void}
*/
click(): void;
/**
* Sets the focus to Switch
* its native method
*
* @public
*/
focusIn(): void;
}