このページは機械翻訳のため、誤りを含む場合があります。 英語の原文を読む

要素

Toast

トーストは、アプリの上にしばらく表示される短いメッセージです。「コピーしました」「下書きを削除しました · 元に戻す」「送信できませんでした」などがその例です。 nsh/base は、GPUI Kit の gpui-base と同様に、スタイルを持たない3つの部品としてその動作を提供します。

el-toast.tsx
el-toast.tsxLive
import { mount, Overlay, signal, Text, View } from "nsh";
import { Toast, type ToastEntry, ToastManager, ToastStack } from "nsh/base";
import { safeArea } from "nsh";
import { button, buttonText, desktop, Log, size, ui, wide } from "./palette";

/** What the demo's toasts show. */
type Content = { title: string; description?: string; undo?: boolean };

function App() {
  const manager = new ToastManager();
  const shown = signal<ToastEntry[]>([]);
  const expanded = signal(false);
  const events = signal<string[]>([]);
  const log = (e: string) => events.set([e, ...events()].slice(0, 6));
  const sync = () => shown.set(manager.visible(3));
  // The lifecycle advances on the app's timer, paused while the stack is expanded.
  setInterval(() => {
    const a = manager.advance(expanded());
    for (const id of a.presented) log(`presented · ${id}`);
    for (const id of a.ending) log(`ending · ${id}`);
    for (const r of a.removed) log(`removed · ${r.id}`);
    if (a.changed) sync();
  }, 50);
  let count = 0;
  const push = (content: Content) => {
    const id = `toast-${++count}`;
    manager.push(id, content, { timeout: 5000 });
    log(`push · ${id}`);
    sync();
  };
  const dismiss = (id: string) => {
    manager.dismiss(id);
    sync();
  };
  /** A button of the demo. */
  const action = (label: string, onPress: () => void) => (
    <View onPress={onPress} {...button()}>
      <Text style={buttonText()}>{label}</Text>
    </View>
  );

  return (
    <View style={{ flex: 1, backgroundColor: ui().page, padding: 20, paddingTop: 24, gap: 14 }}>
      <Text style={{ fontSize: 22, fontWeight: "700", color: ui().text }}>toast</Text>
      <Text style={{ color: ui().muted }}>
        {desktop ? "Show a few; rest the pointer on the stack to expand it and stop their time" : "Show a few; touch the stack to expand it, swipe one right to dismiss it"}
      </Text>
      <View style={{ flexDirection: "row", flexWrap: "wrap", gap: 8 }}>
        {action("Copy the link", () => push({ title: "Copied", description: "The link is on the clipboard" }))}
        {action("Delete the draft", () => push({ title: "Draft deleted", undo: true }))}
        {action("Dismiss all", () => {
          manager.dismissAll();
          sync();
        })}
      </View>
      <Log title="ToastManager.advance · onExpandedChange" lines={events()} minHeight={130} />

      <Overlay style={{ pointerEvents: "box-none", left: 0, right: 0, bottom: 0, padding: 16, paddingBottom: safeArea().bottom + 16, alignItems: wide() ? "flex-end" : "center" }}>
        <ToastStack
          placement={wide() ? "bottomRight" : "bottomCenter"}
          style={{ width: 340, maxWidth: "100%" }}
          onExpandedChange={({ expanded: open }) => {
            expanded.set(open);
            log(`onExpandedChange · ${open}`);
          }}
          onCancel={() => {
            const newest = shown().filter((t) => t.status !== "ending").at(-1);
            if (newest) dismiss(newest.id);
          }}
        >
          <Each of={shown()} key={(t: ToastEntry) => t.id}>
            {(t) => {
              const content = () => t().value as Content;
              return (
                <Toast
                  transitionStatus={t().status}
                  accessibilityLabel={content().title}
                  onDismissRequest={() => dismiss(t().id)}
                  class="transition-all duration-200 ease-out"
                  startingClass="opacity-0 translate-y-4"
                  endingClass="opacity-0 scale-95"
                  swipingClass="transition-none"
                  style={{ ...ui().card, flexDirection: "row", alignItems: "center", gap: 12, padding: 14, borderRadius: 12 }}
                >
                  <View style={{ flex: 1, gap: 2 }}>
                    <Text style={{ fontSize: 14, fontWeight: "600", color: ui().text }}>{content().title}</Text>
                    <If when={content().description}>
                      <Text style={{ fontSize: 13, color: ui().muted }}>{content().description}</Text>
                    </If>
                  </View>
                  <If when={content().undo}>
                    <View onPress={() => dismiss(t().id)} {...button("primary", { size: "sm" })}>
                      <Text style={buttonText("primary")}>Undo</Text>
                    </View>
                  </If>
                </Toast>
              );
            }}
          </Each>
        </ToastStack>
      </Overlay>
    </View>
  );
}

