CheckboxJelölőnégyzet

A jelölőnégyzet segítségével a felhasználó egy vagy több lehetőséget választhat ki egy opciókészletből, vagy egyetlen lehetőséget kapcsolhat be és ki.

Használat

A komponens importálása:

import 'mdui/components/checkbox.js';

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

import type { Checkbox } from 'mdui/components/checkbox.js';

Példa:

Jelölőnégyzet

<mdui-checkbox>Jelölőnégyzet</mdui-checkbox>

Az unchecked-icon, checked-icon, indeterminate-icon attribútumokkal megadhatja a nem kijelölt, kijelölt és határozatlan állapotú jelölőnégyzet Material Icons ikonját. Az unchecked-icon, checked-icon, indeterminate-icon slotokon keresztül is beállíthatja őket.

Jelölőnégyzet

<mdui-checkbox
  unchecked-icon="radio_button_unchecked"
  checked-icon="check_circle"
  indeterminate-icon="playlist_add_check_circle"
>Jelölőnégyzet</mdui-checkbox>

<mdui-checkbox
  indeterminate
  unchecked-icon="radio_button_unchecked"
  checked-icon="check_circle"
  indeterminate-icon="playlist_add_check_circle"
>Jelölőnégyzet</mdui-checkbox>

<br/>

<mdui-checkbox>
  <mdui-icon slot="unchecked-icon" name="radio_button_unchecked"></mdui-icon>
  <mdui-icon slot="checked-icon" name="check_circle"></mdui-icon>
  <mdui-icon slot="indeterminate-icon" name="playlist_add_check_circle"></mdui-icon>
  Jelölőnégyzet
</mdui-checkbox>

<mdui-checkbox indeterminate>
  <mdui-icon slot="unchecked-icon" name="radio_button_unchecked"></mdui-icon>
  <mdui-icon slot="checked-icon" name="check_circle"></mdui-icon>
  <mdui-icon slot="indeterminate-icon" name="playlist_add_check_circle"></mdui-icon>
  Jelölőnégyzet
</mdui-checkbox>

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 jelölve.
	`defaultChecked`	`boolean`	`false`
Alapértelmezett bejelölt állapot. Az űrlap visszaállításakor erre az állapotra áll vissza. Ez a tulajdonság csak JavaScript tulajdonságként állítható be.
`indeterminate`	`indeterminate`	`boolean`	`false`
Határozatlan állapotban van-e.
`required`	`required`	`boolean`	`false`
Az űrlap elküldésekor kötelező-e bejelölni ezt a jelölőnégyzetet.
`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 jelölőnégyzet neve, amely az űrlapadatokkal együtt kerül elküldésre.
`value`	`value`	`string`	`'on'`
A jelölőnégyzet értéke, amely az űrlapadatokkal együtt kerül elküldésre.
`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.
`indeterminate-icon`	`indeterminateIcon`	`string`	-
A határozatlan állapot Material Icons ikonjának neve. Beállítható a `slot="indeterminate-icon"` segítségével is.
	`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
(alapértelmezett)
A jelölőnégyzet szövege.
`unchecked-icon`
A nem kiválasztott állapot ikonja.
`checked-icon`
A kiválasztott állapot ikonja.
`indeterminate-icon`
A határozatlan állapot ikonja.

CSS Parts

Név
`control`
A bal oldali ikon konténere.
`unchecked-icon`
A nem kiválasztott állapot ikonja.
`checked-icon`
A kiválasztott állapot ikonja.
`indeterminate-icon`
A határozatlan állapot ikonja.
`label`
A jelölőnégyzet szövege.

Előző fejezet

Card Kártya

Következő fejezet

Chip Chip

CheckboxJelölőnégyzet

Használat

Példák

Kijelölt állapot

Letiltott állapot

Határozatlan állapot

Ikon

API

Tulajdonságok

Metódusok

Események

Slots

CSS Parts