SwitchKapcsoló

A kapcsoló egyetlen beállítás gyors be- vagy kikapcsolására szolgál, így a felhasználó egyszerűen módosíthatja az adott opció állapotát.

Használat

A komponens importálása:

import 'mdui/components/switch.js';

A komponens TypeScript-típusának importálása:

import type { Switch } from 'mdui/components/switch.js';

Példa:

<mdui-switch></mdui-switch>

Az unchecked-icon attribútummal beállíthatja a nem kijelölt állapot Material Icons ikonját, a checked-icon attribútummal pedig a kijelölt állapot Material Icons ikonját. Az unchecked-icon és checked-icon slotokon keresztül is testreszabhatja a nem kijelölt és kijelölt állapot ikonelemeit.

<mdui-switch unchecked-icon="remove_moderator" checked-icon="verified_user"></mdui-switch>
<mdui-switch>
  <mdui-icon slot="unchecked-icon" name="remove_moderator"></mdui-icon>
  <mdui-icon slot="checked-icon" name="verified_user"></mdui-icon>
</mdui-switch>

Forrás

API

Tulajdonságok

Attribútum	Tulajdonság	Típus	Alapértelmezett
`disabled`	`disabled`	`boolean`	`false`
Letiltott állapotú-e.
`checked`	`checked`	`boolean`	`false`
Be van-e kapcsolva.
	`defaultChecked`	`boolean`	`false`
Alapértelmezett bekapcsolt állapot. Az űrlap visszaállításakor erre az állapotra áll vissza. Ez a tulajdonság csak JavaScript tulajdonságként állítható be.
`unchecked-icon`	`uncheckedIcon`	`string`	-
A nem kiválasztott állapot Material Icons ikonjának neve. Beállítható a `slot="unchecked-icon"` segítségével is.
`checked-icon`	`checkedIcon`	`string`	-
A kiválasztott állapot Material Icons ikonjának neve. Beállítható a `slot="checked-icon"` segítségével is. Alapértelmezés szerint a `check` ikon, üres karakterlánc átadásával eltávolítható az alapértelmezett ikon.
`required`	`required`	`boolean`	`false`
Az űrlap elküldésekor kötelező-e bekapcsolni ezt a kapcsolót.
`form`	`form`	`string`	-
A kapcsolódó `<form>` elem. Ennek az attribútumnak az értéke egy `<form>` elem `id`-ja kell legyen ugyanazon az oldalon. Ha ez az attribútum nincs megadva, az elemnek a `<form>` elem gyermekének kell lennie. Ezzel az attribútummal az elem az oldal bármely pontjára elhelyezhető, nem csak a `<form>` elem gyermekeként.
`name`	`name`	`string`	`''`
A kapcsoló neve, amely az űrlapadatokkal együtt kerül elküldésre.
`value`	`value`	`string`	`'on'`
A kapcsoló értéke, amely az űrlapadatokkal együtt kerül elküldésre.
	`validity`	`ValidityState`	-
Az űrlap-ellenőrzés állapotobjektuma, részletekért lásd: `ValidityState`
	`validationMessage`	`string`	-
Ha az űrlap-ellenőrzés sikertelen, ez a tulajdonság tartalmazza a hibaüzenetet. Ha sikeres, üres karakterlánc.
`autofocus`	`autofocus`	`boolean`	`false`
Automatikusan fókuszt kapjon-e betöltődés után.
`tabindex`	`tabIndex`	`number`	-
Az elem sorszáma a Tab billentyűvel történő navigálás során.

Metódusok

Név	Paraméterek	Visszatérési érték
`checkValidity`		`boolean`
Ellenőrzi, hogy az űrlapmező megfelel-e a validációs szabályoknak. Ha nem, `false` értéket ad vissza és kiváltja az `invalid` eseményt; ha igen, `true` értéket ad vissza.
`reportValidity`		`boolean`
Ellenőrzi, hogy az űrlapmező megfelel-e a validációs szabályoknak. Ha nem, `false` értéket ad vissza, kiváltja az `invalid` eseményt, és megjeleníti a hibajelzést a komponensen; ha igen, `true` értéket ad vissza. Ha az ellenőrzés sikertelen, a komponensen megjelenik az érvénytelenséget jelző vizuális visszajelzés.
`setCustomValidity`	`message: string`	`void`
Egyéni hibaüzenet beállítása. Amíg ez a szöveg nem üres, addig a mező érvénytelennek minősül.
`click`		`void`
Egérkattintás szimulálása az elemen.
`focus`	`options: FocusOptions` (Opcionális)	`void`
Fókusz állítása az aktuális elemre. Egy objektum is átadható paraméterként, a következő tulajdonságokkal: `preventScroll`: Alapértelmezés szerint a fókusz elnyerése után a böngésző az elemre görget. Ha ezt a tulajdonságot `true`-ra állítja, a görgetés elmarad.
`blur`		`void`
Fókusz eltávolítása az aktuális elemről.

Események

Név
`focus`
Fókusz elnyerésekor aktiválódik.
`blur`
Fókusz elvesztésekor aktiválódik.
`change`
A kiválasztott állapot megváltozásakor aktiválódik.
`input`
A kiválasztott állapot megváltozásakor aktiválódik.
`invalid`
Az űrlapmező ellenőrzésének sikertelenségekor aktiválódik.

Slots

Név
`unchecked-icon`
A nem kiválasztott állapot elemei.
`checked-icon`
A kiválasztott állapot elemei.

CSS Parts

Név
`track`
Sáv.
`thumb`
Ikon konténere.
`unchecked-icon`
A nem kiválasztott állapot ikonja.
`checked-icon`
A kiválasztott állapot ikonja.

CSS egyéni tulajdonságok

Név
`--shape-corner`
A komponens sávjának sarok lekerekítésének mérete. Megadható konkrét pixelérték; de ajánlott a design tokenek hivatkozása.
`--shape-corner-thumb`
A komponens ikon konténerének sarok lekerekítésének mérete. Megadható konkrét pixelérték; de ajánlott a design tokenek hivatkozása.

Előző fejezet

Snackbar Snackbar

Következő fejezet

Tabs Fül

SwitchKapcsoló

Használat

Példák

Kijelölt állapot

Letiltott állapot

Ikon