mount(App);
  • ToastManager はトーストを順序どおりに保持し、ライフサイクルを管理します。各トーストはまず "starting" になり、モーションの継続時間が経過すると "present" になります。表示中で一時停止されていない間はタイムアウトをカウントダウンし、終了時には、退場の継続時間のあいだ "ending" の状態を保ってから削除されます。
  • ToastStack はトーストを計測し、ある端を起点にして、最新のものを端の最も近くに配置します。折りたたみ時は重なり合うレイヤー、展開時(ポインターが載っているとき、または指が触れているとき)はリストとして並べ、スプリングで動かします。
  • Toast は各トーストのルートです。alert ロール、アプリのスタイル用の transitionStatus、閉じることを要求するスワイプ、そして表示時にラベルを読み上げるスクリーンリーダーの対応を提供します。

見た目と内容はアプリ側のものであり、どこからでもトーストを表示できる利便性もアプリ側で用意します。アプリはこれらの上に独自の toast(...) を構築します。ギャラリー(examples/gallery/toast.tsx)がそうであり、GPUI Kit の通知が gpui-base のトーストの上に構築されているのと同じです。

use std::time::Duration;

use nsh_core::{time::now, prelude::*};

use nsh_base::{
    Anchor, ToastManager, ToastMotion, ToastOptions, ToastStackState, theme, toast, toast_stack,
};

fn toasts() -> impl IntoElement {
    let manager = stored(ToastManager::<u64, SharedString>::new(ToastMotion::sonner()));
    let shown = signal(Vec::new());
    let state = ToastStackState::new();
    let sync = move || {
        shown.set(manager.with(|m| {
            m.visible(3)
                .map(|(id, t, s)| (*id, t.clone(), s))
                .collect::<Vec<_>>()
        }))
    };
    // Advance the lifecycle while toasts are mounted, paused while expanded.
    set_interval(Duration::from_millis(50), move || {
        if manager.with(|m| m.advance(now(), state.is_expanded()).changed) {
            sync();
        }
    });
    manager.with(|m| {
        m.push(
            1,
            "Copied".into(),
            ToastOptions::timeout(Some(Duration::from_secs(5))),
            now(),
        )
    });
    sync();
    toast_stack()
        .placement(Anchor::BottomCenter)
        .state(state)
        .w(px(340.0))
        .child(each(
            shown,
            |(id, _, _)| *id,
            move |item, _| {
                toast()
                    .transition_status(move || item.get().2)
                    .accessibility_label(move || Some(item.get().1))
                    .on_dismiss_request(move || {
                        manager.with(|m| m.dismiss(&item.get().0, now()));
                    })
                    .rounded_xl()
                    .px_4()
                    .py_3()
                    .bg(move || theme().card)
                    .shadow_lg()
                    .transition_all()
                    .duration(200.0)
                    .starting_class("opacity-0 translate-y-4")
                    .ending_class("opacity-0 scale-95")
                    .child(text(move || item.get().1))
            },
        ))
}

Toast、ToastStack、ToastManager は nsh/base から提供されます。Rust では nsh_base の toast、toast_stack、ToastManager です。

#ToastManager

マネージャーはヘッドレスです。何も描画せず、タイマーも動かしません。アプリがトーストを push し、visible(limit) が返すトーストをそのステータスとともに描画し、いずれかがマウントされている間はタイマーで advance を呼び出します。スタックが展開されている間は paused を渡します。Rust ではアプリの ID と値に対する ToastManager<I, T> で、各呼び出しに Instant があります。TS では文字列の ID と任意の JSON 値に対するクラスで、エンジンのクロック(テストの手動クロックを含む)で動作します。

  • push(id, value, options) は最新のトーストを追加します。同じ ID のトーストがあれば置き換え、その値を返します。options.timeout はその表示時間(ミリ秒)で、指定しない場合は閉じられるまで表示され続けます。
  • dismiss(id) はトーストの退場を開始し、dismissAll() はすべてのトーストの退場を開始してその ID を返します。
  • advance(paused) はライフサイクルを進め、変化した内容を報告します。presented、ending(タイムアウトが尽きたもの)、removed(その値とともに)、そして changed です。
  • visible(limit) は、退場中でないトーストのうち最新の limit 件と退場中のトーストを、古い順に並べたものです。entries()(Rust では iter())はそのすべてです。ほかに get(id)、len()、isEmpty() があります。

