元素
Tabs
标签页在同一处的几个部分之间切换:一个项目的概览和动态、一份文档的几种视图。每个 Tab 负责一个标签页的行为:按压、键盘激活、禁用状态,以及屏幕阅读器读到的标签页角色和它的选中状态。包在外面的 Tabs 就是标签列表,屏幕阅读器把它当作一组播报。外观由应用决定:标签页没有自己的颜色、尺寸、指示器或文字。它的子元素是应用自己的标签,标签页上的 selected: 类,以及它里面元素上的 group-selected: 类,跟随它的状态。每个部分的内容也属于应用:应用在列表旁边显示它的值所指的那一部分。
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))
}import { mount, signal, Text, View } from "nsh";
import { Tab, Tabs } from "nsh/base";
function App() {
const section = signal("overview");
const item = (value: string, label: string) => (
<Tab
selected={section() === value}
onPress={() => section.set(value)}
class="group rounded-(--radius) px-3 py-2 selected:bg-background"
>
<Text class="text-sm text-muted-foreground group-selected:text-foreground">{label}</Text>
</Tab>
);
return (
<View class="gap-4">
<Tabs class="flex-row self-start gap-1 rounded-(--radius-lg) bg-muted p-1">
{item("overview", "Overview")}
{item("activity", "Activity")}
</Tabs>
<Text class="text-foreground">
{section() === "overview"
? "Visitors, sign-ups and conversion this week."
: "Deploys, invoices and new members, newest first."}
</Text>
</View>
);
}
mount(App);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(..) | boolean | false | 列表中当前的标签页:屏幕阅读器报告它已选中,selected: 样式生效。按下时通过 onPress 报告;标签页显示应用传回的值。 |
disabled | .disabled(..) | boolean | false | 不响应按压,也没有按压反馈;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、style | selected:、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 也会按下拥有键盘焦点的标签页。
- 每个平台都按应用的样式绘制:标签页、选中标签页的表面以及各部分的内容。