Skip to content

Pantoken A2UI 目录

探索适用于 A2UI 1.0 的 Pantoken 组件词汇表。此目录仅定义 Pantoken 组件;标准布局组件仍在 A2UI Basic Catalog 中。

客户端支持

  • 已通过已发布的 A2UI 1.0 Lit SDK 验证。
  • 已在 Chromium、Firefox 和 WebKit 中使用 @a2ui/react 0.15.0 和 React 19.3.1 验证。
  • 已在 Chromium、Firefox 和 WebKit 中使用 @a2ui/angular 0.14.0 和 Angular 21.2.5 验证。
  • Flutter、SwiftUI 和 Jetpack Compose:仅支持架构;没有 Pantoken 原生组件渲染器。

操作

此目录未定义可执行函数。按钮操作使用 A2UI 注册的操作处理机制。

Lit 注册

import { basicCatalog } from "@a2ui/web_core/catalogs/basic/v1";
import { MessageProcessor } from "@a2ui/web_core";
import { pantokenA2uiCatalog, registerPantokenA2uiComponents } from "@pantoken/web-components/a2ui";

registerPantokenA2uiComponents();
const processor = new MessageProcessor([basicCatalog, pantokenA2uiCatalog]);

使用 @catalogId 引用 Pantoken 组件,同时也可使用 Basic Catalog 组件。

{
  "id": "save",
  "@catalogId": "https://pantoken.app/a2ui/catalog/v1/catalog.json",
  "component": "PantokenButton",
  "label": "Save"
}

组件 (61)

PantokenIcon

从 Pantoken 图标集中选取的内联字形。

name必填
a-arrow-down, a-arrow-up, a-large-small, accessibility, accessibility-2, activity, ad, ai-info, ai-spinner, air-vent, airplay, alarm-clock, ...
size可选
1em, 1.25em, 1.5em, 2em

PantokenButton

采用令牌样式的操作按钮,可选支持 A2UI 事件和 Invoker Commands 行为。

label必填
A2UI v1.0 DynamicString
variant可选
primary, secondary, tertiary, danger, success, ai, ai-secondary
commandTarget可选
A2UI v1.0 ComponentId
command可选
--show, --close, --toggle, --push, --back, --goto
popoverTarget可选
A2UI v1.0 ComponentId
popoverAction可选
toggle, show, hide
children可选
A2UI v1.0 ChildList
action可选
A2UI v1.0 Action

PantokenAlert

可选支持超时关闭的状态消息。

variant可选
info, success, warning, danger
timeout可选
A2UI v1.0 DynamicNumber
transition可选
fade, none
hasShadow可选
A2UI v1.0 DynamicBoolean
message可选
A2UI v1.0 DynamicString
children可选
A2UI v1.0 ChildList
action可选
A2UI v1.0 Action

PantokenBadge

紧凑型计数或状态徽章。

variant可选
success, danger, inverse
label可选
A2UI v1.0 DynamicString
children可选
A2UI v1.0 ChildList

PantokenPill

紧凑型状态胶囊。

variant可选
neutral, info, success, warning, danger, plum, aurora, sky, orange, violet, sea, stone
label可选
A2UI v1.0 DynamicString
children可选
A2UI v1.0 ChildList

PantokenTag

采用令牌样式的标签或标记。

label可选
A2UI v1.0 DynamicString
children可选
A2UI v1.0 ChildList

PantokenAvatar

具有受限调色板、尺寸和形状的首字母头像。

variant可选
ai, blue, green, grey, orange, red
size可选
2xs, xs, sm, md, lg, xl, 2xl
shape可选
rectangle
initials可选
A2UI v1.0 DynamicString
children可选
A2UI v1.0 ChildList

PantokenSpinner

加载状态指示器。

variant可选
inverse, ai, ai-on-color

PantokenProgress

水平进度或计量指示器。

valueNow可选
A2UI v1.0 DynamicNumber
min可选
A2UI v1.0 DynamicNumber
valueMax可选
A2UI v1.0 DynamicNumber
variant可选
brand, info, success, warning, danger, inverse, primary-inverse
label可选
A2UI v1.0 DynamicString
shouldAnimate可选
A2UI v1.0 DynamicBoolean

PantokenMetric

与描述性标签搭配的大号数值。

value必填
A2UI v1.0 DynamicString
label必填
A2UI v1.0 DynamicString

PantokenRating

只读星级评分,星星数量有上限。

