# @glasshome/ui 中文文档

规范地址：https://npmcn.com/package/%40glasshome/ui/

版本：1\.40\.0
npm 元数据更新时间：2026-11-15T20:59:53.442Z
中文译文更新时间：2026-11-16T16:06:18.722Z
软件包许可：MIT

本文由上游 README 翻译，可能存在偏差，请结合原文核对 API、命令与配置。版权与许可归原作者所有。

原始 npm 页面：https://www.npmjs.com/package/%40glasshome/ui
原文对照：https://npmcn.com/package/%40glasshome/ui/?lang=original
项目主页：https://github.com/glasshome/ui#readme
源码仓库：https://github.com/glasshome/ui

## 关键信息（来自 npm 元数据）

- 包体积（解压后）：1.7 MB，343 个文件
- 模块格式：ES Module
- TypeScript 类型：包内自带
- Node.js 要求：\>=20
- 运行依赖：11 个
- peer 依赖：vitest ^4\.1\.10，solid-js ^1\.9\.9，tailwindcss ^4\.1\.13，tw-animate-css ^1\.4\.0
- 首次发布：2026-03-22T22:15:48.691Z
- 最新版本发布：2026-11-15T20:59:53.103Z
- 近 30 天下载量：3377（2026-10-17 至 2026-11-15，npm 官方下载统计）
- 已发布版本数：84（近 12 个月 84 个）

## 中文简介

用于 GlassHome 的 SolidJS 组件库, 建于 Kobalte 上

## 安装

```sh
npm install @glasshome/ui
```

也可以使用：`pnpm add @glasshome/ui`、`yarn add @glasshome/ui`、`bun add @glasshome/ui`

## README

# @ glasshome/ ui (英语)

