Tailwind

NSH 的样式遵循 Tailwind CSS 4。在 Rust 中，Tailwind 的工具类是名称和取值都相同的类型化样式方法（.p_4() 即 p-4，.rounded_2xl() 即 rounded-2xl，ZINC.shade(900) 即 zinc-900）；在 TSX 中，每个元素都可以直接在 class 中写这些类，它们会以 Tailwind 4 的默认主题为准，在原生层解析。下面每个示例先给出类型化方法，再给出类名：

import { mount, Scroll, signal, Text, View } from "nsh";

function App() {
  const count = signal(0);
  const busy = signal(false);
  const tab = signal("Day");
  const tabs = ["Day", "Week", "Month"];

  const buttons = () => (
    <View class="flex-row flex-wrap gap-2">
      <View
        onPress={() => count.update((n) => n + 1)}
        class="rounded-lg bg-lime-300 px-4 py-2 transition-colors duration-150 active:bg-lime-400"
      >
        <Text class="font-medium text-lime-950">Pressed {count()}×</Text>
      </View>
      <View
        onPress={() => busy.set(!busy())}
        class="rounded-lg border border-black/10 bg-white px-4 py-2 shadow-sm transition active:scale-95 active:bg-zinc-100 dark:border-[#2c2e33] dark:bg-[#24262a] dark:active:bg-[#2d2f34]"
      >
        <Text class="font-medium text-[#15161a] dark:text-[#eceef1]">{busy() ? "Enable" : "Disable"}</Text>
      </View>
      <View disabled={busy()} onPress={() => count.set(0)} class="rounded-lg bg-emerald-400 px-4 py-2 active:bg-emerald-500 disabled:opacity-40">
        <Text class="font-medium text-emerald-950">Reset</Text>
      </View>
    </View>
  );
  const tabsRow = () => (
    <View class="flex-row rounded-xl border border-black/5 bg-[#ecece7] p-1 dark:border-[#1f2124] dark:bg-[#0c0d0f]">
      <Each of={tabs}>
        {(t) => (
          <View
            onPress={() => tab.set(t())}
            class="flex-1 items-center rounded-lg py-2 transition-colors"
            classList={{ "bg-white shadow-sm dark:bg-[#2a2c31]": tab() === t() }}
          >
            <Text class="text-sm font-medium" classList={{ "text-[#15161a] dark:text-[#eceef1]": tab() === t(), "text-[#565a61] dark:text-[#8d9198]": tab() !== t() }}>
              {t()}
            </Text>
          </View>
        )}
      </Each>
    </View>
  );
  const gradient = () => (
    <View class="overflow-hidden rounded-2xl bg-linear-to-br from-lime-300 via-emerald-300 to-sky-400 p-5 shadow-xl shadow-lime-300/20">
      <Text class="text-xl font-bold text-zinc-950">{tab()} view</Text>
      <Text class="mt-1 text-sm text-zinc-950/70">bg-linear-to-br from-lime-300 via-emerald-300 to-sky-400</Text>
    </View>
  );
  const grid = () => (
    <View class="grid grid-cols-3 gap-2">
      <View class="col-span-2 h-14 items-center justify-center rounded-lg bg-sky-950">
        <Text class="text-xs text-sky-200">col-span-2</Text>
      </View>
      <View class="h-14 rounded-lg bg-sky-900" />
      <View class="h-14 rounded-lg bg-sky-800" />
      <View class="row-span-2 rounded-lg bg-sky-400" />
      <View class="h-14 rounded-lg bg-sky-700" />
      <View class="h-14 rounded-lg bg-sky-600" />
      <View class="h-14 rounded-lg bg-sky-500" />
    </View>
  );
  const list = () => (
    <View class="overflow-hidden rounded-xl border border-black/10 bg-white shadow-sm dark:border-[#2c2e33] dark:bg-[#18191c]">
      <Each of={["Inbox", "Drafts", "Sent", "Archive"]}>
        {(item) => (
          <View class="flex-row items-center justify-between border-t border-black/5 px-4 py-3 first:border-t-0 even:bg-[#fafaf7] active:bg-lime-50 dark:border-[#1f2124] dark:even:bg-[#141518] dark:active:bg-[#24262a]">
            <Text class="text-[#15161a] dark:text-[#eceef1]">{item()}</Text>
            <Text class="text-[#8c9097] dark:text-[#5a5e65]">›</Text>
          </View>
        )}
      </Each>
    </View>
  );
  const motion = () => (
    <View class="flex-row items-center justify-around py-2">
      <View class="size-8 animate-spin rounded-md bg-lime-300" />
      <View class="size-8 animate-bounce rounded-full bg-sky-400" />
      <View class="h-8 w-14 animate-pulse rounded-md bg-[#e1e1db] dark:bg-[#2c2e33]" />
    </View>
  );

  return (
    <Scroll class="flex-1 bg-[#f3f3ef] dark:bg-[#101113]">
      <View class="gap-5 p-5 pt-6">
        <Text class="text-2xl font-bold tracking-tight text-[#15161a] dark:text-[#eceef1]">Tailwind classes</Text>
        {/* Two columns from `md:` on (768 points): breakpoints follow the window. */}
        <View class="gap-5 md:flex-row md:items-start">
          <View class="gap-5 md:min-w-0 md:flex-1">
            {buttons()}
            {tabsRow()}
            {gradient()}
          </View>
          <View class="gap-5 md:min-w-0 md:flex-1">
            {grid()}
            {list()}
            {motion()}
          </View>
        </View>
      </View>
    </Scroll>
  );
}