value可选
A2UI v1.0 DynamicNumber
max可选
A2UI v1.0 DynamicNumber
label可选
A2UI v1.0 DynamicString

PantokenProgressCircle

圆形进度或计量指示器。

valueNow可选
A2UI v1.0 DynamicNumber
min可选
A2UI v1.0 DynamicNumber
valueMax可选
A2UI v1.0 DynamicNumber
label可选
A2UI v1.0 DynamicString
shouldAnimate可选
A2UI v1.0 DynamicBoolean
animationDelay可选
A2UI v1.0 DynamicNumber

PantokenIconButton

带有无障碍标签的纯图标按钮。

label必填
A2UI v1.0 DynamicString
iconName必填
a-arrow-down, a-arrow-up, a-large-small, accessibility, accessibility-2, activity, ad, ai-info, ai-spinner, air-vent, airplay, alarm-clock, ...
action可选
A2UI v1.0 Action

PantokenToggleButton

两种状态的按钮,其按下状态绑定到 A2UI 数据。

pressed可选
A2UI v1.0 DynamicBoolean
label可选
A2UI v1.0 DynamicString
children可选
A2UI v1.0 ChildList
action可选
A2UI v1.0 Action

PantokenTruncate

行数在允许范围内的截断文本区域。

lines可选
auto, 1, 2, 3, 4, 5, 6
text可选
A2UI v1.0 DynamicString
children可选
A2UI v1.0 ChildList

PantokenImg

使用经过清理的媒体 URL 并限制呈现方式的响应式图片。

src必填
A2UI v1.0 MediaUrl
alt必填
A2UI v1.0 DynamicString
constrain可选
cover, contain
display可选
block

PantokenSideNavBar

可折叠为仅显示图标的垂直导航栏。

minimized可选
A2UI v1.0 DynamicBoolean
children可选
A2UI v1.0 ChildList

PantokenTreeBrowser

无障碍树结构,其子组件作为可聚焦的树项目公开。

label必填
A2UI v1.0 DynamicString
children必填
A2UI v1.0 ChildList
action可选
A2UI v1.0 Action

PantokenCalendar

可交互的月历,可更新选定的 ISO 日期。

value可选
A2UI v1.0 DynamicString
view可选
A2UI v1.0 DynamicString
action可选
A2UI v1.0 Action

PantokenTooltip

围绕触发组件显示的非交互式工具提示。

triggerLabel必填
A2UI v1.0 DynamicString
tip必填
A2UI v1.0 DynamicString
placement可选
top, bottom, start, end
showDelay可选
A2UI v1.0 DynamicNumber
hideDelay可选
A2UI v1.0 DynamicNumber
children可选
A2UI v1.0 ChildList
action可选
A2UI v1.0 Action

PantokenModal

通过命令控制打开和关闭行为的原生对话框。

open可选
A2UI v1.0 DynamicBoolean
children可选
A2UI v1.0 ChildList
action可选
A2UI v1.0 Action

PantokenContextView

采用 Pantoken 样式的提示弹出层。

open可选
A2UI v1.0 DynamicBoolean
children可选
A2UI v1.0 ChildList
action可选
A2UI v1.0 Action

PantokenPopover

浮动弹出层。

open可选
A2UI v1.0 DynamicBoolean
children可选
A2UI v1.0 ChildList
action可选
A2UI v1.0 Action

PantokenTray

贴近视口边缘的弹出面板,位置和尺寸均受限。

placement可选
top, bottom, start, end
size可选
xs, sm, md, lg, xl
open可选
A2UI v1.0 DynamicBoolean
children可选
A2UI v1.0 ChildList
action可选
A2UI v1.0 Action

PantokenInPlaceEdit

可内联编辑的值,并支持 A2UI 状态更新。

value必填
A2UI v1.0 DynamicString
readOnly可选
A2UI v1.0 DynamicBoolean
inputType可选
text, number, email, url, tel, search
action可选
A2UI v1.0 Action

PantokenDrilldown

基于安全页面和项目数据构建的嵌套菜单。

active可选
A2UI v1.0 DynamicString
pages必填
array
action可选
A2UI v1.0 Action

PantokenPages

具备历史记录感知能力的一组 A2UI 子面板。

active可选
A2UI v1.0 DynamicString
children必填
A2UI v1.0 ChildList
action可选
A2UI v1.0 Action

PantokenDrawerLayout

响应式内容与托盘布局,打开状态由命令控制。

