FabPlovoucí akční tlačítko

Plovoucí akční tlačítko (FAB) se používá ke zdůraznění hlavní akce na stránce a umísťuje klíčové akce na snadno dostupná místa.

Způsob použití

Importujte komponentu podle potřeby:

import 'mdui/components/fab.js';

Importujte TypeScript typy komponenty podle potřeby:

import type { Fab } from 'mdui/components/fab.js';

Příklad použití:

<mdui-fab icon="edit"></mdui-fab>

Příklady

Ikona

Použijte atribut icon k určení názvu ikony Material Icons. Lze také použít prvek ikony pomocí slotu icon.

<mdui-fab icon="edit"></mdui-fab>
<mdui-fab>
  <mdui-icon slot="icon" name="edit"></mdui-icon>
</mdui-fab>

Zdrojový kód

Rozbalený stav

Přidejte atribut extended pro nastavení FAB do rozbaleného stavu, kdy se zobrazí text ve výchozím slotu.

Napsat

<mdui-fab extended icon="edit">Napsat</mdui-fab>

Zdrojový kód

Tvar

Pomocí atributu variant můžete nastavit tvar FAB.

<mdui-fab variant="primary" icon="edit"></mdui-fab>
<mdui-fab variant="surface" icon="edit"></mdui-fab>
<mdui-fab variant="secondary" icon="edit"></mdui-fab>
<mdui-fab variant="tertiary" icon="edit"></mdui-fab>

Zdrojový kód

Velikost

Pomocí atributu size můžete nastavit velikost FAB.

<mdui-fab size="small" icon="edit"></mdui-fab>
<mdui-fab size="normal" icon="edit"></mdui-fab>
<mdui-fab size="large" icon="edit"></mdui-fab>

Zdrojový kód

Odkaz

Pomocí atributu href přidáte na FAB funkci odkazu. Pak můžete také použít atributy související s odkazy: download, target, rel.

<mdui-fab icon="edit" href="https://www.mdui.org" target="_blank"></mdui-fab>

Zdrojový kód

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

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

<mdui-fab disabled icon="edit"></mdui-fab>
<mdui-fab loading icon="edit"></mdui-fab>
<mdui-fab loading disabled icon="edit"></mdui-fab>

Zdrojový kód

API

Vlastnosti

Atribut	Vlastnost	Typ	Výchozí
`variant`	`variant`	`'primary' \| 'surface' \| 'secondary' \| 'tertiary'`	`'primary'`
Varianta FAB. Jednotlivé varianty se liší pouze barvou. Možné hodnoty: `primary`: Používá barvu pozadí Primary container. `surface`: Používá barvu pozadí Surface container high. `secondary`: Používá barvu pozadí Secondary container. `tertiary`: Používá barvu pozadí Tertiary container.
`size`	`size`	`'normal' \| 'small' \| 'large'`	`'normal'`
Velikost FAB. Možné hodnoty: `normal`: Normální velikost FAB. `small`: Malé FAB. `large`: Velké FAB.
`icon`	`icon`	`string`	-
Název ikony z knihovny Material Icons. Lze také nastavit pomocí `slot="icon"`.
`extended`	`extended`	`boolean`	`false`
Určuje, zda je FAB v rozbaleném stavu.
`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.
`icon`
Ikona.

CSS Parts

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

CSS Custom Properties

Název
`--shape-corner-small`
Velikost zaoblení rohů komponenty, když je `size="small"`. Lze zadat konkrétní hodnotu v pixelech; doporučuje se však odkazovat na Designové tokeny.
`--shape-corner-normal`
Velikost zaoblení rohů komponenty, když je `size="normal"`. Lze zadat konkrétní hodnotu v pixelech; doporučuje se však odkazovat na Designové tokeny.
`--shape-corner-large`
Velikost zaoblení rohů komponenty, když je `size="large"`. Lze zadat konkrétní hodnotu v pixelech; doporučuje se však odkazovat na Designové tokeny.

Předchozí kapitola

Dropdown Rozbalovací nabídka

Další kapitola

Icon Ikona