Skip to content

Danh mục A2UI của Pantoken

Giao thức 1.0Xem JSON danh mục

Khám phá bộ từ vựng thành phần Pantoken dành cho A2UI 1.0. Danh mục này chỉ định nghĩa các thành phần Pantoken; các thành phần bố cục tiêu chuẩn vẫn nằm trong Danh mục A2UI Basic.

Hỗ trợ phía máy khách

  • Đã xác minh với SDK Lit A2UI 1.0 được phát hành.
  • Đã xác minh với @a2ui/react 0.15.0 và React 19.3.1 trên Chromium, Firefox và WebKit.
  • Đã xác minh với @a2ui/angular 0.14.0 và Angular 21.2.5 trên Chromium, Firefox và WebKit.
  • Flutter, SwiftUI và Jetpack Compose: chỉ có lược đồ; không có bộ kết xuất thành phần Pantoken native.

Hành động

Danh mục này không định nghĩa hàm thực thi nào. Các hành động của nút sử dụng cơ chế xử lý hành động đã đăng ký của A2UI.

Đăng ký 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]);

Dùng @catalogId để tham chiếu các thành phần Pantoken cùng với các thành phần Basic Catalog.

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

Các thành phần (61)

PantokenIcon

Một hình tượng glyph nội tuyến được chọn từ bộ biểu tượng của Pantoken.

nameBắt buộc
a-arrow-down, a-arrow-up, a-large-small, accessibility, accessibility-2, activity, ad, ai-info, ai-spinner, air-vent, airplay, alarm-clock, ...
sizeKhông bắt buộc
1em, 1.25em, 1.5em, 2em

PantokenButton

Nút hành động được tạo kiểu bằng token, có tùy chọn sự kiện A2UI và hành vi Invoker Commands.

labelBắt buộc
A2UI v1.0 DynamicString
variantKhông bắt buộc
primary, secondary, tertiary, danger, success, ai, ai-secondary
commandTargetKhông bắt buộc
A2UI v1.0 ComponentId
commandKhông bắt buộc
--show, --close, --toggle, --push, --back, --goto
popoverTargetKhông bắt buộc
A2UI v1.0 ComponentId
popoverActionKhông bắt buộc
toggle, show, hide
childrenKhông bắt buộc
A2UI v1.0 ChildList
actionKhông bắt buộc
A2UI v1.0 Action

PantokenAlert

Thông báo trạng thái có tùy chọn tự đóng sau một khoảng thời gian.

variantKhông bắt buộc
info, success, warning, danger
timeoutKhông bắt buộc
A2UI v1.0 DynamicNumber
transitionKhông bắt buộc
fade, none
hasShadowKhông bắt buộc
A2UI v1.0 DynamicBoolean
messageKhông bắt buộc
A2UI v1.0 DynamicString
childrenKhông bắt buộc
A2UI v1.0 ChildList
actionKhông bắt buộc
A2UI v1.0 Action

PantokenBadge

Huy hiệu đếm hoặc trạng thái nhỏ gọn.

variantKhông bắt buộc
success, danger, inverse
labelKhông bắt buộc
A2UI v1.0 DynamicString
childrenKhông bắt buộc
A2UI v1.0 ChildList

PantokenPill

Thẻ trạng thái nhỏ gọn.

variantKhông bắt buộc
neutral, info, success, warning, danger, plum, aurora, sky, orange, violet, sea, stone
labelKhông bắt buộc
A2UI v1.0 DynamicString
childrenKhông bắt buộc
A2UI v1.0 ChildList

PantokenTag

Thẻ hoặc nhãn chip được tạo kiểu bằng token.

labelKhông bắt buộc
A2UI v1.0 DynamicString
childrenKhông bắt buộc
A2UI v1.0 ChildList

PantokenAvatar

Ảnh đại diện dạng chữ cái viết tắt với bảng màu, kích thước và hình dạng được giới hạn.

