Skip to content

كتالوج Pantoken A2UI

البروتوكول 1.0عرض JSON الكتالوج

استكشف مفردات مكوّنات Pantoken الخاصة بـ A2UI 1.0. يعرّف هذا الكتالوج مكوّنات Pantoken فقط؛ أما مكوّنات التخطيط القياسية فتبقى في كتالوج A2UI الأساسي.

دعم العملاء

  • تم التحقق منه باستخدام حزمة SDK المنشورة لـ A2UI 1.0 Lit.
  • تم التحقق باستخدام @a2ui/react 0.15.0 وReact 19.3.1 في Chromium وFirefox وWebKit.
  • تم التحقق باستخدام @a2ui/angular 0.14.0 وAngular 21.2.5 في Chromium وFirefox وWebKit.
  • 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 إلى جانب مكوّنات الكتالوج الأساسي.

{
  "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 ثابت. إضافة مكوّن أو خاصية أو قيمة تعداد اختيارية تعد تغييرًا إضافيًا؛ أما إزالة مكوّن أو خاصية قائمة أو إعادة تسميتهما، أو تضييق نطاق تعداد، أو جعل خاصية اختيارية مطلوبة، فتعد تغييرات كاسرة وتتطلب إصدارًا جديدًا للكتالوج. لا تشكّل جزءًا من كتالوج Pantoken لـ A2UI إلا المكوّنات والخصائص المدرجة أعلاه.

لا يعرّف الكتالوج أي دوال قابلة للتنفيذ ولا يمنح الإذن بتنفيذ الإجراءات. تُرسل إجراءات A2UI عبر معالجة الإجراءات المعتادة في التطبيق المضيف، حيث يجب على التطبيق فرض أذوناته الخاصة.