Элементы
AlertDialog
AlertDialog показывает системное окно предупреждения или лист действий платформы: UIAlertController на iOS и Mac Catalyst, AlertDialog (или диалог со списком для листа действий) на Android и предупреждение в стиле диалогов платформы на остальных платформах. AlertDialog.show (.show() из alert_dialog() в Rust) возвращает промис (в Rust — future), который завершается значением { action }: id действия, выбранного пользователем.
Все подписи задаёт приложение, поэтому предупреждение говорит то, что говорит ваше приложение, на его языке.
import { mount, signal, Text, View } from "nsh";
import { AlertDialog, Button } from "nsh/base";
import { button, buttonText, desktop, focusRing, hoverFill, Inspector, Panel, size, Stage, ui, wide } from "./palette";
type Options = Parameters<typeof AlertDialog.show>[0];
// What each button shows, and what it is about.
const alerts: { label: string; detail: string; danger?: boolean; options: Options }[] = [
{
label: "Delete…",
detail: "cancel + destructive roles",
danger: true,
options: {
title: "Delete the photo?",
description: "This cannot be undone.",
actions: [
{ label: "Cancel", role: "cancel", id: "cancel" },
{ label: "Delete", role: "destructive", id: "delete" },
],
},
},
{
label: "Save changes…",
detail: "three actions, closeOnEscape",
options: {
title: "Save changes?",
description: "Your edits to “Trip notes” are not saved yet.",
actions: [
{ label: "Don't save", role: "destructive", id: "discard" },
{ label: "Cancel", role: "cancel", id: "cancel" },
{ label: "Save", id: "save" },
],
closeOnEscape: true,
},
},
{
label: "Share…",
detail: 'presentation "actionSheet"',
options: {
title: "Share the photo",
presentation: "actionSheet",
actions: [
{ label: "Copy link", id: "copy" },
{ label: "Save", id: "save" },
{ label: "Delete", role: "destructive", id: "delete" },
{ label: "Cancel", role: "cancel", id: "cancel" },
],
},
},
];
function App() {
const answer = signal("–");
const shown = signal(0);
const show = async (options: Options) => {
shown.update((n) => n + 1);
const { action } = await AlertDialog.show(options);
answer.set(action === null ? "{ action: null } (closed without an action)" : `{ action: ${JSON.stringify(action)} }`);
};
const row = () => ({ ...ui().row, borderRadius: 12, padding: 14, gap: 2 });
const hint = desktop ? "Escape or a click outside the action sheet closes it with { action: null }." : "A tap outside the action sheet closes it with { action: null }.";
return (
<View style={{ flex: 1, backgroundColor: ui().page, padding: 20, paddingTop: 24, gap: 12 }}>
<Text style={{ fontSize: 22, fontWeight: "700", color: ui().text }}>alert-dialog</Text>
<Text style={{ color: ui().muted }}>The platform's own alert; every label comes from the app.</Text>
{() =>
wide() ? (
<View style={{ flex: 1, flexDirection: "row", gap: 16 }}>
{/* A row per alert: what it shows, and a button as wide as its label at the end. */}
<Stage width={400}>
<View style={{ ...ui().card, borderRadius: 14, overflow: "hidden" }}>
<Each of={alerts}>
{(a, i) => (
<>
{i() > 0 ? <View style={{ height: 1, marginLeft: 12, backgroundColor: ui().line }} /> : null}
<View style={{ flexDirection: "row", alignItems: "center", gap: 12, height: size.row + 4, paddingHorizontal: 12 }}>
<Text style={{ flex: 1, fontSize: 13, color: ui().muted }}>{a().detail}</Text>
<Button onPress={() => show(a().options)} {...button()}>
<Text style={{ ...buttonText(), color: a().danger ? ui().down : ui().text }}>{a().label}</Text>
</Button>
</View>
</>
)}
</Each>
</View>
</Stage>
<Inspector>
<Panel title={`AlertDialog.show resolved with (${shown()} shown)`}>
<Text style={{ color: ui().accent, fontSize: 14, fontWeight: "600" }}>{answer()}</Text>
</Panel>
<Text style={{ color: ui().faint, fontSize: 12 }}>{hint}</Text>
</Inspector>
</View>
) : (
<View style={{ gap: 10 }}>
<Each of={alerts}>
{(a) => (
<Button onPress={() => show(a().options)} style={row()} activeStyle={{ opacity: 0.7 }} hoverStyle={hoverFill()} focusStyle={focusRing()}>
<Text style={{ color: a().danger ? ui().down : ui().text, fontSize: 16, fontWeight: "600" }}>{a().label}</Text>
<Text style={{ color: ui().muted, fontSize: 13 }}>{a().detail}</Text>
</Button>
)}
</Each>
<View style={{ ...ui().inset, borderRadius: 12, padding: 14, gap: 4, marginTop: 4 }}>
<Text style={{ color: ui().muted, fontSize: 13 }}>AlertDialog.show resolved with ({shown()} shown)</Text>
<Text style={{ color: ui().accent, fontSize: 16, fontWeight: "600" }}>{answer()}</Text>
</View>
<Text style={{ color: ui().faint, fontSize: 13 }}>{hint}</Text>
</View>
)
}
</View>
);
}
mount(App);use nsh_base::{alert_dialog, button};
use nsh_core::prelude::*;
fn app() -> impl IntoElement {
let answer = signal(SharedString::from("–"));
let confirm = move || {
spawn(async move {
let choice = alert_dialog()
.title("Delete the photo?")
.description("This cannot be undone.")
.cancel("cancel", "Cancel")
.destructive("delete", "Delete")
.show()
.await;
let deleted = matches!(choice, Ok(r) if r.action.as_deref() == Some("delete"));
answer.set(if deleted { "deleted" } else { "kept" }.into());
});
};
view()
.flex_1()
.p_4()
.pt(px(48.0))
.gap_3()
.child(
button()
.on_press(confirm)
.rounded_lg()
.bg(rgb(0xdc2626))
.px_4()
.py_3()
.child(text("Delete…").text_color(white()).font_weight(FontWeight::SEMIBOLD)),
)
.child(text(answer))
}import { mount, signal, Text, View } from "nsh";
import { AlertDialog, Button } from "nsh/base";
function App() {
const answer = signal("–");
const confirm = async () => {
const { action } = await AlertDialog.show({
title: "Delete the photo?",
description: "This cannot be undone.",
actions: [
{ label: "Cancel", role: "cancel", id: "cancel" },
{ label: "Delete", role: "destructive", id: "delete" },
],
});
answer.set(action === "delete" ? "deleted" : "kept");
};
return (
<View style={{ flex: 1, padding: 16, paddingTop: 48, gap: 12 }}>
<Button onPress={confirm} class="rounded-lg bg-red-600 px-4 py-3 active:bg-red-700">
<Text class="text-center font-semibold text-white">Delete…</Text>
</Button>
<Text>{answer()}</Text>
</View>
);
}
mount(App);Для диалогов с собственным внешним видом (карточка, лист, полноэкранный сценарий) используйте Dialog.
#AlertDialog.show
AlertDialog.show(options: AlertDialogOptions): Promise<AlertDialogResult>
alert_dialog().title(..).description(..).action(..).cancel(..).destructive(..).show()
-> impl Future<Output = Result<AlertDialogResult, String>>
Результат — { action } (AlertDialogResult): id выбранного действия или null (None), если диалог закрыли без выбора действия: нажатием вне него, клавишей Escape или кнопкой «Назад», если это разрешают closeOnBackdropPress и closeOnEscape. Если действий нет, промис отклоняется с TypeError (в Rust — Err). В Rust nsh_base::alert_dialog() настраивает диалог отдельным методом для каждой опции и каждого действия, в том порядке, в котором действия отображаются, а .show() показывает его; ответ ожидайте в задаче (spawn).
#Листы действий
Лист действий принимает те же опции с режимом отображения "actionSheet":
use nsh_base::alert_dialog;
use nsh_core::prelude::*;
fn share() {
spawn(async move {
let choice = alert_dialog()
.title("Share the photo")
.action_sheet()
.action("copy", "Copy link")
.action("save", "Save")
.destructive("delete", "Delete")
.cancel("cancel", "Cancel")
.show()
.await;
match choice.ok().and_then(|r| r.action).as_deref() {
Some("copy") => { /* … */ }
Some("save") => { /* … */ }
Some("delete") => { /* … */ }
_ => {} // "cancel", or closed without an action.
}
});
}const { action } = await AlertDialog.show({
title: "Share the photo",
presentation: "actionSheet",
actions: [
{ label: "Copy link", id: "copy" },
{ label: "Save", id: "save" },
{ label: "Delete", role: "destructive", id: "delete" },
{ label: "Cancel", role: "cancel", id: "cancel" },
],
});#AlertDialogOptions
| Поле | Rust | Тип | По умолчанию | Описание |
|---|---|---|---|---|
title | .title(..) | string | null | нет | Над описанием. |
description | .description(..) | string | null | нет | Под заголовком. |
actions | .action(..), .cancel(..), .destructive(..), по одному на действие | AlertDialogAction[] | обязательно | Действия по порядку (не менее одного; в предупреждении на Android не более трёх). |
presentation | .action_sheet() | "alert" | "actionSheet" | "alert" | Предупреждение посередине или лист действий снизу (на Android — диалог со списком). |
closeOnEscape | .close_on_escape(..) | boolean | null | false для предупреждения, true для листа действий | Escape и кнопка «Назад» на Android закрывают диалог без выбора действия. |
closeOnBackdropPress | .close_on_backdrop_press(..) | boolean | null | false для предупреждения, true для листа действий | Нажатие вне диалога закрывает его без выбора действия. |
#AlertDialogResult
| Поле | Rust | Тип | Описание |
|---|---|---|---|
action | action | string | null (Option<SharedString>) | id выбранного действия или null, если диалог закрыли без выбора действия. |
#AlertDialogAction
| Поле | Rust | Тип | По умолчанию | Описание |
|---|---|---|---|---|
id | первый аргумент метода | string | обязательно | То, что show возвращает как action при выборе этого действия: имя действия в приложении, которое не меняется независимо от языка подписей. |
label | второй аргумент метода | string | обязательно | Что на нём написано. |
role | .action(..), .cancel(..), .destructive(..) | "default" | "cancel" | "destructive" | "default" | Что оно означает: платформа размещает и рисует действие в соответствии с его ролью (деструктивное действие на iOS красного цвета). |
#Особенности платформ
- iOS:
UIAlertControllerрасполагает действия. Действие с ролью"cancel"размещается там, где iOS помещает действия отмены, а лист действий показывает его отдельно внизу. На iPad и Mac Catalyst лист действий отображается как popover с безымянным действием отмены: нажатие вне него закрывает его, аactionравноnull. - Android:
AlertDialogпоказывает до трёх действий, сопоставляемых по позиции: последнее действие — положительная кнопка, предыдущее — отрицательная, а то, что перед ним, — нейтральная. Лист действий — это список действий в диалоге, где вместо действия отмены используются нажатие вне диалога или кнопка «Назад» (actionтогда равноnull). Диалог со списком показываетtitle, а если у листа нет заголовка —description. - Windows, Linux, GPUI и web: NSH рисует предупреждение или лист действий в стиле диалогов платформы.