Popup
משטח קופץ המעוגן למפעיל שלו.
- דפדפנים
- Chrome 114+Firefox 125+Safari 17+
- שכבה
- 0
- גודל חבילה דחוסה
- 883 B
- מגבלת פריסה כפויה
- 0 ms
- מגבלת Axe
- 0
- תואם SSR
- כן
- מבוסס על
- elements/popover
- חוזה מפורסם
- סביבת בדיקות
מגרש ניסויים
API
PopupTrigger
| מאפיין | טיפוס | ברירת מחדל | תיאור |
|---|---|---|---|
target* | string | — | מזהה ה-PopupContent שכפתור זה מחליף את מצב פתיחתו; הדפדפן מטפל בהחלפת המצב, בסגירה בלחיצה מחוץ לחלונית וב-Escape ללא הידרציה. |
children | ReactNode | — | תוכן כפתור הפתיחה. |
as | TAs & NativeButtonAs<TAs> | "button" | רכיב המעביר מאפיינים ו-ref לכפתור מובנה; תגיות אחרות נדחות, כי פקודות הפעלה דורשות כפתור אמיתי. |
PopupContent
| מאפיין | טיפוס | ברירת מחדל | תיאור |
|---|---|---|---|
id* | string | — | מזהה ייחודי שמספק המשתמש בספרייה; חלקי הפתיחה והסגירה מפנים אליו. |
side | "top" | "right" | "bottom" | "left" | "bottom" | הצד של כפתור הפתיחה שאליו המשטח מעוגן. |
align | "start" | "center" | "end" | "center" | יישור המשטח לאורך הצד שנבחר. |
mode | "auto" | "manual" | "auto" | התנהגות החלונית הקופצת: "auto" נסגרת בלחיצה מחוץ לה וב-Escape, ו-"manual" נשארת פתוחה עד שכפתור סגירה מסתיר אותה. |
children | ReactNode | — | תוכן המשטח של החלונית הקופצת. |
PopupClose
| מאפיין | טיפוס | ברירת מחדל | תיאור |
|---|---|---|---|
target* | string | — | מזהה ה-PopupContent שכפתור זה מסתיר. |
children | ReactNode | — | תוכן כפתור הסגירה. |
as | TAs & NativeButtonAs<TAs> | "button" | רכיב המעביר מאפיינים ו-ref לכפתור מובנה; תגיות אחרות נדחות, כי פקודות הפעלה דורשות כפתור אמיתי. |
Popup.Root (legacy compound)
| מאפיין | טיפוס | ברירת מחדל | תיאור |
|---|---|---|---|
id* | string | — | מזהה יציב למשטח החלונית הקופצת ולפקודות ההפעלה, המוזרק לילדים הישירים Trigger, Content ו-Close. |
mode | "auto" | "manual" | "hint" | "auto" | התנהגות החלונית הקופצת המועברת למשטח Content. |
className | string | — | המחלקה המוחלת על האלמנט העוטף. |
children | ReactNode | — | החלקים Trigger, Content ו-Close. |
Popup.Trigger (legacy compound)
| מאפיין | טיפוס | ברירת מחדל | תיאור |
|---|---|---|---|
className | string | — | המחלקה המוחלת על כפתור הפתיחה. |
children | ReactNode | — | תוכן כפתור הפתיחה. |
Popup.Content (legacy compound)
| מאפיין | טיפוס | ברירת מחדל | תיאור |
|---|---|---|---|
side | "top" | "right" | "bottom" | "left" | "bottom" | הצד של כפתור הפתיחה שאליו המשטח מעוגן. |
align | "start" | "center" | "end" | "center" | יישור המשטח לאורך הצד שנבחר. |
className | string | — | המחלקה המוחלת על משטח החלונית הקופצת. |
children | ReactNode | — | תוכן המשטח של החלונית הקופצת. |
Popup.Close (legacy compound)
| מאפיין | טיפוס | ברירת מחדל | תיאור |
|---|---|---|---|
className | string | — | המחלקה המוחלת על כפתור הסגירה. |
children | ReactNode | — | תוכן כפתור הסגירה. |
מקלדת
| מקש | פעולה |
|---|---|
| Escape | סגירה |
| Tab | מעבר אל תוכן החלונית הקופצת כשהיא פתוחה |
נגישות
Popover API המובנה: מפעיל popovertarget פותח וסוגר את המשטח לפני הרצת JavaScript כלשהו; הדפדפן אחראי לסגירה בלחיצה בחוץ, ל-Escape ולקינון, ומעגן את המשטח למפעיל שפתח אותו.
נקודות חיבור לעיצוב
data-sidedata-aligndata-positioningdata-uiify-popupdata-part="trigger|content|close"--uiify-trigger-open (inside [data-uiify-popup][data-part="root"])