open可选
A2UI v1.0 DynamicBoolean
placement可选
start, end
shouldOverlayTray可选
A2UI v1.0 DynamicBoolean
trayLabel可选
A2UI v1.0 DynamicString
contentLabel可选
A2UI v1.0 DynamicString
trayChildren可选
A2UI v1.0 ChildList
children可选
A2UI v1.0 ChildList

PantokenDateInput

带日历弹出层并支持 ISO 值更新的日期字段。

value可选
A2UI v1.0 DynamicString
label可选
A2UI v1.0 DynamicString
placeholder可选
A2UI v1.0 DynamicString
action可选
A2UI v1.0 Action

PantokenDateTimeInput

组合式日期和时间字段,支持 ISO 值更新。

value可选
A2UI v1.0 DynamicString
action可选
A2UI v1.0 Action

PantokenTabs

无障碍标签页组,将 A2UI 子面板与标签配对。

label必填
A2UI v1.0 DynamicString
tabLabels必填
array
activeIndex可选
A2UI v1.0 DynamicNumber
children必填
A2UI v1.0 ChildList
action可选
A2UI v1.0 Action

PantokenCard

Pantoken 卡片组件,包含安全文本和子内容。

label可选
A2UI v1.0 DynamicString
children可选
A2UI v1.0 ChildList

PantokenByline

Pantoken 署名组件,包含安全文本和子内容。

label可选
A2UI v1.0 DynamicString
children可选
A2UI v1.0 ChildList

PantokenTable

数据表格,包含标题、列标题和纯文本单元格。

caption必填
A2UI v1.0 DynamicString
headers必填
array
rows必填
array

PantokenLink

可导航的文本链接,URL 协议限制在允许范围内。

label必填
A2UI v1.0 DynamicString
href可选
string
target可选
_self, _blank, _parent, _top
children可选
A2UI v1.0 ChildList
action可选
A2UI v1.0 Action

PantokenList

Pantoken 列表组件,包含安全文本和子内容。

label可选
A2UI v1.0 DynamicString
children可选
A2UI v1.0 ChildList

PantokenCheckbox

带可见标签并支持选中状态更新的原生复选框。

label必填
A2UI v1.0 DynamicString
checked可选
A2UI v1.0 DynamicBoolean
disabled可选
A2UI v1.0 DynamicBoolean
name可选
A2UI v1.0 DynamicString
value可选
A2UI v1.0 DynamicString
action可选
A2UI v1.0 Action

PantokenRadio

带可见标签并支持选中值更新的原生单选控件。

label必填
A2UI v1.0 DynamicString
checked可选
A2UI v1.0 DynamicBoolean
disabled可选
A2UI v1.0 DynamicBoolean
name可选
A2UI v1.0 DynamicString
value必填
A2UI v1.0 DynamicString
action可选
A2UI v1.0 Action

PantokenMenu

Pantoken 菜单组件,包含安全文本和子内容。

label可选
A2UI v1.0 DynamicString
children可选
A2UI v1.0 ChildList

PantokenBreadcrumb

带标签的导航地标,包含面包屑项目。

label必填
A2UI v1.0 DynamicString
children可选
A2UI v1.0 ChildList

PantokenBillboard

Pantoken 广告牌组件,包含安全文本和子内容。

label可选
A2UI v1.0 DynamicString
children可选
A2UI v1.0 ChildList

PantokenToggleGroup

采用令牌样式的折叠组,包含摘要和可展开的子内容。

summary必填
A2UI v1.0 DynamicString
open可选
A2UI v1.0 DynamicBoolean
children可选
A2UI v1.0 ChildList
action可选
A2UI v1.0 Action

PantokenPagination

用于分页控件的带标签导航地标。

label必填
A2UI v1.0 DynamicString
children可选
A2UI v1.0 ChildList

PantokenToggleDetails

原生折叠面板,包含摘要和可展开的子内容。

summary必填
A2UI v1.0 DynamicString
open可选
A2UI v1.0 DynamicBoolean
children可选
A2UI v1.0 ChildList
action可选
A2UI v1.0 Action

PantokenFileDrop

Pantoken 文件拖放组件,包含安全文本和子内容。

label可选
A2UI v1.0 DynamicString
children可选
A2UI v1.0 ChildList

PantokenRangeInput

数值范围受限的原生范围滑块。

label必填
A2UI v1.0 DynamicString
value可选
A2UI v1.0 DynamicNumber
min可选
A2UI v1.0 DynamicNumber
max可选
A2UI v1.0 DynamicNumber
step可选
A2UI v1.0 DynamicNumber
disabled可选
A2UI v1.0 DynamicBoolean
action可选
A2UI v1.0 Action

