# @harmonics/lattice-ui 中文文档

规范地址：https://npmcn.com/package/%40harmonics/lattice-ui/

版本：0\.19\.1
npm 元数据更新时间：2026-11-12T08:39:45.011Z
中文译文更新时间：2026-11-17T18:58:35.413Z
软件包许可：MIT

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

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

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

- 包体积（解压后）：401 kB，47 个文件
- 模块格式：ES Module
- TypeScript 类型：包内自带
- 运行依赖：0 个
- 首次发布：2026-10-26T19:47:58.581Z
- 最新版本发布：2026-11-12T08:39:44.598Z
- 近 30 天下载量：4507（2026-10-17 至 2026-11-15，npm 官方下载统计）
- 已发布版本数：25（近 12 个月 25 个）

## 中文简介

谐音树外观为自定义元素:一面花纹相相,六角天相,高起花纹相外形;一面剪相相接相相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相相接相接相接相接相接相接相接相接相接相相接相接相接相接相接相接相接相接相相接相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相 任何一页,任何

## 安装

```sh
npm install @harmonics/lattice-ui
```

也可以使用：`pnpm add @harmonics/lattice-ui`、`yarn add @harmonics/lattice-ui`、`bun add @harmonics/lattice-ui`

## README

# @相声/相声-ui

谐音树的外观为自定义元素:一幅被拉出自己三角形的相貌 六角星空,高高起的细胞和三角形外形,剪切的手势,环绕一个被扣点的四道,标记,并有一块棋盘来作后盾. 他们工作 在任何页面和任何框架(React, Vue, Svelte, Solid, Plain HTML)中,没有构建步骤。 每个 抽取出自己的"影子"根,并带着树的颜色,所以它不需要别的了 该页。 你带来国家;元素引出它.

```sh
npm install @harmonics/lattice-ui
```

## 五分钟后

```html
<script type="module">
  import "@harmonics/lattice-ui/define"; // registers every element
</script>

<lattice-face mood="distressed"></lattice-face>
<lattice-shape shape="flower" tone="sage"></lattice-shape>
<hex-sky style="height: 200px"></hex-sky>
<button><lattice-icon name="shears"></lattice-icon> Prune</button>
```

`@harmonics/lattice-ui` 本身在导入时未定义: call `defineLatticeElements()` (或 一个元素的 `defineLatticeFace()`,.)在浏览器中. 两者都能够在服务器渲染中安全地导入; 在那里他们什么都不做。 每一个输入既是属性又是属性; 属性集不是 更改属性, 所以样式按类而不是按 `[mood=…]`输入未知值 回到默认状态.

一个已经保存的标签库留给它, 并带有警告 。 给元素一个标记 拥有 : `defineHexSky("my-sky")`,每张都一样 `defineX`。 。 。 .

在页面上移动的元素( 重新排序的列表) 保留它正在做的事情; 一个从页面取出 一会儿再说吧.

## 要件

### `<lattice-face>`

