Class IgcSwitchComponent

Similar to a checkbox, a switch controls the state of a single setting on or off.

Element

igc-switch

Slot

The switch label.

Fires

igcChange - Emitted when the control's checked state changes.

Fires

igcFocus - Emitted when the control gains focus.

Fires

igcBlur - Emitted when the control loses focus.

Csspart

base - The base wrapper of the switch.

Csspart

control - The switch control.

Csspart

thumb - The position indicator of the switch.

Csspart

label - The switch label.

Hierarchy

IgcCheckboxBaseComponent
- IgcSwitchComponent

Constructors

constructor

new IgcSwitchComponent(): IgcSwitchComponent
Inherited from IgcCheckboxBaseComponent.constructor
- Defined in src/components/checkbox/checkbox-base.ts:83
Returns IgcSwitchComponent

Properties

disabled

disabled: boolean

The disabled state of the component

Attr

[disabled=false]

invalid

invalid: boolean

Control the validity of the control.

Attr

labelPosition

labelPosition: "after" | "before" = 'after'

The label position of the control.

Attr

label-position

name

name: string

The name attribute of the control.

Attr

required

required: boolean

Makes the control a required field in a form context.

Attr

`Static` styles

styles: CSSResult[] = ...

`Static` `Readonly` tagName

tagName: "igc-switch" = 'igc-switch'

Accessors

checked

get checked(): boolean
Inherited from IgcCheckboxBaseComponent.checked
- Defined in src/components/checkbox/checkbox-base.ts:72
Returns boolean
set checked(value): void
Inherited from IgcCheckboxBaseComponent.checked
- Defined in src/components/checkbox/checkbox-base.ts:62
The checked state of the control.

Attr
Parameters
- value: boolean
Returns void

form

get form(): null | HTMLFormElement
Inherited from IgcCheckboxBaseComponent.form
- Defined in src/components/common/mixins/form-associated.ts:91
Returns the HTMLFormElement associated with this element.

Returns null | HTMLFormElement

validationMessage

get validationMessage(): string
Inherited from IgcCheckboxBaseComponent.validationMessage
- Defined in src/components/common/mixins/form-associated.ts:100
A string containing the validation message of this element.

Returns string

validity

get validity(): ValidityState
Inherited from IgcCheckboxBaseComponent.validity
- Defined in src/components/common/mixins/form-associated.ts:97
Returns a ValidityState object which represents the different validity states the element can be in, with respect to constraint validation.

Returns ValidityState

value

get value(): string
Inherited from IgcCheckboxBaseComponent.value
- Defined in src/components/checkbox/checkbox-base.ts:52
Returns string
set value(value): void
Inherited from IgcCheckboxBaseComponent.value
- Defined in src/components/checkbox/checkbox-base.ts:45
The value attribute of the control.

Attr
Parameters
- value: string
Returns void

willValidate

get willValidate(): boolean
Inherited from IgcCheckboxBaseComponent.willValidate
- Defined in src/components/common/mixins/form-associated.ts:106
A boolean value which returns true if the element is a submittable element that is a candidate for constraint validation.

Returns boolean

Methods

blur

blur(): void
Inherited from IgcCheckboxBaseComponent.blur
- Defined in src/components/checkbox/checkbox-base.ts:112
Removes focus from the control.

Returns void

checkValidity

checkValidity(): boolean
Inherited from IgcCheckboxBaseComponent.checkValidity
- Defined in src/components/common/mixins/form-associated.ts:109
Checks for validity of the control and emits the invalid event if it invalid.

Returns boolean

click

click(): void
Inherited from IgcCheckboxBaseComponent.click
- Defined in src/components/checkbox/checkbox-base.ts:100
Simulates a click on the control.

Returns void

connectedCallback

connectedCallback(): void
Inherited from IgcCheckboxBaseComponent.connectedCallback
- Defined in src/components/checkbox/checkbox-base.ts:88
Returns void

emitEvent

emitEvent<K, D>(type, eventInitDict?): boolean
Inherited from IgcCheckboxBaseComponent.emitEvent
- Defined in src/components/common/mixins/event-emitter.ts:31
Type parameters
Type Parameters
- K extends keyof IgcCheckboxEventMap
- D extends boolean | void
Parameters
- type: K
- Optional eventInitDict: CustomEventInit<D>
Returns boolean

focus

focus(options?): void
Inherited from IgcCheckboxBaseComponent.focus
- Defined in src/components/checkbox/checkbox-base.ts:106
Sets focus on the control.

Parameters
- Optional options: FocusOptions
Returns void

reportValidity

reportValidity(): boolean
Inherited from IgcCheckboxBaseComponent.reportValidity
- Defined in src/components/common/mixins/form-associated.ts:112
Checks for validity of the control and shows the browser message if it invalid.

Returns boolean

setCustomValidity

setCustomValidity(message): void
Inherited from IgcCheckboxBaseComponent.setCustomValidity
- Defined in src/components/common/mixins/form-associated.ts:118
Sets a custom validation message for the control. As long as message is not empty, the control is considered invalid.

Parameters
- message: string
Returns void

`Static` register

register(): void
- Defined in src/components/checkbox/switch.ts:35
Returns void

Class IgcSwitchComponent

Element

Slot

Fires

Fires

Fires

Csspart

Csspart

Csspart

Csspart

Hierarchy

Hierarchy

Constructors

Properties

Accessors

Methods

Constructors

constructor

Returns IgcSwitchComponent

Properties

disabled

Attr

invalid

Attr

labelPosition

Attr

name

Attr

required

Attr

Static styles

Static Readonly tagName

Accessors

checked

Returns boolean

Attr

Parameters

value: boolean

Returns void

form

Returns null | HTMLFormElement

validationMessage

Returns string

validity

Returns ValidityState

value

Returns string

Attr

Parameters

value: string

Returns void

willValidate

Returns boolean

Methods

blur

Returns void

checkValidity

Returns boolean

click

Returns void

connectedCallback

Returns void

emitEvent

Type parameters

Type Parameters

Parameters

type: K

Optional eventInitDict: CustomEventInit<D>

Returns boolean

focus

Parameters

Optional options: FocusOptions

Returns void

reportValidity

Returns boolean

setCustomValidity

Parameters

message: string

Returns void

Static register

`Static` styles

`Static` `Readonly` tagName

`Static` register