PantokenMask

一个 Pantoken 遮罩组件,包含安全文本和子内容。

label可选
A2UI v1.0 DynamicString
children可选
A2UI v1.0 ChildList

PantokenScreenReaderContent

一个 Pantoken 屏幕阅读器内容组件,包含安全文本和子内容。

label可选
A2UI v1.0 DynamicString
children可选
A2UI v1.0 ChildList

PantokenHeading

一个 Pantoken 标题组件,包含安全文本和子内容。

label可选
A2UI v1.0 DynamicString
children可选
A2UI v1.0 ChildList

PantokenText

一个 Pantoken 文本组件,包含安全文本和子内容。

label可选
A2UI v1.0 DynamicString
children可选
A2UI v1.0 ChildList

PantokenCloseButton

一个无障碍关闭控件,可分发 A2UI 点击操作。

label必填
A2UI v1.0 DynamicString
action可选
A2UI v1.0 Action

PantokenFormField

一个 Pantoken 表单字段组件,包含安全文本和子内容。

label可选
A2UI v1.0 DynamicString
children可选
A2UI v1.0 ChildList

PantokenFormFieldGroup

一个带标签的字段集,用于分组相关表单控件。

label必填
A2UI v1.0 DynamicString
children可选
A2UI v1.0 ChildList

PantokenRadioInputGroup

一个带标签的字段集,用于分组相关单选控件。

label必填
A2UI v1.0 DynamicString
children可选
A2UI v1.0 ChildList

PantokenFormFieldMessages

一个 Pantoken 表单字段消息组件,包含安全文本和子内容。

label可选
A2UI v1.0 DynamicString
children可选
A2UI v1.0 ChildList

PantokenTextInput

一个原生文本输入框,带有可见标签并支持值更新。

label必填
A2UI v1.0 DynamicString
value可选
A2UI v1.0 DynamicString
type可选
text, email, url, tel, search, date, time
placeholder可选
A2UI v1.0 DynamicString
name可选
A2UI v1.0 DynamicString
required可选
A2UI v1.0 DynamicBoolean
disabled可选
A2UI v1.0 DynamicBoolean
readOnly可选
A2UI v1.0 DynamicBoolean

PantokenTextArea

一个原生多行文本字段,带有可见标签并支持值更新。

label必填
A2UI v1.0 DynamicString
value可选
A2UI v1.0 DynamicString
placeholder可选
A2UI v1.0 DynamicString
name可选
A2UI v1.0 DynamicString
required可选
A2UI v1.0 DynamicBoolean
disabled可选
A2UI v1.0 DynamicBoolean
readOnly可选
A2UI v1.0 DynamicBoolean

PantokenSimpleSelect

一个带标签的选择控件,选项有界且仅包含文本。

label必填
A2UI v1.0 DynamicString
value可选
A2UI v1.0 DynamicString
name可选
A2UI v1.0 DynamicString
required可选
A2UI v1.0 DynamicBoolean
disabled可选
A2UI v1.0 DynamicBoolean
options必填
array

PantokenInputGroup

一个 Pantoken 输入组组件,包含安全文本和子内容。

label可选
A2UI v1.0 DynamicString
children可选
A2UI v1.0 ChildList

PantokenNumberInput

一个原生数字输入框,数值有界并带有可见标签。

label必填
A2UI v1.0 DynamicString
value可选
A2UI v1.0 DynamicNumber
min可选
A2UI v1.0 DynamicNumber
max可选
A2UI v1.0 DynamicNumber
step可选
A2UI v1.0 DynamicNumber
name可选
A2UI v1.0 DynamicString
required可选
A2UI v1.0 DynamicBoolean
disabled可选
A2UI v1.0 DynamicBoolean

PantokenView

一个 Pantoken 视图组件,包含安全文本和子内容。

label可选
A2UI v1.0 DynamicString
children可选
A2UI v1.0 ChildList

目录版本管理

v1 目录 ID 保持稳定。添加可选组件、属性或枚举值属于增量变更;移除或重命名现有组件或属性、缩小枚举范围,或将可选属性改为必填,均属于破坏性变更,需要发布新的目录版本。只有上面列出的组件和属性属于 Pantoken 的 A2UI 目录。

此目录未定义可执行函数,也不授权任何操作。A2UI 操作通过宿主应用的常规操作处理机制分发,应用必须自行强制执行权限控制。