ToastMotion は両者のトークンを保持します。duration(400 ms:登場の期限とスタックのスプリングの応答時間)、exitDuration(200 ms)、collapsedPeek(14)、expandedGap(14)、collapsedScaleStep(0.05)、collapsedVisible(3)で、いずれも Sonner の値です(Rust では ToastMotion::sonner()。TS では省略したフィールドがこれらの値になります)。

#ToastStack

スタックの子は、古い順に並んだトーストです。placement の端(デフォルトは "topRight"。下側のアンカーでは上方向に配置されます)を起点に、折りたたみ時のトーストは collapsedPeek ずつずらして重なり、後ろのものほど collapsedScaleStep ずつ狭くなり、表示されるのは collapsedVisible のみです。展開時は expandedGap 間隔のリストになります。トーストの到着や退場、および展開は、臨界減衰のスプリングで動きます。ポインターがスタックの上にある間、または指が触れている間は展開状態になります(onExpandedChange({ expanded })。Rust では ToastStackState で、is_expanded() がそれを読み取ります)。これにより、ユーザーがトーストを読んだり触れたりしている間、アプリはタイムアウトを一時停止できます。

スタックの配置はアプリが行います。セーフエリアの内側で、端に置いた Overlay の中に配置します。幅は class と style で決まります。トーストを保持している間は、Escape と Android の戻るボタンを受け取り(onCancel。closeOnEscape={false} ではアプリの他の部分に任せます)、最新のトーストを閉じます。

#Toast

トーストは、アプリのコンテンツを囲む alert ロールです。その transitionStatus はマネージャーのものであり、状態クラスは class に従って付与されます。"starting" の間は最初のフレームで startingClass が付き、その transition クラスがそこからアニメーションします(Tailwind の starting:、CSS の @starting-style)。"ending" の間は退場の継続時間のあいだ endingClass が付きます。ポインターでスワイプされている間は swipingClass が付きます(transition-none により指に追従し続けます)。

指またはマウスで swipeDirection(デフォルトは "right"。null でスワイプを無効化)の方向にドラッグすると、ポインターが動いた後にトーストが動くため、内部のボタンはボタンとして機能します。swipeThreshold ポイント(50)を超えて離すか、フリックすると、そのまま外へ移動し、閉じることを要求します(onDismissRequest)。届かなければ元の位置に戻ります。スクリーンリーダーは、表示時に accessibilityLabel を読み上げます。

#Toast props

PropRustTypeDefaultDescription
transitionStatus.transition_status(..)"starting" | "present" | "ending""starting"ライフサイクルのフェーズ。
startingClass, endingClass, swipingClass.starting_class(..), …stringなし最初のフレーム、退場中、スワイプ中のクラス。
swipeDirection.swipe_direction(..)"right" | "left" | "up" | "down" | null"right"スワイプで取り除く方向。
swipeThreshold.swipe_threshold(..)number50スワイプを離したときに閉じることを要求するまでの移動量。
accessibilityLabel.accessibility_label(..)stringなし表示時にスクリーンリーダーが読み上げる内容。
onDismissRequest.on_dismiss_request(..)() => voidなしユーザーがスワイプして取り除いた。

#ToastStack props

PropRustTypeDefaultDescription
motion.motion(..)ToastMotionSonner の値モーションのトークン。
placement.placement(..)"topLeft" | "topCenter" | "topRight" | "bottomLeft" | "bottomCenter" | "bottomRight" | "leftCenter" | "rightCenter""topRight"レイアウトの起点となる端。
closeOnEscape.close_on_escape(..)booleantrueトーストを保持している間、Escape と戻るを受け取る。
onExpandedChange.on_expanded_change(..), .state(..)(e: { expanded: boolean }) => voidなし操作によって展開または折りたたまれた。
onCancel.on_cancel(..)() => voidなしEscape または戻る:最新のトーストを閉じる。