variantKhông bắt buộc
ai, blue, green, grey, orange, red
sizeKhông bắt buộc
2xs, xs, sm, md, lg, xl, 2xl
shapeKhông bắt buộc
rectangle
initialsKhông bắt buộc
A2UI v1.0 DynamicString
childrenKhông bắt buộc
A2UI v1.0 ChildList

PantokenSpinner

Chỉ báo trạng thái đang tải.

variantKhông bắt buộc
inverse, ai, ai-on-color

PantokenProgress

Chỉ báo tiến trình hoặc đồng hồ đo dạng ngang.

valueNowKhông bắt buộc
A2UI v1.0 DynamicNumber
minKhông bắt buộc
A2UI v1.0 DynamicNumber
valueMaxKhông bắt buộc
A2UI v1.0 DynamicNumber
variantKhông bắt buộc
brand, info, success, warning, danger, inverse, primary-inverse
labelKhông bắt buộc
A2UI v1.0 DynamicString
shouldAnimateKhông bắt buộc
A2UI v1.0 DynamicBoolean

PantokenMetric

Giá trị lớn đi kèm nhãn mô tả.

valueBắt buộc
A2UI v1.0 DynamicString
labelBắt buộc
A2UI v1.0 DynamicString

PantokenRating

Đánh giá bằng sao chỉ đọc với số sao được giới hạn.

valueKhông bắt buộc
A2UI v1.0 DynamicNumber
maxKhông bắt buộc
A2UI v1.0 DynamicNumber
labelKhông bắt buộc
A2UI v1.0 DynamicString

PantokenProgressCircle

Chỉ báo tiến trình hoặc đồng hồ đo dạng tròn.

valueNowKhông bắt buộc
A2UI v1.0 DynamicNumber
minKhông bắt buộc
A2UI v1.0 DynamicNumber
valueMaxKhông bắt buộc
A2UI v1.0 DynamicNumber
labelKhông bắt buộc
A2UI v1.0 DynamicString
shouldAnimateKhông bắt buộc
A2UI v1.0 DynamicBoolean
animationDelayKhông bắt buộc
A2UI v1.0 DynamicNumber

PantokenIconButton

Nút chỉ có biểu tượng với nhãn hỗ trợ truy cập.

labelBắt buộc
A2UI v1.0 DynamicString
iconNameBắt buộc
a-arrow-down, a-arrow-up, a-large-small, accessibility, accessibility-2, activity, ad, ai-info, ai-spinner, air-vent, airplay, alarm-clock, ...
actionKhông bắt buộc
A2UI v1.0 Action

PantokenToggleButton

Nút hai trạng thái có trạng thái được nhấn liên kết với dữ liệu A2UI.

pressedKhông bắt buộc
A2UI v1.0 DynamicBoolean
labelKhông bắt buộc
A2UI v1.0 DynamicString
childrenKhông bắt buộc
A2UI v1.0 ChildList
actionKhông bắt buộc
A2UI v1.0 Action

PantokenTruncate

Vùng văn bản được giới hạn hiển thị với số dòng nằm trong danh sách cho phép.

linesKhông bắt buộc
auto, 1, 2, 3, 4, 5, 6
textKhông bắt buộc
A2UI v1.0 DynamicString
childrenKhông bắt buộc
A2UI v1.0 ChildList

PantokenImg

Hình ảnh thích ứng với URL phương tiện đã được làm sạch và cách hiển thị được giới hạn.

srcBắt buộc
A2UI v1.0 MediaUrl
altBắt buộc
A2UI v1.0 DynamicString
constrainKhông bắt buộc
cover, contain
displayKhông bắt buộc
block

PantokenSideNavBar

Thanh điều hướng dọc có thể thu gọn thành dạng chỉ hiển thị biểu tượng.

minimizedKhông bắt buộc
A2UI v1.0 DynamicBoolean
childrenKhông bắt buộc
A2UI v1.0 ChildList

PantokenTreeBrowser

Cây có hỗ trợ truy cập, trong đó các thành phần con được hiển thị thành các mục cây có thể nhận tiêu điểm.

