ButtonTlačítko

Tlačítka se primárně používají k provádění akcí, jako je odeslání e-mailu, sdílení dokumentu nebo lajkování komentáře.

Způsob použití

Importujte komponentu podle potřeby:

import 'mdui/components/button.js';

Importujte TypeScript typy komponenty podle potřeby:

import type { Button } from 'mdui/components/button.js';

Příklad použití:

Tlačítko

<mdui-button>Tlačítko</mdui-button>

Příklady

Tvar

Použijte atribut variant k nastavení tvaru tlačítka.

Elevated

Filled

Tonal

Outlined

Text

<mdui-button variant="elevated">Elevated</mdui-button>
<mdui-button variant="filled">Filled</mdui-button>
<mdui-button variant="tonal">Tonal</mdui-button>
<mdui-button variant="outlined">Outlined</mdui-button>
<mdui-button variant="text">Text</mdui-button>

Zdrojový kód

Celá šířka

Přidejte atribut full-width, aby tlačítko zabíralo celou šířku nadřazeného prvku.

Tlačítko

<mdui-button full-width>Tlačítko</mdui-button>

Zdrojový kód

Ikona

Nastavením atributů icon a end-icon můžete přidat ikony Material Icons na levou a pravou stranu tlačítka. Lze také přidat prvky na levou a pravou stranu tlačítka pomocí slotů icon a end-icon.

Ikona

Slot

<mdui-button icon="search" end-icon="arrow_forward">Ikona</mdui-button>
<mdui-button>
  Slot
  <mdui-icon slot="icon" name="downloading"></mdui-icon>
  <mdui-icon slot="end-icon" name="attach_file"></mdui-icon>
</mdui-button>

Zdrojový kód

Odkaz

Nastavením atributu href můžete tlačítko změnit na odkaz. Pak můžete také použít tyto atributy související s odkazy: download, target, rel.

Odkaz

<mdui-button href="https://www.mdui.org" target="_blank">Odkaz</mdui-button>

Zdrojový kód

Zakázaný stav a stav načítání

Atribut disabled tlačítko zakáže; atribut loading přidá stav načítání tlačítka.

Zakázáno

Načítání

Načítání a zakázáno

<mdui-button disabled>Zakázáno</mdui-button>
<mdui-button loading>Načítání</mdui-button>
<mdui-button loading disabled>Načítání a zakázáno</mdui-button>

Zdrojový kód

API

Vlastnosti

