元素

Tabs

标签页在同一处的几个部分之间切换:一个项目的概览和动态、一份文档的几种视图。每个 Tab 负责一个标签页的行为:按压、键盘激活、禁用状态,以及屏幕阅读器读到的标签页角色和它的选中状态。包在外面的 Tabs 就是标签列表,屏幕阅读器把它当作一组播报。外观由应用决定:标签页没有自己的颜色、尺寸、指示器或文字。它的子元素是应用自己的标签,标签页上的 selected: 类,以及它里面元素上的 group-selected: 类,跟随它的状态。每个部分的内容也属于应用:应用在列表旁边显示它的值所指的那一部分。

el-tabs.tsx
el-tabs.tsx运行中
import { mount, signal, Text, View } from "nsh";
import { Tab, Tabs } from "nsh/base";
import { desktop, focusRing, hoverFill, Log, size, Split, tint, ui } from "./palette";

// What each section shows: the app switches the content by its own value.
const sections = [
  {
    id: "overview",
    label: "Overview",
    rows: [
      ["Visitors", "12,480"],
      ["Sign-ups", "342"],
      ["Conversion", "2.74%"],
    ],
  },
  {
    id: "activity",
    label: "Activity",
    rows: [
      ["Deploy to production", "09:41"],
      ["Invoice paid", "08:15"],
      ["New member joined", "07:02"],
    ],
  },
  {
    id: "settings",
    label: "Settings",
    rows: [
      ["Region", "Frankfurt"],
      ["Plan", "Pro"],
      ["Seats", "8 of 10"],
    ],
  },
];
const folders = [
  { id: "inbox", label: "Inbox", count: 12 },
  { id: "archive", label: "Archive", count: 0 },
  { id: "spam", label: "Spam", count: 3, locked: true },
];

function App() {
  const section = signal("overview");
  const folder = signal("inbox");
  const events = signal<string[]>([]);
  const log = (line: string) => events.set([line, ...events()].slice(0, 3));
  const current = () => sections.find((s) => s.id === section())!;
  return (
    <View style={{ flex: 1, backgroundColor: ui().page, padding: 20, paddingTop: 24, gap: 14 }}>
      <Text style={{ fontSize: 22, fontWeight: "700", color: ui().text }}>tabs</Text>
      <Text style={{ color: ui().muted }}>
        {desktop ? "Click a tab, or Tab to one and press Space" : "Tap a tab to show its section"}
      </Text>

      <Split gap={14} inspector={<Log title={`onPress · ${section()}, ${folder()}`} lines={events()} minHeight={76} />}>
        {/* A segmented tab list: each tab is a segment, `selectedStyle` raises the selected one. */}
        <Tabs style={{ flexDirection: "row", gap: 4, padding: 3, borderRadius: 10, ...ui().inset, ...(desktop ? { alignSelf: "flex-start" } : {}) }}>
          <Each of={sections}>
            {(s) => (
              <Tab
                selected={section() === s().id}
                onPress={() => {
                  section.set(s().id);
                  log(`${s().label} pressed`);
                }}
                style={
                  desktop
                    ? { height: 26, paddingHorizontal: 14, borderRadius: 7, alignItems: "center", justifyContent: "center" }
                    : { flex: 1, height: 30, borderRadius: 7, alignItems: "center", justifyContent: "center" }
                }
                class="active:opacity-70"
                hoverStyle={section() === s().id ? undefined : hoverFill()}
                focusStyle={focusRing()}
                selectedStyle={ui().raised}
              >
                <Text style={{ fontSize: 13, fontWeight: "500", color: section() === s().id ? ui().text : ui().muted }}>
                  {s().label}
                </Text>
              </Tab>
            )}
          </Each>
        </Tabs>

        {/* The selected section's content, which the app shows by its value. */}
        <View style={{ ...ui().card, borderRadius: 14, overflow: "hidden" }}>
          <Each of={current().rows}>
            {(row, i) => (
              <>
                {i() > 0 ? <View style={{ height: 1, marginLeft: desktop ? 12 : 16, backgroundColor: ui().line }} /> : null}
                <View
                  style={
                    desktop
                      ? { flexDirection: "row", alignItems: "center", paddingHorizontal: 12, height: size.row }
                      : { flexDirection: "row", alignItems: "center", paddingHorizontal: 16, paddingVertical: 12 }
                  }
                >
                  <Text style={{ flex: 1, fontSize: size.label, color: ui().text }}>{row()[0]}</Text>
                  <Text style={{ fontSize: 14, fontWeight: "600", fontVariant: ["tabular-nums"], color: ui().muted }}>{row()[1]}</Text>
                </View>
              </>
            )}
          </Each>
        </View>

        {/* Tabs with counts: the selected one's own fill, a disabled one dimmed. */}
        <Tabs style={{ flexDirection: "row", gap: 6 }}>
          <Each of={folders}>
            {(f) => (
              <Tab
                selected={folder() === f().id}
                disabled={f().locked}
                onPress={() => {
                  folder.set(f().id);
                  log(`${f().label} pressed`);
                }}
                class="active:opacity-70 disabled:opacity-40"
                hoverStyle={f().locked || folder() === f().id ? undefined : hoverFill()}
                focusStyle={focusRing()}
                style={{ flexDirection: "row", alignItems: "center", gap: 6, height: desktop ? size.controlSm : 30, paddingHorizontal: desktop ? 10 : 12, borderRadius: 8 }}
                selectedStyle={{ backgroundColor: tint(ui().accent, 0.16) }}
              >
                <Text style={{ fontSize: 13, fontWeight: "500", color: folder() === f().id ? ui().accent : ui().muted }}>
                  {f().label}
                </Text>
                {f().count > 0 ? (
                  <Text style={{ fontSize: 12, fontWeight: "600", fontVariant: ["tabular-nums"], color: ui().faint }}>{f().count}</Text>
                ) : null}
              </Tab>
            )}
          </Each>
        </Tabs>
      </Split>
    </View>
  );
}