labelBắt buộc
A2UI v1.0 DynamicString
childrenBắt buộc
A2UI v1.0 ChildList
actionKhông bắt buộc
A2UI v1.0 Action

PantokenCalendar

Lịch tháng tương tác cập nhật ngày ISO được chọn.

valueKhông bắt buộc
A2UI v1.0 DynamicString
viewKhông bắt buộc
A2UI v1.0 DynamicString
actionKhông bắt buộc
A2UI v1.0 Action

PantokenTooltip

Chú giải công cụ không tương tác bao quanh một thành phần kích hoạt.

triggerLabelBắt buộc
A2UI v1.0 DynamicString
tipBắt buộc
A2UI v1.0 DynamicString
placementKhông bắt buộc
top, bottom, start, end
showDelayKhông bắt buộc
A2UI v1.0 DynamicNumber
hideDelayKhông bắt buộc
A2UI v1.0 DynamicNumber
childrenKhông bắt buộc
A2UI v1.0 ChildList
actionKhông bắt buộc
A2UI v1.0 Action

PantokenModal

Hộp thoại native với hành vi mở và đóng được điều khiển bằng lệnh.

openKhông bắt buộc
A2UI v1.0 DynamicBoolean
childrenKhông bắt buộc
A2UI v1.0 ChildList
actionKhông bắt buộc
A2UI v1.0 Action

PantokenContextView

Cửa sổ bật lên dạng chú thích với kiểu dáng Pantoken.

openKhông bắt buộc
A2UI v1.0 DynamicBoolean
childrenKhông bắt buộc
A2UI v1.0 ChildList
actionKhông bắt buộc
A2UI v1.0 Action

PantokenPopover

Bề mặt cửa sổ bật lên nổi.

openKhông bắt buộc
A2UI v1.0 DynamicBoolean
childrenKhông bắt buộc
A2UI v1.0 ChildList
actionKhông bắt buộc
A2UI v1.0 Action

PantokenTray

Bảng bật lên ở cạnh khung nhìn với vị trí và kích thước được giới hạn.

placementKhông bắt buộc
top, bottom, start, end
sizeKhông bắt buộc
xs, sm, md, lg, xl
openKhông bắt buộc
A2UI v1.0 DynamicBoolean
childrenKhông bắt buộc
A2UI v1.0 ChildList
actionKhông bắt buộc
A2UI v1.0 Action

PantokenInPlaceEdit

Giá trị có thể chỉnh sửa nội tuyến với các cập nhật trạng thái A2UI.

valueBắt buộc
A2UI v1.0 DynamicString
readOnlyKhông bắt buộc
A2UI v1.0 DynamicBoolean
inputTypeKhông bắt buộc
text, number, email, url, tel, search
actionKhông bắt buộc
A2UI v1.0 Action

PantokenDrilldown

Menu lồng nhau được tạo từ dữ liệu trang và mục an toàn.

activeKhông bắt buộc
A2UI v1.0 DynamicString
pagesBắt buộc
array
actionKhông bắt buộc
A2UI v1.0 Action

PantokenPages

Tập hợp các bảng con A2UI có nhận biết lịch sử.

activeKhông bắt buộc
A2UI v1.0 DynamicString
childrenBắt buộc
A2UI v1.0 ChildList
actionKhông bắt buộc
A2UI v1.0 Action

PantokenDrawerLayout

Bố cục nội dung và khay thích ứng với trạng thái mở được điều khiển bằng lệnh.

openKhông bắt buộc
A2UI v1.0 DynamicBoolean
placementKhông bắt buộc
start, end
shouldOverlayTrayKhông bắt buộc
A2UI v1.0 DynamicBoolean
trayLabelKhông bắt buộc
A2UI v1.0 DynamicString
contentLabelKhông bắt buộc
A2UI v1.0 DynamicString
trayChildrenKhông bắt buộc
A2UI v1.0 ChildList
childrenKhông bắt buộc
A2UI v1.0 ChildList

PantokenDateInput