一个苍白的六边形板块从页面上抬起,上面有一张脸,在1,536个拉蒂斯三角形. 它闲闲地(喘息地,眨眼地)取笑 `pulse` 向上,保持自己的浏览和 流出眼泪,放出笑的眼神和口, 沉入旧面孔 步入新面孔 升起时. 下 `prefers-reduced-motion` (随其变化而去),或 `still`静静地 只有改变。 关闭屏幕, 或隐藏标签, 它不会闲置 。 每张页面上的脸都闪烁 呼吸在自己的时间,所以一行 他们不移动作为一个; 闲置是几十个姿势, 各画一出并保存. 在72像素下,它被取出于相近的花纹上(每边被切入8, 在64平地下,有更大胆的线条,128平地上的盘子被抛出,所以 小脸还是个脸.

| 投入 | 类型 | 默认 |  |
| --- | --- | --- | --- |
| `mood` | `happy` `content` `asleep` `sad` `distressed` `puzzled` `relieved` (单位:千美元)`MOODS`(中文(简体) ) | `happy` | 感觉如何,每个心情都戴着相貌。 用它来表达一种感觉 |
| `expression` | 一张脸的名字来自 `FACES`,无论如何(`happy`, (中文(简体) ), `content`, (中文(简体) ), `laughing`, (中文(简体) ), `sad`, (中文(简体) ), `surprised`, (中文(简体) ), `puzzled`, (中文(简体) ), `angry`, (中文(简体) ), `worried`, (中文(简体) ), `sleepy`, (中文(简体) ), `wink`, (中文(简体) ), `smitten`(中文(简体) ) |  | 一面名相,不论心情如何,胜过 `mood` |
| `character` | `elder` `sprout` `scamp`,无论如何 |  | 谁所穿. 需要一个 `characters` 条目;一个未知的,或者没有,是树本身的脸 |
| `pulse` | 编号 | `0` | 举起它一个人取笑解脱 |
| `still` | 布尔 | `false` | 没有闲事,没有笑,没有淡出 |
| `size` | 数字( 像素) | `96` | 其宽度;高度随同. 72下取取出相近的花纹,64下平地,128下没有板块 |
| `label` | 字符串 | "一个快乐的脸" | 屏幕阅读器说 |
| `decorative` | 布尔 | `false` | 从屏幕阅读器中隐藏 |

```js
const face = document.querySelector("lattice-face");
face.pulse += 1;
```

#### 字符

`import "@harmonics/lattice-ui/characters"` 增加三个字符和五个表达式(`proud`, (中文(简体) ), `bored`, (中文(简体) ), `determined`, (中文(简体) ), `shy`, (中文(简体) ), `skeptical`),是一页来装入: `index` 从来没有。 直到它结束 到达时,它会增加一个角色或表情 倒倒在树上 和情绪的表情; 一个已经画出的脸,然后把它取出, 这样导入可以按任何顺序来, 或者懒惰。 每个 角色穿16个.

| `character` | 谁 | 移动 |
| --- | --- | --- |
| `elder` | 干; 都看过了 | 慢慢地: 持之以恒, 抬起眉头, 叹息 |
| `sprout` | 这里新建; 处于警戒状态 | 快:一双眨眼一双发抖 |
| `scamp` | 准备什么 | 拍出前一点:嘴上抽搐,侧道相望 |

人物闲置小取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取处处处处处处处处处处处的取取取取取取取取取取取取取 (一眨眼,一双取出,一倒下,一平克,一倒下) 老脸蛋 脉搏, `still`,减少运动或关闭屏幕 停止一个行为;树本身 脸部保持它的回路和水槽.

```html
<script type="module">
  import "@harmonics/lattice-ui/define";
  import "@harmonics/lattice-ui/characters";
</script>
<lattice-face character="scamp" expression="proud"></lattice-face>
```

### `<lattice-shape>`

由天花板的细胞和三角形组成,从一页起,每个部分组成 树的树林.

| 投入 | 类型 | 默认 |  |
| --- | --- | --- | --- |
| `shape` | `cell` `pair` `line` `flower` `triangle` `diamond` `trapezoid` `big-triangle` `hexagon` (单位:千美元)`SHAPE_NAMES`(中文(简体) ) | `cell` |  |
| `parts` | `Part[]`或者和JSON一样 |  | 窗帘上的任何形状; 胜过 `shape`。设置新阵列:已更改的阵列没有重新绘制 |
| `tone` | 名称 `TONE_NAMES`,或 0–7 键 | `0` | `brown` `ochre` `slate` `plum` `sage` (0–4,树的树林), `good-fruit` `bitter-fruit` `untasted-fruit` (5-7),无论如何 `tone` 可能也是个名字 |
| `color` | 任何 CSS 颜色 |  | 以你自己的颜色画出每个部分, 在其中画出你页面的标志: 它的上部颜色本身,它的侧面更深. 获胜 `tone` |
| `lift` | 编号 | `8` | 高高高高高高高高高高高高高高高高高高高高高高高高高高高高高高高高高高高高高高高高高高高高高高高高高高高高高高高高高高高高高高高高高高高高高高高高高高高高高高高高高高高高高高高高高高高高高高高高高高高高高高高高高高高高高高高高高高高高高高高高高高高高高高高高高高高高高高高高高高高高高高高高高高高高高高高高高高高高高高高高高高高高高高高高高高高高高高高高高高高高高高高高高高地高高高高高高高高高高高高高高高高高高高高高高高高高高高高高高高高高高高高高高高高高高高高高高高高高高高高高高高高高高高高高高高高高高高高 |
| `scale` | 编号 | `1` | 1 是树本身的大小:一个横跨76像素的单元格 |
| `label` | 字符串 |  | 如果没有一个,它就隐藏在屏幕阅读器中;当可按时,它的名字 |
| `pressable` | 布尔 | `false` | 类似自身形状的按钮( 下方) |
| `pressed` | 布尔 | 未设定 | 使可压取形状为切换(`aria-pressed`);页面设置 |
| `disabled` | 布尔 | `false` | 无法按出标签顺序的可压缩形状 |

部分是单元格 `{ kind: "cell", at: { q, r } }` 轴心螺旋网,或三角形 `{ kind: "tri", at: { i, j, k } }` (橡皮车) `i, j` 三角网格, `k` 0指向右边,1 ),各有可选 `tone`。 。 。 .

```js
shape.parts = [
  { kind: "cell", at: { q: 0, r: 0 }, tone: 1 },
  { kind: "tri", at: { i: 0, j: 3, k: 0 }, tone: 5 },
];
```

与 `pressable` 它是一个像自己形状的按钮, 对于一个调色板的树林, 一个取形器或 一个是形状的按钮。 在标签顺序中 `role="button"` 联 合 国 `label` 作为它的名称 (一个没有标签的警告在控制台). 点击其面部、 输入或空间( 在发布时) 火灾 `press`, (中文(简体) ), `{ shape, parts }`。只有它的面部取出指针: 相隔回合中的媒体 a 六边形的角落去 任何它下面。 它在指针下稍高一点 在按下时或按下时,汇到其升力的一半 `pressed`;键盘的环绕着它自己的 大纲和a `pressed` 一个保持一个安静的环 并画出它的顶部 在它的木材, 所以调色板 显示所选择的深度。 形状从不压自己:保留一个 `pressed` 在调色板中 `press`。 。 。 .

```js
for (const swatch of swatches)
  swatch.addEventListener("press", () => {
    for (const s of swatches) s.pressed = s === swatch;
  });
```

### `<hex-sky>`

树的天空,它的六边形花纹 划过它,填补元素。 把它大小为任何街区. 装饰相.

| 投入 | 类型 | 默认 |  |
| --- | --- | --- | --- |
| `kind` | `sky` `earth` | `sky` | 地:地上被撕成三角形的细胞 |
| `orient` | `pointy` `flat` | `pointy` | 平地:平地晶片顺时针转出四分之一回转的原生地,所以其细胞有平地上下平地 |
| `scale` | 编号 | `1` | 花纹的大小 |
| `x`, (中文(简体) ), `y` | 数字( 像素) | `0` | 龙卷风的出处位于元素的左上方, 所以显示一个较大部分的天空保持了它的细胞 |

### `<lattice-ways>`

一个点周围有四个动作,在一个尖顶的六角轴承上:上起下起下起下起下起下起下起下起下起下起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起起. 一页在指针倒下时显示它. 一个轴承是页面的.

将主机放置在点上(一个零大小的元素,或者任何框,其中心是点)和 设定 `pointer` 到已经下线的指针。 元素捕捉它。 没有指针, a 按此元素开始 。 细胞在离开时沿轴向内翻转 观相. 死区内部的放出,或被取消的指针,不选择什么. 那边 所以减速运动不会改变什么 拖放不是唯一的办法: 控制每个动作(WCAG 2.5.7).

| 投入 | 类型 | 默认 |  |
| --- | --- | --- | --- |
| `up-label`, (中文(简体) ), `down-label`, (中文(简体) ), `down-left-label`, (中文(简体) ), `down-right-label` | 字符串 | `Up`, (中文(简体) ), `Down`, (中文(简体) ), `Down-left`, (中文(简体) ), `Down-right` | 该单元格外侧的名称 |
| `up-icon`, (中文(简体) ), `down-icon`, (中文(简体) ), `down-left-icon`, (中文(简体) ), `down-right-icon` | 图标名称 | `count`, (中文(简体) ), `highlight`, (中文(简体) ), `next`, (中文(简体) ), `search` | 牢房里的标记 |
| `pointer` | 编号 | `-1` | 指针已下. `-1` 等待关于元素的媒体 |

| 活动 | `detail` |  |
| --- | --- | --- |
| `way` | `{ bearing }` | 指针上方是: `up`, (中文(简体) ), `down`, (中文(简体) ), `down-left`, (中文(简体) ), `down-right` |
| `wayend` | `{ bearing? }` | 每释出. `bearing` 无选择时省略 |

```js
ways.pointer = event.pointerId;
ways.addEventListener("way", (e) => act(e.detail.bearing));
ways.addEventListener("wayend", () => close());
```

`LatticeWaysEventMap` 自动键入这些元素 `addEventListener`。 。 。 .

### `<shears-pad>`

切口手势. 一拖一拖 画出刀刃的消失 并报告中风 削减由你决定。 把它放在可以剪掉的东西上 把它当作任何街区大小.

| 活动 | `detail` |  |
| --- | --- | --- |
| `stroke` | `{ points, point, fresh }` | 在每次行动时; `point` 是最新的, `fresh` 第一次中风 |
| `strokeend` | `{ points, cancelled }` | 每中风一次:升起,或 `cancelled` 当切短时(指针被取消或丢失, `disabled` 设置, 垫从页面上取出) |

点位于元素自左上角的像素中. `disabled` 停止它中风.

键盘也切了,所以拖动不是唯一的方法(WCAG 2.5.7):垫子在制表顺序上, 箭头会移动一个刀片标记(小步的Shift),空格或 Enter 则会在那里开始剪接并结束 越狱会缩短时间 一样 `stroke` 财务报告和审定财务报表 `strokeend` 从一个指针。 名称 自己通过这些键到屏幕读取器(`role="application"`) (中文(简体) ). 一页自己的 `tabindex`, (中文(简体) ), `role` 财务报告和审定财务报表 `aria-label` 保存 : `tabindex="-1"` 从标签顺序中取出,用于提供 切开自己的按钮.

```js
pad.addEventListener("stroke", (e) => cutAlong(e.detail.points));
pad.addEventListener("strokeend", (e) => (e.detail.cancelled ? undo() : commit()));
```

`ShearsPadEventMap` 自动键入 `addEventListener`为了找到中风的伤口, 见 [切割](https://npmcn.com/package/%40harmonics/lattice-ui/#readme-cutting)。 。 。 .

### `<lattice-icon>`

树上的一个标记(`ICON_NAMES`),在文本的颜色中,一个阶地平方 (单位:千美元)`--lattice-icon-size` 以改变它。 隐藏在屏幕阅读器中,除非它有 `label`每一个 标记取自花纹:六边形、三角形和钻石;每行正上方或 30°时。 24 像素以下( 默认步骤为 16) `shears`, (中文(简体) ), `bin` 财务报告和审定财务报表 `name` 绘制小画 细节较少,每个标记都用更重的线;元素根据自己的大小来选择.

| `name` |  | 部件 |
| --- | --- | --- |
| `shears` (默认) | 有两把六边形手柄,两把钻石刀 | `shears-handle`, (中文(简体) ), `shears-blade` |
| `done` | 六边形的支票 | `done-cell`, (中文(简体) ), `done-check` |
| `note` | 有两行写法的六边形 | `note-cell`, (中文(简体) ), `note-line` |
| `turn` | 六边形开口,三角形指向圆(R) | `turn-path`, (中文(简体) ), `turn-arrow` |
| `glue` | 两个牢房共用一重(G) | `glue-cell`, (中文(简体) ), `glue-seam` |
| `apart` | 两个单元格相隔很广(Shift+G) | `apart-cell` |
| `bin` | 钻石盖下的一个杯子(删除) | `bin-can`, (中文(简体) ), `bin-rib` (不低于24像素), `bin-lid` |
| `name` | 铅笔起于30°,三角形 | `name-body`, (中文(简体) ), `name-point`, (中文(简体) ), `name-band` (不低于24像素) |
| `split` | 三角形,中间转弯,西耶平斯基台阶 | `split-whole`, (中文(简体) ), `split-hole` |
| `search` | 六边形镜头, 指柄的条形 | `search-lens`, (中文(简体) ), `search-handle` |
| `previous` | 向左指向一线三角形 | `previous-arrow` |
| `next` | 向右指向一线三角形 | `next-arrow` |
| `close` | 30°处横穿两道 | `close-stroke` |
| `highlight` | 一个标记,它的一分三角, 在中风上,它放下 | `highlight-body`, (中文(简体) ), `highlight-nib`, (中文(简体) ), `highlight-stroke` |
| `count` | 四下中风打出五分之一 | `count-tally`, (中文(简体) ), `count-strike` |
| `bet` | 左侧是六边形 右上方是它的基地 | `bet-letter` |
| `harmonics` | 一个六边形,它的右手三角形 分出一个洞和三个角 | `harmonics-cell`, (中文(简体) ), `harmonics-spoke`, (中文(简体) ), `harmonics-hole` |

`turn`, (中文(简体) ), `glue`, (中文(简体) ), `apart` 财务报告和审定财务报表 `bin` 为: `<lattice-board>`键盘动作,用于提供 每个按钮; `name`, (中文(简体) ), `split` 财务报告和审定财务报表 `bin` 是和谐网的自身控制; `previous`, (中文(简体) ), `next`, (中文(简体) ), `close`, (中文(简体) ), `highlight` 财务报告和审定财务报表 `count` - 读者(和谐塔纳克读者栏和文字表); `bet`托拉的第一个字母是塔纳克读者自己的记号,在它的图标和取回者上; `harmonics` 是家庭的, 在其他的谐音页面的图标.

## 董事会

`<lattice-board>` 是一个人所建造的熔岩的表面 即和谐号 树的 Build 模式有。 它是一个自己的条目,所以一个没有一加载的一页都没有.

```js
import { defineLatticeBoard } from "@harmonics/lattice-ui/board";
defineLatticeBoard();

const board = document.querySelector("lattice-board");
board.pieces = [
  { id: "a", parts: [{ kind: "cell", at: { q: 1, r: 1 }, tone: 0 }, { kind: "cell", at: { q: 2, r: 1 }, tone: 0 }] },
  { id: "b", parts: [{ kind: "tri", at: { i: -6, j: 16, k: 0 }, tone: 5 }] }, // a triangle of cell (7, 1)
];
board.addEventListener("change", (e) => save(e.detail.pieces));
```

```html
<lattice-board tray style="height: 400px"></lattice-board>
```

拖出一块,绳子把它拉入: 靠近一个插槽,它倾斜 和插槽灯,它更靠近 抓住并握住,放走它 点击到槽里,或者去它最靠近的地方。 一块 (b) R和Shift+R(或双击)将其转至第六; G 粘贴到它与它共享的每块( 边先发光); Shift+ G把它打成这样 单位; Alt-Drag 将部分拉出; 删除丢出 。 在减速运动下,一个携带的棋子 完全按照指针,没有动画.

| 投入 | 类型 | 默认 |  |
| --- | --- | --- | --- |
| `pieces` | `{ id?, parts, pivot? }[]`或者和JSON一样 |  | 棋盘从什么开始,读回,它自己的棋子现在(每个 `{ id, parts, pivot }`) (中文(简体) ). 重新设定,作为新的阵列,以替换它们; 将读过的东西拿回来,每块保留它 `pivot`,所以它转像它。 一张没有一张的相片的代号 从不匹配的页面 |
| `fixed` | `{ id?, parts }[]` (财产) |  | 平地和在路上,从来没有处理,粘住或交回。 重新设置它只代替了固定的部件:其他的留在人放置的地方. 固定的棋子放在页面所放的地方,甚至从板上划出太窄了,放在最小的板上 |
| `tray` | 布尔 | `false` | 左下方的两个单元格:拖出一个新的单元格或三角形(或在一个上输入),将一块投到那里丢去:托盘会转出警示颜色并显示一个在它的上方的取出 |
| `scale` | 编号 | `1` | 1 是树本身的大小:一个横跨76像素的单元格 |
| `label` | 字符串 | "一块花板" | 屏幕读取器怎么叫它 |

| 活动 | `detail` |  |
| --- | --- | --- |
| `change` | `{ pieces, action, id }` | 做每件事之后: `action` 实值 `move`, (中文(简体) ), `turn`, (中文(简体) ), `glue`, (中文(简体) ), `break`, (中文(简体) ), `pull`, (中文(简体) ), `add` 或者说 `remove`· ; `id` 该作品已付诸行动(`""` 当调整大小将棋子移回棋盘时)。 可取消 : `preventDefault()` 撤销它,除了 调整大小的,不是。 它从板上冒出一个土生土长 `change` 有: 表格本身 `change` 围着板子的听众也听到了 |
| `catch` | `{ id }` | 一个插槽抓住了带的棋子: 一页自己的声音在这里 |

棋盘填充元素;大小为任意块. 它的花纹从左上方开始 所以 `<hex-sky>` 大小相同且 `scale` 下方显示槽. `LatticeBoardEventMap` 类型 董事会本身的事件 `addEventListener`碎片是 `Piece`页:1 [几何](https://npmcn.com/package/%40harmonics/lattice-ui/#readme-geometry):在交接这些功能之前,有一个页面可以将它们与这些功能一起列出.

## 样式

每个元素都带有树的颜色标志,有光有暗(下面是) `prefers-color-scheme`) (中文(简体) ). 设定其中任何元素本身来改变它:

```css
lattice-face, lattice-shape {
  --color-tree-ink: #222;
  --color-tree-raised: #fffdf6;
}
```

把它们设定在元素上,而不是在 `body`:一个元素自己的活符坐落在比祖先更相近的地方.

无论系统是什么,都用一个元素 `data-theme="light"` 或者说 `"dark"`; 与 软件包 `tokens.css` (下文), `data-theme` 在页面根上对页面也做同样的处理. 这些元素使用的是:

| 脚本 | 用于 |
| --- | --- |
| `--color-tree-sky` | 天空,什么树林和板块混合 |
| `--color-tree-earth` | 大地的天空 |
| `--color-tree-ink` | 脸的特征 |
| `--color-tree-raised` | 面板,一闪一闪,未尝有果实 |
| `--color-tree-wood-0` . `--color-tree-wood-4` | 五道树林; `wood-0` 也是板块的边缘 |
| `--color-tree-olive` | 果实 |
| `--color-tree-alert` | 脸红 舌头 刀刃的踪迹 |
| `--color-tree-lattice-sky`, (中文(简体) ), `--color-tree-lattice-earth` | 线条 |
| `--tree-rule-width`, (中文(简体) ), `--tree-rule-thick-width` | 边缘、接缝、刀片 |
| `--space-tree-2`, (中文(简体) ), `--space-tree-4` | 脸部下沉多远; 图标大小 |

每一个元素还暴露出其绘画的一部分: `::part(face)`, (中文(简体) ), `::part(shape)`, (中文(简体) ), `::part(sky)`, (中文(简体) ), `::part(trail)`, (中文(简体) ), `::part(icon)`, (中文(简体) ), `::part(board)`,形状的焦点环 `::part(ring)`A级 标记本身的路径也是部件(参见 `<lattice-icon>`以徘徊者发誓 `lattice-icon::part(done-cell)`。 。 。 .

## 键和字体

这些元素从页面上不需要任何东西:每个元素都包含着树的标志,并画出不 文本,所以不需要字体。 对于一个要自己在树上写字的页面 值, 包中还装入了符号和读取面, 每个在导入时才装入 :

```js
import "@harmonics/lattice-ui/tokens.css"; // every token of the tree, on :root, light and dark
import "@harmonics/lattice-ui/fonts.css"; // Atkinson Hyperlegible Next, upright and italic
```

```css
body { font: var(--font-body); background: var(--color-tree-sky); color: var(--color-tree-ink); }
```

`tokens.css` 是树的 `DESIGN.md` 作为自定义属性:颜色(`--color-tree-*`,与 它们的暗值 `prefers-color-scheme: dark`),类型(`--font-body` 及其大小),以及 间距和宽度(`--space-tree-*`, (中文(简体) ), `--tree-*-width`) (中文(简体) ). 这个 `--font-tree-*` 符号名称 树的单相间相,机器人多相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相 他们有一个页面 得到它的系统单一空间在那里.

`fonts.css` 宣布 Atkinson 超能下一位(盲文学院的面孔,制作时的形状) 容易混淆的字母保持不变)作为可变 `@font-face`编号与 `unicode-range`,所以一个 浏览器只获取其信件需要的文件(拉丁文文件约为34 KB). 拿着 单独导入自己的工作表:

```js
import "@harmonics/lattice-ui/fonts/atkinson-hyperlegible-next/index.css";
```

面部由SIL开放字体许可证1.1;其 `LICENSE` 船舶及其档案 `fonts/atkinson-hyperlegible-next/`。这些文件是 `@fontsource-variable` 发表.

## 框架

-   **反应 19**: 直接使用标记(如其他标记一样,在制作前定义板); 添加 `import type {} from "@harmonics/lattice-ui/react"` 他们的道具。 反应 19 设置输入为属性, 所以 `parts={[…]}` 工作,并倾听 `onstroke` 编号 : `onstrokeend`。在 React 第一次使其生效之前先定义各项要素: 无法查看属性和设置 `parts` 作为属性 `"[object Object]"`绘制 无所事事(形状会在控制台上警告一次).
-   **固态**数字 : `import type {} from "@harmonics/lattice-ui/solid"`; 设定对象为 `prop:parts`· ; 听着 `on:stroke`。 。 。 .
-   **阴道**:告诉编译器标签是自定义元素 (单位:千美元)`compilerOptions.isCustomElement: (tag) => /^(lattice|hex|shears)-/.test(tag)`; 绑定对象 与 `.prop` (单位:千美元)`:parts.prop="parts"`); 听从 `@stroke`。 。 。 .
-   **Svelte、 Angular、 Plain HTML 软件**:作为任何自定义元素.

类型脚本知道来自 `HTMLElementTagNameMap` 一旦软件包被导入.

## 几何

`@harmonics/lattice-ui/hexes` 是拉蒂斯自己的几何, 对于一个页面将块放在 天空本身(一个棋盘、一个谜题、一个编辑器)。 纯函数,没有DOM,在服务器渲染中安全.

```js
import { pieceOf, moved, snapDelta, fits, nearestFit, screenArea } from "@harmonics/lattice-ui/hexes";

const piece = pieceOf("a", [{ kind: "cell", at: { q: 2, r: 1 }, tone: 1 }]);
const carried = moved(piece, snapDelta(piece, dx, dy)); // follow a pointer, snapped to whole cells
const placed = fits(carried, others, screenArea(width, height))
  ? carried
  : nearestFit(carried, others, screenArea(width, height));
```

天空是尖顶六边形44:一个细胞横跨76.21个,行相隔66个,每个 排起半个囚室 再往右 一个单元格是 `{ q, r }` (轴);其盒的左上角是 `boxOf(hex)`分出三角形 天空也是角形的网格 `{ i, j }` (单位:千美元)`cornerOf`),每个 两个三角形的左上角 `{ i, j, k }`数字 : `k` 右一分,左边一分 一块是 `{ id, parts, pivot }`; 制作一个 `pieceOf`。一个带细胞的片段一次移动整个细胞.

