@getaster/elements

中文文档
0.4.72发布于 2026/11/16Apache-2.0TypeScriptES Module构建来源已验证近 30 天下载 3529

由共享的Aster数据模型支持的浏览器-本地网格,窗体和工作空间控制.

中文使用文档
文档目录5 节
  1. 安装
  2. 连接网格
  3. 编写应用程序
  4. 文件和支助
  5. 许可证

@ getster/ 要素

对元数据驱动的企业应用程序的浏览器-本地控制:网格, 表格、拾取器、过滤器、仪表板和工作空间。 控制共享记录 通过编辑状态 @getaster/data 并使用 CSS 进行布局和主题.

预览控件单独发布于 @getaster/elements-preview。 。 。 .

安装

npm install @getaster/data @getaster/elements

使用带有自定义元素和ES模块的现代浏览器,并加装一个捆绑器 解决 npm 模块和 CSS 导入。 货包船"TypeScript"申报. 其主条目注册浏览器元素并需要 DOM; 使用 @getaster/data 为无头工作。 包工具需要节点22或更后.

@getaster/elements/styles/theme-lamplight.css 财务报告和审定财务报表 @getaster/elements/styles/theme-harbour.css 各作底生, 元素样式和一个身份。 灯光也装入了包件 Bricolage Grotesque和Fraunces 拉丁面相, 与当地面相匹配 后退,从 @getaster/elements/styles/fonts.css。导入一个 输入,而不是部件.

连接网格

有了OData服务 暴露一个 Projects 实体集和 JSON CSDL 元数据:

import { DataContext, fetchTransport } from '@getaster/data';
import { Grid } from '@getaster/elements';
import '@getaster/elements/styles/aster-ui.css';

const ctx = await DataContext.connect(
  fetchTransport('https://your-service.example/odata/')
);
const grid = new Grid();
grid.ctx = ctx;
grid.set = 'Projects';
grid.label = 'Projects';
grid.style.height = '24rem';
document.body.append(grid);

将端点和实体替换为您自己的。 给虚拟网格 a 边框高度,并按 主题指南视图时 关闭, 删除元素; 单独拥有的数据模型仍然是主机的 责任.

编写应用程序

使用共享数据上下文连接网格,窗体和选择. Java 脚本和 YAML 构成支持可重复使用的工作空间定义. 管制规定 键盘交互和语义标记; 应用程序标签、焦点流和 在完成的应用程序中仍然需要测试无障碍性.

软件包依赖于Aster的数据核心,Lit HTML和Preact信号. 留一个 在您的构建中每个共享运行时间的相容副本 。 YAML 编译器是一个 分道扬镳, @getaster/elements/yaml,是装入 页:1 yaml parser; 导入已编译定义的浏览器永远不会加载它 . 可选ECharts适配器接受应用程序提供的运行时间;ECharts, 显示数据和模拟服务不捆绑在这个软件包中。 这个 灯光字体文件及其SIL Open Font许可文本包含在下面 styles/fonts/。没有安装脚本.

文件和支助

许可证

阿帕奇2.0 (英语). 见包含的内容 LICENSE 和特定软件包 NOTICE。 。 。 . 单独安装的附属单位保留自己的许可证.

版本与发布记录

@getaster/elements 共发布 20 个版本,首次发布于 2026/10/21;过去 12 个月发布了 20 个版本。最新版本附带 npm provenance 构建来源证明,可追溯到公开的 CI 构建记录。

版本发布日期距今
0.4.72latest2026/11/16今天
0.4.472026/11/141 天前
0.4.422026/11/133 天前
0.4.402026/11/133 天前
0.4.382026/11/123 天前
0.4.352026/11/123 天前

其他发布通道:next → 0.1.0-preview.1。

关于 @getaster/elements 的常见问题

@getaster/elements 是什么?

由共享的Aster数据模型支持的浏览器-本地网格,窗体和工作空间控制.

如何安装 @getaster/elements?

在项目目录运行 npm install @getaster/elements,或使用 pnpm add / yarn add / bun add。它还提供命令行工具 aster-lint、aster-skill、aster-theme-check,可以用 npx aster-lint 直接运行。

@getaster/elements 支持 TypeScript 吗?

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

@getaster/elements 支持 ESM 还是 CommonJS?

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

@getaster/elements 需要什么版本的 Node.js?

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

@getaster/elements 可以商用吗?

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

@getaster/elements 的下载量有多少?

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

@getaster/elements 还在维护吗?

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