Trường ngày có cửa sổ bật lên lịch và cập nhật giá trị ISO.

valueKhông bắt buộc
A2UI v1.0 DynamicString
labelKhông bắt buộc
A2UI v1.0 DynamicString
placeholderKhông bắt buộc
A2UI v1.0 DynamicString
actionKhông bắt buộc
A2UI v1.0 Action

PantokenDateTimeInput

Trường ngày và giờ kết hợp với cập nhật giá trị ISO.

valueKhông bắt buộc
A2UI v1.0 DynamicString
actionKhông bắt buộc
A2UI v1.0 Action

PantokenTabs

Tập hợp tab có hỗ trợ truy cập, ghép các bảng con A2UI với nhãn.

labelBắt buộc
A2UI v1.0 DynamicString
tabLabelsBắt buộc
array
activeIndexKhông bắt buộc
A2UI v1.0 DynamicNumber
childrenBắt buộc
A2UI v1.0 ChildList
actionKhông bắt buộc
A2UI v1.0 Action

PantokenCard

Thành phần thẻ Pantoken với văn bản an toàn và nội dung con.

labelKhông bắt buộc
A2UI v1.0 DynamicString
childrenKhông bắt buộc
A2UI v1.0 ChildList

PantokenByline

Thành phần dòng ghi công Pantoken với văn bản an toàn và nội dung con.

labelKhông bắt buộc
A2UI v1.0 DynamicString
childrenKhông bắt buộc
A2UI v1.0 ChildList

PantokenTable

Bảng dữ liệu có chú thích, tiêu đề cột và các ô chỉ chứa văn bản.

captionBắt buộc
A2UI v1.0 DynamicString
headersBắt buộc
array
rowsBắt buộc
array

PantokenLink

Liên kết văn bản có thể điều hướng với lược đồ URL nằm trong danh sách cho phép.

labelBắt buộc
A2UI v1.0 DynamicString
hrefKhông bắt buộc
string
targetKhông bắt buộc
_self, _blank, _parent, _top
childrenKhông bắt buộc
A2UI v1.0 ChildList
actionKhông bắt buộc
A2UI v1.0 Action

PantokenList

Thành phần danh sách Pantoken với văn bản an toàn và nội dung con.

labelKhông bắt buộc
A2UI v1.0 DynamicString
childrenKhông bắt buộc
A2UI v1.0 ChildList

PantokenCheckbox

Hộp kiểm native có nhãn hiển thị và cập nhật trạng thái chọn.

labelBắt buộc
A2UI v1.0 DynamicString
checkedKhông bắt buộc
A2UI v1.0 DynamicBoolean
disabledKhông bắt buộc
A2UI v1.0 DynamicBoolean
nameKhông bắt buộc
A2UI v1.0 DynamicString
valueKhông bắt buộc
A2UI v1.0 DynamicString
actionKhông bắt buộc
A2UI v1.0 Action

PantokenRadio

Điều khiển radio native có nhãn hiển thị và cập nhật giá trị được chọn.

labelBắt buộc
A2UI v1.0 DynamicString
checkedKhông bắt buộc
A2UI v1.0 DynamicBoolean
disabledKhông bắt buộc
A2UI v1.0 DynamicBoolean
nameKhông bắt buộc
A2UI v1.0 DynamicString
valueBắt buộc
A2UI v1.0 DynamicString
actionKhông bắt buộc
A2UI v1.0 Action

PantokenMenu

Thành phần menu Pantoken với văn bản an toàn và nội dung con.

labelKhông bắt buộc
A2UI v1.0 DynamicString
childrenKhông bắt buộc
A2UI v1.0 ChildList

PantokenBreadcrumb

Mốc điều hướng có nhãn với các mục đường dẫn.

labelBắt buộc
A2UI v1.0 DynamicString
childrenKhông bắt buộc
A2UI v1.0 ChildList

PantokenBillboard

Thành phần bảng thông tin Pantoken với văn bản an toàn và nội dung con.

labelKhông bắt buộc
A2UI v1.0 DynamicString
childrenKhông bắt buộc
A2UI v1.0 ChildList

