דילוג לתוכן
uiify

Slider

מחוון לבחירת ערך יחיד או טווח בין שני גבולות.

דפדפנים
Chrome 123+Firefox 121+Safari 17.5+
שכבה
0
גודל חבילה דחוסה
501 B
מגבלת פריסה כפויה
0 ms
מגבלת Axe
0
תואם SSR
כן
חוזה מפורסם
סביבת בדיקות

מגרש ניסויים

Slider

מחוון ברירת מחדל

מחוון מבוקר

מחוון עם סימונים

מחוון טווח

מחוון אנכי

מחוון מושבת

60%

API

Slider

מאפייןטיפוסברירת מחדלתיאור
valuenumber—הערך הנוכחי, ההופך את המחוון למבוקר.
defaultValuenumber—הערך ההתחלתי של המחוון הלא מבוקר, שלאחר מכן מנוהל על ידי קלט הטווח המובנה.
onValueChange(value: number) => void—נקראת עם המספר החדש בכל תזוזה של המחוון.
minnumber0הערך הנמוך ביותר שניתן לבחור.
maxnumber100הערך הגבוה ביותר שניתן לבחור.
stepnumber1ההפרש בין ערכים שניתן לבחור.
disabledbooleanfalseמשבית את הקלט המובנה ומגדיר את המאפיין data-disabled.
renderReactElement | ((props, state) => ReactElement)—החלפת האלמנט המוצג תוך שימור ההתנהגות וקישורי הנגישות.

SliderClient

מאפייןטיפוסברירת מחדלתיאור
valuenumber | readonly [number, number]—ערך מבוקר; זוג ערכים מציג ידית תחתונה ועליונה.
defaultValuenumber | readonly [number, number]—ערך התחלתי לקלט הטווח המובנה או לטווח בעל שתי ידיות.
onValueChange(value: number | readonly [number, number]) => void—נקראת כשהערך הנבחר או הטווח המסודר משתנים.
minnumber0הערך הנמוך ביותר שניתן לבחור.
maxnumber100הערך הגבוה ביותר שניתן לבחור.
stepnumber | null1צעד מספרי משמר את הדילוג המובנה לפני ההידרציה; null מגביל את הערכים ל-min, max וסימונים לאחר ההידרציה.
marksreadonly { value: number; label?: ReactNode }[]—תוויות שנתות ונקודות הצמדה כאשר step הוא null.
orientation"horizontal" | "vertical""horizontal"כיוון הפריסה של הפקד והסימונים שלו.
thumbLabelsreadonly [string, string]—שמות נגישים לידיות הטווח התחתונה והעליונה.
slotPropsSliderClientSlotProps—מאפיינים מובנים למסילה, לטווח, לסימונים, לידיות החזותיות ולקלטים המובנים שנוצרים. הסימונים מזוהים לפי ערכיהם וניתן למקד אותם גם לפי אינדקס התצוגה; מאפייני הידיות משתמשים במפתחות value, minimum ו-maximum.
disabledbooleanfalseמשבית את כל קלטי הטווח המובנים.
renderReactElement | ((props, state) => ReactElement)—החלפת האלמנט המוצג תוך שימור ההתנהגות וקישורי הנגישות.

מקלדת

מקשפעולה
Arrow keysשינוי שדה הטווח המובנה והממוקד בצעד אחד או עד לעצירה
Home / Endהעברת הידית הממוקדת למינימום או למקסימום
Tabמעבר בין הידית התחתונה לעליונה של הטווח

נגישות

Slider מרנדר שדה טווח מובנה שפועל לפני הידרציה וכש-JavaScript מושבת. גם SliderClient מרנדר שדות טווח מובנים בשרת, ואז שולט בהם לאחר הידרציה עבור ערכי טווח, סימונים עם תוויות והצמדה לא אחידה. step מספרי שומר על צעדים מובנים לפני הידרציה; הצמדה לסימונים באמצעות step={null} מתחילה לאחר הידרציה. תנו למחוון יחיד aria-label או aria-labelledby; לשתי ידיות הטווח תנו thumbLabels.

נקודות חיבור לעיצוב

data-uiify-sliderdata-uiify-slider-clientdata-part="root"data-part="track"data-part="range"data-part="mark"data-part="thumb"data-orientationdata-disableddata-enhanced--uiify-slider-start--uiify-slider-end--uiify-slider-position
דף זה תורגם אוטומטית וטרם נבדק.