用于 GlassHome 的 SolidJS 组件库, 以 [科巴尔特](https://kobalte.dev/)。 。 。 .

70+可访问,有主题意识的组件外加框架-不可知的设计符号和Tailwind v4 CSS预设,所有你需要建造的智能家庭仪表板. 权力 [格拉斯之家](https://glasshome.app/)本地首个家庭助理仪表板.

整个图书馆都使用单一的玻璃材料(`.glass` 键入 `--glass-*` no. `SPEC.md` 是设计-系统合同;活廊`bun run dev:gallery`)是其可执行的形式.

## 安装

```bash
bun add @glasshome/ui solid-js @glasshome/sync-layer
# or
npm install @glasshome/ui solid-js @glasshome/sync-layer
```

同伴依赖性 :

| 软件包 | 需要时间 |
| --- | --- |
| `solid-js` `^1.9` | 所有东西都放在下面 `/solid` |
| `@glasshome/sync-layer` | `/solid` 仅(实体选择器、区域选择器、演示模式帮助器) |

软件包是 **仅限无害环境管理** 以及载有在捆绑器和节点16+模块分辨率下解决的类别声明的现代无害环境管理船舶。 节点 `>=20`。 。 。 .

## 入境点

### `@glasshome/ui` 公用事业和地表食谱

框架-不可知根:对被制裁的玻璃表面的类-字符串配方,安全地从Solid组件无法运行的服务器代码(如Astro前题)导入.

```typescript
import { cn, buttonVariants, CARD_SURFACE, ALERT_TONES, OVERLAY_SURFACE } from "@glasshome/ui";

const cls = cn("px-4 py-2", condition && "text-white");
const btn = buttonVariants({ variant: "outline", size: "sm" });
```

### `@glasshome/ui/solid` - 构成部分

所有组件都从一个子路径导出.

```tsx
import { Button, Card, CardHeader, CardTitle, CardContent, Badge } from "@glasshome/ui/solid";

function DeviceCard() {
  return (
    <Card>
      <CardHeader>
        <CardTitle>Living Room</CardTitle>
        <Badge tone="var(--success)">Online</Badge>
      </CardHeader>
      <CardContent>
        <Button onClick={() => console.log("toggled")}>Toggle Light</Button>
      </CardContent>
    </Card>
  );
}
```

组成家庭: `Accordion` • 妇女 `Alert` • 妇女 `AlertDialog` • 妇女 `AreaPicker` • 妇女 `AspectRatio` • 妇女 `Avatar` • 妇女 `Badge` • 妇女 `BottomSheet` • 妇女 `Breadcrumb` • 妇女 `Button` • 妇女 `ButtonGroup` • 妇女 `Card` • 妇女 `Carousel` • 妇女 `Charts (AreaChart, BarList, StackedBar, RangeToggle)` • 妇女 `Checkbox` • 妇女 `Collapsible` • 妇女 `ColorSlider` • 妇女 `ColorWheel` • 妇女 `ContextMenu` • 妇女 `CopyButton` • 妇女 `CountPill` • 妇女 `DataTable (TableSearchInput, TableFilterSelect, TableSortHeader, TableSkeleton, TableEmpty, TableError, TableBulkBar)` • 妇女 `Dialog` • 妇女 `Dock` • 妇女 `DropdownMenu` • 妇女 `Empty` • 妇女 `EntitySelector` • 妇女 `Field` • 妇女 `Form` • 妇女 `HeroAction` • 妇女 `HoverCard` • 妇女 `IconPicker` • 妇女 `ImagePicker` • 妇女 `Input` • 妇女 `InputGroup` • 妇女 `InputOTP` • 妇女 `Item` • 妇女 `Kbd` • 妇女 `Label` • 妇女 `Logo` • 妇女 `MediaTile` • 妇女 `NumberField` • 妇女 `OptionCard` • 妇女 `Overlay` • 妇女 `PageHeader` • 妇女 `Pagination` • 妇女 `PasswordInput` • 妇女 `PickerSearch` • 妇女 `Popover` • 妇女 `Progress` • 妇女 `RadioGroup` • 妇女 `Resizable` • 妇女 `ResponsiveDialog` • 妇女 `SchemaForm` • 妇女 `ScopeIndicator` • 妇女 `ScrollArea` • 妇女 `SectionCard` • 妇女 `Select` • 妇女 `SelectionScope (SelectionHighlight)` • 妇女 `Separator` • 妇女 `SettingsRow (SwitchRow, LabeledField, LabeledInput, LabeledIconPicker, RowActions, SectionAddButton, SectionEmpty)` • 妇女 `Sheet` • 妇女 `Skeleton` • 妇女 `Slider` • 妇女 `SlidingIndicator (deprecated)` • 妇女 `Sonner (toast)` • 妇女 `Spinner` • 妇女 `StepIndicator` • 妇女 `Switch` • 妇女 `Table` • 妇女 `Tabs` • 妇女 `Textarea` • 妇女 `TierBadge` • 妇女 `Toggle` • 妇女 `ToggleGroup` • 妇女 `Tooltip` • 妇女 `WidgetCard` • 妇女 `WidgetIdentity` • 妇女 `WidgetTrustBadge`

`Badge` 纯玻璃 : `tone` 取任何 CSS 颜色( R)`<Badge tone="var(--success)">`;没有固体变体徽章.

### `@glasshome/ui/tokens` - 设计符号作为数据

无框架主题模型:预设, oklch 解析/ 解析, 以及 oklch- hex 转换( gamut- maped, 用于无法解析 oklch 的渲染器) 。 在节点脚本,服务器中安全,并构建工具.

```typescript
import { THEME_PRESETS, DEFAULT_THEME_ID, resolveThemeColors, oklchToHex } from "@glasshome/ui/tokens";
```

### 天体

`.astro` 文件导入 `@glasshome/ui/solid` 像任何Solid文件一样。 包裹的源头是 `solid` 导出条件, 因此 Astro 的 Solid 集成会编译它用于服务器; 一个组件没有 `client:` 指令生成静态的 HTML, 没有发送运行时间 .

### `@glasshome/ui/styles` - 有尾风 v4 CSS

```css
@import "@glasshome/ui/styles";
```

提供玻璃材料,设计标志(彩色,光线,动画),以及Tailwind v4主题层. `@glasshome/ui/styles/theme` 单独曝光符号调色板.

## 发展

```bash
bun install
bun run dev:gallery   # live component gallery on :5199, hot-reloads against src
bun run test          # vitest unit + render smoke tests
bun run lint          # biome
bun run check:tokens  # theme.css <-> tokens/presets.ts sync guard
bun run check:types   # typecheck src + tests
bun run build         # dist ESM + declarations
bun run check:publish # publint + arethetypeswrong
```

## 许可证

麻省理工学院

## 常见问题

### @glasshome/ui 是什么？

用于 GlassHome 的 SolidJS 组件库, 建于 Kobalte 上

### 如何安装 @glasshome/ui？

在项目目录运行 npm install @glasshome/ui，或使用 pnpm add / yarn add / bun add。它还需要宿主项目提供 peer 依赖：solid-js（^1\.9\.9）、tailwindcss（^4\.1\.13）、tw-animate-css（^1\.4\.0）。npm 7 及以上与 pnpm 8 及以上默认会自动安装必需的 peer 依赖，Yarn 需要手动安装。

### @glasshome/ui 支持 TypeScript 吗？

支持。包内自带 TypeScript 类型声明（package\.json 声明了 types 入口），安装后即可获得类型提示，无需再安装 @types 包。

### @glasshome/ui 支持 ESM 还是 CommonJS？

以 ES Module 形式发布，推荐使用 import 引入。在 CommonJS 项目中，Node\.js 20\.19\+ / 22\.12\+ 可以直接 require\(\) 不含顶层 await 的 ES Module，更早的版本需要改用动态 import\(\)。

### @glasshome/ui 需要什么版本的 Node\.js？

package\.json 的 engines 字段要求 Node\.js \>=20。版本不符时 npm 默认只给出警告，开启 engine-strict 后会拒绝安装。

### @glasshome/ui 可以商用吗？

@glasshome/ui 使用 MIT 许可。宽松许可：允许商业使用、修改和再分发，通常只需在分发时保留原版权与许可声明。以上为概括，不构成法律意见，请以许可原文为准。

### @glasshome/ui 的下载量有多少？

根据 npm 官方下载统计，@glasshome/ui 在 2026/10/17 – 2026/11/15 这 30 天内被下载 3,377 次，日均约 113 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入，适合横向比较热度，不能直接等同于使用人数。

### @glasshome/ui 还在维护吗？

最新版本 1\.40\.0 发布于 2026/11/16（今天）；至今共发布 84 个版本，其中过去 12 个月发布了 84 个；首次发布于 2026/03/23。发布频率只是参考信号：功能稳定的工具可能很少需要更新，建议结合源码仓库的 issue 和提交记录判断。