mount(App);

use nsh_core::ui::palette::ZINC;

view()
    .flex_row()
    .items_center()
    .gap_3()
    .rounded_2xl()
    .bg(AdaptiveColor::new(white(), ZINC.shade(800)))
    .p_4()
    .shadow_lg()
    .active(|s| s.scale(0.98))
    .child(
        text("Tailwind on native views")
            .text_base()
            .font_weight(FontWeight::SEMIBOLD)
            .text_color(AdaptiveColor::new(ZINC.shade(900), white())),
    )

<View class="flex-row items-center gap-3 rounded-2xl bg-white p-4 shadow-lg active:scale-[0.98] dark:bg-zinc-800">
  <Text class="text-base font-semibold text-zinc-900 dark:text-white">Tailwind on native views</Text>
</View>

类型化方法生成的样式规则与类名编译出的完全相同，无需解析字符串。对于类名，整个过程不生成 CSS，也不在 JavaScript 中运行任何代码：字符串被直接交给核心，核心对每个不同的类字符串只解析一次（并缓存），把它转换为样式规则后应用。依赖状态的变体（按下、深色模式、窗口宽度）会在相应状态变化时由核心重新应用；按下和聚焦状态在原生层跟踪，因此 active: 的反馈（Rust 中的 .active(..)）无需与你的代码往返。

类名和 style 属性 产生的是同样的原生样式，两者可以组合使用；本页介绍类名特有的部分及其类型化写法。Tailwind 参考 列出了所有支持的工具类。

#class 与 classList

view()
    .rounded_lg()
    .px_4()
    .py_2()
    .transition_colors()
    .bg(move || if selected.get() { INDIGO.shade(600) } else { ZINC.shade(200) })
    .style_when(busy, |s| s.opacity(0.5))

<View
  class="rounded-lg px-4 py-2 transition-colors"
  classList={{ "bg-indigo-600": selected(), "bg-zinc-200": !selected(), "opacity-50": busy() }}
/>

• class 是一个类名字符串，可以是动态的：class={`h-6 rounded bg-${color()}-500`} 可以正常工作，因为类名在运行时解析。
• classList 把类名映射到条件：值为真时该类生效。它在 class 之后应用。
• 在 Rust 中，传入闭包或 signal 的方法会跟随它变化（.bg(move || ..)），.style_when(condition, |s| ..) 在条件成立时应用样式，.when(condition, |v| ..) 则在创建元素时一次性决定。

冲突的处理方式：

