alert
Funkce alert je rozšířením komponenty <mdui-dialog>. Nahrazuje nativní window.alert, takže kvůli otevření dialogu s upozorněním nemusíte ručně psát HTML.
Způsob použití
Importujte funkci podle potřeby:
import { alert } from 'mdui/functions/alert.js';
Příklad použití:
<mdui-button class="example-button">otevřít</mdui-button>
<script type="module">
import { alert } from "mdui/functions/alert.js";
const button = document.querySelector(".example-button");
button.addEventListener("click", () => {
alert({
headline: "Název upozornění",
description: "Popis upozornění",
confirmText: "OK",
onConfirm: () => console.log("potvrzeno"),
});
});
</script>API
alert(options: Options): Promise<void>
Funkce alert přijímá jako parametr objekt Options a vrací Promise. Pokud se upozornění zavře kliknutím na tlačítko OK, Promise se vyřeší (resolve); jinak se odmítne (reject).
Options
| Název vlastnosti | Typ | Výchozí hodnota |
|---|---|---|
headline |
string |
- |
| Název upozornění | ||
description |
string |
- |
| Popis upozornění | ||
icon |
string |
- |
| Název ikony Material Icons v záhlaví upozornění | ||
closeOnEsc |
boolean |
false |
| Určuje, zda se upozornění zavře po stisknutí klávesy ESC. | ||
closeOnOverlayClick |
boolean |
false |
| Zda zavřít výstrahu při kliknutí na překryvnou vrstvu | ||
confirmText |
string |
OK |
| Text potvrzovacího tlačítka | ||
queue |
string |
- |
|
Název fronty. Ve výchozím nastavení není fronta zapnutá. Při opakovaném volání této funkce se zobrazí více výstrah současně. Zadáním názvu fronty zajistíte, že se výstrahy se stejným názvem otevřou až po zavření předchozí. Funkce |
||
onConfirm |
(dialog: Dialog) => void | boolean | Promise<void> |
- |
|
Funkce zpětného volání při kliknutí na potvrzovací tlačítko. Parametrem funkce je instance dialogu, Ve výchozím nastavení se po kliknutí na potvrzovací tlačítko výstraha zavře; pokud je návratová hodnota |
||
onOpen |
(dialog: Dialog) => void |
- |
|
Funkce zpětného volání při otevření upozornění. Parametrem funkce je instance dialogu, |
||
onOpened |
(dialog: Dialog) => void |
- |
|
Funkce zpětného volání po dokončení animace otevření upozornění. Parametrem funkce je instance dialogu, |
||
onClose |
(dialog: Dialog) => void |
- |
|
Funkce zpětného volání při zahájení zavírání upozornění. Parametrem funkce je instance dialogu, |
||
onClosed |
(dialog: Dialog) => void |
- |
|
Funkce zpětného volání po dokončení animace zavření upozornění. Parametrem funkce je instance dialogu, |
||
onOverlayClick |
(dialog: Dialog) => void |
- |
|
Funkce zpětného volání při kliknutí na překryvnou vrstvu. Parametrem funkce je instance dialogu, |
||