@ag2/weave

中文文档
0.21.1发布于 2026/11/05Apache-2.0TypeScriptES Module近 30 天下载 1.1万

编织-AG2空间设计系统(从折叠2.6.2起)

中文使用文档
文档目录3 节
  1. 临时侧边栏倒塌
  2. 环境背景
  3. 地方发展

编织

故事书: https://ag2-space.github.io/weave/ 互联网档案馆的存檔,存档日期2013-12-02 每个分支都有自己的 https://ag2-space.github.io/weave/<branch>/。 。 。 .

AG2空间设计系统. 从 折叠 2.6.2 (阿帕切-2.0); @ag2/[email protected] 实值 折叠@ 2.6.2 在新名称下.

临时侧边栏倒塌

保留 PageNav 挂载和呼叫 useRoomNavAutoCollapse 一次从房间布局:

import { useRoomNavAutoCollapse } from "@ag2/weave";

useRoomNavAutoCollapse(commonsOpen && !isMobile, roomId);

钩子在不写字的情况下先倒塌侧边栏 roomNavCollapsed。 。 。 . 关闭常识或卸载布局 释放请求并恢复已保存 优先选择。 手动控制仍在使用 useRoomNavCollapsed();它们切换有效的 状态,保存用户的选择,并覆盖已激活的请求。 正在切换标签 同一个房间保留了这个选择。 关闭和重新开放公共设施,或更改 roomId, (中文(简体) ), 启动新的自动崩溃。 终身保留任择范围不变 ,并禁用移动中的请求.

useRoomNavCollapsed() 保留其现有的tuple和动画选项。 崩溃了 侧边栏的还原按钮仍然是扩展它的方法;不需要室长控制.

环境背景

OrbBackground 使 Absorb / calm / Aura 字段成为默认背景 联 合 国 SplashScreen。将其与导出元素放在元素内 OrbBackgroundHost 所以它的装饰画布坐落在内容后面 被剪到表面边缘. 母程序通过正常的主题符号提供背景颜色 .

事情已经解决了 color.Background.Container 符号,包括嵌入和自定义 主题。 可选 appearance="light" | "dark" prop 允许框架主机覆盖 颜色强度。 被减少的运动使一个静态域;隐藏文档暂停动画. 所有动画帧,调整观察器大小,以及主题收听器被移除于卸载. Starfield 财务报告和审定财务报表 StarfieldHost 仍为现有消费者出口.

田园改编自 平面/空间。 。 。 .

折叠

Npm package

Folds是为Cinny矩阵客户端所制作的设计系统.

地方发展

执行以下启动开发服务器的命令 :

npm ci # Install all dependencies
npm run storybook # Serve a development version

要构建软件包:

npm run build # Build package into dist directory

版本与发布记录

@ag2/weave 共发布 28 个版本,首次发布于 2026/09/14;过去 12 个月发布了 28 个版本。

版本发布日期距今
0.21.1latest2026/11/051 天前
0.21.02026/11/051 天前
0.20.02026/11/042 天前
0.19.02026/11/042 天前
0.18.02026/10/298 天前
0.17.02026/10/298 天前

其他发布通道:direction-d → 0.6.0-direction-d.2。

关于 @ag2/weave 的常见问题

@ag2/weave 是什么?

编织-AG2空间设计系统(从折叠2.6.2起)

如何安装 @ag2/weave?

在项目目录运行 npm install @ag2/weave,或使用 pnpm add / yarn add / bun add。它还需要宿主项目提供 peer 依赖:react(>=17 <19)、react-dom(>=17 <19)、classnames(^2.3.2)、@vanilla-extract/css(^1.9.2)、@phosphor-icons/react(^2.1.10)、@vanilla-extract/recipes(^0.3.0)。npm 7 及以上与 pnpm 8 及以上默认会自动安装必需的 peer 依赖,Yarn 需要手动安装。

@ag2/weave 支持 TypeScript 吗?

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

@ag2/weave 支持 ESM 还是 CommonJS?

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

@ag2/weave 可以商用吗?

@ag2/weave 使用 Apache-2.0 许可。宽松许可:允许商业使用、修改和再分发,并附带明确的专利授权;分发时需保留许可与 NOTICE 文件,修改过的文件要注明改动。以上为概括,不构成法律意见,请以许可原文为准。

@ag2/weave 的下载量有多少?

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

@ag2/weave 还在维护吗?

最新版本 0.21.1 发布于 2026/11/05(1 天前);至今共发布 28 个版本,其中过去 12 个月发布了 28 个;首次发布于 2026/09/14。发布频率只是参考信号:功能稳定的工具可能很少需要更新,建议结合源码仓库的 issue 和提交记录判断。