mount(App);
use nsh_base::{tab, tabs, theme};
use nsh_core::ui::prelude::*;

fn sections() -> impl IntoElement {
    let section = signal("overview");
    let item = move |value: &'static str, label: &'static str| {
        let selected = move || section.get() == value;
        tab()
            .selected(selected)
            .on_press(move |_: &()| section.set(value))
            .rounded(move || theme().radius)
            .px_3()
            .py_2()
            .selected_style(|s| s.bg(move || theme().background))
            .child(text(label).text_sm().text_color(move || {
                if selected() { theme().foreground } else { theme().muted_foreground }
            }))
    };
    view()
        .gap_4()
        .child(
            tabs()
                .flex_row()
                .self_start()
                .gap_1()
                .p_1()
                .rounded(move || theme().radius)
                .bg(move || theme().muted)
                .child(item("overview", "Overview"))
                .child(item("activity", "Activity")),
        )
        .child(text(move || {
            if section.get() == "overview" {
                "Visitors, sign-ups and conversion this week."
            } else {
                "Deploys, invoices and new members, newest first."
            }
        }).text_color(move || theme().foreground))
}

Tab 和 Tabs 来自 nsh/base,在 Rust 中是 nsh-base crate。值由应用持有:列表本身不持有值。每个标签页被告知自己是否选中;按下时通过 onPress 报告,应用设置自己的值并显示对应的部分,每个标签页显示应用传回的 selected。列表和标签页的圆角同心:列表的内边距(p-1)正是 radius.lg 与 radius 之差。在 Rust 中,tab() 和 tabs() 创建它们,每个属性对应一个设置方法(.selected(..)),每个事件对应一个监听方法(.on_press(..)),外观用类型化的样式方法,内容用 .child(..)。

#属性

#Tab

