Similar to a checkbox, a switch controls the state of a single setting on or off.
Element
igc-switch
Slots
default — The switch label.
CSS Parts
base — The base wrapper of the switch.
control — The switch input element.
thumb — The position indicator of the switch.
label — The switch label.

Properties

Section titled "Properties"

disabled

Section titled "disabled"

Inherited from: IgcCheckboxBaseComponent

The disabled state of the component.

 
disabled: boolean

Defined in src/components/common/mixins/forms/types.ts:29

invalid

Section titled "invalid"

Inherited from: IgcCheckboxBaseComponent

Sets the control into invalid state (visual state only).

 
invalid: boolean

Defined in src/components/common/mixins/forms/types.ts:36

labelPosition

Section titled "labelPosition"

Inherited from: IgcCheckboxBaseComponent

The label position of the control.

 
labelPosition: ToggleLabelPosition = 'after'

Defined in src/components/checkbox/checkbox-base.ts:91

name

Section titled "name"

Inherited from: IgcCheckboxBaseComponent

The name attribute of the control.

 
name: string

Defined in src/components/common/mixins/forms/types.ts:42

Accessors

Section titled "Accessors"

form

Section titled "form"

Inherited from: IgcCheckboxBaseComponent

Returns the HTMLFormElement associated with this element.

get form(): HTMLFormElement | null

Defined in src/components/common/mixins/forms/types.ts:45

Returns HTMLFormElement | null

validationMessage

Section titled "validationMessage"

Inherited from: IgcCheckboxBaseComponent

A string containing the validation message of this element.

get validationMessage(): string

Defined in src/components/common/mixins/forms/types.ts:54

Returns string

validity

Section titled "validity"

Inherited from: IgcCheckboxBaseComponent

Returns a ValidityState object which represents the different validity states the element can be in, with respect to constraint validation.

get validity(): ValidityState

Defined in src/components/common/mixins/forms/types.ts:51

Returns ValidityState

willValidate

Section titled "willValidate"

Inherited from: IgcCheckboxBaseComponent

A boolean value which returns true if the element is a submittable element that is a candidate for constraint validation.

get willValidate(): boolean

Defined in src/components/common/mixins/forms/types.ts:60

Returns boolean

Methods

Section titled "Methods"

blur

Section titled "blur"

Inherited from: IgcCheckboxBaseComponent

Removes focus from the control.

blur(): void

Defined in src/components/checkbox/checkbox-base.ts:106

Returns void

checkValidity

Section titled "checkValidity"

Inherited from: IgcCheckboxBaseComponent

Checks for validity of the control and emits the invalid event if it invalid.

checkValidity(): boolean

Defined in src/components/common/mixins/forms/types.ts:140

Returns boolean

click

Section titled "click"

Inherited from: IgcCheckboxBaseComponent

Simulates a click on the control.

click(): void

Defined in src/components/checkbox/checkbox-base.ts:94

Returns void

focus

Section titled "focus"

Inherited from: IgcCheckboxBaseComponent

Sets focus on the control.

focus(options: FocusOptions): void

Defined in src/components/checkbox/checkbox-base.ts:100

Parameters

  • options: FocusOptions

Returns void

reportValidity

Section titled "reportValidity"

Inherited from: IgcCheckboxBaseComponent

Checks for validity of the control and shows the browser message if it invalid.

reportValidity(): boolean

Defined in src/components/common/mixins/forms/types.ts:143

Returns boolean

setCustomValidity

Section titled "setCustomValidity"

Inherited from: IgcCheckboxBaseComponent

Sets a custom validation message for the control. As long as message is not empty, the control is considered invalid.

setCustomValidity(message: string): void

Defined in src/components/common/mixins/forms/types.ts:149

Parameters

  • message: string

Returns void