PantokenToggleGroup

Nhóm tiết lộ được tạo kiểu bằng token, có phần tóm tắt và nội dung con có thể mở rộng.

summaryBắt buộc
A2UI v1.0 DynamicString
openKhông bắt buộc
A2UI v1.0 DynamicBoolean
childrenKhông bắt buộc
A2UI v1.0 ChildList
actionKhông bắt buộc
A2UI v1.0 Action

PantokenPagination

Mốc điều hướng có nhãn dành cho các điều khiển phân trang.

labelBắt buộc
A2UI v1.0 DynamicString
childrenKhông bắt buộc
A2UI v1.0 ChildList

PantokenToggleDetails

Phần tiết lộ native có phần tóm tắt và nội dung con có thể mở rộng.

summaryBắt buộc
A2UI v1.0 DynamicString
openKhông bắt buộc
A2UI v1.0 DynamicBoolean
childrenKhông bắt buộc
A2UI v1.0 ChildList
actionKhông bắt buộc
A2UI v1.0 Action

PantokenFileDrop

Thành phần thả tệp Pantoken với văn bản an toàn và nội dung con.

labelKhông bắt buộc
A2UI v1.0 DynamicString
childrenKhông bắt buộc
A2UI v1.0 ChildList

PantokenRangeInput

Thanh trượt phạm vi native với các giá trị số bị giới hạn.

labelBắt buộc
A2UI v1.0 DynamicString
valueKhông bắt buộc
A2UI v1.0 DynamicNumber
minKhông bắt buộc
A2UI v1.0 DynamicNumber
maxKhông bắt buộc
A2UI v1.0 DynamicNumber
stepKhông bắt buộc
A2UI v1.0 DynamicNumber
disabledKhông bắt buộc
A2UI v1.0 DynamicBoolean
actionKhông bắt buộc
A2UI v1.0 Action

PantokenMask

Một thành phần mặt nạ Pantoken với văn bản an toàn và nội dung con.

labelKhông bắt buộc
A2UI v1.0 DynamicString
childrenKhông bắt buộc
A2UI v1.0 ChildList

PantokenScreenReaderContent

Một thành phần nội dung dành cho trình đọc màn hình của Pantoken với văn bản an toàn và nội dung con.

labelKhông bắt buộc
A2UI v1.0 DynamicString
childrenKhông bắt buộc
A2UI v1.0 ChildList

PantokenHeading

Một thành phần tiêu đề Pantoken với văn bản an toàn và nội dung con.

labelKhông bắt buộc
A2UI v1.0 DynamicString
childrenKhông bắt buộc
A2UI v1.0 ChildList

PantokenText

Một thành phần văn bản Pantoken với văn bản an toàn và nội dung con.

labelKhông bắt buộc
A2UI v1.0 DynamicString
childrenKhông bắt buộc
A2UI v1.0 ChildList

PantokenCloseButton

Điều khiển đóng có thể truy cập, gửi một hành động nhấp A2UI.

labelBắt buộc
A2UI v1.0 DynamicString
actionKhông bắt buộc
A2UI v1.0 Action

PantokenFormField

Một thành phần trường biểu mẫu Pantoken với văn bản an toàn và nội dung con.

labelKhông bắt buộc
A2UI v1.0 DynamicString
childrenKhông bắt buộc
A2UI v1.0 ChildList

PantokenFormFieldGroup

Một fieldset có nhãn, nhóm các điều khiển biểu mẫu liên quan.

labelBắt buộc
A2UI v1.0 DynamicString
childrenKhông bắt buộc
A2UI v1.0 ChildList

PantokenRadioInputGroup

Một fieldset có nhãn, nhóm các điều khiển radio liên quan.

labelBắt buộc
A2UI v1.0 DynamicString
childrenKhông bắt buộc
A2UI v1.0 ChildList

PantokenFormFieldMessages

Một thành phần thông báo trường biểu mẫu Pantoken với văn bản an toàn và nội dung con.