躺下来 `<lattice-shape>` 完全在一个 `<hex-sky>` 成员名单 `scale` (单位:千美元)`s`,使形状 部件并放在 `s × (minX − 2, minY − lift − 2)`每一个角落的左上角 覆盖`covered`, (中文(简体) ), `cornersOf`, (中文(简体) ), `cornerOf`),少了外形的粘接和抬起.

### 粘贴

共享一面(不只是一角)的片块可以被粘入一面;每个部分保留其一面 `tone`这样 胶片仍然显示它的树林, 它移动和转动在一起。 分割 a 的函数 块取出 `id`,你自己的生成器 新块id.

```js
import { apart, glued, pulledOff, seamsOf, sharedSides, turned, unitAt } from "@harmonics/lattice-ui/hexes";

const sides = others.flatMap((o) => sharedSides(piece, o)); // where G would glue: draw them lit
const { piece: one, absorbed } = glued(piece, others); // G: drop the absorbed ids from your list
const seams = seamsOf(one); // the sides between its parts, to draw as hairlines
const units = apart(one, newId); // Shift+G: every part a piece of its own
const [part, ...rest] = pulledOff(one, index, newId); // one part off; the rest stay joined
const turnedOnce = turned(one, 1); // a sixth clockwise about its pivot (pivotPoint(one) on screen)
const fresh = unitAt("tri", x, y, tone, newId()); // a new cell or triangle under a point
```

