Skip to content

Pantoken A2UI 型錄

通訊協定 1.0檢視型錄 JSON

探索 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,在 Basic Catalog 元件旁參照 Pantoken 元件。

{
  "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

採用 Token 樣式的動作按鈕,可選擇使用 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

採用 Token 樣式的標籤或標記。

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

採用 Token 樣式的揭露群組,包含摘要與可展開的子內容。

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 動作會透過主機應用程式的一般動作處理機制派發,應用程式必須在該處執行自己的權限控管。