labelKhông bắt buộc
A2UI v1.0 DynamicString
childrenKhông bắt buộc
A2UI v1.0 ChildList

PantokenTextInput

Một ô nhập văn bản gốc có nhãn hiển thị và cập nhật giá trị.

labelBắt buộc
A2UI v1.0 DynamicString
valueKhông bắt buộc
A2UI v1.0 DynamicString
typeKhông bắt buộc
text, email, url, tel, search, date, time
placeholderKhông bắt buộc
A2UI v1.0 DynamicString
nameKhông bắt buộc
A2UI v1.0 DynamicString
requiredKhông bắt buộc
A2UI v1.0 DynamicBoolean
disabledKhông bắt buộc
A2UI v1.0 DynamicBoolean
readOnlyKhông bắt buộc
A2UI v1.0 DynamicBoolean

PantokenTextArea

Một trường văn bản nhiều dòng gốc có nhãn hiển thị và cập nhật giá trị.

labelBắt buộc
A2UI v1.0 DynamicString
valueKhông bắt buộc
A2UI v1.0 DynamicString
placeholderKhông bắt buộc
A2UI v1.0 DynamicString
nameKhông bắt buộc
A2UI v1.0 DynamicString
requiredKhông bắt buộc
A2UI v1.0 DynamicBoolean
disabledKhông bắt buộc
A2UI v1.0 DynamicBoolean
readOnlyKhông bắt buộc
A2UI v1.0 DynamicBoolean

PantokenSimpleSelect

Một điều khiển chọn có nhãn với các tùy chọn chỉ chứa văn bản, được giới hạn.

labelBắt buộc
A2UI v1.0 DynamicString
valueKhông bắt buộc
A2UI v1.0 DynamicString
nameKhông bắt buộc
A2UI v1.0 DynamicString
requiredKhông bắt buộc
A2UI v1.0 DynamicBoolean
disabledKhông bắt buộc
A2UI v1.0 DynamicBoolean
optionsBắt buộc
array

PantokenInputGroup

Một thành phần nhóm ô nhập Pantoken với văn bản an toàn và nội dung con.

labelKhông bắt buộc
A2UI v1.0 DynamicString
childrenKhông bắt buộc
A2UI v1.0 ChildList

PantokenNumberInput

Một ô nhập số gốc với giá trị được giới hạn và nhãn hiển thị.

labelBắt buộc
A2UI v1.0 DynamicString
valueKhông bắt buộc
A2UI v1.0 DynamicNumber
minKhông bắt buộc
A2UI v1.0 DynamicNumber
maxKhông bắt buộc
A2UI v1.0 DynamicNumber
stepKhông bắt buộc
A2UI v1.0 DynamicNumber
nameKhông bắt buộc
A2UI v1.0 DynamicString
requiredKhông bắt buộc
A2UI v1.0 DynamicBoolean
disabledKhông bắt buộc
A2UI v1.0 DynamicBoolean

PantokenView

Một thành phần khung nhìn Pantoken với văn bản an toàn và nội dung con.

labelKhông bắt buộc
A2UI v1.0 DynamicString
childrenKhông bắt buộc
A2UI v1.0 ChildList

Quản lý phiên bản danh mục

ID danh mục v1 ổn định. Việc thêm thành phần, thuộc tính hoặc giá trị enum không bắt buộc là thay đổi bổ sung; xóa hoặc đổi tên thành phần hay thuộc tính hiện có, thu hẹp enum hoặc chuyển thuộc tính không bắt buộc thành bắt buộc là thay đổi phá vỡ tương thích và cần phiên bản danh mục mới. Chỉ các thành phần và thuộc tính được liệt kê ở trên mới thuộc danh mục A2UI của Pantoken.

Danh mục này không định nghĩa hàm thực thi nào và không cấp quyền cho hành động. Các hành động A2UI được gửi đi thông qua cơ chế xử lý hành động thông thường của ứng dụng máy chủ, nơi ứng dụng phải tự thực thi các quyền của mình.