侧相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相相接相接相接相接相接相接相接相接相接相相接相接相接相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相 取出胶片 与 `<lattice-shape>` 像其他的一样,把它的零件.

### 磁铁

一个携带的碎片被拉入了天空的花纹. 靠近一个槽 它倾入。 更近一点,插槽 抓住它,它就在那里画出 它一直被扣留 直到被拖走 距离比渔获物更远 所以它不会在边缘闪烁. `MAGNET` 持有 4个相距,作为部件的部件: `reach`, (中文(简体) ), `capture`, (中文(简体) ), `release` 财务报告和审定财务报表 `lean`。 。 。 .

```js
import { magnetOf, moved, snapFrames, stepOnScreen } from "@harmonics/lattice-ui/hexes";

let held; // the slot it is held in, handed back on every move
onPointerMove((dx, dy) => {
  const m = magnetOf(piece, dx, dy, held);
  held = m.held;
  draw(piece, m.x, m.y); // where it is drawn, as a move from where it was lifted
  glow(m.step, m.pull); // the slot it would land in, and how hard it pulls (0 to 1)
});
onPointerUp((dx, dy) => {
  const m = magnetOf(piece, dx, dy, held);
  const slot = stepOnScreen(m.step); // the slot's move on the screen
  piece = moved(piece, m.step);
  // The click: from where it was let go, past the slot once, to rest in it.
  element.animate(snapFrames({ x: m.x - slot.x, y: m.y - slot.y }), { duration: 260 });
});
```