属性Rust类型默认值说明
selected.selected(..)booleanfalse列表中当前的标签页:屏幕阅读器报告它已选中,selected: 样式生效。按下时通过 onPress 报告;标签页显示应用传回的值。
disabled.disabled(..)booleanfalse不响应按压,也没有按压反馈;disabled: 样式生效,屏幕阅读器会报告它不可用。
selectedStyle.selected_style(|s| ..)StyleProp<ViewStyle>无选中且未禁用时标签页自身的样式,与 selected: 类相同。
accessibilityLabel.accessibility_label(..)string无屏幕阅读器读出的文字:子元素没有说明这个标签页名称的文字时(例如只有图标)设置。
children.child(..)JSX.Element无应用的标签、图标或徽标,屏幕阅读器会读出。
class、style样式方法string、StyleProp<ViewStyle>无标签页自身:包住标签的那块表面。
activeStyle、hoverStyle、focusStyle、disabledStyle.active(|s| ..)、.hover(..)、.focus(..)、.disabled_style(..)StyleProp<ViewStyle>无标签页按下、悬停、获得焦点或禁用时的样式,与对应的 <state>: 类相同。

#Tabs

属性Rust类型默认值说明
children.child(..)JSX.Element无列表中的标签页,以及应用放在它们之间的其他内容。
class、style样式方法string、StyleProp<ViewStyle>无列表的布局和外观:默认是一列,flex-row 排成一行。

#事件

事件Rust说明
onPress(Tab).on_press(|_: &()| ..)标签页被按下:轻点、点击、拥有键盘焦点时按 Space 或 Return,或屏幕阅读器的激活。它在任何变化之前运行:标签页显示应用传回的 selected。

已选中的标签页同样报告按压,应用可以响应第二次按压(例如把这一部分滚动到顶部)。禁用的标签页不报告任何事件。

#部件

部件位置样式状态
列表Tabs 的 class、style
标签页列表里Tab 的 class、styleselected:、disabled:、active:、hover:、focus:(或 selectedStyle、disabledStyle 等)
标签标签页里它们自己的元素(children)在标签页的 class 上加 group 后,使用 group-selected:、group-disabled: 等 group-*: 变体
这一部分的内容列表旁边应用自己的元素应用的值

用标签页自身的表面表达选中:填充、更强的标签颜色或更重的字重(见设计指南的交互状态一节)。

#禁用

禁用的标签页不响应按压,屏幕阅读器会报告它不可用。它的 disabled: 类生效并覆盖 selected: 类,它里面的 group-disabled: 类随之生效:

<Tab
  selected={section() === "billing"}
  disabled={!isOwner()}
  onPress={() => section.set("billing")}
  class="group rounded-(--radius) px-3 py-2 selected:bg-background disabled:opacity-50"
>
  <Text class="text-sm text-muted-foreground group-selected:text-foreground">Billing</Text>
</Tab>

#无障碍

  • 标签页对屏幕阅读器而言是一个元素,角色是 "tab",带有它的选中状态。它的标签是子元素的文字,或 accessibilityLabel。
  • Tabs 的角色是 "tablist":屏幕阅读器把其中的标签页当作一组播报,每个标签页仍然是独立的元素。
  • disabled 按平台的方式报告(VoiceOver、TalkBack、UI Automation、浏览器的无障碍树)。
  • 在 macOS 和 Web 上,每个标签页都是键盘焦点的一站:Tab 可以到达它,Space 和 Return 按下它,focus: 样式显示焦点所在。

标签、角色和播报的一般用法见无障碍。

#平台说明

  • iOS、Android 和 Mac Catalyst:按压是在标签页上(包括它的标签)结束的一次轻点。
  • 桌面(macOS、Windows、Linux、GPUI)和 Web:按压是一次点击。在 macOS 和 Web 上,Space 和 Return 也会按下拥有键盘焦点的标签页。
  • 每个平台都按应用的样式绘制:标签页、选中标签页的表面以及各部分的内容。