1. 同一字符串中靠后的类优先："p-2 p-4" 的结果是 p-4。不需要 tailwind-merge：组件可以直接把调用方传入的 class 追加在后面。在 Rust 中同样是后调用的方法优先。
2. 带变体的类在普通类之后应用，并按 Tailwind 的变体顺序排列（hover: 在 active: 之前，断点从小到大，dark: 最后），与它们在字符串中的位置无关。和 CSS 一样，odd:bg-a last:bg-b 会让位于奇数位置的最后一行得到 bg-a，因为 Tailwind 把 odd 排在 last 之后。
3. style 优先于类名。
4. ! 让一个类变为 important：!p-0。

Rust 组件（SafeAreaView、KeyboardAvoidingView 以及应用自己 crate 中的组件）在 TSX 中同样接受 class 和 classList；你的类会合并在组件自身样式之后，同等优先级时以你的为准。

#变体

变体可以组合：dark:active:bg-zinc-700、md:landscape:flex-row。在 Rust 中，.active(..) 样式里的 AdaptiveColor 就相当于 dark:active:。

view()
    .group()
    .flex_row()
    .items_center()
    .gap_3()
    .rounded_xl()
    .bg(white())
    .p_3()
    .active(|s| s.bg(ZINC.shade(50)))
    .child(text("Settings").flex_1().text_color(ZINC.shade(900)))
    .child(
        text("›")
            .text_color(ZINC.shade(300))
            .transition_transform()
            .group_active(|s| s.translate_x(px(4.0))),
    )

<View class="group flex-row items-center gap-3 rounded-xl bg-white p-3 active:bg-zinc-50">
  <Text class="flex-1 text-zinc-900">Settings</Text>
  <Text class="text-zinc-300 transition-transform group-active:translate-x-1">›</Text>
</View>

任何元素上的 disabled（Rust 中的 .disabled(..)）都会应用 disabled: 类（.disabled_style(..)），并把它的按下处理器从挂载内容中移除，因此也不会显示按下反馈：

view()
    .disabled(saving)
    .on_press(save)
    .rounded_lg()
    .bg(EMERALD.shade(500))
    .px_4()
    .py_2()
    .active(|s| s.bg(EMERALD.shade(600)))
    .disabled_style(|s| s.opacity(0.4))
    .child(text("Save").font_weight(FontWeight::MEDIUM).text_color(white()))

<View disabled={saving()} onPress={save} class="rounded-lg bg-emerald-500 px-4 py-2 active:bg-emerald-600 disabled:opacity-40">
  <Text class="font-medium text-white">Save</Text>
</View>

断点比较的是窗口（NSH 渲染所在的表面）而不是设备：在 iPad 分屏或可调整大小的窗口中，它们跟随窗口宽度变化，window() 也是如此。

#与 Web 上的 Tailwind 的差异

• 单位是点（point）。 p-4（.p_4()）是 16 点（1 个间距步长 = 4pt，1rem = 16pt）。以 px 写的任意值也按点计算：p-[13px]（.p(px(13.0))）就是 13pt。
• flex 是横向排列，与 CSS 一致：class="flex" 会让子元素横向排列，除非有方向类另行指定（在字符串中的任何位置都可以：flex-col flex 是纵向）。没有 flex 或 inline-flex 的视图保持 NSH 默认的纵向排列。block 和 flow-root 使用块布局；inline 和 inline-block 按视图布局（没有行内格式化上下文）。在 Rust 中由 .flex_row() 和 .flex_col() 设置方向。
• 视图上的文字类会被继承。 视图上的 text-*、font-*、leading-*、tracking-* 等文字工具类（Rust 中的 .text_color(..)、.font_weight(..) 等）会像 CSS 继承那样传给其内部的文本和输入元素：<View class="text-white"> 会让其中的标签变成白色。
• space-x-* / space-y-* 是间距（等同 gap-x / gap-y）。
• 状态背景色显示在渐变之上。 在 CSS 中渐变会盖住 background-color，因此 bg-linear-* 表面上的 active:bg-* 永远看不到；在 NSH 中，来自 active:、hover:、focus: 或 group-*: 的背景色会在该状态期间替换渐变（除非该状态设置了自己的渐变，例如 active:from-*）。activeStyle 等状态样式以及动画背景色也是如此。
• 在 NSH 中属于属性的设置，以类的形式也可用：line-clamp-*、truncate、whitespace-nowrap、pointer-events-*、object-*（图片缩放模式）、select-text、caret-* 和 placeholder:text-* 都能使用；若同时设置了对应的显式属性（numberOfLines、pointerEvents、resizeMode 等），以属性为准。在 Rust 中它们是元素的方法（.number_of_lines(..)、.resize_mode(..) 等）。
• 支持的范围：Tailwind 4 中在原生层有意义的工具类和变体。peer-* 变体、伪元素（before:、after:）和任意属性（[mask-type:luminance]）会报告为未知类。原生无需处理的纯 Web 工具类（antialiased、will-change-*、touch-*、scroll-*、snap-*、overscroll-*、box-border 等）会被接受并忽略。

