انتقل إلى المحتوى
uiify

Popup

سطح نافذة منبثقة مثبت إلى زر التفعيل.

المتصفحات
Chrome 114+Firefox 125+Safari 17+
الفئة
0
الحجم المضغوط
883 B
ميزانية التخطيط القسري
0 ms
ميزانية axe
0
متوافق مع SSR
نعم
مبني على
elements/popover
العقد المنشور
بيئة الاختبار

المختبر

Popup

Preferences

Invite teammate

Manual dismissal

API

PopupTrigger

الخاصيةالنوعافتراضيالوصف
target*string—معرّف PopupContent الذي يبدّل هذا الزر ظهوره؛ يتولى المتصفح التبديل والإغلاق بالنقر خارج النافذة ومفتاح Escape دون إماهة.
childrenReactNode—محتوى زر التفعيل.
asTAs & NativeButtonAs<TAs>"button"مكوّن يمرّر الخصائص والمرجع إلى زر أصلي؛ تُرفض الوسوم الأخرى لأن أوامر invoker تحتاج إلى زر حقيقي.

PopupContent

الخاصيةالنوعافتراضيالوصف
id*string—معرّف فريد يوفّره المستهلك؛ يشير إليه زر التفعيل والإغلاق.
side"top" | "right" | "bottom" | "left""bottom"جانب زر التفعيل الذي يُرسى عليه السطح.
align"start" | "center" | "end""center"محاذاة السطح على امتداد الجانب المختار.
mode"auto" | "manual""auto"سلوك النافذة المنبثقة: تغلق "auto" بالنقر خارجها وبـ Escape، وتظل "manual" مفتوحة حتى يخفيها أمر إغلاق من عنصر invoker.
childrenReactNode—محتوى سطح النافذة المنبثقة.

PopupClose

الخاصيةالنوعافتراضيالوصف
target*string—معرّف PopupContent الذي يخفيه هذا الزر.
childrenReactNode—محتوى زر الإغلاق.
asTAs & NativeButtonAs<TAs>"button"مكوّن يمرّر الخصائص والمرجع إلى زر أصلي؛ تُرفض الوسوم الأخرى لأن أوامر invoker تحتاج إلى زر حقيقي.

Popup.Root (legacy compound)

الخاصيةالنوعافتراضيالوصف
id*string—معرّف ثابت لسطح النافذة المنبثقة وأوامر invoker، يُحقن في الأبناء المباشرين Trigger وContent وClose.
mode"auto" | "manual" | "hint""auto"سلوك النافذة المنبثقة الممرّر إلى سطح Content.
classNamestring—الفئة المطبّقة على العنصر الحاوي.
childrenReactNode—الأجزاء Trigger وContent وClose.

Popup.Trigger (legacy compound)

الخاصيةالنوعافتراضيالوصف
classNamestring—الفئة المطبّقة على زر التفعيل.
childrenReactNode—محتوى زر التفعيل.

Popup.Content (legacy compound)

الخاصيةالنوعافتراضيالوصف
side"top" | "right" | "bottom" | "left""bottom"جانب زر التفعيل الذي يُرسى عليه السطح.
align"start" | "center" | "end""center"محاذاة السطح على امتداد الجانب المختار.
classNamestring—الفئة المطبّقة على سطح النافذة المنبثقة.
childrenReactNode—محتوى سطح النافذة المنبثقة.

Popup.Close (legacy compound)

الخاصيةالنوعافتراضيالوصف
classNamestring—الفئة المطبّقة على زر الإغلاق.
childrenReactNode—محتوى زر الإغلاق.

لوحة المفاتيح

المفتاحالإجراء
Escapeإغلاق
Tabالانتقال إلى محتوى النافذة المنبثقة عند فتحها

إمكانية الوصول

Popover API الأصلية: يبدّل invoker ذو popovertarget ظهور السطح قبل تشغيل أي JavaScript؛ ويدير المتصفح الإغلاق بالنقر خارجه وEscape والتداخل، ويرسي السطح إلى عنصر invoker الذي فتحه.

نقاط التنسيق

data-sidedata-aligndata-positioningdata-uiify-popupdata-part="trigger|content|close"--uiify-trigger-open (inside [data-uiify-popup][data-part="root"])
تُرجمت هذه الصفحة آليًا ولم تُراجع بعد.