在被缩小的动作下,将片段划入槽中并去掉动画.

### 切割

这算什么 `<shears-pad>` 中风了 中风一进一出就穿透了轮廓 一边去,一边去,一边去,一边去,一边去,一边去,一边去.

```js
import { crossesCell, crossesLine, crossesRing } from "@harmonics/lattice-ui/hexes";

pad.addEventListener("stroke", (e) => {
  const stroke = e.detail.points; // in the sky's pixels when the pad covers the sky at scale 1
  const isCut = (part) => part.kind === "cell" && crossesCell(stroke, part.at);
  const cut = pieces.filter((p) => p.parts.some(isCut));
  const severed = crossesLine(stroke, branch); // through a line of points
  const through = crossesRing(stroke, outline); // through any closed outline
});
```

`crossesCell(stroke, hex, lift)` 将单元格取为已绘制 `lift` 超越它的位置.

## 服务器渲染

导入服务器上的任何一条都无所作为, 丢弃也无所作为 。 标记为标记; 当页面在浏览器中定义它们时,它们会绘制它们.

## 许可证

麻省理工学院. 包裹捆绑 [固态](https://www.solidjs.com/) (麻省理工学院).

## 常见问题

### @harmonics/lattice-ui 是什么？

谐音树外观为自定义元素:一面花纹相相,六角天相,高起花纹相外形;一面剪相相接相相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相相接相接相接相接相接相接相接相接相接相相接相接相接相接相接相接相接相接相相接相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相 任何一页,任何

### 如何安装 @harmonics/lattice-ui？

在项目目录运行 npm install @harmonics/lattice-ui，或使用 pnpm add / yarn add / bun add。

### @harmonics/lattice-ui 支持 TypeScript 吗？

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

### @harmonics/lattice-ui 支持 ESM 还是 CommonJS？

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

### @harmonics/lattice-ui 可以商用吗？

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

### @harmonics/lattice-ui 的下载量有多少？

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

### @harmonics/lattice-ui 还在维护吗？

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