Atribut	Vlastnost	Typ	Výchozí
`variant`	`variant`	`'elevated' \| 'filled' \| 'tonal' \| 'outlined' \| 'text'`	`'filled'`
Varianta tlačítka. Možné hodnoty: `elevated`: Tlačítko se stínem, vhodné pro oddělení tlačítka od pozadí. `filled`: Výrazná varianta vhodná pro primární akce, například „Uložit“ nebo „Potvrdit“. `tonal`: Vizuální efekt mezi `filled` a `outlined`, vhodný pro akce se středně vysokou prioritou, jako je „Další“ v procesu. `outlined`: Tlačítko s okrajem, vhodné pro středně prioritní a vedlejší akce, jako je „Zpět“. `text`: Textové tlačítko, vhodné pro akce s nejnižší prioritou.
`full-width`	`fullWidth`	`boolean`	`false`
Určuje, zda tlačítko vyplní celou šířku rodičovského prvku.
`icon`	`icon`	`string`	-
Název ikony z knihovny Material Icons na levé straně. Lze také nastavit pomocí `slot="icon"`.
`end-icon`	`endIcon`	`string`	-
Název ikony z knihovny Material Icons na pravé straně. Lze také nastavit pomocí `slot="end-icon"`.
`href`	`href`	`string`	-
Cílová URL odkazu. Pokud je tato vlastnost nastavena, komponenta se interně vykreslí jako prvek `<a>` a zpřístupní se vlastnosti pro odkazy.
`download`	`download`	`string`	-
Soubor ke stažení. Poznámka: Platí pouze, pokud je nastaven atribut `href`.
`target`	`target`	`'_blank' \| '_parent' \| '_self' \| '_top'`	-
Způsob otevření odkazu. Možné hodnoty: `_blank`: Otevře odkaz v novém okně nebo kartě. `_parent`: Otevře odkaz v nadřazeném okně. `_self`: Výchozí možnost. Otevře odkaz ve stejném okně. `_top`: Otevře odkaz v celém okně. Poznámka: Platí pouze, pokud je nastaven atribut `href`.
`rel`	`rel`	`'alternate' \| 'author' \| 'bookmark' \| 'external' \| 'help' \| 'license' \| 'me' \| 'next' \| 'nofollow' \| 'noreferrer' \| 'opener' \| 'prev' \| 'search' \| 'tag'`	-
Vztah mezi aktuálním dokumentem a odkazovaným dokumentem. Možné hodnoty: `alternate`: Alternativní verze aktuálního dokumentu. `author`: Autor aktuálního dokumentu nebo článku. `bookmark`: Trvalý odkaz na konkrétní část dokumentu. `external`: Odkaz vede na externí zdroj (mimo aktuální web/doménu). `help`: Odkaz na související nápovědu. `license`: Hlavní obsah aktuálního dokumentu je pokryt licencí odkazovaného dokumentu. `me`: Odkaz směřuje na profil vlastníka (rel="me"). `next`: Aktuální dokument je součástí série a odkazovaný dokument je následující v sérii. `nofollow`: Autor nebo vydavatel aktuálního dokumentu neschvaluje odkazovaný dokument. `noreferrer`: Neodesílá HTTP hlavičku `Referer`. Má podobný účinek jako `noopener`. `opener`: Pokud má odkaz atribut `target="_blank"`, atribut `rel="opener"` určuje, zda nové okno nebo karta bude mít přístup k původnímu oknu přes `window.opener`. `prev`: Aktuální dokument je součástí série a odkazovaný dokument je předchozí v sérii. `search`: Odkazuje na vyhledávací zdroj pro aktuální dokument a související stránky. `tag`: Poskytuje štítek vhodný pro aktuální dokument (identifikovaný danou adresou). Poznámka: Dostupné pouze při zadání atributu `href`.
`autofocus`	`autofocus`	`boolean`	`false`
Určuje, zda prvek získá automaticky fokus po dokončení načítání stránky.
`tabindex`	`tabIndex`	`number`	-
Pořadí prvku při přepínání fokusu pomocí klávesy Tab.
`disabled`	`disabled`	`boolean`	`false`
Určuje, zda je prvek zakázaný.
`loading`	`loading`	`boolean`	`false`
Určuje, zda je prvek ve stavu načítání.
`name`	`name`	`string`	`''`
Název tlačítka, který se odešle spolu s daty formuláře. Poznámka: Tato vlastnost platí pouze, pokud není nastaven atribut `href`.
`value`	`value`	`string`	`''`
Počáteční hodnota tlačítka, která se odešle spolu s daty formuláře. Poznámka: Tato vlastnost platí pouze, pokud není nastaven atribut `href`.
`type`	`type`	`'submit' \| 'reset' \| 'button'`	`'button'`
Typ tlačítka. Výchozí typ je `button`. Možné typy: `submit`: Kliknutím na tlačítko se odešlou data formuláře na server. `reset`: Kliknutím na tlačítko se všechna pole ve formuláři resetují na počáteční hodnoty. `button`: Tento typ tlačítka nemá žádné výchozí chování. Poznámka: Tato vlastnost platí pouze, pokud není zadán atribut `href`.
`form`	`form`	`string`	-
Přidružený formulář `<form>`. Hodnotou by mělo být `id` prvku `<form>` na stejné stránce. Pokud není atribut zadán, musí být tento prvek potomkem `<form>`. Díky tomuto atributu jej však lze umístit kamkoli na stránku, nejen jako potomka `<form>`. Poznámka: Tato vlastnost platí pouze, pokud není zadán atribut `href`.
`formaction`	`formAction`	`string`	-
Adresa URL pro odeslání formuláře. Přepíše atribut `action` formuláře, pokud je nastaven. Poznámka: Tato vlastnost platí pouze, pokud není zadán atribut `href` a `type="submit"`.
`formenctype`	`formEnctype`	`'application/x-www-form-urlencoded' \| 'multipart/form-data' \| 'text/plain'`	-
Typ obsahu při odesílání formuláře na server. Možné hodnoty: `application/x-www-form-urlencoded`: Výchozí hodnota, pokud atribut není zadán. `multipart/form-data`: Používá se, když formulář obsahuje prvek `<input type="file">`. `text/plain`: Přidáno v HTML5; používá se pro ladění. Přepíše atribut `enctype` prvku `<form>`, pokud je nastaven. Poznámka: Tato vlastnost platí pouze, pokud není zadán atribut `href` a `type="submit"`.
`formmethod`	`formMethod`	`'post' \| 'get'`	-
HTTP metoda pro odeslání formuláře. Možné hodnoty: `post`: Data formuláře jsou obsažena v těle požadavku a odeslána na server. `get`: Data formuláře jsou připojena k URI formuláře pomocí `?` jako oddělovače a výsledné URI je odesláno na server. Tato metoda se používá, když formulář nemá vedlejší účinky a obsahuje pouze ASCII znaky. Přepíše atribut `method` prvku `<form>`, pokud je nastaven. Poznámka: Tato vlastnost platí pouze, pokud není zadán atribut `href` a `type="submit"`.
`formnovalidate`	`formNoValidate`	`boolean`	`false`
Je-li nastaven, přeskočí se při odesílání formuláře validace. Přepíše atribut `novalidate` prvku `<form>`, pokud je nastaven. Poznámka: Tato vlastnost platí pouze, pokud není zadán atribut `href` a `type="submit"`.
`formtarget`	`formTarget`	`'_self' \| '_blank' \| '_parent' \| '_top'`	-
Určuje, kde se zobrazí odpověď po odeslání formuláře. Možné hodnoty: `_self`: Výchozí chování. Otevře se ve stejném okně. `_blank`: Otevře se v novém okně nebo kartě. `_parent`: Otevře se v nadřazeném okně. `_top`: Otevře se v celém okně. Přepíše atribut `target` prvku `<form>`, pokud je nastaven. Poznámka: Tato vlastnost platí pouze, pokud není zadán atribut `href` a `type="submit"`.
	`validity`	`ValidityState`	-