其余部分都与 Tailwind 4 文档一致：调色板、透明度修饰符（bg-black/40）、任意值（bg-[#34c759]、w-[72px]、grid-cols-[1fr_2fr]）、分数（w-1/2、translate-x-1/2）、阴影和 ring、渐变（bg-linear-to-r、bg-radial、bg-conic 配合 from- / via- / to-）、滤镜、backdrop-blur-*、mix-blend-*、变换、transition-* 和 duration-*、animate-spin / ping / pulse / bounce，以及网格，每一项在 Rust 中都有对应的类型化方法。滤镜与混合 的平台限制对类名同样适用。

#主题

类名以 Tailwind 4 的默认主题为准解析。在 nsh.json 的 "tailwind" 下扩展它；你的条目会加入默认值（同名时替换默认值）：

{
  "tailwind": {
    "colors": {
      "brand": { "50": "#f5f3ff", "500": "#7c3aed", "600": "#6d28d9", "DEFAULT": "#7c3aed" },
      "ink": "#1f2328"
    },
    "radius": { "card": 14 },
    "fontFamily": { "display": "Pacifico" },
    "breakpoints": { "tablet": 600 }
  }
}

有了这个主题，bg-brand-500、text-brand（即 DEFAULT 色阶）、border-ink、rounded-card、font-display 和 tablet:flex-row 都是有效的类名。

未知的键和无效的值会导致构建错误（nsh.json: tailwind: unknown theme key 'colours'）。主题会编译进 bundle，并在第一帧之前生效。

Tailwind 主题影响你的类名。类型化方法保持 Tailwind 的默认刻度，因此 Rust 组件在任何应用中看起来都一样，它们从应用主题的设计令牌，即 nsh.json 中的 "theme" 获取应用的外观（用 Rust 开发）。

#主题 token

应用的主题（nsh.json 中的 "theme"）保存它的设计令牌：shadcn/ui 的颜色（background、foreground、primary、muted-foreground、border、ring、chart-1、sidebar 等）、radius、字体 font-sans 和 font-mono，以及应用自己添加的令牌。类名像 Tailwind 引用 CSS @theme 变量那样引用它们，Rust 组件用 nsh_base 的 theme() 读取，TSX 用 nsh 的 token() 读取，所以 TSX 页面和 Rust 组件使用同一套主题：

use nsh_base::theme;

view()
    .rounded(move || theme().radius)
    .border_1()
    .border_color(move || theme().border)
    .bg(move || theme().card)
    .p_4()
    .child(text("Balance").text_color(move || theme().card_foreground))
    .child(text("Updated just now").text_color(move || theme().muted_foreground))
    .child(
        view()
            .rounded(move || theme().radius)
            .bg(move || theme().primary)
            .px_4()
            .py_2()
            .active(|s| s.bg(move || theme().primary.opacity(0.9)))
            .child(text("Continue").text_color(move || theme().primary_foreground)),
    )

<View class="rounded-(--radius) border border-border bg-card p-4">
  <Text class="text-card-foreground">Balance</Text>
  <Text class="text-muted-foreground">Updated just now</Text>
  <View class="rounded-(--radius) bg-primary px-4 py-2 active:bg-primary/90">
    <Text class="text-primary-foreground">Continue</Text>
  </View>
</View>

token 的名称就是主题文件中 CSS 变量去掉 -- 后的名称：muted-foreground、radius、chart-1。在 Rust 中，shadcn 的令牌是 theme() 的方法（primary()、muted_foreground()、radius()、font_mono()），所有令牌也都可以用 theme().color("up")、theme().number("radius-card") 或 theme().font("font-display") 读取。

• 应用自己的令牌。 主题文件中的每个名称都是 token，就像 CSS @theme 中的每个变量："up": "#16a34a" 生成 bg-up、text-up 和 bg-up/30；"radius-card": "14px" 生成 rounded-(--radius-card)；"font-display": "Pacifico" 生成 font-(family-name:--font-display)。长度的单位是点；(number:--name) 传入不带单位的数值。
• 字体。 font-sans 是应用的字体：没有设置自己字体族的文字都用它绘制，就像网页使用 Tailwind 的 --font-sans。font-mono 是 font-mono 类和 TextView 中代码的字体。未设置时两者都是系统字体。
• 两种外观。 token 带有主题的浅色值和深色值：bg-primary、theme().primary 和 token("primary") 都会随外观自动切换，不需要 dark: 类。只在一种外观里设置的颜色在两种外观下都使用该值。
• 你的 Tailwind 颜色优先。 "tailwind" 的 colors 或 Tailwind 调色板里的名称就是那个颜色，所以 Tailwind 主题里没有 primary 这个颜色时，bg-primary 是主题 token。
• 主题可以在运行时改变。 嵌入原生应用的 NSH 应用拿到宿主的主题时，以及主题每次变化时，引用 token 的类、读取 theme() 的 Rust 绑定和读取 token() 的 TSX 代码都会更新，其中类和绑定在原生侧更新。宿主主题里没有的 token 使用应用自己 "theme" 中的值（再没有则用默认主题的值）。
• 与其他类名一样检查。 既不是默认主题、也不是应用 "theme" 中 token 的名称，在构建时会报告为未知类（unknown class 'bg-chart-up'）。要使用只有宿主提供的 token，在应用的 "theme" 里也给它一个值：应用单独运行时显示这个值。

引用 token 的类和其他类一样，每套主题只解析一次：绘制时的开销与调色板颜色相同。

#TSX 中的 token()

nsh 的 token(name) 是令牌在当前外观下的值：颜色是 #rrggbbaa，长度是以点为单位的数值，字体是字体族名称。它是响应式的，在组件、memo 或 effect 中读取它的代码会在主题或外观变化时重新运行，适合类名用不到的地方，例如画布或图表：

import { Canvas, token } from "nsh";

<Canvas
  style={{ height: 160 }}
  draw={(cx, { width, height }) => {
    cx.beginPath();
    cx.moveTo(0, height);
    cx.lineTo(width, 0);
    cx.strokeStyle = token("chart-1");
    cx.lineWidth = 2;
    cx.stroke();
  }}
/>

名称带有类型：NSH 根据主题把应用的令牌写入 .nsh/types/nsh/tokens.d.ts，所以主题中有 "up" 后 token("up") 的类型是 string，主题中没有的名称是类型错误。

#类名检查

nsh build、nsh dev、nsh run 和 nsh test 会用运行时相同的解析器和主题检查 JSX 中的静态类名（class 中的字符串字面量以及 classList 的键），并对不存在的类发出警告：

 warn nsh::build App.tsx:12:36: unknown class `bg-brand-550`

警告不会导致构建失败。运行时拼接的类名（bg-${color()}-500）在运行时第一次遇到时检查，每个未知类记录一次日志（unknown classes: ...）。类型化方法由 Rust 编译器检查。

#用类名还是样式？

两者都在原生层解析，开销相当。类名更简短，并且无需写代码就能使用变体（按下状态、深色模式、断点）。内联样式可以接收在 JavaScript 中计算出的值，也能接受原生动画值（opacity: fade、transform: [{ translateX: x }]）。大多数 TSX 应用用类名描述静态外观，用 style 处理需要计算或动画的部分。Rust 组件两者都使用类型化方法，并用 .bind_opacity(..)、.bind_translate_x(..) 等绑定动画值。

#相关内容

• 样式：style 属性、类型化方法以及各种效果的平台限制。
• Tailwind 参考：所有工具类和变体。
• 布局：flexbox 与网格，同样可以用类名表达。