Objekt s informacemi o stavu validace formuláře; podrobnosti viz `ValidityState`.
	`validationMessage`	`string`	-
Pokud pole formuláře neprojde validací, tato vlastnost obsahuje chybovou zprávu. Při úspěšné validaci je výsledkem prázdný řetězec.

Metody

Název	Parametry	Vrací
`click`		`void`
Simuluje kliknutí myší na prvek.
`focus`	`options: FocusOptions` (Volitelné)	`void`
Nastaví fokus na aktuální prvek. Lze předat objekt jako parametr s vlastnostmi: `preventScroll`: Ve výchozím nastavení se po získání fokusu stránka posune tak, aby byl prvek viditelný. Pokud nechcete, aby se stránka posouvala, nastavte tuto vlastnost na `true`.
`blur`		`void`
Odebere fokus z aktuálního prvku.
`checkValidity`		`boolean`
Zkontroluje, zda pole formuláře prošlo validací. Pokud ne, vrátí `false` a spustí událost `invalid`; pokud ano, vrátí `true`.
`reportValidity`		`boolean`
Zkontroluje, zda pole formuláře prošlo validací. Pokud ne, vrátí `false` a spustí událost `invalid`; pokud ano, vrátí `true`. Při neúspěšné validaci se zobrazí chybová zpráva.
`setCustomValidity`	`message: string`	`void`
Nastaví vlastní chybový text. Dokud tento text není prázdný, znamená to, že pole neprošlo validací.

Události

Název
`focus`
Spustí se při získání fokusu.
`blur`
Spustí se při ztrátě fokusu.
`invalid`
Spustí se, pokud pole formuláře neprojde validací.

Slots

Název
(výchozí)
Text tlačítka.
`icon`
Prvek na levé straně tlačítka.
`end-icon`
Prvek na pravé straně tlačítka.

CSS Parts

Název
`button`
Interní prvek `<button>` nebo `<a>`.
`label`
Text tlačítka.
`icon`
Ikona na levé straně tlačítka.
`end-icon`
Ikona na pravé straně tlačítka.
`loading`
Prvek `<mdui-circular-progress>` ve stavu načítání.

CSS Custom Properties

Název
`--shape-corner`
Velikost zaoblení rohů komponenty. Lze zadat konkrétní hodnotu v pixelech; doporučuje se však odkazovat na Designové tokeny.

Předchozí kapitola

BottomAppBar Spodní aplikační lišta

Další kapitola

ButtonIcon Ikonové tlačítko