הרכבת חומרים 3
androidx.compose.material3
(לעיון בכל חבילות ה-Compose, אפשר לעיין במסמכי ההפנייה של ה-API)
העדכון האחרון | גרסה יציבה | גרסה מועמדת להפצה | גרסת בטא | גרסת אלפא |
---|---|---|---|---|
2 ביולי 2025 | 1.3.2 | - | - | 1.4.0-alpha17 |
מבנה
Compose הוא שילוב של שבעה מזהי קבוצות Maven בתוך androidx
. כל קבוצה מכילה קבוצת משנה ממוקדת של פונקציונליות, ולכל אחת מהן יש קבוצה משלה של הערות על הגרסה.
בטבלה הזו מוסבר על הקבוצות ויש קישורים לכל קבוצה של הערות מוצר.
קיבוץ | תיאור |
---|---|
compose.animation | ליצור אנימציות באפליקציות Jetpack Compose כדי לשפר את חוויית המשתמש. |
compose.compiler | שינוי פונקציות @Composable והפעלת אופטימיזציות באמצעות פלאגין של מהדר Kotlin. |
compose.foundation | כתיבת אפליקציות ב-Jetpack Compose באמצעות אבני בניין מוכנות לשימוש והרחבת הבסיס כדי ליצור רכיבים משלכם למערכת העיצוב. |
compose.material | אפשר ליצור ממשקי משתמש של Jetpack פיתוח נייטיב באמצעות רכיבי Material Design מוכנים לשימוש. זוהי נקודת הכניסה ברמה הגבוהה ביותר של Compose, שנועדה לספק רכיבים שתואמים לאלה שמתוארים בכתובת www.material.io. |
compose.material3 | אפשר ליצור ממשקי משתמש ב-Jetpack Compose באמצעות רכיבי Material Design 3, הדור הבא של Material Design. Material 3 כולל רכיבים וערכות נושא מעודכנים ותכונות התאמה אישית של Material You, כמו צבעים דינמיים. הוא מעוצב כך שיהיה עקבי עם הסגנון החזותי החדש של Android 12 וממשק המשתמש של המערכת. |
compose.runtime | אבני הבניין הבסיסיות של מודל התכנות וניהול המצב של Compose, וזמן הריצה המרכזי של הפלאגין של מהדר Compose לטירגוט. |
compose.ui | רכיבים בסיסיים בממשק המשתמש של Compose שנדרשים כדי ליצור אינטראקציה עם המכשיר, כולל פריסה, ציור וקלט. |
הצהרה על יחסי תלות
כדי להוסיף תלות ב-Compose, צריך להוסיף את מאגר Google Maven לפרויקט. מידע נוסף זמין במאמר בנושא מאגר Maven של Google.
מוסיפים את יחסי התלות של הארטיפקטים שאתם צריכים בקובץ build.gradle
של האפליקציה או המודול:
Groovy
dependencies { implementation "androidx.compose.material3:material3:1.3.2" implementation "androidx.compose.material3:material3-window-size-class:1.3.2" implementation "androidx.compose.material3:material3-adaptive-navigation-suite:1.4.0-alpha17" } android { buildFeatures { compose true } composeOptions { kotlinCompilerExtensionVersion = "1.1.1" } kotlinOptions { jvmTarget = "1.8" } }
Kotlin
dependencies { implementation("androidx.compose.material3:material3:1.3.2") implementation("androidx.compose.material3:material3-window-size-class:1.3.2") implementation("androidx.compose.material3:material3-adaptive-navigation-suite:1.4.0-alpha17") } android { buildFeatures { compose = true } composeOptions { kotlinCompilerExtensionVersion = "1.1.1" } kotlinOptions { jvmTarget = "1.8" } }
מידע נוסף על יחסי תלות זמין במאמר הוספת יחסי תלות ב-Build.
משוב
המשוב שלכם עוזר לנו לשפר את Jetpack. נשמח לשמוע מכם אם תגלו בעיות חדשות או אם יש לכם רעיונות לשיפור הספרייה הזו. לפני שיוצרים ספרייה חדשה, כדאי לעיין בבעיות הקיימות בספרייה הזו. כדי להוסיף את ההצבעה שלכם לבעיה קיימת, לוחצים על לחצן הכוכב.
מידע נוסף זמין במאמרי העזרה בנושא כלי המעקב אחר בעיות.
Compose Material3 Common Version 1.0
גרסה 1.0.0-alpha01
17 באפריל 2024
הגרסאות androidx.compose.material3:material3-common:1.0.0-alpha01
, androidx.compose.material3:material3-common-android:1.0.0-alpha01
ו-androidx.compose.material3:material3-common-desktop:1.0.0-alpha01
יוצאות. גרסה 1.0.0-alpha01 מכילה את הקומטים האלה.
תכונות חדשות
רכיבים ללא עיצוב שאפשר להשתמש בהם כדי ליצור רכיבי Material Design:
- פלטה טונאלית
- סמל
- גודל משטח המגע
Compose Material3 Adaptive Navigation Suite Version 1.0
גרסה 1.0.0-alpha07
1 במאי 2024
הגרסאות androidx.compose.material3:material3-adaptive-navigation-suite:1.0.0-alpha07
, androidx.compose.material3:material3-adaptive-navigation-suite-android:1.0.0-alpha07
ו-androidx.compose.material3:material3-adaptive-navigation-suite-desktop:1.0.0-alpha07
יוצאות. גרסה 1.0.0-alpha07 מכילה את הקומטים האלה.
שינויים ב-API
- הפיכת ממשקי API של חבילת הניווט ללא ניסיוניים (If62af)
תיקוני באגים
- צריכת תמונות ממוזערות של תוכן כברירת מחדל (50266df)
גרסה 1.0.0-alpha06
17 באפריל 2024
הגרסאות androidx.compose.material3:material3-adaptive-navigation-suite:1.0.0-alpha06
, androidx.compose.material3:material3-adaptive-navigation-suite-android:1.0.0-alpha06
ו-androidx.compose.material3:material3-adaptive-navigation-suite-desktop:1.0.0-alpha06
יוצאות. גרסה 1.0.0-alpha06 מכילה את הקומטים האלה.
שינויים ב-API
- הוספה של
containerColor
ו-contentColor
אלNavigationSuiteScaffoldDefaults
. (I64e3a, b/331993720) - הוספת הפונקציה
itemColors
אלNavigationSuiteDefaults
. (Idf719, b/328480012) - הופכים את
NavigationSuiteScope
לאטום. (Iefa57)
גרסה 1.0.0-alpha05
6 במרץ 2024
הגרסאות androidx.compose.material3:material3-adaptive-navigation-suite:1.0.0-alpha05
, androidx.compose.material3:material3-adaptive-navigation-suite-android:1.0.0-alpha05
ו-androidx.compose.material3:material3-adaptive-navigation-suite-desktop:1.0.0-alpha05
יוצאות. גרסה 1.0.0-alpha05 מכילה את הקומטים האלה.
שינויים ב-API
- הופכים את ה-constructor
NavigationSuiteItemColors
לציבורי. (Ica83a, b/324886877)
גרסה 1.0.0-alpha04
21 בפברואר 2024
הגרסאות androidx.compose.material3:material3-adaptive-navigation-suite:1.0.0-alpha04
, androidx.compose.material3:material3-adaptive-navigation-suite-android:1.0.0-alpha04
ו-androidx.compose.material3:material3-adaptive-navigation-suite-desktop:1.0.0-alpha04
יוצאות. גרסה 1.0.0-alpha04 מכילה את הקומיטים האלה.
עדכונים של יחסי תלות
- מעדכנים את יחסי התלות של Material3 Adaptive לנתיבי המודולים החדשים. (Ibc421)
- מעבר לשימוש בגרסה של Window Manager של מחלקות גודל חלון. (I3794d)
גרסה 1.0.0-alpha03
7 בפברואר 2024
הגרסאות androidx.compose.material3:material3-adaptive-navigation-suite:1.0.0-alpha03
, androidx.compose.material3:material3-adaptive-navigation-suite-android:1.0.0-alpha03
ו-androidx.compose.material3:material3-adaptive-navigation-suite-desktop:1.0.0-alpha03
יוצאות. גרסה 1.0.0-alpha03 מכילה את הקומיטים האלה.
שינויים ב-API
- עדכון שם החבילה ל-navigationsuite מ-navigation-suite (I7eff7)
- רכיבי Material3 שחושפים
MutableInteractionSource
בממשק ה-API שלהם עודכנו כך שהם חושפים עכשיוMutableInteractionSource
שניתן להגדיר כ-null, ומוגדר כ-null כברירת מחדל. אין כאן שינויים סמנטיים: העברת הערך null פירושה שאתם לא רוצים להעלות אתMutableInteractionSource
, והוא ייווצר בתוך הרכיב אם יהיה צורך בכך. שינוי ל-null מאפשר לרכיבים מסוימים לא להקצותMutableInteractionSource
אף פעם, ולרכיבים אחרים ליצור מופע רק כשצריך, וכך לשפר את הביצועים של הרכיבים האלה. אם אתם לא משתמשים ב-MutableInteractionSource
שמועבר לרכיבים האלה, מומלץ להעביר במקומו null. מומלץ גם לבצע שינויים דומים ברכיבים שלכם. (I41abb, b/298048146)
גרסה 1.0.0-alpha02
13 בדצמבר 2023
הגרסאות androidx.compose.material3:material3-adaptive-navigation-suite:1.0.0-alpha02
, androidx.compose.material3:material3-adaptive-navigation-suite-android:1.0.0-alpha02
ו-androidx.compose.material3:material3-adaptive-navigation-suite-desktop:1.0.0-alpha02
יוצאות. גרסה 1.0.0-alpha02 מכילה את הקומיטים האלה.
תכונות חדשות
- הוספת
NavigationSuiteType
(If8cb1, b/313688598)
תיקוני באגים
- תוקן באג שגורם לרכיב הניווט למלא את המסך כולו כשהמשטח הבסיסי מכיל את
modifier.fillMaxSize
. (c9cf250, b/312664933)
גרסה 1.0.0-alpha01
15 בנובמבר 2023
androidx.compose.material3:material3-adaptive-navigation-suite:1.0.0-alpha01
משוחרר. גרסה 1.0.0-alpha01 מכילה את הקומיטים האלה.
תכונות חדשות
Compose Material3 Adaptive Version 1.0
גרסה 1.0.0-alpha06
7 בפברואר 2024
הגרסאות androidx.compose.material3:material3-adaptive:1.0.0-alpha06
, androidx.compose.material3:material3-adaptive-android:1.0.0-alpha06
ו-androidx.compose.material3:material3-adaptive-desktop:1.0.0-alpha06
יוצאות. גרסה 1.0.0-alpha06 מכילה את הקומיטים האלה.
תכונות חדשות
- נוספו אפשרויות התנהגות נוספות לניווט אחורה ב-
ThreePaneScaffoldNavigator
. (I858aa) - הוספנו תוכן אופציונלי של יעדים להיסטוריית הניווט. (Ibd7e6)
גרסה 1.0.0-alpha05
24 בינואר 2024
הגרסאות androidx.compose.material3:material3-adaptive:1.0.0-alpha05
, androidx.compose.material3:material3-adaptive-android:1.0.0-alpha05
ו-androidx.compose.material3:material3-adaptive-desktop:1.0.0-alpha05
יוצאות. גרסה 1.0.0-alpha05 מכילה את הקומיטים האלה.
תכונות חדשות
- תמיכה בהתחשבות בהיסטוריה בניווט ב-scaffold ובחישוב ערכים (I71d46)
גרסה 1.0.0-alpha04
10 בינואר 2024
הגרסאות androidx.compose.material3:material3-adaptive:1.0.0-alpha04
, androidx.compose.material3:material3-adaptive-android:1.0.0-alpha04
ו-androidx.compose.material3:material3-adaptive-desktop:1.0.0-alpha04
יוצאות. גרסה 1.0.0-alpha04 מכילה את הקומיטים האלה.
תכונות חדשות
- הוספנו תמיכה מקצה לקצה בפיגומים של חלוניות (I1b462)
שינויים ב-API
- העברנו את מאפייני הגבולות של הציר ב-Posture לרשימה של פרטי הציר (I24f90)
תיקוני באגים
- תיקון: לא ניתן להרכיב מחדש את
AnimatedPane
(c3f573d)
גרסה 1.0.0-alpha03
13 בדצמבר 2023
הגרסאות androidx.compose.material3:material3-adaptive:1.0.0-alpha03
, androidx.compose.material3:material3-adaptive-android:1.0.0-alpha03
ו-androidx.compose.material3:material3-adaptive-desktop:1.0.0-alpha03
יוצאות. גרסה 1.0.0-alpha03 מכילה את הקומיטים האלה.
שינויים ב-API
- שינוי תפקידי ה-scaffold לכינויים של
ThreePaneScaffoldRole
. (I65bd1) - יצירת מחלקת בסיס לתפקידי פיגום (I4784d)
- הסרת פרמטר מיותר מהתוכן של
AnimatedPane
(Ibc73b) - משנה את השם של
collectWindowSizeAsState
ומחזיר במקום זאת ערכים גולמיים (I480f4)
גרסה 1.0.0-alpha02
29 בנובמבר 2023
הגרסאות androidx.compose.material3:material3-adaptive:1.0.0-alpha02
, androidx.compose.material3:material3-adaptive-android:1.0.0-alpha02
ו-androidx.compose.material3:material3-adaptive-desktop:1.0.0-alpha02
יוצאות. גרסה 1.0.0-alpha02 מכילה את הקומיטים האלה.
שינויים ב-API
- פיצלנו את ממשקי ה-API של הניווט מממשקי ה-API של ה-scaffold האדפטיבי. (Ic4045)
- הסרת הכיתה
GutterSize
. (I785b3)
תיקוני באגים
- החלפת חלוניות לא מתבצעת כשלא משתמשים ב-
AnimatedPane
(d88f181)
גרסה 1.0.0-alpha01
15 בנובמבר 2023
androidx.compose.material3:material3-adaptive:1.0.0-alpha01
משוחרר. גרסה 1.0.0-alpha01 מכילה את הקומיטים האלה.
תכונות חדשות
ממשקי API של Material3 לתנאים משתנים:
ממשקי API של הנחיית פיגום של חלונית דינמית ב-Material3:
ממשקי API של Material3 adaptive pane scaffold:
- ממשקי API בסיסיים של מסגרת חלונית
Compose Material3 גרסה 1.4
גרסה 1.4.0-alpha17
2 ביולי 2025
androidx.compose.material3:material3-*:1.4.0-alpha17
משוחרר. גרסה 1.4.0-alpha17 מכילה את הקומטים האלה.
תכונות חדשות
- עדכון האנימציה של קבוצת הלחצנים כך שתופעל עד 75% מהאנימציה כשלוחצים על הלחצן במקום ללחוץ עליו. (593942a, b/423596967)
תיקוני באגים
- תוקנה בעיה שבה פריט בקרוסלה יכול היה, במקרים מסוימים, לחרוג מגודל הרכיב הגדול במהלך חישובי הפריסה, מה שגרם לחיתוך של הווידג'ט כולו. (I1c3d7, b/397489534)
- תוקן באג שגרם לדילוג על
beforeContentPadding
כשגללו קרוסלות עם היסטים חופפים של התחלה וסיום. (c3d5f3a, b/420618979) - עדכון ההתנהגות המופעלת של
SwipeToDismiss
כדי להתבסס על מצב ההסכמה במקום על המצב הנוכחי. ההתנהגות הקיימת משוחזרת, כך שההתנהגות של רכיב העוגן מושבתת רק כשהרכיב מגיע למצב של ביטול. (3844e07, b/425006844) - עכשיו אפשר לפתוח את התפריט הקופץ של
ExposedDropdownMenu
באמצעות קלט מהמקלדת. בנוסף, תיקנו את הבעיה שבה אי אפשר להגיע לתפריט באמצעות המקלדת בגרסה שניתנת לעריכה. (46ead03)
גרסה 1.4.0-alpha16
18 ביוני 2025
androidx.compose.material3:material3-*:1.4.0-alpha16
משוחרר. גרסה 1.4.0-alpha16 מכילה את הקומטים האלה.
תכונות חדשות
- נוסף רכיב קרוסלה של תמונות עם יישור למרכז (I6f6d3)
שינויים ב-API
- הטמעה של החלפות XR בסרגל הכלים האנכי (Ia1604)
- נוספו פונקציות גלילה פרוגרמטיות ל-
CarouselState
(I12f8e) - הוספת
ComponentOverride
ל-ModalWideNavigationRail
(I4f440) - הוספת
ComponentOverride
ל-WideNavigationRail
(I6354f) - יצירת
ComponentOverride
עבורHorizontalFloatingToolbar
(I51116) - יצירת
ComponentOverride
עבורShortNavigationBar
(I30e24) SwipeToDismissBoxState
הפניות אלconfirmValueChange
סומנו כהפניות שיצאו משימוש. במקום זאת, המשתמשים צריכים להשתמש בפונקציית הקריאה החוזרת שלSwipeToDismissBox
APIonDismissed
. (Iee780)- הוספנו את הפרמטר userScrollEnabled לרכיבי Carousel composable. (I1d4d2)
- עכשיו אפשר לצפות ב-
currentItem
של קרוסלה מ-CarouselState
. (Ie87e9)
תיקוני באגים
- תוקנה בעיה שבה צורה שרירותית בלחצן פעולה צף (FAB) שמועבר ל-
FloatingToolbar
לא החילה את הצל שלה בצורה נכונה. (Icdcc9, b/423336922) - כל הקרוסלות משתמשות עכשיו בתפקיד הסמנטי Carousel כברירת מחדל. (I7af12)
- תוקנה תנועה שגויה של האגודל כשמצב פס ההזזה עודכן באמצעות
LaunchedEffect
(Id9f31, b/302774166)
גרסה 1.4.0-alpha15
20 במאי 2025
androidx.compose.material3:material3-*:1.4.0-alpha15
משוחרר. גרסה 1.4.0-alpha15 מכילה את הקומטים האלה.
שינויים ב-API
- נוספה יצירה מקומית:
MotionTheme.LocalMotionScheme
. ההרשאה הזו מאפשרת גישה לתוכנית התנועה של העיצוב מ-CompositionLocalConsumerModifierNodes
, באמצעותcurrentValueOf(MotionTheme.LocalMotionScheme)
. (I014b1) - השימוש בבונה
ColorScheme
ללא תפקידי צבע קבועים הוצא משימוש. צריך לבצע מיגרציה לבונה שכולל תפקידים קבועים. (Iad0ee) - רכיב הטקסט M3 תומך עכשיו ב-
TextAutoSize
. (I7f524) - הוספנו API ליצירת וריאציות של גודל כפתור מפוצל, והוספנו דוגמאות. (Ice30b)
תיקוני באגים
- תוקנה בעיה שבה המיקום של
Snackbar
ושלFloatingActionButton
היה שגוי כשההגדרה 'מקצה לקצה' הופעלה. הכלי Scaffold מחיל עכשיו נכון את השוליים הפנימיים האופקיים על הרכיבים האלה. (Ib7c30, b/244400727) - מתקנים את התנועה של
BottomSheet
מהרחבה מלאה להרחבה חלקית. האפקט שלBottomSheet
עכשיו הואMotionScheme
כשמסתירים או מכווצים, ומרחבי כשמרחיבים. (Ifa46f, b/416063171) - הבונה
ColorScheme
ללא תפקידים של מאגר משטחים סומן כנסתר ולא מומלץ יותר לשימוש. (Ia7237) - הסרנו דרישה של
CircularWavyProgressIndicator
Size.minDimension > 0
, שבעבר גרמה לחריגה, כדי לאפשר גמישות רבה יותר. (Ic9418, b/377531195) - היפר-קישורים ב-
Text(AnnotatedString)
מקבלים עכשיו עיצוב Material כברירת מחדל. (I78288, b/339843816) - תוקנה בעיה שבה הפונקציה
toShape()
ב-RoundedPolygon
שומרת במטמון נתיב וגורמת לבעיה כשמתבצעות כמה קריאות ל-createOutline
בגדלים שונים. (I4026d)
גרסה 1.4.0-alpha14
7 במאי 2025
androidx.compose.material3:material3-*:1.4.0-alpha14
משוחרר. גרסה 1.4.0-alpha14 מכילה את הקומטים האלה.
שינויים ב-API
- נוסף
AppBarColumn
חדש שפועל באותו אופן כמוAppBarRow
אבל עבור תוכן שמוצג בעמודה. (Iaf6bd) - הוספנו את מספר הפריטים המקסימלי ל-
AppBarRow
. ההגדרה הזו נדרשת כדי להטמיע בצורה נכונה את מפרט החומרים עבור סרגלי אפליקציות עליונים. (I92ce4) - נוספה שיטה ב-
TooltipScope
כדי לקבל אתlayoutCoordinates
של העוגן. הוצאנו משימוש את השיטהdrawCaret
כי מפתחים יכולים להשתמש בשיטה החדשה הזו כדי לקבל את גבולות העוגןlayoutCoordinates
וליצור צורה מתאימה שמכילה סימן קרט. (Ia2e12, b/329470609) - נוספה תמיכה ב
java.time
בכלי לבחירת תאריכים: נוספו עומסים שלrememberDatePickerState/rememberDateRangePickerState
שמקבלים אובייקטים של java.time (לדוגמה,LocalDate
ראשוני,YearMonth
). נוספו גם פונקציות הרחבה באובייקטים של המצב כדי לקבל או להגדיר ערכים באמצעות סוגים כמוLocalDate
ו-YearMonth
. נדרש API מגרסה 26 ואילך או ביטול סוכר. (I70f29, b/266202516, b/281859606) - הוספנו את הקומפוזבל
CenteredTrack
שמאפשר להשתמש ב-Slider עם מסלול שמתחיל מהמרכז. (I5b1d6)
תיקוני באגים
- שיפרנו את הביצועים של אינדיקטורים מתקדמים של התקדמות: סוגים ליניאריים נטענים עכשיו ב-8.5% מהר יותר עם 11% פחות הקצאות, בעוד שסוגים מעגליים נהנים משיפור משמעותי של 47% במהירות ו-39% פחות הקצאות. (I595d8)
גרסה 1.4.0-alpha13
23 באפריל 2025
androidx.compose.material3:material3-*:1.4.0-alpha13
משוחרר. גרסה 1.4.0-alpha13 מכילה את הקומטים האלה.
שינויים ב-API
- הפרמטרים
isAppearanceLightStatusBars
ו-isAppearanceLightNavigationBars
נוספו מחדש ל-ModalBottomSheetProperties
כפרמטרים ל-Android בלבד. (Id4bc0) - מוסיפים רכיב
AppBarRow
שאחראי על טיפול בפריטים שחורגים מהגבולות שלו. (I742bd) - מעדכנים את ה-API של
DatePicker
ו-DateRangePicker
כדי לבקש מיקוד כשעוברים למצב של הזנת תאריך. החלפנו את הפרמטר הבוליאניrequestFocus
בפרמטר אופציונליfocusRequester
שמקבלFocusRequester
. (I14b69) - הסרת מקש הצירוף ומקור האינטראקציה מהפריטים שניתן ללחוץ עליהם ומהפריטים שניתן להפעיל ולכבות כברירת מחדל. במקום זאת, כדאי להשתמש בו כפרט הטמעה. (I95ed6)
- הכפתור
ButtonGroup
עודכן כך שיוצג בתפריט נפתח אם יש יותר מדי כפתורים שלא נכנסים למסך. (I7b88b)
תיקוני באגים
- ה-Bottomsheet צורך עכשיו את החלק העליון של המסך כשהוא קטן יותר מההיסט הנוכחי. כך המשתמשים יכולים לספק שוליים עליונים להתנהגות מורחבת. המינוי
BottomSheetDefaults.windowInsets
כולל עכשיו אתWindowInsets.safeDrawing.Top
. (I0ab67, b/321877275, b/336962418, b/342093067) - הופעלו אנימציות כניסה/יציאה (הנמכה/החלקה) לסמלים/אווטרים מובילים של צ'יפים ולסמלים נגררים כשהם מתווספים או מוסרים. ההגדרה הזו מועילה בעיקר לצ'יפים שאפשר לבחור (מסנן, קלט), אבל היא חלה באופן כללי. (I9af21)
- תיקון ההתנהגות השגויה של פס ההזזה מימין לשמאל שנגרמה על ידי
LookaheadScope
. (Ieb152, b/408118041) - תיקון הקריסה של Bottom
AppBar
שקשורה לגלילה עם ממשק משתמש מוסתר של המערכת. (Ic6140, b/405996228)
גרסה 1.4.0-alpha12
9 באפריל 2025
androidx.compose.material3:material3-*:1.4.0-alpha12
משוחרר. גרסה 1.4.0-alpha12 מכילה את הקומטים האלה.
שינויים ב-API
- הוסרו פרמטרים ספציפיים ל-Android מ-
ModalBottomSheetProperties
(Iab97f, b/362539765) - הוספת פונקציות של עומס יתר (overloading) לגודל ברירת המחדל של ידית הגרירה (I0ed0d)
- הוספנו פונקציות חדשות
NavigationSuiteScaffold
וNavigationSuiteScaffoldLayout
כדי לתמוך בסוגים חדשים של פריסות, והוספנו תמיכה בתוכן של פעולה ראשית אופציונלית. (Ib262a, b/353144478) - הוצאה משימוש של
Modifier.weight
עם פרמטר המילוי ב-ButtonGroup
. הוספת גרסה ללא מילוי. (Id32bb) - שינוי השם של
xSmall-
ושלxLarge-
רכיב IconButton ברירת המחדל היאextra
. (Ib6e0f) - הוספנו פונקציות חדשות של
NavigationSuite
,NavigationSuiteItem
ו-NavigationSuiteColors
כדי לתמוך בסוגים חדשים של פריסות. (I203d6) - הוספנו את הפונקציות החדשות
NavigationSuiteTypes
ו-navigationSuiteType
שכוללות את אפשרויות הפריסה האלה (If68f9)
תיקוני באגים
ColorScheme.contentColorFor
ממופה עכשיו מ-surfaceDim
אלonSurface
. (I8891a)- עדכנו את ההטמעה של
DateInputTextField
כדי לפתור בעיה שבה שדה הקלט לא שיקף תאריך שהוגדר באופן פרוגרמטי. (I6c8d1, b/401143451) - תוקן סדר ההתמקדות ב-TalkBack עבור פס הניווט ופס הניווט הרחב (I6cf6f, b/407048224)
גרסה 1.4.0-alpha11
26 במרץ 2025
androidx.compose.material3:material3-*:1.4.0-alpha11
משוחרר. גרסה 1.4.0-alpha11 מכילה את הקומטים האלה.
שינויים ב-API
- עדכון של אותיות רישיות במאפיינים שאפשר להרכיב באובייקטים שמוגדרים כברירת מחדל עבור לחצן ולחצן החלפת מצב. מוסיפים שיטות ב-
ToggleButtonDefaults
וב-ButtonDefaults
לריווח מומלץ של התוכן, לצורות, לגודל הסמל, לריווח הסמלים ולסגנון הטקסט בהתאם לגובה של מאגר התוכן. (Iea69e) - הוסרו פונקציות וקבועים ניסיוניים שהוצאו משימוש מה-
FloatingToolbar
. (I8f339) - לרכיבי הגובה יש עכשיו ממשק משותף, והם כוללים בנאים ומאפיינים ציבוריים. (Ibb172)
- נוסף משנה
animateWidth
ב-ButtonGroupScope
שצריך להשתמש בו עם רכיבי צאצא של קבוצת לחצנים כדי להנפיש אותם בצורה נכונה. (Ia3bb6)
תיקוני באגים
- תוקן הריווח בסרגל הכלים הצף כדי להבטיח איזון חזותי במהלך הכיווץ, ושופרה הגמישות עבור תוכן גדול יותר. (I06c00)
גרסה 1.4.0-alpha10
12 במרץ 2025
androidx.compose.material3:material3-*:1.4.0-alpha10
משוחרר. גרסה 1.4.0-alpha10 מכילה את הקומטים האלה.
שינויים ב-API
- הוצאנו משימוש את
TabRowDefaults.tabIndicatorOffset
לטובתTabIndicatorScope.tabIndicatorOffset
. (Ib36b3) - תיקון שגיאת כתיב בריווח הפנימי הקטן של תוכן בלחצני ברירת המחדל. (I19bfe)
- המאפיינים
TabRow
ו-ScrollableTabRow
הוצאו משימוש, ועכשיו יש מאפיינים ראשיים ומשניים לכל אחד מהם. השורות בכרטיסיות 'ראשי' ו'משני' מניבות ביצועים טובים יותר ומדויקות יותר בהתאם למפרט. (I918e2) - הוספת את
rememberSliderState
ואתrememberRangeSliderState
. (I8e384) - נוספה האפשרות
shouldAutoSnap
ל-SliderState
כדי לשלוט במנגנון ההצמדה האוטומטית. השבתת המנגנון עשויה להיות שימושית לאנימציות בהתאמה אישית. (I07745) - הרוחב המינימלי של כרטיסייה בשורת כרטיסיות שאפשר לגלול בה הוא עכשיו פרמטר. הווריאציות של שורות הכרטיסיות הראשיות והמשניות כבר לא ניסיוניות. (If6f15, b/226665301)
- הגדרנו את הכיתה
ExitAlwaysFloatingToolbarScrollBehavior
כציבורית, כדי לאפשר יצירה ללא קומפוזיציה. (Ibf31c)
גרסה 1.4.0-alpha09
26 בפברואר 2025
androidx.compose.material3:material3-*:1.4.0-alpha09
משוחרר. גרסה 1.4.0-alpha09 מכילה את הקומטים האלה.
שינויים ב-API
- שינוי השם של שדות ההגדרה של
DragHandle
במצב ברירת המחדל, הפרדה בין מצב לחיצה למצב גרירה, הגדרה של הגדלים שמוגדרים כברירת מחדל כגלויים לכולם. (I787b9) - עדכונים ב-API של
TowRowsTopAppBar
. הוסר פרמטר ה-lambdaexpanded
והוספו פרמטרים נפרדים לגובה המורחב והמכווץ. (Idd677, b/306697446, b/229134133, b/268068946)
תיקוני באגים
- סרגלי האפליקציות התחתונים פועלים עכשיו בהתאם לשירות 'גילוי באמצעות מגע' (למשל,
TalkBack
) ולהשאיר אותם גלויים בכל פעם שהשירות מופעל. (I4b34d)
גרסה 1.4.0-alpha08
12 בפברואר 2025
androidx.compose.material3:material3-*:1.4.0-alpha08
משוחרר. גרסה 1.4.0-alpha08 מכילה את הקומטים האלה.
תכונות חדשות
הוספנו API של
TimePickerDialog
שאפשר להשתמש בו בשבילTimePicker
,TimeInput
או כדי להחליף בין גרסאות. (Id2d83)ממשקי API חדשים של סרגל החיפוש:
- עכשיו, סרגלי חיפוש מכווצים ו'תצוגות' חיפוש מורחבות הם רכיבים נפרדים שניתנים להרכבה.
-
SearchBar
מייצג את סרגל החיפוש במצב המכווץ. -
ExpandedFullScreenSearchBar
ו-ExpandedDockedSearchBar
מייצגים את סרגל החיפוש במצב מורחב. הקישורים האלה נפתחים בחלון חדש. -
SearchBarState
כדי לשלוט במצב של סרגל החיפוש -
TopSearchBar
כדי להוסיף טיפול בתוספות והתנהגות גלילה - עומס יתר חדש של
InputField
שמשתמש ב-SearchBarState
(Ie0723, b/261496232, b/283311462, b/350916229, b/352872248)
שינויים ב-API
- תמיכה בשינוי צורה של פינות לחצני סמלים בלחיצה. (I21843)
- ממשקי ה-API של שדה טקסט לקישוט או תיבת קישוט כבר לא ניסיוניים. (I31d95)
- הוספנו דוגמאות וערכי ברירת מחדל לגרסה המחוברת של
ButtonGroup
. (I5c8ce) - הופכים את פרמטר המצב לאחרון ב-
NavigationSuiteScaffold
וב-NavigationSuiteScaffoldLayout
. (I9cc7b)
תיקוני באגים
- הוספנו ל-
FloatingToolbars
פעולות נגישות מותאמות אישית, כך ששירותי נגישות יכולים עכשיו להרחיב או לכווץ את כל הווריאציות שלFloatingToolbar
. בגרסה עם לחצן ה-FAB, ההגדרה הזו חלה על לחצן ה-FAB, ובגרסה בלי לחצן ה-FAB, ההגדרה הזו חלה על התוכן הראשי. (I26420) FloatingToolbars
עכשיו מתבוננים בשירות של חקר המגע (לדוגמה, TalkBack) וסרגל הכלים יורחב ויוצג בכל פעם שהשירות יופעל. (I02172)- תוקנה קריסה באינדיקטורים של ההתקדמות והטעינה במקרה של העברת
Float.NaN
כהתקדמות. (I4fa96, b/352364576)
גרסה 1.4.0-alpha07
29 בינואר 2025
androidx.compose.material3:material3-*:1.4.0-alpha07
משוחרר. גרסה 1.4.0-alpha07 מכילה את הקומטים האלה.
תכונות חדשות
- הוספנו גמישות רבה יותר בהתאמה אישית של המראה של תיבות הסימון באמצעות API חדש. API שמספק פרמטרים של קו, שמאפשרים שליטה רבה יותר באופן שבו מוצגים סימן הווי והתיבה עם הקו. (I65a88)
- הוספנו את
TwoRowsTopAppBar
API, חלופה עם יותר אפשרויות להתאמה אישית לסרגלי אפליקציות בגודל בינוני וגדול, ליצירת סרגלי אפליקציות עליונים עם שתי שורות. למפתחים יש עכשיו שליטה בתוכן של הכותרות והכתוביות במצבים המכווץ והמורחב, עם אפשרות להתאמה אישית של הגובה בכל מצב. (I0be3c, b/306697446, b/229134133, b/268068946)
שינויים ב-API
- שינינו את השם של וריאציה ניסיונית
BottomAppBar
ל-FlexibleBottomAppBar
, כדי לספק יותר שליטה על סידור התוכן והגובה שלו. (Iaa448) - עדכון השמות של מאפיינים באובייקט ברירת המחדל של קבוצת לחצנים ל-
CapitalCase
. השם שלanimateFraction
עודכן כדי לשקף בצורה מדויקת יותר את ההתנהגות שהוא מייצג. (I545cd) - הוספת עומסים יתרים לכפתורים נפוצים שמאפשרים צורות מונפשות באינטראקציה של לחיצה. נוספו צורות של לחצנים שנשמרו במטמון. (I5ec20)
- עכשיו אפשר לקבוע איך לחצן פעולה צף (FAB) עם
FloatingToolbar
יגיב לגלילה באמצעותFloatingToolbarScrollBehavior
. בסרגלי כלים שממוקמים לאורך קצה מרכזי (כמו מרכז עליון או מרכז תחתון), מומלץ להשתמש בהתנהגות גלילה כדי להסתיר את הרכיב כולו בזמן הגלילה, למראה נקי יותר. הפעולה הזו גם מונעת את המצב שבו הלחצן הראשי לא ממוקם במרכז, מצב שעלול לקרות כשמשתמשים בדגלexpanded
לצורך כיווץ. (I33f67) - עדכון של ממשקי ה-API הניסיוניים
TopAppBar
לשימוש ב-Alignment.Horizontal
במקום ב-TopAppBarTitleAlignment
בהתאמה אישית של יישור הכותרת וכותרת המשנה. (I70ca2) -
SliderState#onValueChange
עכשיו גלוי לכולם כדי לתת למשתמשים יותר שליטה (I104eb) - הוספת
NavigationSuiteScaffoldState
כדי לאפשר אנימציה של רכיב הניווט. בנוסף, הוספנו עומסים שלNavigationSuiteScaffold
ו-NavigationSuiteScaffoldLayout
עם פרמטר מצב. (I6a8c9, b/328674235)
תיקוני באגים
- העברת הכיתות
IconButtonColors
ו-IconToggleButtonColors
מ-IconButtonDefaults.kt
בחזרה אלIconButton.kt
. (I3c233)
External Contribution
- הפוסט
SliderState#isDragging
גלוי עכשיו לכולם. (I8458a)
גרסה 1.4.0-alpha06
15 בינואר 2025
androidx.compose.material3:material3-*:1.4.0-alpha06
משוחרר. גרסה 1.4.0-alpha06 מכילה את הקומטים האלה.
שינוי בהתנהגות
- הוספנו את
displayCutout
לקבוצת השוליים הפנימיים שרכיבי Material לוקחים בחשבון כברירת מחדל, כדי למנוע חפיפה בין התוכן לבין החלק החסר במסך. זהו שינוי בהתנהגות שישפיע על האופן שבו רכיבים שמודעים לשינוי גודל חלון התצוגה מתנהגים סביב חיתוך המסך. זה כולל את ערך ברירת המחדל של הפרמטרWindowInsets
לרכיבי Material 3 עם מודעות ל-inset, ואת הערכים שלWindowInsets
שמופיעים באובייקטים של ברירות המחדל של הרכיבים גם ב-Material 2 וגם ב-Material 3. אם השינוי הזה גורם להתנהגות לא רצויה, צריך לציין באופן ידני את הפרמטרWindowInsets
לכל רכיב. (I43ee9, b/362508045)
שינויים ב-API
- עדכונים ב-API של
TopAppBar
. משנים את השם של סרגלי האפליקציות העליונים בגודל בינוני וגדול עם כותרת משנה ל-*FlexibleTopAppBar
. איחדנו את הווריאציות של הצבעים לפונקציה אחתTopAppBarDefault.topAppBarColors()
והוספנו פרמטר צבעsubtitle
שיוחל על רכיב ה-Composable של הכתוביות שסופק (I41b65) - הסרה של
WideNavigationRailArrangement
API לטובתArrangement.Vertical
(Id0341) - הוספת
VerticalSlider @Composable
חדש. (I2bfba) - הוספנו טראק חדש
@Composable
שמאפשר לציין פינות חיצוניות מותאמות אישית לטראק וסמלי טראק. (I436a4) - מעדכנים את ממשקי ה-API של סרגל הכלים הצף כדי להשתמש באובייקט
FloatingToolbarColors
במקום בצבע יחיד של קונטיינר. (I9a054) - הוספה ושימוש בהערה ניסיונית חדשה
ExperimentalMaterial3ComponentOverrideApi
(Ia1eaf) -
Modifier.indicatorLine
מקבל עכשיו צורה לשדה הטקסט כדי לטפל בחיתוך. (I8c5f3, b/380704151) - משנים את השם של הפונקציות הניסיוניות
FloatingAppBar
ל-FloatingToolbar
(I1dbf8) - נוסף
floatingToolbarVerticalNestedScroll
חדש שאפשר לצרף למאגר עם אפשרות גלילה כדי לעדכן את מצב ההרחבה של סרגל הכלים הצף על סמך תנועת גלילה שחוצה סף. (I6d65f) - השקנו API חדש ליצירת סרגל כלים צף עם לחצן פעולה צף (FAB) שמצורף אליו. ממשק ה-API מספק אפשרויות גמישות להתאמה אישית, שמאפשרות לכם לסדר את סרגל הכלים בצורה אופקית או אנכית, ולמקם את ה-FAB בתחילת סרגל הכלים או בסופו. (I9e350)
תיקוני באגים
- תוקנה בעיה בנגישות של חלונית Snackbar שגרמה להכרזה על עצמה כשסוגרים אותה כשההגדרה
TalkBack
מופעלת. (/I9db53)
External Contribution
- הפונקציה
BasicTooltip
נפוצה ב-Foundation וBasicTooltip/Tooltip
ב-Material3. (Ifc2e6)
גרסה 1.4.0-alpha05
12 בדצמבר 2024
androidx.compose.material3:material3-*:1.4.0-alpha05
משוחרר. גרסה 1.4.0-alpha05 מכילה את הקומטים האלה.
שינויים ב-API
- החלפת סוג בערך
WideNavigationRailState.current/target
של enum כדי לשפר את הקריאות (I2d6ab) SplitButton
שינוי Shape API מ-data class ל-class לצורך תאימות בינארית. (I53812)- נוסף API של תיאור קצר שכולל פרמטר
onDismissRequest
, כדי שהיוצרים יוכלו להחליט מה יקרה כשמשתמש ילחץ מחוץ לתיאור הקצר. הוצאנו משימוש את ה-API הישן שלא מכיל את הפרמטר החדש הזה. (I99aef) - שינוי השם של
opticalCentering
ל-horizontalCenterOptically
. הופכים את התוסף לפנימי. החלפת פרמטר הריווח בהיסט מקסימלי להתחלה ולסיום. (I0b904) - משנים את
WideNavigationRailState
כך שיכלול את הערך הנוכחי או ערך היעד, ומסירים את סוגי הנתונים המנויים לטובת ערך בוליאני. (Idfa29, b/356039090) - מוסיפים
NavigationBarItemComponentOverride
. (I3a06a)
תיקוני באגים
- תיקון ההתנהגויות של סרגל האפליקציות העליון והתחתון כדי לשנות את הצבע באופן מהימן כשגוללים את התוכן עד הסוף. (Idc4e8, b/293665988)
- פונקציות של התנהגות גלילה בסרגלי אפליקציות עליונים ותחתונים מחזירות עכשיו התנהגות שנשמרה, כדי לשפר את הביצועים בכל ההרכבות מחדש. (I0fdbe, b/207957336)
- פרמטר הצירוף מוחל עכשיו אחרי צירופים פנימיים כמו התנהגות וסמנטיקה של גרירה, במקום לפני. ההגדרה הזו משפיעה על הסדר שבו המערכת מחילה את שינויי המחיר. (I8d83f)
- הגיליון התחתון המורחב נשאר מורחב גם אחרי שינוי הגודל. (I2870b, b/324934884)
- הפניית סימונים של סרגל הניווט והסטטוס בצורה נכונה למאפייני חלונות. (Ie674d, b/362539765)
- מעבירים את פרמטר השינוי ל-scaffolds root, כמו שמתואר במסמך. ההטמעה הזו תואמת ל-M2. (I0235e, b/372311595)
External Contribution
- פונקציית
DatePickerDialog
שעברה המרה. (I7dced)
גרסה 1.4.0-alpha04
13 בנובמבר 2024
androidx.compose.material3:material3-*:1.4.0-alpha04
משוחרר. גרסה 1.4.0-alpha04 מכילה את הקומטים האלה.
שינויים בהתנהגות
- החזרת שינויי הצבע שהוצגו ב-aosp/3212478 ל-
iconButtonColors
, iconToggleButtonColors
, outlinedIconButtonColors
, outlinedIconToggleButtonColors
ו-outlinedIconToggleButtonBorder
. העברנו את ההתנהגות שבוטלה עכשיו לקבוצה חדשה של פונקציות שנקראותiconButtonVibrantColors
וכן הלאה, כדי להדגיש את הצבעים עם הניגודיות הגבוהה שמוחזרים. (Iffd8d)
תכונות חדשות
- רכיב Introduce
VerticalDragHandle
(I6c770)
שינויים ב-API
- שינוי השם של
DismissibleModalWideNavigationRailDefaults
לModalWideNavigationRailDefaults
. (I8e877) - מוסיפים
NavigationBarComponentOverrides
. (I8a3f3) - מוסיפים
NavigationRailComponentOverride
. (I83e13) - הוספנו את
WideNavigationRailState
כדי לטפל בכיווץ ובהרחבה של החלונית, אפשרנו לסגור אתModalWideNavigationRail
ומחקנו אתDismissibleModalWideNavigationRail
. (I88568) - הוספת ברירות מחדל של גדלים xSmall, medium, large ו-xLarge לברירות המחדל של לחצן ההפעלה/ההשבתה. (Ie95d1)
- מוסיפים את גדלי ברירת המחדל xSmall, medium, large ו-xLarge לברירות המחדל של הכפתורים. (If8b6d)
תיקוני באגים
- הצבע של הסמל האחרון בסמל המסנן עודכן מ'ראשי' ל-
OnSurfaceContainer
, בהתאם למפרט. כל צבעי המתאר של הסמלים עודכנו מ'מתאר' ל'וריאציית מתאר', בהתאם למפרט. (I68bd4)
גרסה 1.4.0-alpha03
30 באוקטובר 2024
androidx.compose.material3:material3-*:1.4.0-alpha03
משוחרר. גרסה 1.4.0-alpha03 מכילה את הקומטים האלה.
שינויים ב-API
- ה-constructor של
SheetState
עם density הוצא משימוש, ועכשיו משתמשים בספי צפיפות מיקום ומהירות. (Ifd16e) - נוסף
rememberTooltipPositionProvider
שמכיל לוגיקה מעודכנת של מיקום. הוצאו משימושrememberPlainTooltipPositionProvider
ו-rememberRichTooltipPositionProvider
. (Ie66e2) - בנוסף,
ModalBottomSheetProperties
מאפשרת התאמה אישית של הצבעים של שורת המצב וסרגל הניווט. כברירת מחדל, העדכונים האלה מתבססים על צבע התוכן ולא על הסטטוס של העיצוב הכהה במערכת. (Ib874e, b/362539765) - שיפרנו את חוויית הקלט בבוחרי תאריכים: במצב קלט, שדה הטקסט של התאריך יסומן כדי לאפשר הזנת טקסט מיידית. השינוי מוסיף פרמטר
requestFocus
ל-DatePicker
ול-DateRangePicker
. כדי למנוע את המיקוד, מעבירים את הערךfalse
. (I12d09, b/286399710, b/340102743) - שמירת ברירות המחדל של הצורה במטמון באובייקט Shape. הגדרת ברירות המחדל של הצורה
@Composable
עבור כפתור החלפת מצב. הצורה מצטמצמת לצורה אחת כברירת מחדל, כי הווריאציות מפנות לאותו קובץ טוקנים. (Iaa014)
תיקוני באגים
- אופטימיזציה של ההתנהגות של Scaffold
contentPadding
כדי להימנע מהרכבה מחדש של תוכן הגוף בכל פעם ש-contentPadding
משתנה. (I8c8e2, b/373904168) - השם של
TextFieldLabelScope
progress
שונה לlabelMinimizedProgress
- השם של
TextFieldLabelPosition
Default
שונה לAttached
. הוסרו חברים בממשק. (If75c6) - תוקנה בעיה ב-
DatePicker
במצב קלט שבה שגיאות אימות יכלו לגרום לשינוי הגובה של הרכיב. (I2e229, b/280462363) - גורמים למחוון של Material לשנות את הערך שלו כשלוחצים על מקשי בקרה. (I1c442)
גרסה 1.4.0-alpha02
16 באוקטובר 2024
androidx.compose.material3:material3-*:1.4.0-alpha02
משוחרר. גרסה 1.4.0-alpha02 מכילה את הקומטים האלה.
שינויים ב-API
- עדכנו את כלי בחירת התאריכים כדי להבטיח שימוש עקבי באזוריות בכל
DatePicker
וDateRangePicker
כשמגדירים אזוריות ישירות דרךDatePickerState
אוDateRangePickerState
. שימו לב: כשמגדירים את המאפיין Locales ישירות למצב, אתם צריכים לוודא שטקסט הכותרת והכותרת הראשית מותאמים בהתאם, כי טקסט ברירת המחדל שלהם עדיין יוחל בהתאם ל-Locale של פלטפורמת ברירת המחדל. (I37073, b/326490763, b/321657276) - המאפיין
SheetState.isAnimationRunning
נחשף עכשיו. (I9a3d7) DatePickerColors
עכשיו קודם כל נלקחים בחשבון הצבעים שמוגדרים ב-DatePickerColors
, ורק אחר כך הצבעים שמוגדרים בסגנונות הטקסט של הטיפוגרפיה בעיצוב. חשוב גם לשים לב שהעדכון הזה משנה את המיקום של הפרמטרcolor
בפונקציות של בוחר התאריכים, ומוסיף פרמטרcontentColor
להתאמה אישית של צבעי הטקסט בכותרת ובשם. (I30d03, b/347031394)- משנים את השם של
SplitButton
ל-SplitButtonLayout
ומסירים את ממשקי ה-API של וריאציות הצבעSplitButton
. כדי ליצור וריאציות, נעשה שימוש חוזר בווריאציות של הלחצנים שסופקו על ידיSplitButtonDefaults
. (I44c36) -
ModalBottomSheet
כולל עכשיו את הפרמטרsheetGestureEnabled
(I856cb, b/288211587) - שם האפשרות
standardMotionScheme
ושם האפשרותexpressiveMotionScheme
שונו ל'רגיל' ו'מובלט'. עכשיו אפשר לגשת לשתי הפונקציות דרך אובייקט העזרMotionScheme
על ידי קריאה לפונקציותMotionScheme.standard()
ו-MotionScheme.expressive()
. (Iceccf) - הוספת הפרמטר
maxWidth
לתיאורי הכלים הפשוטים והמתקדמים. ברירת המחדל היא מפרט העיצוב של 200dp לתיאורי כלים פשוטים ו-320dp לתיאורי כלים עשירים. (I30ce9)
תיקוני באגים
- התאריכים
DatePicker
ו-DateRangePicker
מתעדכנים עכשיו בצורה נכונה בחודש שמוצג, כשהם מוגדרים באמצעותdisplayedMonthMillis
של המצב שלהם. (If9e47, b/333414302) - התוכן של
ModalBottomSheet
מוזז עכשיו מהסטטוס בר. (I5114c, b/321877275, b/336962418, b/342093067) - [Bottom Sheet] Change back callback priority to
PRIORITY_DEFAULT
to allow IME keyboard to dismiss first. (I447fb) - תיקנו קריסות ב-
DatePicker
וב-DateRangePicker
כששנת המינימום לבחירה מוגדרת לשנה עתידית. (I78656, b/319395747) - פתרון בעיה בכלי לבחירת תאריכים כדי לעדכן את ממשק המשתמש כשמחילים מופע מעודכן של
SelectableDates
. (Iad59a, b/290135807, b/339898760)
גרסה 1.4.0-alpha01
2 באוקטובר 2024
androidx.compose.material3:material3-*:1.4.0-alpha01
משוחרר. גרסה 1.4.0-alpha01 מכילה את הקומטים האלה.
שינויים בהתנהגות
- הספרייה לא מוסיפה יותר תלות ב-
material-icons-core
, לכן אם הפרויקט שלכם הסתמך על זה, תצטרכו להוסיף את התלות הזו באופן מפורש בקובציbuild.gradle[.kts]
. (I735ff, b/349894318) - הצבע של התווית הפעילה של
NavigationBarItem
ושלNavigationRailItem
משתנה מ-onSurface
ל-secondary
כדי לשפר את נוחות השימוש, את הניגודיות של הצבעים ואת העקביות במערכת (Ibc297). כדי לחזור להתנהגות הקודמת, מעתיקים את צבעי ברירת המחדל ומשנים אתselectedTextColor
ל-MaterialTheme.colorScheme.onSurface
. - רכיבי Material 3 משתמשים עכשיו ב-
MotionScheme
החדש כדי להגדיר את התנועה שלהם. (Ie0f93) - שינויים בתנועה של אינדיקטור התקדמות מעגלי לא מוגדר (I3c07e)
- מעדכנים את הצבעים
OutlinedIconButtonColors
וOutlinedIconToggleButtonColors
כדי לשפר את ניגודיות הצבעים. (I2743d) - עדכון הצבע של הקונטיינר והתוכן של
FilledIconToggleButtonColors
ו-FilledTonalIconToggleButtonColors
. (Ic5d0f) - צבע הגבול של
OutlinedButton
עודכן מoutline
לoutlineVariant
. (057f00)
שינויים ב-API
- הוספנו פרמטר אופציונלי
reverseLayout
לפונקציהTopAppBar
שלenterAlwaysScrollBehavior
כדי לשפר את התמיכה בתוכן שהוגדר עםreverseLayout
. (I4e0e5) -
SegmentedButton
תומך עכשיו בארגומנטcontentPadding
. (I5ad91, b/358414376) - ל-
PullToRefreshState
אין יותר הטמעה שמוגדרת כברירת מחדל עבורisAnimating
(I6a593) - נוספו עומסים חדשים של Material
TextField
ו-OutlinedTextField
שמשתמשים ב-TextFieldState
. הוספנו ממשקי API של תיבות עיטור שתואמים ל-TextFieldDecorator
. (If13a1) - נוסף פרמטר לשליטה ב
labelPosition
של שדה הטקסט. שימוש ב-alwaysMinimize
מאפשר להציג את התווית ואת ה-placeholder בשדה טקסט בו-זמנית, גם כשהשדה לא מודגש. (I1ef2c) - נוספו רכיבי Material
SecureTextField
ו-OutlinedSecureTextField
לשדות להזנת סיסמה. (I7e22d) - נוסף היקף לתוויות של שדות טקסט כדי לשאול על התקדמות האנימציה. (If5ec8)
- הוספנו תמיכה ב-
MotionEvent.CLASSIFICATION_DEEP_PRESS
בהסברים הקצרים. (I62e6a) - המשתנה
isAfternoon
שלTimePickerState
הוא עכשיו ערך של תוסף במקום משתנה בממשק, והשם שלו שונה ל-isPm
(I89a97) - עדכון של סוג הגופן כדי לתמוך בסולמות של גופנים מודגשים. (Ifa13c)
- הוספנו את
ModalWideNavigationRail
API ושינינו את השם של ממשקיModalExpandedNavigationRail
API ל-DismissibleModalWideNavigationRail
. (Ic9118) - העדכון של
FloatingAppBarScrollBehavior
מאפשר חישוב אוטומטי שלscreenOffset
ולא מחייב@Composable
. (Idf349) - עדכונים ב-API
LoadingIndicator
כדי לתקן את השמות באובייקט ברירת המחדל שלו. נוסף קבועLoadingIndicatorElevation
ב-PullToRefresh
. (I1d72b) - עדכונים ב-API
LoadingIndicator
כדי לתקן את השמות באובייקט ברירת המחדל שלו. נוסף קבועLoadingIndicatorElevation
ב-PullToRefresh
. (I1d72b) - נוספו פרמטרים
amplitude
ו-waveSpeed
לווריאציות הלא מוגדרות שלLinearWavyProgressIndicator
ו-CircularWavyProgressIndicator
. (I2a0c5) - תמיכה בשינוי הצורה של לחצן הפעלה/השבתה עם סמל בהתאם למצב הלחיצה או הסימון שלו. (Ibc781)
- עדכון של סוג הגופן כדי לתמוך בסולמות של גופנים מודגשים. (Ifa13c)
- הצורה
SplitButton
משתנה בהתאם למצב ברירת המחדל או למצב הלחיצה. הוסרAnimatedTrailingButton
api כיTrailingButton
api יכול להציע את אותן התאמות אישיות (I95066) - מוסיפים משנה כדי להנפיש את ההצגה וההסתרה של ה-FAB, למשל כשמגללים את התוכן. (I8338d)
- הוספת צורות וריווח של קבוצת לחצנים מחוברים ל-
ButtonGroupDefaults
לשימוש בדוגמה. (I68e30) - הוספת ריווח אופקי ללחצן האחרון בלחצן מפוצל והפעלת מרכוז אופטי שמחושב לפי ההבדלים בין הפינות בהתחלה ובסוף (I122e2)
- אנחנו משיקים Material חדש
MotionScheme
שמאפשר להגדיר סכמה לתנועה של הרכיב. הסכמה מוגדרת דרךMaterialTheme
. (Id50c2)
תיקוני באגים
- החלת אינדקס נכון של מעבר בין רכיבים על רכיבי
Scaffold
צאצא מסוג Composables. הסדר הואtopBar
,bottomBar
, fab, content, snackbar. (I5936b) - תוקנה בעיה ברכיבים
DatePicker
ו-DateRangePicker
שבה בחלק מהלוקאלים ובפורמטים מסוימים, חלק מרכיבי התאריך (לדוגמה, שמות החודשים) לא התחילו באות גדולה. (I1430f) - שילוב של טוקנים של רכיבי FAB ו-FAB Menu (עדכונים חזותיים קלים בריווח ובטקסט) (Ib57f3)
-
ModalBottomSheet
מופיע עכשיו ראשון בסדר המעבר הסמנטי, ואחריו שכבת ה-scrim. (I436f9, b/358594665) - תיקון של בעיה שבה סרגל האפליקציה התחתון לא נעלם לגמרי כשגוללים מתחת ללחצן הניווט במצב 'מקצה לקצה' (I3ee21)
Compose Material3 גרסה 1.3
גרסה 1.3.2
9 באפריל 2025
androidx.compose.material3:material3-*:1.3.2
משוחרר. גרסה 1.3.2 מכילה את הקומטים האלה.
תיקוני באגים
-
ListItem
מתקן את החישוב של הגובה הפנימי שלו, ועכשיו הוא שומר את כמות המקום המתאימה בפריסה. - הסרת ריווח פנימי מיותר של התווית
NavigationBarItem
, והתאמה נכונה למפרט. - תיקון הפריסה של
TabRow
במצב מימין לשמאל.
גרסה 1.3.1
30 באוקטובר 2024
androidx.compose.material3:material3-*:1.3.1
משוחרר. גרסה 1.3.1 מכילה את ההתחייבויות האלה.
תיקוני באגים
- התאריכים
DatePicker
ו-DateRangePicker
מתעדכנים עכשיו בצורה נכונה בחודש שמוצג, כשהם מוגדרים באמצעותdisplayedMonthMillis
של המצב שלהם. (If9e47, b/333414302) - תיקנו קריסות ב-
DatePicker
וב-DateRangePicker
כששנת המינימום לבחירה מוגדרת לשנה עתידית. (I78656, b/319395747) - פתרון בעיה בכלי לבחירת תאריכים כדי לעדכן את ממשק המשתמש כשמחילים מופע מעודכן של
SelectableDates
. (Iad59a, b/290135807, b/339898760) - משנים את העדיפות של הקריאה החוזרת (callback) שמשמשת את התכונה 'גיליונות תחתונים' ל-
PRIORITY_DEFAULT
כדי לאפשר למקלדת IME להיסגר קודם. (I447fb)
גרסה 1.3.0
4 בספטמבר 2024
androidx.compose.material3:material3-*:1.3.0
משוחרר. גרסה 1.3.0 מכילה את ההתחייבויות האלה.
שינויים חשובים מאז גרסה 1.2.0
תכונות עיקריות בגרסה 1.3.0
רכיבים חדשים של Material Design 3
- קרוסלה
-
HorizontalMultiBrowseCarousel
ו-HorizontalUncontainedCarousel
שיפורים ברכיבים קיימים של Material Design 3.
-
- [
ModalBottomSheet
] עכשיו יש תמיכה בתכונה 'חזרה עם חיזוי' ב-U+ (Iccf32, b/281967264, b/304850357) - [
SearchBar
] תומך עכשיו בחיזוי החזרה ב-U+ (I657f8) - חלונית ההזזה לניווט (
ModalDrawerSheet
ו-DismissibleDrawerSheet
) תומכת עכשיו בתכונה 'חזרה עם חיזוי' ב-U+ כהסכמה להצטרפות (Ie5b0b) -
DropdownMenu
תומך עכשיו בצבע, בצורה, בגובה ובגבול בהתאמה אישית. (I8e981,b/289554448, b/301887035, b/283654243) - המחוון עודכן כדי לשפר את הנגישות. נוספו לו רווח ואינדיקטור עצירה. (I3058e)
- בוצע עדכון ב-
ProgressIndicator
כדי לשפר את הנגישות על ידי הוספת רווח ואינדיקטור לעצירה. (I21451) - נוסף סמן ברירת מחדל לתיאור כלי עשיר, תמיכה בסמן מותאם אישית לציור בהינתן עוגן
LayoutCoordinates
. (Ifd42c) שינויי תוכנה שעלולים לגרום לכשלים - ממשקי API חדשים של משיכה לרענון:
- הפונקציה
PullToRefreshState
פשוטה יותר, ועכשיו אפשר להשתמש בה בערכים חלקיים במקום ביחידות Dp. - המצב של
isRefreshing
נשלט על ידי המשתמש ולא על ידיPullToRefreshState
. - הפרדנו את חיבור הגלילה המקונן מ-
PullToRefreshState
. היא מטופלת על ידיPullToRefreshBox
אוModifier.pullToRefresh
החדשים. - העדכון הזה הוא שינוי שובר תאימות לממשקי API ניסיוניים קודמים. (I0adeb, b/314496282, b/317177684, b/323787138, b/324573502, b/317177683) שינויים שמשפיעים על המראה
- הפונקציה
- צריך לעדכן את שכבת העל של מצב המיקוד ל-0.1f כדי להבטיח ניגודיות צבעים מספקת. (I7ea77)
- שינויים קלים בברירות המחדל של צבע הרקע והמשטח ב-
lightColorScheme
וב-darkColorScheme
. (I9db52) - העדכון כולל שינוי של המחוון ושל הצבעים
ProgressIndicator
בהתאם למפרט החדש של ניגודיות בין רכיבים שאינם טקסט. (I26807) SurfaceContainer
וריאציות נמצאות עכשיו בשימוש ברכיבים. רכיבים שבהם נעשה שימוש ב-Surface
וב-TonalElevation
כדי לחשב באופן רשמי את הצבע, משתמשים עכשיו כברירת מחדל בתפקידיSurfaceContainer
, שלא מושפעים מהעלאת הטון. (b/304584161)- התפקידים של Surface ו-Surface container שונו קצת, ועכשיו יש יותר גוון בעיצובים בהירים וכהים. (I677a5)
- ממשקי API ניסיוניים הועברו לגרסה יציבה.
- שיפורי ביצועים
גרסה 1.3.0-rc01
21 באוגוסט 2024
androidx.compose.material3:material3-*:1.3.0-rc01
משוחרר. גרסה 1.3.0-rc01 מכילה את הקומטים האלה.
תיקוני באגים
-
ModalBottomSheet
מופיע עכשיו ראשון בסדר המעבר הסמנטי, ואחריו שכבת ה-scrim. (I436f9, b/358594665)
גרסה 1.3.0-beta05
24 ביולי 2024
androidx.compose.material3:material3-*:1.3.0-beta05
משוחרר. גרסה 1.3.0-beta05 מכילה את הקומטים האלה.
- תוקנה בעיה שבה תוכן
BottomSheet
חסר או נחתך ב-Android N וב-Android O (a10a2d) - הגדלנו את הגבולות הסמנטיים של פס ההזזה כדי ש-
TalkBack
יציג כמו שצריך את סימני ההתמקדות סביב התמונות הממוזערות. (0b5a1d)
גרסה 1.3.0-beta04
26 ביוני 2024
androidx.compose.material3:material3-*:1.3.0-beta04
משוחרר. גרסה 1.3.0-beta04 מכילה את הקומטים האלה.
גרסה 1.3.0-beta03
12 ביוני 2024
androidx.compose.material3:material3-*:1.3.0-beta03
משוחרר. גרסה 1.3.0-beta03 מכילה את ההתחייבויות האלה.
External Contribution
- הפיכת
androidx.compose.material3.DropdownMenu
לזמין ממקור נפוץ. (If62c0)
גרסה 1.3.0-beta02
29 במאי 2024
androidx.compose.material3:material3-*:1.3.0-beta02
משוחרר. גרסה 1.3.0-beta02 מכילה את הקומטים האלה.
שינויים ב-API
-
Modifier.pullToRefreshIndicator
תומך בהעלאה, מעדכן את ממשקי ה-API של Pull To Refresh כך שההגדרה enabled תהיה בוליאנית ולא למדה. תמיכה בהתאמת תוכן ב-PullToRefreshBox
(I75679) - הפיכת
TooltipScope
לממשק אטום ויצירת הטמעה פנימית לשימוש ב-TooltipBox
וב-Label. (I3833e) - נוספו שני משנים חדשים ל-
CarouselItemScope
–maskClip
ו-maskBorder
– כדי להוסיף בקלות צורה ומסגרת לכל פריט בקרוסלה (Id67a1) -
TimePickerState
הוא עכשיו ממשק שמאפשר להגדיר את השעה (I88546) - עדכון ה-API לעיצוב הקישורים: העברת
TextLinkStyles
אלTextStyle
והסרתTextDefaults
מהחומר. (I5477b)
תיקוני באגים
- סמלי הסטטוס וסרגל הניווט ב-
ModalBottomSheet
מגיבים עכשיו לסטטוס של העיצוב הכהה. (Ie1fe7, b/338342149) - נוספה סמנטיקה של סגירת גיליון ל-
ModalBottomSheet
scrim. (0e61cb,b/328801864)
External Contribution
- הפיכת
androidx.compose.material3.AlertDialog
לזמין ממערך מקורות נפוץ (Ia33f5) - הפיכת
ModalBottomSheet
לזמין מקבוצת מקורות משותפת (Id7cc7)
גרסה 1.3.0-beta01
14 במאי 2024
androidx.compose.material3:material3-*:1.3.0-beta01
משוחרר. גרסה 1.3.0-beta01 מכילה את הקומטים האלה.
שינויים ב-API
- שימוש ב-
DpSize
במקום ב-CaretProperties
. הסרה שלCaretProperties
. שינוי השם שלCaretScope
לTooltipScope
. (Id9a76) - ה-API לעדכון קישורים עם עיצוב Material בטקסט עודכן. הסרנו את השיטות מה-
TextDefaults
ליצירתLinkAnnotations
עם נושאים ולניתוח HTML עם קישורים שמותאמים לנושאים. במקום זאת, הוספנו מחלקהTextLinkStyles
שמאפשרת לעצב את הקישורים כפרמטר ל-Text composable. (I31b93)
גרסה 1.3.0-alpha06
1 במאי 2024
androidx.compose.material3:material3-*:1.3.0-alpha06
משוחרר. גרסה 1.3.0-alpha06 מכילה את הקומטים האלה.
שינויי תוכנה שעלולים לגרום לכשלים
ממשקי API חדשים של משיכה לרענון:
- הפונקציה
PullToRefreshState
פשוטה יותר, ועכשיו אפשר להשתמש בה בערכים חלקיים במקום ביחידות Dp. - המצב של
isRefreshing
נשלט על ידי המשתמש ולא על ידיPullToRefreshState
. - הפרדנו את חיבור הגלילה המקונן מ-
PullToRefreshState
. היא מטופלת על ידיPullToRefreshBox
אוModifier.pullToRefresh
החדשים. - העדכון הזה הוא שינוי שובר תאימות לממשקי API ניסיוניים קודמים. (I0adeb, b/314496282, b/317177684, b/323787138, b/324573502, b/317177683)
- הפונקציה
שינויים ב-API
- השדה
RippleConfiguration#isEnabled
הוסר, והשדהLocalRippleConfiguration
הפך לשדה שאפשר להשאיר ריק. כדי להשבית את האפקט, במקום לספקRippleConfiguration
עםisEnabled = false
, מספקיםnull
ל-LocalRippleConfiguration
. (I22725) ModalBottomSheet
כשמפעילים את ההגדרה 'מקצה לקצה', הציור של שכבת המסך מעל סרגל הסטטוס מדויק יותר. מעכשיו, התוכן של גיליון תחתון מודאלי יכול להשתמש בשוליים הפנימיים של החלון, וכך לאפשר הצגת תוכן מעל סרגל הניווט. הפרמטרModalBottomSheet
windowInsets
שונה ל-contentWindowInsets
כדי לציין איפה יחולו השוליים הפנימיים. הם כבר לא קשורים ללוגיקה של החלון. הסוגcontentWindowInsets
השתנה לפונקציה שמחזירהWindowInsets
, כדי לאפשר את הפתרון שלה בחלון החדש. (I39630, b/274872542, b/300280229, b/290893168)- רכיבי
PrimaryScrollableTabRow
ו-SecondaryScrollableTabRow
משתמשים עכשיו בפריסה מותאמת אישית במקום בהרכבה משנית, מה שאמור לשפר את הביצועים. (I991e0) - נוספה אפשרות לעיצוב של מצב לחיצה בקישורי טקסט, בנוסף לעיצוב רגיל, לעיצוב של מצב ריחוף ולעיצוב של מצב מיקוד. בכל אחת מהשיטות האלה יש ארגומנט
pressedStyle
כדי לתמוך בכך.TextDefaults
(Ic473f, b/139312671)
תיקוני באגים
- עכשיו נקודות העיגון של מגירת הניווט תואמות לרוחב של
drawerContent
. (Ibc72f, b/245355396) - הריווח הפנימי העליון של התווית מחושב עכשיו לפי גודל הגופן של המערכת.
OutlinedTextField
(Idc781) - המיקום הקבוע של החבילה הוא
CalendarLocale
. (Ifa235) - [תנועת חזרה עם חיזוי] עדכון אנימציות של תנועת חזרה עם חיזוי לשימוש בעקומת אינטרפולציה של (0.1, 0.1, 0, 1) (I2591a)
גרסה 1.3.0-alpha05
17 באפריל 2024
androidx.compose.material3:material3-*:1.3.0-alpha05
משוחרר. גרסה 1.3.0-alpha05 מכילה את הקומטים האלה.
תכונות חדשות
- ב-
SearchBar
וב-DockedSearchBar
יש עכשיו עומסים חדשים שמקבלים פרמטר של שדה טקסט. כך אפשר לעצב את שדה הטקסט בנפרד משאר סרגל החיפוש, וגם להעביר שדות טקסט מותאמים אישית. שדה הטקסט של ההטמעה הנוכחית זמין עכשיו בתורSearchBarDefaults.InputField
. (I50c73, b/275074248, b/278773336, b/326627700) - הפונקציה lambda
drawTick
נוספה ל-API הציבורי כדי להתאים אישית את סימני התיק אם צריך (I0c048)
שינויים ב-API
- נוספה אפשרות לעיצוב קישורי טקסט במצב לחיצה, בנוסף לעיצוב רגיל, עיצוב במצב ריחוף ועריכה (I5f864, b/139312671)
- בוצע עדכון של
CarouselItemInfo
כדי לחשוף את ה-Rect של המסכה שמשמש לחיתוך הפריט (I785d8) - הוסר
BasicTooltipState
מה-API הציבורי של Material 3. הפונקציונליות שלו משולבת עםTooltipState
עד ש-BasicTooltip
של Foundation יתייצב. (Icda29) - נוסף אובייקט
TextDefaults
שמכיל שיטות ליצירתLinkAnnotation
ולניתוח מחרוזת עם תגי HTML שחלים על הקישורים (I98532, b/139312671)MaterialTheme
ExposedDropdownMenuBoxScope
לא מאפשרת יותר שימוש במחלקות משנה. לתפריטים הנפתחים שמוצגים יש עכשיוMenuAnchorType
שצריך להעביר אלmenuAnchor
כדי לשפר את הנגישות. צריך להשתמש בשיטה הזו במקום להעביר אתfocusable
אלExposedDropdownMenu
, שיצא משימוש. ל-menuAnchor
יש פרמטר חדש לשליטה במצבenabled
. (I55ee6, b/257209915, b/308840226)- תוקן צבע הגבול של
OutlinedButton
כשהוא מושבת. נוספה פונקצייתButtonDefaults.outlinedButtonBorder("enabled")
עמוסה מדי שמקבלת את המצב המופעל. (Ie650b, b/318461363) - נוספה מחלקה חדשה,
CarouselItemInfo
, כדי לעזור ללקוחות לקבל מידע על גדלי הפריטים. (I9070c) - השימוש בבונה
ColorScheme
ללא קונטיינרים של משטחים הוצא משימוש. צריך לעבור אל ה-constructor שכולל מאגרי מידע של משטחים. (I35c11) - [Outlined]
TextFieldDefaults
ContainerBox
שונה ל-Container
. (Ie8d3b)
תיקוני באגים
- אם הערך של
sheetSwipeEnabled
הוא False, לא תהיה יותר גלילה שלBottomSheetScaffold
מגלילה מקוננת. (I5e1c1, b/306464779) - הסרנו חלק מההערות מסוג
ExperimentalMaterial3Api
OptIn ב-IconButtonSamples.kt
. (I111d1)
גרסה 1.3.0-alpha04
3 באפריל 2024
androidx.compose.material3:material3-*:1.3.0-alpha04
משוחרר. גרסה 1.3.0-alpha04 מכילה את הקומטים האלה.
תכונות חדשות
- נוספו שתי גרסאות ניסיוניות של קרוסלת Material3 –
HorizontalMultiBrowseCarousel
ו-HorizontalUncontainedCarousel
(I88d64) - עודכן ה-Nav Drawer של Compose M3 (
ModalDrawerSheet
ו-DismissibleDrawerSheet
) כדי לתמוך בתכונה 'חזרה עם חיזוי' ב-U+ כהסכמה (Ie5b0b) - נוסף API חדש ב-Icon כדי לאפשר העברת גוון צבע כ-lambda כדי למנוע קומפוזיציה מחדש. (I5b5a2)
- ממשקי ה-API של סרגל האפליקציות העליון תומכים עכשיו בגבהים מותאמים אישית גם לקטעים קבועים וגם לקטעים שאפשר לכווץ. (Ib8b0c, b/323403446)
שינויים ב-API
- ממשקי ה-API של סרגל האפליקציות העליון תומכים עכשיו בגבהים מותאמים אישית גם לקטעים קבועים וגם לקטעים שאפשר לכווץ. תוקנה בעיה שגרמה לכך שסרגלי אפליקציות עליונים עם שורה אחת הורכבו מחדש יותר מדי פעמים בזמן גלילת התוכן. תוקנה בעיה שבה
MediumTopAppBar
כותרות נחתכו במכשירים עם הגדרות גדולות של גופן או תצוגה. (Ib8b0c, b/323403446, b/300953236, b/286296147, b/330410290, b/308540676) -
SegmentedButton
וממשקי ה-API המשויכים יציבים עכשיו (I8a158) - הגרסאות
SwipeToDismissBox
, SwipeToDismissBoxDefaults
, SwipeToDismissBoxState
ו-SwipeToDismissBoxValue
מסומנות עכשיו כגרסאות יציבות. (I5f000) - הוסרו ממשקי ה-API וסוגי ה-enum
DismissDirection
ו-DismissValue
שהוצאו משימוש. (I89ccd) - נוסף תג ניסיוני לאובייקט הנלווה
CarouselState
של Carousel. (I94154) - הוצאנו משימוש את
LocalMinimumInteractiveComponentEnforcement
והשקנו אתLocalMinimumInteractiveComponentSize
במקומו. (I7a7ac) - ה-constructor של
SearchBarColors
הוא עכשיו ציבורי. (I769ca) - נוסף פרמטר
gesturesEnabled
ל-SwipeToDismissBox
. (Idc59f, b/324170119) - הוסרו ממשקי API של שדות טקסט שסומנו ככאלה שיצאו משימוש וכניסיוניים. (I1305f)
גרסה 1.3.0-alpha03
20 במרץ 2024
androidx.compose.material3:material3-*:1.3.0-alpha03
משוחרר. גרסה 1.3.0-alpha03 מכילה את הקומטים האלה.
שינויי תוכנה שעלולים לגרום לכשלים ויזואליים
- צריך לעדכן את שכבת העל של מצב המיקוד ל-0.1f כדי להבטיח ניגודיות צבעים מספקת. (I7ea77)
- שינויים קלים בברירות המחדל של צבע הרקע והמשטח ב-
lightColorScheme
וב-darkColorScheme
. (I9db52)
תכונות חדשות
- נוספו פרמטרים להתאמה אישית של
ExposedDropdownMenu
. בפרט, לתפריטים יש עכשיו פרמטרfocusable
(ברירת המחדל היאtrue
) שצריך להגדיר ל-false
כשעובדים עם שדות טקסט שאפשר לערוך. (I4184c, b/323694447, b/278609042)
שינויים ב-API
- הסימון
ScaffoldSubcomposeInMeasureFix
הוסר. (Ie2a4b) - החשבון
NavigationRailItemColors
מסומן עכשיו כ@Immutable
. (If6112, b/327660613) - החשבון
NavigationBarItemColors
מסומן עכשיו כ@Immutable
. (I42a30, b/298064514) - שינוי הסדר של פרמטרים ברכיב Slider Track. (I9f315)
- האפשרות
ExposedDropdownMenu
מיושמת עכשיו באמצעותPopup
. ההתנהגות צריכה להיות זהה, למעט תפריטים שניתן להתמקד בהם עם שדות טקסט שניתנים לעריכה, שאפשר לסגור אותם כשמקלידים במקלדת.
תיקוני באגים
- התפקידים של Surface ו-Surface container שונו קצת, ועכשיו יש יותר גוון בעיצובים בהירים וכהים. (I677a5)
- העדכון כולל שינוי של המחוון ושל הצבעים
ProgressIndicator
בהתאם למפרט החדש של ניגודיות בין רכיבים שאינם טקסט. (I26807) - צריך לעדכן את שכבת העל של מצב המיקוד ל-0.1f כדי להבטיח ניגודיות צבעים מספקת. (I7ea77)
- שינויים קלים בברירות המחדל של צבע הרקע והמשטח ב-
lightColorScheme
וב-darkColorScheme
. (I9db52)
גרסה 1.3.0-alpha02
6 במרץ 2024
androidx.compose.material3:material3-*:1.3.0-alpha02
משוחרר. גרסה 1.3.0-alpha02 מכילה את הקומטים האלה.
שינויים ב-API
- החזרת המצב היציב של פס ההזזה. הופך את
State.onValueChangeFinished
ל-val שוב. הוספתonValueChangeFinished
לrememberUpdatedState
. (I82ab2, b/322269951) - רכיבי הניווט משתמשים עכשיו בתפקידים החדשים של
SurfaceContainer
. ב-DrawerDefaults
יש עכשיו מאפיינים נפרדים שלstandardContainerColor
ו-modalContainerColor
. השם שלDrawerDefaults.ModalDrawerElevation
הוא עכשיו0.dp
. (I7fbac) - הסרנו את
@Stable
מהמצבים שלSlider
כי אנחנו משנים אתstate.onValueChangeFinished
לvar
. (Ied34a, b/322269951) ModalBottomSheet
ו-StandardBottomSheet
animation spec הוא עכשיוTweenSpec
, אחרי עדכון מאנימציית קפיצה. הבעיה של חריגה גלויה נפתרה. הוסרו בנאים (constructors) שהוצאו משימושSheetState
ללא צפיפות. (I7babc, b/285847707)
תיקוני באגים
SurfaceContainer
וריאציות נמצאות עכשיו בשימוש ברכיבים. רכיבים שבהם צבע חושב באופן רשמי באמצעות Surface ו-TonalElevation
משתמשים עכשיו בתפקידיSurfaceContainer
כברירת מחדל, שלא מושפעים מהגבהה טונאלית. (b/304584161)- תוקן באג שגרם לכך שצבע המאגר של
ElevatedFilterChip
כשהוא לא נבחר והוא מושבת היה שחור. (I400e6, b/322407043) - תיקון אינדיקטור התקדמות לא מוגדר כשההתקדמות היא 0 (Id6582)
- תוקנה בעיה שקשורה ל-
Slider
ול-RangeSlider
בפריסה מימין לשמאל (Iab0e1) - הוספת
SliderRangeTolerance
לחישוב טווח המחוון כי עיגול של מספרים עשרוניים יכול להיות לא מדויק. (Ic918a, b/324934900) - חשוב לוודא שהלחצנים של
DatePickerDialog
מוצגים כשמטמיעיםDateRangePicker
או כשמציגים בוחר תאריכים מכל סוג במסכים קטנים עם גופנים גדולים יותר. (Ie4758, b/325107799, b/277768544) -
Menu
משתמש עכשיו בתפקידSurfaceContainer
כדי להגדיר את צבע המאגר. השם שלMenuDefaults.TonalElevation
הוא עכשיו0.dp
. (I135b7) -
TextField
משתמש עכשיו בתפקידSurfaceContainerHighest
כדי להגדיר את צבע המאגר. (I4dced) - צ'יפים מורחבים מסתמכים עכשיו על התפקיד
SurfaceContainerLow
(I7cd2f) - הצבע של הקונטיינר
DatePicker
הוא עכשיוSurfaceContainerHigh
. השם שלDatePickerDefaults.TonalElevation
הוא עכשיו0.dp
. (Ida753) - עדכון הצבע של מאגר התוכן של דפי התחתית ושל ידית הגרירה. (I72a0a)
- הצבע של הקונטיינר
RichTooltip
הוא עכשיוSurfaceContainer
. (Ia8b45) - הצבע של הקונטיינר
SearchBar
הוא עכשיוSurfaceContainerHighest
. השם שלSearchBarDefaults.TonalElevation
הוא עכשיו0.dp
. (I88604) - העדכונים משביתים את המתג ומבטלים את הבחירה במסלולים או בסמלים כדי להשתמש בתפקיד הצבע
SurfaceContainerHighest
. (I7687a) - הצבע של הקונטיינר
AlertDialog
הוא עכשיוSurfaceContainerHigh
. (Ie0433) - הצבע של הקונטיינר
BottomAppBar
הוא עכשיוSurfaceContainer
. הצבע שלTopAppBar
onScroll
הוא עכשיוSurfaceContainer
. (I41630) - הצבע של הקונטיינר
ElevatedCard
הוא עכשיוSurfaceContainerLow
.FilledCard
צבע המאגר שלSurfaceContainerHighest
. (I35141) - הצבע של הקונטיינר
ElevatedButton
הוא עכשיוSurfaceContainerLow
. כשמבטלים את הבחירה בFilledIconButton
, צבע הרקע שלו עכשיו הואSurfaceContainerHighest
. (I792c9) - מעדכן את התפקיד של צבע המאגר
TimePicker
וצבע לוח השעון ל-SurfaceContainerHighest
. (I43b93)
גרסה 1.3.0-alpha01
21 בפברואר 2024
androidx.compose.material3:material3-*:1.3.0-alpha01
משוחרר. גרסה 1.3.0-alpha01 מכילה את הקומיטים האלה.
תכונות חדשות
- Update Compose M3
ModalBottomSheet
to support Predictive Back on U+ (Iccf32, b/281967264, b/304850357) - עדכון של Compose M3
SearchBar
לתמיכה בתכונה 'חזרה עם חיזוי' ב-U+ (I657f8) - המחוון עודכן כדי לשפר את הנגישות. נוספו לו רווח ואינדיקטור עצירה. (I3058e)
- בוצע עדכון ב-
ProgressIndicator
כדי לשפר את הנגישות על ידי הוספת רווח ואינדיקטור לעצירה. (I21451) - הוספנו קרט ברירת מחדל לתיבת מידע עשירה. ה-API החדש של תיבת המידע העשירה מאפשר עכשיו לצייר קרט מותאם אישית בהינתן עוגן
LayoutCoordinates
. (Ifd42c)
שינויים בהתנהגות
- רכיבי Material הועברו לשימוש בממשקי ה-API החדשים של אפקט האדווה, והם כבר לא מבצעים שאילתות לגבי
RippleTheme
.
שינויים ב-API
- הסרטון
drawStopIndicator
גלוי עכשיו לכולם. (I3f59f) - סימון הפונקציה
DatePicker
שלformatWithSkeleton
כפנימית (Ic65dc) -
DropdownMenu
תומך עכשיו בצבע, בצורה, בגובה ובגבול בהתאמה אישית. (I8e981, b/289554448, b/301887035, b/283654243) - רכיבי Material3 שחשפו
MutableInteractionSource
בממשק ה-API שלהם עודכנו כך שהם חושפים עכשיוMutableInteractionSource
שניתן להגדיר כ-null, ומוגדר כברירת מחדל ל-null
. אין כאן שינויים סמנטיים: העברת הערך null פירושה שאתם לא רוצים להעלות אתMutableInteractionSource
, והוא ייווצר בתוך הרכיב אם יהיה צורך בכך. שינוי ל-null מאפשר לרכיבים מסוימים לא להקצותMutableInteractionSource
אף פעם, ולרכיבים אחרים ליצור מופע רק כשצריך, וכך לשפר את הביצועים של הרכיבים האלה. אם אתם לא משתמשים ב-MutableInteractionSource
שמועבר לרכיבים האלה, מומלץ להעביר במקומו null. מומלץ גם לבצע שינויים דומים ברכיבים שלכם. (I41abb, b/298048146) - הוספנו את
RippleConfiguration
ואתLocalRippleConfiguration
כדי לאפשר התאמה אישית של אפקטי אדווה לכל רכיב או עץ משנה באמצעות ערכים קבועים. לדוגמה, כדי לשנות את הצבע של רכיב שאין לכם שליטה עליו, או כדי להשבית את האפקט של גל האדווה ברכיב. ברוב המקרים צריך להשתמש בערכי ברירת המחדל: ממשקי ה-API האלה הם פתרון למקרים שבהם רוצים להתאים אישית רכיבים ספציפיים או עצי משנה מוגבלים. לשינויים רחבים יותר ולמערכות עיצוב מותאמות אישית, כדאי ליצור אפקט גלי משלכם באמצעותcreateRippleModifierNode
. (I7b5d6, b/298048146) - נוסף ripple API חדש ב-material3 שמחליף את
rememberRipple
שהוצא משימוש. בנוסף, נוספוCompositionLocal
,LocalUseFallbackRippleImplementation
זמניים כדי להחזיר את השימוש ברכיבי material3 לממשקי ה-API שהוצאו משימושrememberRipple
/RippleTheme
. ההגדרה הזו תוסר בגרסה היציבה הבאה, והיא נועדה רק כעזר זמני להעברה במקרים שבהם מספקיםRippleTheme
מותאם אישית. (I34cbc, b/298048146)
תיקוני באגים
- הוסרה קומפוזיציה משנית בתוך
ModalBottomSheet
כדי לשפר את הביצועים. תוקנה בעיה שגרמה לקריסה שלModalBottomSheet
בתרחישים ספציפיים בשילוב עםLookaheadScope
. (I2a198) - הוסרה קומפוזיציה משנית בתוך
BottomSheetScaffold
כדי לשפר את הביצועים. תוקנה בעיה שגרמה לקריסה שלBottomSheetScaffold
בתרחישים ספציפיים בשילוב עםLookaheadScope
. (Ie6401) - היישור של התג משתנה כך שהוא קרוב יותר למרכז של תוכן העוגן ביחס לפינה השמאלית העליונה. (I18a28)
- תוקנה בעיית נגישות ב-
DateRangePicker
שבה הכותרת של הטקסט 'חודש-שנה' הועברה כפעולה למשתמשים בקורא המסך, בגישה באמצעות מתג וב-Voice Access. (I2ac55) - תוקן באג בסדר הפרמטרים
mediumTopAppBarColors
. (Ibe64a)
גרסה 1.2
גרסה 1.2.1
6 במרץ 2024
androidx.compose.material3:material3-*:1.2.1
משוחרר. גרסה 1.2.1 מכילה את הקומטים האלה.
תיקוני באגים
- החזרת היציבות למצבי פס ההזזה. הופך את
State.onValueChangeFinished
ל-val שוב. הוספתonValueChangeFinished
לrememberUpdatedState
. (Ie8fd0, b/322269951) - הסרנו את
@Stable
מהמצבים שלSlider
כי אנחנו משנים אתstate.onValueChangeFinished
לvar
. (I82ba1, b/322269951) - תיקון
NavigationBar
צבעים בהתאמה אישית כדי להעתיק מברירות המחדל. (80a779, b/326894020) - תיקון רגרסיה ב-
ExposedDropdownMenu
כדי לאפשר שוב התמקדות בו (3fcec1, b/323694447) - תוקנה בעיה במטמון של צבע הכפתור (3e5bbcb/327371655)
גרסה 1.2.0
7 בפברואר 2024
androidx.compose.material3:material3-*:1.2.0
משוחרר. גרסה 1.2.0 מכילה את הקומיטים האלה.
בעיה ידועה
- באג בעיבוד של אינטראופרביליות בין View ל-Compose הופיע בגרסה
PrimaryTabRow
כחלק משינוי לשיפור הביצועים. הפתרון האפשרי הוא להשתמש ב-TabRow
עםTabRowDefaults.PrimaryIndicator
שינויים חשובים מאז גרסה 1.1.0
רכיבים חדשים של Material Design 3
- מושכים כדי לרענן
- Segmented Button
שיפורים ברכיבים קיימים של Material Design 3.
- סרגל האפליקציה התחתון (יישור מימין לשמאל, הסתרה אוטומטית בגלילה)
- עדכון ויזואלי של הכרטיסיות
- תג (עדכון יישור)
ממשקי API ניסיוניים קודמו לגרסה יציבה!
שיפורים בביצועים
- בפוסט הזה בבלוג אפשר לקרוא פרטים נוספים.
גרסה 1.2.0-rc01
24 בינואר 2024
androidx.compose.material3:material3-*:1.2.0-rc01
משוחרר. גרסה 1.2.0-rc01 כוללת את הקומיטים האלה.
תיקוני באגים
- תוקן באג בסדר הפרמטרים
mediumTopAppBarColors
. (Ibe64a) - תוקנה באג שהופיע בגרסה
1.2.0-beta02
ב-CardDefaults.cardColors
, שגרם לכך ש-contentColor
לא התעדכן על סמך ערך הפרמטרcontainerColor
. (Iee041, b/319671246) - תוקן באג ב-
disabledContentColor
שהופיע ב-1.2.0-beta02
, והוסף אופטימיזציה קלה. (I6dda1, b/318428829)
גרסה 1.2.0-beta02
10 בינואר 2024
androidx.compose.material3:material3-*:1.2.0-beta02
משוחרר. גרסה 1.2.0-beta02 מכילה את הקומיטים האלה.
באג מוכר
- באג ב-
IconButtonColors
יקצה כברירת מחדל אתdisabledContentColor
לגרסת אלפא (0.38f) שלLocalContentColor
במקום למשתמש שצויןcontentColor
. הפתרון הזמני הוא להגדיר במפורש אתdisabledContentColor
. נפתור את הבעיה הזו במהדורה הבאה.
שינויים ב-API
- הוספת האפשרות להפעיל חצים של תיאורי כלים לממשקי API רגילים של
Tooltip
. (Ibf767) - השמות של
SwipeToDismissState
,rememberSwipeToDismiss
וגםSwipeToDismissValue
שונו ל-_SwipeToDismissBox_
. (I68d6d)
תיקוני באגים
- תוקן ערך הריפוד בסוף
ListItem
כדי להתאים למפרט. (Ibd68b, b/305342674) - צבע המתאר של כרטיס עם מתאר ממופה עכשיו בצורה נכונה ל-
OutlineVariant
. (I75480, b/310979715) - הצבע הדינמי נלקח עכשיו מתפקידי צבע שהוגדרו במערכת. השינוי הזה משפר את הניגודיות של תוכן נגיש, ומתאים יותר את הצבע הדינמי למפרט של Material. (I1de96)
- תוקן הטיפול בלחצן
ModalBottomSheet
חזרה ב-Android T/13 ומעלה כשמשתמשים ב-android:enableOnBackInvokedCallback="true"
. (I728dc, b/306196110)
גרסה 1.2.0-beta01
13 בדצמבר 2023
androidx.compose.material3:material3-*:1.2.0-beta01
משוחרר. גרסה 1.2.0-beta01 מכילה את הקומיטים האלה.
שינויים ב-API
- סימון של
TabIndicatorScope
כניסיוני. (I45c88) - הסרה של ממשקי API ניסיוניים שהוצאו משימוש עבור תיאור הכלים. (I438cb)
- לשנות עומסים חדשים של
TabRow
כך שלא ישתמשו בהרכבות משנה. כתוצאה מכך, יש דרך אחרת ליצור את האינדיקטוריםTabRow
באמצעות משנים מותאמים אישית. (Ife741) - הוצאה משימוש של ממשקי ה-API
DismissDirection
ו-DismissValue
. הן אוחדו ל-SwipeToDismissValue
, שהערכים שלו מציינים גם את המיקום וגם את הכיוון שלSwipeToDismissBox
. הערךDismissState.progress
מסומן עכשיו כFloatRange
בין0.0
לבין1.0
. הפונקציותDismissState
deprecated Saver ו-Constructor הוסרו. הרכיבSwipeToDismiss
, האובייקט state והאובייקט defaults סומנו מחדש כניסיוניים. (Ib54f2)
תיקוני באגים
- האינדיקטור שמוגדר כברירת מחדל ל-
PullToRefresh
הוא עכשיו חץ פתוח במקום משולש מלא. (I67be3)
גרסה 1.2.0-alpha12
29 בנובמבר 2023
androidx.compose.material3:material3-*:1.2.0-alpha12
משוחרר. גרסה 1.2.0-alpha12 מכילה את הקומיטים האלה.
שינויים ב-API
-
RangeSlider
מקבל עכשיו טווח Kotlin (למשל,0f..1f
) במקום מחלקה של ערךFloatRange
בהתאמה אישית. ב-SnapFlingBehavior.kt
נעשה עכשיו שימוש גם בטווח Kotlin. (I025cb) - מסמנים פונקציות ליצירת משני סימון כ-
@Stable
. (Ib109f)
גרסה 1.2.0-alpha11
15 בנובמבר 2023
androidx.compose.material3:material3-*:1.2.0-alpha11
משוחרר. גרסה 1.2.0-alpha11 מכילה את הקומיטים האלה.
תכונות חדשות
- הטמעה של
PullToRefreshContainer
ושלPullToRefreshState
, שביחד מספקים הטמעה של משיכה לרענון ב-Material3. (I16456, b/261760718)
שינויים ב-API
- מסמנים את
SwipeToDismissBox
DismissDirection
ואתDismissValue
כניסויים. (I517b0) - שינוי השם של
SwipeToDismiss
לSwipeToDismissBox
. משנים את השם שלbackground
ל-backgroundContent
ואת השם שלdismissContent
ל-content
lambda. (I7f4d3) - מגדירים את ה-constructor של
ChipElevation
ושלSelectableChipElevation
כ-public. (Ie0c48, b/308432421) - מתבצעת הוספה של
ModalBottomSheetProperties
. מתבצעת העברה שלsecurePolicy
אלModalBottomSheetProperties
. הוספה שלisFocusable
ו-shouldDismissOnBackPress
אלModalBottomSheetProperties
. הערכים הבוליאניים החדשים האלה עוזרים לקבוע איך גיליון תחתון של חלון קופץ צריך לטפל באירועי IME. (Iea56f, b/278216859) - עדכנו את המצבים
RangeSlider
ו-Slider
כדי להסיר אתinitialOnValueChange
, הקידומות הראשוניות ומסמכי ה-kdoc המתאימים. (I57d30) - הוצאה משימוש של המחלקה
ChipBorder
והבקשות המשויכות להפעלת פונקציות, והמלצה להשתמש ישירות ב-BorderStroke
במקום זאת. (I89cc2) - ממשקי ה-API של Foundation Tooltip נקראים עכשיו
@ExperimentalFoundationApi
. (I30b0b) - המאפיינים
TabRow
ו-ScrollableTabRow
כבר לא מוצאים משימוש. הווריאנטים החדשים 'ראשי' ו'משני' מסומנים כניסיוניים. (I0def6) - הצ'יפים של המסננים והקלט משתמשים עכשיו ישירות ב-
BorderStroke
. (I07a8d) - הבית
SegmentedButton
משתמש עכשיו ב-BorderStroke
ישירות. (I89b9b) - שינינו את השם של הפונקציה הכללית
AlertDialog
ל-BasicAlertDialog
והוצאנו משימוש את הפונקציה הקודמת. (Idbe52) - שינוי השם של ממשקי
SwipeToDismiss
API ל-SwipeDismiss
, והעברת ממשקיSwipeDismiss
API החדשים למצב יציב. (I14cbe) - הוספת
tonalElevation
וshadowElevation
לממשקי API של תיאורי כלים. בנוסף, אנחנו מעבירים את ממשקי ה-APITooltipBox
,PlainTooltip
ו-RichTooltip
בחזרה למצב ניסיוני, כי הם שוחררו בטעות כגרסאות יציבות. (If0f66, b/293939035) - קידום של ממשקי API ניסיוניים של שבבים לגרסה יציבה. (Iea2c3)
- הוסרה ההערה
@ExperimentalMaterial3Api
מהכרטיסים הניתנים ללחיצה של Material3. (I88dbf)
תיקוני באגים
- תוקנה בעיה שגרמה לקריסה של
SwipeToDismiss
בתרחישים מסוימים עם פריסות Lookahead ו-Lazy מקוננות. (Ica8d1, b/297226562)
גרסה 1.2.0-alpha10
18 באוקטובר 2023
androidx.compose.material3:material3-*:1.2.0-alpha10
משוחרר. גרסה 1.2.0-alpha10 מכילה את הקומיטים האלה.
שינויים ב-API
- קידום של
Badge
ו-BadgedBox
לגרסה יציבה. (I67f16, b/261565132) - הוספת
securePolicy
כפרמטר ל-ModalBottomSheet
, כדי שהמשתמשים יוכלו להגדיר את ההתנהגות שלWindowManager.LayoutParams.FLAG_SECURE
. (Icdac8, b/296250262) - נוספו עומסים חדשים של
LinearProgressIndicator
ו-CircularProgressIndicator
שמקבליםprogress
כביטוי למדה. הגרסאות האלה אמורות להיות יעילות יותר מהגרסאות הקודמות. (I824e6, b/295616656) - שינוי השם של
StandardSizeClasses
ל-AllSizeClasses
. (I8cb07) - שילוב של פונקציות חישוב של מחלקות גודל חלון. (Iad935)
תיקוני באגים
- תוקנה בעיה שגרמה לקריסה
DatePicker
כשלוחצים במהירות על לחצני החצים לניווט כשהחודש שמוצג נמצא בקצה של טווח השנים המותר. (I46f36, b/290954897, b/297002119) - [סרגל ניווט] תמיכה בצבע שקוף לאינדיקטור. (Ie0a9b, b/267289987)
גרסה 1.2.0-alpha09
4 באוקטובר 2023
androidx.compose.material3:material3-*:1.2.0-alpha09
משוחרר. גרסה 1.2.0-alpha09 מכילה את הקומיטים האלה.
שינויים ב-API
- העברנו את
ModalNavigationDrawer
ו-DismissibleNavigationDrawer
לשימוש בממשקי API חדשים שלAnchoredDraggable
. המאפייןanimateTo
שלDrawerState
הוחלף בשיטות open ו-close, וההיסט נחשף עכשיו כערך מסוג float במקום כאובייקט מצב. אפשר לגשת להיסט ישירות דרךcurrentOffset
. (I0a72c) - נוספו פונקציות לא מורכבות ליצירה ישירה של
DatePickerState
ושלDateRangePickerState
. אפשר להשתמש בפונקציות האלה כחלופה לפונקציות ComposablerememberDatePickerState
ו-rememberDateRangePickerState
כשצריך. (I70326, b/291524052) - לסוגי המודעות 'קבועה' ו'ניתנת לגלילה'
TabRows
יש עכשיו וריאציות ראשיות ומשניות. הם ממופים בצורה נכונה להתנהגות הצבע והאינדיקטור כפי שמוגדר ב-Material3. -
PrimaryScrollableTabRow
ו-SecondaryScrollableTabRow
חושפים עכשיו את מצב הגלילה. (Iec8f5, b/260572337) - הוספת פרמטר חדש,
sheetMaxWidth
, שמפתחים יכולים להגדיר כדי לציין רוחב מקסימלי שהגיליון יתפרס על פניו. אפשר להעביר את הערך Dp.Unspecified לפרמטר אם רוצים גיליון שמשתרע על כל רוחב המסך. (Ifb7c9, b/266697696) - הוספנו בחזרה את ממשקי ה-API
PlainTooltipBox
ו-RichTooltipBox
כשיטות שיצאו משימוש. (I246fa)
תיקוני באגים
- תוקן קראש שמתרחש כשמאתחלים את
DatePicker
עםDatePickerFormatter
שיש לו תבניות תאריכים מסוימות שנשארות זהות כשממירים אותן לתבניות תאריכים (כמו YY). (I01f29)
גרסה 1.2.0-alpha08
20 בספטמבר 2023
androidx.compose.material3:material3-*:1.2.0-alpha08
משוחרר. גרסה 1.2.0-alpha08 מכילה את הקומיטים האלה.
שינוי בהתנהגות
-
ColorScheme
הוא עכשיו Immutable, ולכן עדכונים של צבעים בודדים פחות יעילים, אבל שימוש נפוץ יותר בצבעים יעיל יותר. הסיבה לשינוי הזה היא שברוב האפליקציות, עדכון של צבעים ספציפיים לא נחשב לתרחיש שימוש עיקרי. האפשרות הזו עדיין קיימת, אבל היא תרכיב מחדש יותר מבעבר. כתוצאה מכך, נצמצם באופן משמעותי את מספר המינויים למצבים בכל קוד Material, וזה ישפיע על עלות האתחול וזמן הריצה של תרחישי שימוש סטנדרטיים יותר. (Ic447d, b/297212873) - ההנפשה של הגבהה טונלית במצבי אינטראקציה שונים לא תואמת יותר למפרט. (Icdd12)
שינויים ב-API
- נוספה
BottomAppBar
חדשה שמקבלת כפרמטרBottomAppBarScrollBehavior
כדי להסתיר אותו אוטומטית כשמגללים את התוכן. בנוסף, הוספנוFabPosition.EndOverlay
אפשרות להצגת ה-FAB כשכבת-על על סרגל האפליקציות התחתון ב-scaffold, במקום להצגה מעליו. (Iecb47) - נוסף רכיב Label פשוט שמבוסס על
BasicTooltipBox
ולא נסגר כשמקישים מחוץ לגבולות התווית. (I821f9)
תיקוני באגים
- הוסר השימוש ב-
rememberSaveable
להצגת הסברים קצרים. (Icc131, b/299500338) - הוספנו דגל זמני כדי לקבוע אם רכיב Scaffold ימדוד את הצאצאים שלו במהלך המדידה או במהלך המיקום. כברירת מחדל, המדידה תתבצע במדידה. אם נתקלתם בבעיות בהתנהגות החדשה, אתם יכולים לדווח על בעיה. (I0b354)
- מודעה אופקית קבועה מקצה לקצה ב-
BottomSheet
באמצעות המידה הנכונה של רוחב המסך במכשיר. (I1df0c, b/299058752) - תוקן באג שגרם לכך ש-
ModalBottomSheet
לא הפעיל אתonDismissedRequest
כשסגרתם אותו בהחלקה כלפי מטה בגיליון. (Idfdd8)
גרסה 1.2.0-alpha07
6 בספטמבר 2023
androidx.compose.material3:material3-*:1.2.0-alpha07
משוחרר. גרסה 1.2.0-alpha07 מכילה את הקומיטים האלה.
תכונות חדשות
- נוספה תמיכה בסמלים עם שיקוף אוטומטי בגרסה
compose material 1.6.0-alpha05
. פרטים על סמלים עם שיקוף אוטומטי מופיעים בהערות על הגרסה.
שינויים ב-API
-
SliderState
implementsDraggableState
(I9b116) - שינוי הצורה לפרמטר חובה. משנים את השם של
position
ל-index
בפונקציית העזר של הצורה. (I34941) - מעדכן את
DatePicker
formatWithSkeleton
כך שיכלול מפה שמשמשת כמטמון לשיפור הביצועים. (I3195f) - הוספנו את
BasicTooltipBox
ל-compose.foundation
ועדכנו אתPlainTooltipBox
ואתRichTooltipBox
כך שישתמשו ב-TooltipBox
עם רכיביPlainTooltip
ו-RichTooltip
חדשים שניתנים להרכבה. (I79e1d)
תיקוני באגים
- הפונקציות
dynamicLightColorScheme
ו-dynamicDarkColorScheme
מחזירות עכשיו צבעים עם כרומה גבוהה יותר לתפקידים של surface ו-surfaceContainer
. (I5e901) - תוקנה בעיה שבה חלק מהרכיבים שמשתמשים ב-Subcomposition (למשל
BottomSheetScaffold
) בתוך Scaffold בתוךLookaheadScope
ניסו לקרוא את הגודל שלהם מוקדם מדי. (I297b4, I871f1, b/295536718)
גרסה 1.2.0-alpha06
23 באוגוסט 2023
androidx.compose.material3:material3-*:1.2.0-alpha06
משוחרר. גרסה 1.2.0-alpha06 מכילה את הקומיטים האלה.
תיקוני באגים
- תוקן החישוב של
DropdownMenu
offset
כך שהיסטים של x תלויים רק בכיוון הפריסה המקומי, והיסטים של y לא יתהפכו יותר כשהתפריט קרוב לחלק התחתון של המסך. (Iccc74, b/294103942) - תוקן החישוב של
DropdownMenu
offset
כך שהיסטים של x תלויים רק בכיוון הפריסה המקומי, והיסטים של y לא יתהפכו יותר כשהתפריט קרוב לחלק התחתון של המסך. (Ib87a2, b/294103942)
גרסה 1.2.0-alpha05
9 באוגוסט 2023
androidx.compose.material3:material3-*:1.2.0-alpha05
משוחרר. גרסה 1.2.0-alpha05 מכילה את הקומיטים האלה.
שינויים ב-API
- עדכונים לתיבת הסימון ולצבעים
TriStateCheckbox
. ההגדרהCheckboxDefaults.colors()
disabledUncheckedColor
משפיעה עכשיו רק על הגבול של תיבת הסימון. במקרים מיוחדים שבהם צריך להגדיר את הצבע הפנימי של התיבה כשהיא מושבתת ולא מסומנת, צריך ליצור מופע מותאם אישית שלCheckboxColors
עם ערכי הצבע הרצויים. (I77d17, b/291943198)
גרסה 1.2.0-alpha04
26 ביולי 2023
androidx.compose.material3:material3-*:1.2.0-alpha04
משוחרר. גרסה 1.2.0-alpha04 מכילה את הקומיטים האלה.
תכונות חדשות
- Experimental Segmented Button API (Ifc8fb)
- עכשיו יש למחיצות פרמטר לשליטה בכיוון, כדי לתמוך במחיצות אנכיות. (I4c899, b/288438593)
שינויים ב-API
- אנחנו מעבירים את התלות בצפיפות לרמת הרכיב. ההמלצה הזו רלוונטית לרכיבים הבאים:
SwipeToDismiss
ורכיבים שמבוססים על גיליון. צריך להשתמש בעומס החדש שצוין, שבו הצפיפות היא פרמטר. (I1846e) - הערות נוספות לציון קלט מותר לרכיבים הניתנים להרכבה (Ief234)
- הוספת פרמטר של סמל ללחצן מפולח, פיצול הסמנטיקה כך שניתן לבחור לחצנים מפולחים כדי להטמיע בחירה יחידה, וניתן להפעיל או להשבית אותם כדי להטמיע בחירה מרובה, עם
SelectableSegmentedButtonRow
ו-ToggelableSegmentedButtonRow
בהתאמה. (I38740) - השם של הקו המפריד שונה ל-
HorizontalDivider
. נוספה פונקציונליותVerticalDivider
. (I5975c) - כדי למזער את ההמרה האוטומטית של ערכים פרימיטיביים לאובייקטים (autoboxing), צריך לשנות את השימוש ב-
ClosedFloatingPointRange
ל-FloatRange
הקל יותר בממשקי API ניסיוניים של Material3. (I4aab5) - נוספה אפשרות חדשה ליישור התחלתי עבור
FabPosition
(Ib7aea, b/170592777)
תיקוני באגים
ModalBottomSheet
מכבד את כיוון הפריסה המקומי. (Ib4f44, b/285628622)
גרסה 1.2.0-alpha03
21 ביוני 2023
androidx.compose.material3:material3-*:1.2.0-alpha03
משוחרר. גרסה 1.2.0-alpha03 מכילה את הקומיטים האלה.
שינויים בהתנהגות
- הגופן
includeFontPadding
מוגדר עכשיו כברירת מחדל כ-false
בטיפוגרפיה של Material 3. גם סגנון גובה השורה שמוגדר כברירת מחדל השתנה ל-Trim.None
ו-Alignment.Center
, והערךlineHeight
(ב-sp) נוסף ל-TextStyle
שלTypography
. אם רוצים להתאים אישית את הערכים האלה, אפשר לעיין במסמכי ה-API. בפוסט הזה בבלוג מוסבר לעומק על השינויים האלה. (I6266f, Icabc3)
תכונות חדשות
- נוסף עומס יתר ל-
RangeSlider
שהוא גרסה עם שמירת מצב של הרכיב. נוצרRangeSliderState
שמכיל את כל המידע על הרצועה הפעילה הנוכחית, את המדידות של הרכיבים שלRangeSlider
ואת הלוגיקה של הגרירה והמחוות. (I8c270) - סרגל החיפוש תומך עכשיו בהצללות באמצעות הפרמטר
shadowElevation
שנוסף לאחרונה. (Ia5369, b/271040353) ColorScheme
תומך עכשיו בתפקידים חדשים שלSurfaceContainer
.- עכשיו אפשר להשבית את שכבת העל של הגבהה טונאלית של פני השטח באמצעות
LocalTonalElevationEnabled
composition local. (Ic203c, b/277774590)
שינויים ב-API
- פותחים את הקונסטרוקטורים של צבעי הרכיבים. (I8c4a6)
- הוספנו פרמטר שאפשר להתמקד בו לשני ממשקי ה-API של תיאורי הכלים, כדי שמפתחים יוכלו להגדיר אם תיאור הכלי יצרוך אירועי מגע או לא. חשוב לזכור שהפעולה הזו עלולה לשבש את המעבר האוטומטי בין רכיבי הנגישות. (Ie32d8)
- נגישות אופטימלית לביצועים ולהקצאות זיכרון. (Iede48)
- חשיפת
DefaultSizeClasses
ויצירתStandardSizeClasses
עבורWindowSizeClasses
(I91838) - שינוי
WindowWidth/HeightSizeClass
למחלקות של ערכי float (Ie686e)
תיקוני באגים
- הפרמטר
contentWindowInsets
של Scaffold מתחשב עכשיו ב-window insets שנצרכו. שימו לב: אם מציינים את הפרמטריםtopBar
ו-bottomBar
, אופן ההתנהלות של ריווח התוכן לא משתנה. (I08b73, b/264601542) - מתקנים את היישור של סרגל האפליקציות העליון המרכזי כדי לוודא שכותרת ארוכה לא מוצגת מעל סמלי הפעולות או סמל הניווט. (I4369f, b/236994621)
- המיקומים של הכרטיסיות אוכפים עכשיו רוחב תוכן מינימלי של 24dp. כך מספקים יעד נגיש למגע עבור אינדיקטורים של כרטיסיות. (Id8861)
- לוחות צבעים דינמיים מ-
dynamicLightColorScheme
ומ-dynamicDarkColorScheme
תומכים עכשיו בתפקידים חדשים של פלטפורמות. (I1252e) - עדכון היישור של התראות התגים כך שלא ייחתכו כשהן מתנגשות עם סבא או סבתא רבא. (Idf75a)
גרסה 1.2.0-alpha02
24 במאי 2023
androidx.compose.material3:material3-*:1.2.0-alpha02
משוחרר. גרסה 1.2.0-alpha02 מכילה את הקומיטים האלה.
שינויים ב-API
- מוסיפים את הפרמטר window insets ל-
ModalBottomSheet
.- המסך החצי שקוף של
ModalBottomSheet
יכול להיות מוצג מאחורי שורת הסטטוס אם הערך שלwindowInsets
מוגדר לאפס - עדכנו את פונקציונליות ברירת המחדל של
ModalBottomSheet
כך שהיא לא תכלול את סרגלי המערכת, כולל הניווט - במצב 'מקצה לקצה', הטיפול בהזחה של שורת הסטטוס מתבצע באמצעות ידית הגרירה.
-
BottomSheetDefaults
כולל שוליים פנימיים של חלונות ל-BottomSheetWindow
. (I31200, b/274872542, b/272973615, b/272334475, b/268432129, b/275849044, b/275486106, b/268433162)
- המסך החצי שקוף של
- הוצאה משימוש של
Indicator
והוספה שלPrimary
/SecondaryIndicator
בהתאם למפרט של M3. האפשרותPrimaryIndicator
מתאימה לרוחב התוכן של הכרטיסייה, ואילו האפשרותSecondaryIndicator
מתאימה לרוחב המלא שזמין. הפונקציהSecondaryIndicator
שוות ערך לפונקציהIndicator
שהוצאה משימוש, ויכולה להחליף אותה ישירות. (I27604) - נוספה אפשרות להעביר
ScrollState
כשיוצריםDropdownMenu
אוExposedDropdownMenu
כדי לשלוט במצב הגלילה האנכית של הפריטים שמוצגים בתפריט. (Ia0734, b/185304441) - נוסף עומס יתר ל-
Slider
שהוא גרסה עם שמירת מצב של הרכיב. נוצרSliderState
שמכיל את כל המידע על הרצועה הפעילה הנוכחית, את המדידות של הרכיבים שלSlider
ואת הלוגיקה של הגרירה והמחוות. (I124a5) - שינוי השם של מאפיין הסמנטיקה
isContainer
ל-isTraversalGroup
(I121f6) - הוספנו את
TextStyle.merge(...)
שעבר אופטימיזציה עם רשימה מלאה של פרמטרים. (Iad234, b/246961787) - יצרנו ממשקי API ציבוריים ל-
TooltipState
, ל-RichTooltipState
ול-PlainTooltipState
. נוספוRichTooltipStateImpl
וPlainTooltipStateImpl
למצבי ברירת מחדל. נוספו פונקציותremember*State
כדי לקבל את המצבים המיושמים האלה. הוסרTooltipSync
לטובתTooltipDefault.GlobalMutatorMutex
. (I7813d) - עדכנו את
DatePickerColors
כך שיכלול אפשרויות נוספות להתאמה אישית של המפריד בבוחר התאריכים, הניווט והצבעים של שדות הזנת הטקסט. (I1a685, b/274626815) -
DatePickerState
ו-DateRangePickerState
הם עכשיו ממשקים ציבוריים עם הטמעות ברירת מחדל שאפשר לאחזר באמצעותrememberDatePickerState
ו-rememberDateRangePickerState
. (I71c52) - הסרנו את
dateValidator
מ-DatePicker
ומ-DateRangePicker
והוספנו ממשקSelectableDates
שאפשר להגדיר במצב כדי לשלוט באילו תאריכים או שנים אפשר לבחור בממשק המשתמש. (Ic2fc6) - הוסר מ-API יציב, צפויים שינויים נוספים ב-API של המצב (I3f39a)
TimePicker
ModalBottomSheet
עברה ל-Android בלבד. לא מומלץ להשתמש ב-ModalBottomSheet
במחשב, והפונקציונליות לא מתוחזקת באופן פעיל. (Ib3778)
תיקוני באגים
- תוקנה
AlertDialog
פעולת הסגירה כך שתופיע מתחת לפעולת האישור כשהפעולות מוערמות זו על גבי זו כדי להתאים לרוחב של תיבת הדו-שיח. התיקון הזה מתאים את ההטמעה למפרט של Material Design. (I029de, b/235454277) - תוקן באג ב-
ListItem
שגרם לשימוש בריווח שגוי בשלושה פריטים. (I6e235) -
ModalBottomSheet
יכולה להציג עכשיו מקלדת IME (מספרים Idc508, b/262140644, b/268380384, b/272483584)
גרסה 1.2.0-alpha01
10 במאי 2023
הגרסאות androidx.compose.material3:material3:1.2.0-alpha01
ו-androidx.compose.material3:material3-window-size-class:1.2.0-alpha01
יוצאות לאור. גרסה 1.2.0-alpha01 מכילה את הקומיטים האלה.
גרסה 1.1
גרסה 1.1.2
20 בספטמבר 2023
הגרסאות androidx.compose.material3:material3:1.1.2
ו-androidx.compose.material3:material3-window-size-class:1.1.2
יוצאות לאור. גרסה 1.1.2 מכילה את הקומיטים האלה.
תיקוני באגים
- תוקנה הבעיה שבה שינוי הועבר באופן שגוי לשני רכיבים הניתנים להרכבה. (b/282761472)
- הפונקציה
TimePickerState
מחזירה שעות שגויות כשהיא מאותחלת עם 23 שעות. (b/278242122) - תוקן מצב ההפעלה הראשוני של המתג לאימות של שעה ודקה. (b/269768197, b/282790635)
- תוקנה בעיה שבה
state.hour
החזיר ערך שגוי לשעה 23:00. (b/282761472, b/278242122)
גרסה 1.1.1
21 ביוני 2023
הגרסאות androidx.compose.material3:material3:1.1.1
ו-androidx.compose.material3:material3-window-size-class:1.1.1
יוצאות לאור. גרסה 1.1.1 מכילה את הקומיטים האלה.
תיקוני באגים
- מוסיף קריאה ל-
ModalBottomSheet
בלי הפרמטרwindowInset
לצורך תאימות בינארית. (Ib7959) - מוסיפים את הפרמטר window insets ל-
ModalBottomSheet
.- המסך החצי שקוף של
ModalBottomSheet
יכול להיות מוצג מאחורי שורת הסטטוס אם הערך שלwindowInsets
מוגדר לאפס - עדכנו את פונקציונליות ברירת המחדל של
ModalBottomSheet
כך שהיא לא תכלול את סרגלי המערכת, כולל הניווט - במצב 'מקצה לקצה', הטיפול בהזחה של שורת הסטטוס מתבצע באמצעות ידית הגרירה.
-
BottomSheetDefaults
כולל שוליים פנימיים של חלונות ל-BottomSheetWindow
. (I31200, b/274872542, b/272973615, b/272334475, b/268432129, b/275849044, b/275486106, b/268433162)
- המסך החצי שקוף של
גרסה 1.1.0
10 במאי 2023
הגרסאות androidx.compose.material3:material3:1.1.0
ו-androidx.compose.material3:material3-window-size-class:1.1.0
יוצאות לאור. גרסה 1.1.0 מכילה את הקומיטים האלה.
התכונות העיקריות בגרסה 1.1.0
רכיבים חדשים של Material Design 3
שיפורים ברכיבים קיימים של Material Design 3.
ממשקי API ניסיוניים קודמו לגרסה יציבה!
פרטים נוספים זמינים בפוסט הזה בבלוג.
גרסה 1.1.0-rc01
19 באפריל 2023
הגרסאות androidx.compose.material3:material3:1.1.0-rc01
ו-androidx.compose.material3:material3-window-size-class:1.1.0-rc01
יוצאות לאור. גרסה 1.1.0-rc01 כוללת את הקומיטים האלה.
שינויים ב-API
- הוסר מ-API יציב, צפויים שינויים נוספים ב-API של המצב (I3f39a)
TimePicker
ModalBottomSheet
עברה ל-Android בלבד. לא מומלץ להשתמש ב-ModalBottomSheet
במחשב, והפונקציונליות לא מתוחזקת באופן פעיל. (Ib3778)
גרסה 1.1.0-beta02
5 באפריל 2023
הגרסאות androidx.compose.material3:material3:1.1.0-beta02
ו-androidx.compose.material3:material3-window-size-class:1.1.0-beta02
יוצאות לאור. גרסה 1.1.0-beta02 מכילה את הקומיטים האלה.
שינויים ב-API
- לפרמטר
SheetState
יש עכשיו ערך אופציונליskipHiddenState
- לפרמטר
rememberStandardBottomSheetState
יש עכשיו ערך אופציונליskipHiddenState
- לתג
BottomSheetScaffold
יש עכשיו עוגן מוסתר מוגדר, אבל הוא מושבת כברירת מחדל - התיעוד של
SheetState.requireOffset
עודכן - השם של
BottomSheetDefaults.MinimizedShape
השתנה לBottomSheetDefaults.HiddenShape
(I839f4, b/273870234)
תיקוני באגים
- לא להחליף את לוח השעון משעה לדקה כשהתכונה 'גילוי באמצעות מגע' מופעלת. (I717d0)
- הסמנטיקה של נקודות האחיזה לגרירה
ModalBottomSheet
ו-BottomSheetScaffold
מוזגה עכשיו. (I05afb) - הפרמטרים
BottomSheetScaffold
,containerColor
ו-contentColor
משפיעים עכשיו רק על התוכן. (I992cb) BottomSheetScaffold nestedScroll
לתוכן של גיליון אלקטרוני יש עכשיו אפשרות להטלה. (I992cb)
גרסה 1.1.0-beta01
22 במרץ 2023
הגרסאות androidx.compose.material3:material3:1.1.0-beta01
ו-androidx.compose.material3:material3-window-size-class:1.1.0-beta01
יוצאות לאור. גרסה 1.1.0-beta01 מכילה את הקומיטים האלה.
שינויים ב-API
- מוסיפים פרמטר של סוג פריסה ל-
TimePicker
composable. הוא מאפשר להשתמש בפריסות שונות, בהתאם לתצורת המסך (Ia0e16) SearchBarDefaults
סומן כניסיוני. (I65561)- נוספה הגבהה של הצל ל-
BottomSheetScaffold
(I94e0f) - נוספה תמיכה בהצגת בוררי התאריכים ללא חלק הכותרת. שינויים ב-API כדי לאפשר העברה של כותרת null כשיוצרים כלי לבחירת תאריך. מעכשיו אפשר להעביר כותרת, שם ו-
showToggleMode = false
עם הערך null כדי להציג כלי לבחירת תמונות ללא כותרת. (Id3f3a, b/266132421, b/267194809)
תיקוני באגים
- סרגלי החיפוש מפסיקים להתמקד באופן אוטומטי כשהם לא פעילים. (I22a7c, b/261444487)
- עדכנו את
DateRangePicker
כדי לאפשר בחירת טווח עם אותו תאריך להתחלה ולסיום. (I16529, b/272882497) - שדות טקסט ממקמים עכשיו את רכיבי הטקסט שלהם בצורה נכונה כשגודל הגופן קטן מהצפוי. יכול להיות שיהיה שינוי של כמה פיקסלים באפליקציות, בהתאם להגדרות הגופן ולסקריפט. (I8b8d0)
- לפעולות סמנטיות בגיליון התחתון יש עכשיו תוויות. (I277b0)
גרסה 1.1.0-alpha08
8 במרץ 2023
הגרסאות androidx.compose.material3:material3:1.1.0-alpha08
ו-androidx.compose.material3:material3-window-size-class:1.1.0-alpha08
יוצאות לאור. גרסה 1.1.0-alpha08 מכילה את הקומיטים האלה.
תכונות חדשות
- הוספנו תמיכה ב-
BottomSheetScaffold
וב-BottomSheetScaffoldState
. (I063d4)
שינויים ב-API
- נוספה פונקציונליות ל-
DatePickerState
ול-DateRangePickerState
שמאפשרת להגדיר תאריכים אחרי היצירה הראשונית של המצב, וגם לאפס את הבחירות על ידי הגדרת חותמות זמן של null. צריך להיזהר כשמגדירים תאריכים באופן ידני, והפונקציה החדשהsetSelection
תציג חריגה אם תאריך שסופק לא יעמוד בתנאי מוקדם (ראו תיעוד). (Ifa645, b/268609314, b/270427389) - שינינו את השם של Collapsed
SheetValue
ל-PartiallyExpanded
כדי לתאר בצורה מדויקת וגמישה יותר את ההתנהגות במצב הזה. (Ia1491) - השמות של הפרמטרים
ListItem
עודכנו ל-_content במקום _text. הפונקציות לקבלת ערכי ברירת מחדל הן עכשיוReadOnlyComposables
במקומות הרלוונטיים. (I69a25) - העברת ממשקי API אינטראקטיביים של Surface מניסיוניים לזמינים. (I90d59, b/261561812)
תיקוני באגים
- תוקנה בעיה שבה המצב של
ModalBottomSheet
HalfExpanded
חושב בצורה שגויה והגיליון נראה כאילו הוא צף. (I45e84, b/268411386) - הוספת סימן וי
confirmValueChange
להקשה על מסך ההסתרה עבורModalBottomSheet
. (I2311a, b/270425759) - העברת פעולות סמנטיות
BottomSheet
לנקודת אחיזה לגרירה. (I158ba) ModalBottomSheet
עכשיו הפוקוס מוגדר על ההפעלה, והאפליקציה מטפלת בכפתור 'הקודם'. (I4d2ab)- האפשרות
ModalBottomSheet onDismissRequest
מטופלת עכשיו גם במהלך גלילה מהירה מקונטיינר אחד לקונטיינר אחר. (I655c5, b/268433166)
גרסה 1.1.0-alpha07
22 בפברואר 2023
הגרסאות androidx.compose.material3:material3:1.1.0-alpha07
ו-androidx.compose.material3:material3-window-size-class:1.1.0-alpha07
יוצאות לאור. גרסה 1.1.0-alpha07 מכילה את הקומיטים האלה.
תכונות חדשות
- הוספת רכיב Time Input שאפשר להשתמש בו עם
rememberTimePickerState()
, בהתאם למפרט M3 של Time Input (Ia4fab) - נוסף API של Material 3
DateRangePicker
לבחירת טווח תאריכים. (I7a6c3, b/267194809) - הוספנו תמיכה במצב קלט של Material 3 לבחירת טווחי תאריכים באמצעות
DateRangePicker
API. (Ifdbc4) - עכשיו אפשר להתאים אישית את הצבעים של שדות הטקסט:
- צבעי שדה הקלט וטקסט ה-placeholder בהתאם למצב המיקוד ולמצב השגיאה. הפרמטר
textColor
נקרא עכשיוunfocusedTextColor
, והפרמטרplaceholderColor
נקרא עכשיוunfocusedPlaceholderColor
. - צבע המאגר של שדות טקסט מלאים על סמך מצב השגיאה עם הפרמטר
errorContainerColor
החדש.
- צבעי שדה הקלט וטקסט ה-placeholder בהתאם למצב המיקוד ולמצב השגיאה. הפרמטר
- הצבעים של שדה הטקסט בתפריט הנפתח שמוצג עודכנו עם פרמטרים לתמיכה ב-API החדש של הקידומת והסיומת. (I9c8b4, b/254284181, b/264766350)
שינויים ב-API
- ביטלנו את השימוש בכמה גרסאות של Slider API והסרנו עומסים מיותרים של Slider, שכלולים ב-Slider הניסיוני החדש עם נקודת אחיזה ומסלול בהתאמה אישית. העלאת
RangeSlider
לדרגת יציבות. (Ie8fbd) - השם של
defaultElevation
שונה ל-elevation
בפונקציות של הצ'יפ לחישוב גובה. (I0f872) - ה-API הבאים של שדות טקסט ב-Material 3 כבר לא ניסיוניים:
TextField
, OutlinedTextField
, textFieldWithLabelPadding
, textFieldWithoutLabelPadding
, outlinedTextFieldPadding
. (Ieb5c0, b/261561819) -
TimePickers
is24Hour
משתמש בהגדרת המערכת (I18856) - הוסרה הערה ניסיונית מממשקי API של scaffold. (Ibb51e, b/261565765, b/261436953)
תיקוני באגים
- צורת ברירת המחדל
ModalBottomSheet
היא עכשיו תמידSheetDefaults.ExpandedShape
. (I0dfca) - שיפורים בנגישות של Material 3
DatePicker
ושלDateRangePicker
. (I5087e) - תוקן באג שבו מגבלת הגובה המקסימלי מועברת ויכולה לגרום לקריסה. (I30d8c)
- הוסרו תפקידים סמנטיים ממשטחים שאפשר ללחוץ עליהם ולבחור אותם, ורכיבים שעשו בהם שימוש עודכנו כדי להגדיר תפקידים באמצעות modifier.semantics (I793d9)
גרסה 1.1.0-alpha06
8 בפברואר 2023
הגרסאות androidx.compose.material3:material3:1.1.0-alpha06
ו-androidx.compose.material3:material3-window-size-class:1.1.0-alpha06
יוצאות לאור. גרסה 1.1.0-alpha06 מכילה את הקומיטים האלה.
תכונות חדשות
- שדות טקסט תומכים עכשיו בטקסט של קידומת וסיומת (Ia8578, b/179884561)
- נוספה פונקציה
TimePicker
להצגת כלי לבחירת שעה בהתאם למפרט Material 3, לשימוש בשילוב עםTimePickerState
ושיטת נוחותrememberTimePickerState
(I71910) - קלט תאריך הוא עכשיו מצב תצוגה ב-
DatePicker
. הוספנו תמיכה במעבר בין מצב של בחירת תאריך לבין מצב של הזנת תאריך. (Ieeff7) - הוספנו API ל-
RichTextTooltips
. (I58ef3) - הטמעה של גיליון תחתון מודלי ב-Material 3, כולל
ModalBottomSheet
ו-ModalBottomSheetDefaults
. בנוסף, נוספוSheetState
ו-rememberSheetState
שאפשר להשתמש בהם בעתיד ברכיבי גיליון. (I0853a, b/244189383)
שינויים ב-API
- ייצוב API
showSnackbar
(I195c2, b/261424370) - ייצוב ממשקי ה-API של צ'יפ העזרה וצ'יפ ההצעה (Ibb67b, b/261424370)
- העברת ממשקי ה-API
ListItem
,ListItemDefaults
ו-ListItemColors
לסטטוס לא ניסיוני (I7e7fa, b/261438882) - קידום של ממשקי ה-API
SliderPositions
, SliderDefaults.Thumb
ו-SliderDefaults.Track
לגרסה יציבה, והוספה של ממשקי ה-APISlider
ו-RangeSlider
שאינם ניסיוניים ומכילים תמונות ממוזערות ורצועות בהתאמה אישית. בנוסף, הוצאנו משימוש את ממשקי ה-API הקודמים שלSlider
ושלRangeSlider
. (Ie5ea6, b/261566890) - הגדרנו את
Modifier.tooltipAnchor()
כציבורי, כדי שמפתחים יוכלו להעביר אותו לרכיב העוגן כדי לציין שצריך להציג הסבר קצר בלחיצה ארוכה. ממשקPlainTooltipBox
API עודכן כך שאי אפשר יותר להגדיר אתTooltipState
כ-nullable, ועכשיו יש לו ערך ברירת מחדל. (Ie2fb7) ProgressIndicatorDefaults.circularTrackColor
סומן כ@Composable
לצורך עקביות. (Id29cc)- שחזור של getter של מאפיין
LocalMinimuTouchTargetEnforcement
וסימון שלו כמאפיין שהוצא משימוש, והפניה אוטומטית אלLocalMinimumInteractiveComponentEnforcement
. (I60dd5)
גרסה 1.1.0-alpha05
26 בינואר 2023
הגרסאות androidx.compose.material3:material3:1.1.0-alpha05
ו-androidx.compose.material3:material3-window-size-class:1.1.0-alpha05
יוצאות לאור. גרסה 1.1.0-alpha05 מכילה את הקומיטים האלה.
תכונות חדשות
DatePickerDialog
ותמיכה בנגישות- נוספו תמונה ממוזערת מותאמת אישית ומסלול ל-
RangeSlider
.
עדכונים של יחסי תלות
-
Compose UI
ו-Compose Material
תלויים עכשיו ב-Lifecycle 2.6.0.
גרסה 1.1.0-alpha04
11 בינואר 2023
הגרסאות androidx.compose.material3:material3:1.1.0-alpha04
ו-androidx.compose.material3:material3-window-size-class:1.1.0-alpha04
יוצאות לאור. גרסה 1.1.0-alpha04 מכילה את הקומיטים האלה.
תכונות חדשות
- API ראשוני
DatePicker
לבחירת תאריך יחיד דרך ממשק משתמש של לוח שנה. ממשק ה-API הזה עדיין עובר שינויים. (I722b9) - הוספנו תמיכה בהצגת תיאורי כלים פשוטים באמצעות
PlainTooltipBox
. (I0cdfb) - סרגל החיפוש (Iad128)
SwipeToDismiss
(I458a8, b/242889540)
שינויים ב-API
- נוספה תכונת
IsContainer
סמנטיקה בפלטפורמות השונות של Google. הנכס הזה ישמש בשינוי מאוחר יותר שקובע את סדר המעבר על סמך המשמעות הסמנטית של רכיבים כמו משטחים. (I63379) - סימון ממשקי API שקשורים לחלונית ההזזה לניווט כגרסה יציבה. (Iab01e, b/261439597)
- נוסף פרמטר של צבע הרקע לאינדיקטורים של התקדמות מעגלית, ופרמטר של קצה הקו לאינדיקטורים של התקדמות מעגלית וליניארית. (Ie668c, b/216325962, b/222964817)
- הוספת אפשרות להחזרת ערך null לסוגים נוספים של פונקציות שהוצאו משימוש ומוסתרות (Ibf7b0)
- מוסיפים
Modifier.minimumInteractiveComponentSize
. אפשר להשתמש בו כדי להזמין מקום בגודל של לפחות 48dp כדי להבחין בין אינטראקציות של מגע, אם גודל הרכיב קטן יותר. (I33f58, b/258495559) - הוספנו API ניסיוני ל-
AlertDialog
composable שיש לו משבצת תוכן. (Iec4a2)
תיקוני באגים
- ההתקדמות באינדיקטורים של ההתקדמות מוגבלת עכשיו לטווח הצפוי. (I8a7eb, b/262262727)
בעיה ידועה
- כשמעדכנים מ-
androidx.compose.foundation:1.4.0-alpha03
ל-androidx.compose.foundation:1.4.0-alpha04
, יכול להיות שתיתקלו בשגיאהjava.lang.NoSuchFieldError
. כאן דווחה הבעיה במקור. תיקון נשלח ויהיה זמין בעדכון הבא של Compose. כפתרון עקיף, אפשר לעדכן את הספריותandroidx.compose.material
ו-androidx.compose.material3
לגרסה האחרונה(1.1.0-alpha04) או לשנמך אתandroidx.compose.foundation
לגרסה 1.4.0-alpha03.
גרסה 1.1.0-alpha03
7 בדצמבר 2022
הגרסאות androidx.compose.material3:material3:1.1.0-alpha03
ו-androidx.compose.material3:material3-window-size-class:1.1.0-alpha03
יוצאות לאור. גרסה 1.1.0-alpha03 מכילה את הקומיטים האלה.
שינויים ב-API
- השמות של
consumedWindowInsets()
ו-withConsumedWindowInsets()
שונו ל-consumeWindowInsets()
ו-onConsumedWindowInsetsChanged()
, והמשנים הפכו לציבוריים. (Ie44e1) - הוספה של ריווח חדש כברירת מחדל ללחצן טקסט עם סמל. (I8f662)
- נוספו צבעים מושבתים לסרגל הניווט ולסרגל הצד. (Ia7892, b/258867034)
- נוסף Modifier API כדי לשלוח שאילתות לגבי פרטי גלילה של רכיבי צאצא. (I2ba9d, b/203141462)
- משמש ב-
Clickable
כדי להשהות נכון אינטראקציות של לחיצה, כשמחוות יכולות להפוך לאירועי גלילה. - תוקנה הבעיה שבה לא היה עיכוב נכון באפקט האדוות כשנעשה שימוש ב-
Clickables
בתוךScrollable ViewGroup
. - עדכנו את מגירות האפליקציות ואת Sheets כדי לעכב לחיצות בצורה נכונה במקרים שבהם תנועות יכולות להפוך לאירועי גלילה.
עדכונים של יחסי תלות
-
Compose UI
ו-Compose Material
תלויים עכשיו ב-Lifecycle 2.5.1. (I05ab0, b/258038814)
גרסה 1.1.0-alpha02
9 בנובמבר 2022
הגרסאות androidx.compose.material3:material3:1.1.0-alpha02
ו-androidx.compose.material3:material3-window-size-class:1.1.0-alpha02
יוצאות לאור. גרסה 1.1.0-alpha02 מכילה את הקומיטים האלה.
שינויים ב-API
-
awaitFirstDown
ו-waitForUpOrCancellation
תומכים עכשיו ב-PointerEventPass
כדי לאפשר גמישות רבה יותר (גם מתקן אתExposedDropdownMenuBox
שמציג תפריט בזמן גלילה).(I7579a, b/212091796) - נוסף הפרמטר
minLines
לרכיבי Text של Material ו-Material3, TextField
ו-OutlinedTextField
שמאפשר להגדיר את הגובה המינימלי של הרכיב במונחים של מספר שורות (I4af1d) - הוצאנו משימוש את הפונקציה
TopAppBarDefaults smallTopAppBarColors
לטובת פונקציה חדשהtopAppBarColors
שבה צריך להשתמש כשיוצריםTopAppBar
. (Ie6cb9) - נוסף הפרמטר
minLines
ל-BasicText
ול-BasicTextField
. הוא מאפשר להגדיר את הגובה המינימלי של רכיבי ה-Composable האלה במונחים של מספר שורות (I24294, b/122476634)
תיקוני באגים
- חיתוך התוכן של
IconButton
ו-IconToggleBotton
של Material3 לצורה של שכבת המצב של הרכיב (למשל צורה עגולה). (I9da8f) - העדכונים ב-Material3 Medium וב-Large top app bars מאפשרים להחיל את אותו צבע רקע על כל המשטח שלהם, ולהגדיר ערכי צבע שקופים כדי לשנות את צבעי ברירת המחדל. (I67659, b/249688556, b/250838918)
גרסה 1.1.0-alpha01
24 באוקטובר 2022
הגרסאות androidx.compose.material3:material3:1.1.0-alpha01
ו-androidx.compose.material3:material3-window-size-class:1.1.0-alpha01
יוצאות לאור. גרסה 1.1.0-alpha01 מכילה את הקומיטים האלה.
תיקוני באגים
- בוצעו תיקונים בסרגל האפליקציות העליון כשמחילים כותרת עם TextStyle ו-Brush. (If667e)
גירסה 1.0
גרסה 1.0.1
9 בנובמבר 2022
הגרסאות androidx.compose.material3:material3:1.0.1
ו-androidx.compose.material3:material3-window-size-class:1.0.1
יוצאות לאור. גרסה 1.0.1 מכילה את הקומיטים האלה.
תיקוני באגים
- העדכונים ב-Material3 Medium וב-Large top app bars מאפשרים להחיל את אותו צבע רקע על כל המשטח שלהם, ולהגדיר ערכי צבע שקופים כדי לשנות את צבעי ברירת המחדל. (I67659, b/249688556, b/250838918)
גרסה 1.0.0
24 באוקטובר 2022
הגרסאות androidx.compose.material3:material3:1.0.0
ו-androidx.compose.material3:material3-window-size-class:1.0.0
יוצאות לאור. גרסה 1.0.0 מכילה את הקומיטים האלה.
התכונות העיקריות של גרסה 1.0.0
זו הגרסה היציבה הראשונה של Compose Material 3!
עיצוב ערכות נושא ב-Material Design 3 וצבע דינמי ב-Material You
רכיבים של Material Design 3
- תג
- סרגל האפליקציה התחתון
- לחצנים
- Button, ElevatedButton, FilledTonalButton, OutlinedButton, TextButton
- כפתור פעולה צף (FAB) וכפתור פעולה צף מורחב
- כרטיסים
- Card, OutlinedCard, ElevatedCard
- תיבת סימון
- צ'יפים
- תיבות דו-שיח
- Divider
- תפריט נפתח
- רשימה
- סרגל הניווט
- חלונית הזזה לניווט
- פס ניווט
- מחוון התקדמות
- כפתור בחירה
- פס הזזה
- Slider, RangeSlider
- החלפת חשבון
- כרטיסיות
- Tab, LeadingIconTab, TabRow, ScrollableTabRow
- שדות טקסט
- סרגל האפליקציות העליון
- סמל
- Icon, IconButton
- טקסט
- Surface
- פריסה
- צבע התוכן
סיווג גודל החלון
material3-window-size-class
היא ספרייה חדשה שמספקת תמיכה במחלקות של גודל חלון: קבוצה של נקודות עצירה (breakpoints) מוגדרות מראש של אזור התצוגה, שבעזרתן אפשר לעצב, לפתח ולבדוק פריסות של אפליקציות שניתנות לשינוי גודל. אפשר להשתמש ב-calculateWindowSizeClass
כדי לאחזר מופע של מחלקת גודל החלון, שבעזרתו אפשר לקבוע איך ממשק המשתמש צריך להיראות, למשל להציג סרגל ניווט במקום ניווט בתחתית החלון בגדלים גדולים יותר של חלונות. מידע נוסף ודוגמאות לשימוש מופיעים במאמרי העזרה שלWindowSizeClass
API.פרטים נוספים זמינים בפוסט הזה בבלוג.
גרסה 1.0.0-rc01
5 באוקטובר 2022
הגרסאות androidx.compose.material3:material3:1.0.0-rc01
ו-androidx.compose.material3:material3-window-size-class:1.0.0-rc01
יוצאות לאור. גרסה 1.0.0-rc01 כוללת את הקומיטים האלה.
שינויים ב-API
- נוסף פרמטר של משבצת לתמיכה ב-API של שדה טקסט לטקסט (Iaac0d, b/227146125)
גרסה 1.0.0-beta03
21 בספטמבר 2022
הגרסאות androidx.compose.material3:material3:1.0.0-beta03
ו-androidx.compose.material3:material3-window-size-class:1.0.0-beta03
יוצאות לאור. גרסה 1.0.0-beta03 מכילה את הקומיטים האלה.
שינויים ב-API
-
ExposedDropdownMenuDefaults
חושף עכשיו ערך של ריווח פנימי לאפשרויות בתפריט. (I34ee1) - ב-
ExposedDropdownMenuBoxScope
יש עכשיו משנהModifier.menuAnchor()
שצריך להעביר לשדה הטקסט כדי להבטיח התנהגות נכונה של נגישות. (I27fa3) - הוספנו שתי שיטות עמוסות מדי ל-Slider API הנוכחי כדי לאפשר למשתמשים להעביר אצבע או מסלול כדי לאכלס את פס ההזזה. (I21c00)
תיקוני באגים
- מיפוי הצבעים של העיצוב הכהה עבור On Error Container עודכן לטון 90 (Ic5612)
- בוצע תיקון שמאפשר להגדיר רקע שקוף לסרגלי אפליקציות קטנים בחלק העליון של Material 3. (I645e2, b/245575782)
גרסה 1.0.0-beta02
7 בספטמבר 2022
הגרסאות androidx.compose.material3:material3:1.0.0-beta02
ו-androidx.compose.material3:material3-window-size-class:1.0.0-beta02
יוצאות לאור. גרסה 1.0.0-beta02 מכילה את הקומיטים האלה.
שינויים ב-API
- השוליים הפנימיים של רכיבי ברירת המחדל שהוצגו ברכיבי m3 בגרסה beta01 כבר לא מתחשבים בשוליים הפנימיים של ה-IME.
- לרכיב Material3 Scaffold יש עכשיו פרמטר
contentWindowInsets
, שמאפשר לציין את כמות השוליים הפנימיים לטיפול במשבצת התוכן. (Icf11a, b/243713323) - הפונקציה הניסיונית Material 3
SmallTopAppBar
הוצאה משימוש, ונוספה פונקציה מקבילהTopAppBar
. צריך להעביר את השימוש לגרסה החדשה. (I74404, b/226918634) - הוספת שליטה על התנהגויות של הטלה והצמדה של סרגל האפליקציות העליון. (I15c81)
- הסרה של startIndent מהרכיב Divider, העברה של color לפרמטר האחרון. (If7be2)
תיקוני באגים
- הגדרת תיבות דו-שיח שיציגו את עצמן למשתמשי TalkBack על ידי הכרזת המילה 'תיבת דו-שיח' כשהן מוצגות. (I857ef)
גרסה 1.0.0-beta01
24 באוגוסט 2022
הגרסאות androidx.compose.material3:material3:1.0.0-beta01
ו-androidx.compose.material3:material3-window-size-class:1.0.0-beta01
יוצאות לאור. גרסה 1.0.0-beta01 מכילה את הקומיטים האלה.
הפניית API
כדי לראות את העיצובים, הרכיבים והפונקציות העדכניים ביותר שזמינים, אפשר לעיין בסקירה הכללית של חומר העזר בנושא Compose Material 3 API.
שינויים ב-API
- עדכנו את סרגל האפליקציות העליון של Material 3 כך שניתן יהיה להקטין אותו למצב מכווץ לחלוטין או להגדיל אותו למצב מורחב לחלוטין. בנוסף, עודכנה פונקציית ההתנהגות
TopAppBarDefaults
כך שתהיה Composables ותספק ערכי ברירת מחדל למצב סרגל האפליקציות העליון ולמפרט האנימציה. (I642b3) - עדכון של חתימות רכיבי ה-FAB כך שיתאימו לממשק ה-API של המשטח (I3afaa)
- הוספנו תמיכה מובנית ב-insets בסרגלי אפליקציות עליונים, במגירות, בסרגלי ניווט ובסרגלי צד. הרכיבים האלה, כשמשתמשים בהם בנפרד או עם Scaffold, מטפלים באופן אוטומטי ב-insets למפתחים. הערה: השינוי הזה לא מוסיף טיפול אוטומטי בסמלים של סרגל הסטטוס ובשקיפות של סרגל הסטטוס וסרגל הניווט. כדי ליהנות מהחוויה הטובה ביותר מקצה לקצה, צריך להמשיך לעשות את זה באופן ידני. (I7e4e6, b/183161866)
- עדכנו את ברירות המחדל של הרכיבים כדי לצמצם את שטח ה-API, וכך לאפשר גמישות בעתיד ולשפר את הביצועים. (I31820)
- שינוי הסדר של הפרמטרים של הצ'יפ ושל דף המגירה של הניווט כדי לשמור על עקביות ב-API (I45d0b)
- הוסר
startIndent
מהרכיב Divider והצבע הועבר להיות הפרמטר האחרון.(If7be2)
גרסה 1.0.0-alpha16
10 באוגוסט 2022
הגרסאות androidx.compose.material3:material3:1.0.0-alpha16
ו-androidx.compose.material3:material3-window-size-class:1.0.0-alpha16
יוצאות לאור. גרסה 1.0.0-alpha16 מכילה את הקומיטים האלה.
תכונות חדשות
- תמיכה בהגדרת רוחב מותאם אישית בחלונית ההזזה לניווט. (Ia7f10)
שינויים ב-API
- שינוי הסדר של הפרמטרים Tab ו-Leading icon tab כדי לשמור על עקביות ב-API (Ie2637)
- התכונה
BadgeDefaults
סומנה כניסיונית. (I98ef3) - הוסרה פונקציית חלונית ההזזה לניווט שהוצאה משימוש. (I4f2db)
- שינוי הסדר של הפרמטרים של Slider ב-Material 3 כדי לשמור על עקביות ב-API (I0aee7)
- שינוי הסדר של הפרמטרים
NavigationBar
ו-NavigationRail
כדי לשמור על עקביות ב-API (I51cda) - כדי לשמור על עקביות ב-API, צריך לשנות את סדר הפרמטרים ב-Material 3. (If4ae1)
- שינוי סדר הפרמטרים של Slider ב-Material 3 כדי לשמור על עקביות ב-API (I62673)
- שינוי השם של הפרמטר icons (סמלים) ל-actions (פעולות) כדי ליצור עקביות עם סרגל האפליקציות העליון (Id75be)
- סימון
Badge
ו-BadgedBox
כניסיוניים כי יישור העוגן עדיין משתנה. (I1712e, b/236524516) - שינוי
@ExperimentalMaterial3Api
ההערות בווריאציות של לחצני סמלים ל-@OptIn
(I070b5) - הפרדנו את התוכן של מגירת הניווט לרכיב שאפשר להרכבה משלו, כדי לאפשר ציון רוחב מותאם אישית. (Ia7f10)
- הסרה של
Divider
מ-MenuDefaults
ומ-TabDefaults
(I4e33c)
גרסה 1.0.0-alpha15
27 ביולי 2022
הגרסאות androidx.compose.material3:material3:1.0.0-alpha15
ו-androidx.compose.material3:material3-window-size-class:1.0.0-alpha15
יוצאות לאור. גרסה 1.0.0-alpha15 מכילה את הקומיטים האלה.
תכונות חדשות
- מאפשר גרירה של סרגל האפליקציות העליון מהסרגל עצמו. (I65c00, b/205873416)
שינויים ב-API
- עדכונים בממשקי ה-API
FilterChip
ו-ElevatedFilterChip
כדי להסיר את משבצתselectedIcon
ולעודד שימוש חוזר ב-leadingIcon
להצגת מצב נבחר. (Ie5dc2) - הוספת תפקידי צבע שונים של שכבת scrim ושל קווי מתאר. (Id6d54)
- תיקון מוסכמות מתן שמות לברירות מחדל שניתנות להרכבה. (I62b27)
- סימון של
ListItemDefaults
ושלListItemColors
כמוצרים ניסיוניים. (I1f3ec) - שינויים ב-API של סרגל האפליקציה העליון כדי לשקף טוב יותר את המשמעות של מאפייני המצב שלו. בנוסף, צריך לסמן את ה-API של סרגל האפליקציות העליון כניסיוני. (Ic0ad8)
- הוספנו ל-
TextFieldColors
צבעים לבחירת טקסט, כדי שיהיה קל יותר למצוא אותם. (Iba1b8) - הוספת
ButtonDefault.ButtonWithIconContentPadding
לשימוש בלחצנים שמכילים סמל. (I2bf9c) - שדות הטקסט סומנו כניסיוניים כדי לאפשר גמישות רבה יותר בשינויים עתידיים בממשק ה-API. (I127b5)
- ההערה
@ExperimentalMaterial3Api
הוסרה מהפונקציהCheckbox
. (I5eefc) - ההערה
@ExperimentalMaterial3Api
הוסרה מהפונקציהRadioButton
. (I17e2a) - הוסרה ההערה
@ExperimentalMaterial3Api
מהכרטיסים הלא אינטראקטיביים. (I9bd49) - עדכונים של אובייקטים שונים של ברירות מחדל של רכיבים, כך שיכללו צבעים, צורות וכו'. (I96e11)
תיקוני באגים
- הוסרו סמלים לא פעילים של קלט שבבים לדוגמאות כדי למנוע בלבול בקרב המשתמשים באפליקציית הקטלוג. (I9846a)
גרסה 1.0.0-alpha14
29 ביוני 2022
הגרסאות androidx.compose.material3:material3:1.0.0-alpha14
ו-androidx.compose.material3:material3-window-size-class:1.0.0-alpha14
יוצאות לאור. גרסה 1.0.0-alpha14 מכילה את הקומיטים האלה.
תכונות חדשות
- נוספה הטמעה של רשימת M3. דוגמאות לשימוש מופיעות במסמכי התיעוד (Id7a20)
שינויים ב-API
- שינוי שם הפרמטר מ-values ל-value ב-
RangeSlider
(I3b79a) - שינויים ב-API בהטמעה של
InputChip
כדי לתמוך במצב שניתן לבחירה בהתאם למפרט של Material Design. תמיכה נוספת בצבעים שלFilterChip
למצב מושבת שנבחר. (I55244, b/235792432) - הוספת לחצן פעולה צף (FAB) שמוגדר כברירת מחדל
BottomAppBar
(Ida4c8) - הכרטיס
ColorScheme.surfaceColorAtElevation
נוסף (Id41af) - ממשקים בספריות של Compose נוצרים עכשיו באמצעות שיטות ממשק שמוגדרות כברירת מחדל ב-jdk8 (I5bcf1)
- המחלקות
WindowWidthSizeClass
ו-WindowHeightSizeClass
מיישמות עכשיו את הממשק Comparable, כך שאפשר להשוות ביניהן באמצעות אופרטורים (<, <=, >=, >) וממשקי API אחרים. (I747d0)
תיקוני באגים
- עדכון דוגמת התג כדי לספק תיאור משמעותי יותר של התוכן. (I10b9d)
- נוספה אפשרות להשתמש בגודל הגופן של המערכת בכלי לבחירת העיצוב של קטלוג Material 3. (I10605)
- הוספת קוד לדוגמה לתג ולאינדיקטורים של התקדמות לא מוגדרת. (I8fbe0)
גרסה 1.0.0-alpha13
1 ביוני 2022
הגרסאות androidx.compose.material3:material3:1.0.0-alpha13
ו-androidx.compose.material3:material3-window-size-class:1.0.0-alpha13
יוצאות לאור. גרסה 1.0.0-alpha13 מכילה את הקומיטים האלה.
שינויים ב-API
- יש תמיכה בשמירה על המיקום של סרגל האפליקציות העליון כשמשנים את ההגדרה. (I10459, b/216160958)
גרסה 1.0.0-alpha12
18 במאי 2022
הגרסאות androidx.compose.material3:material3:1.0.0-alpha12
ו-androidx.compose.material3:material3-window-size-class:1.0.0-alpha12
יוצאות לאור. גרסה 1.0.0-alpha12 מכילה את הקומיטים האלה.
תיקוני באגים
- עכשיו אפשר להגדיר רוחב 0 לרכיב slider parent. (b/231707291)
גרסה 1.0.0-alpha11
11 במאי 2022
הגרסאות androidx.compose.material3:material3:1.0.0-alpha11
ו-androidx.compose.material3:material3-window-size-class:1.0.0-alpha11
יוצאות לאור. גרסה 1.0.0-alpha11 מכילה את הקומיטים האלה.
תכונות חדשות
- נוספה
RangeSlider
ל-Material 3 (I18e38) - הוספת תמיכה ב-Material3
AssistChip
וInputChip
(I0d25a) - הוספת תמיכה ב-Material3
FilterChip
וSuggestionChip
(I9fdf3)
שינויים ב-API
- השם של רכיב ה-Composable
TextFieldDefaults.BorderStroke
שיוצר קו גבול ב-OutlinedTextField
שונה ל-TextFieldDefaults.BorderBox
. (I5f295) - שינויים חזותיים ב-m3 (Iab30e)
- הגדרה שמאפשרת להעביר צבעים ללחצני סמלים רגילים. (Ia2445)
תיקוני באגים
- הוספת בדיקת lint ל-material3/Scaffold כדי לוודא שהריווח הפנימי נמצא בשימוש (I72293, b/226951418)
גרסה 1.0.0-alpha10
20 באפריל 2022
הגרסאות androidx.compose.material3:material3:1.0.0-alpha10
ו-androidx.compose.material3:material3-window-size-class:1.0.0-alpha10
יוצאות לאור. גרסה 1.0.0-alpha10 מכילה את הקומיטים האלה.
תכונות חדשות
-
material3-window-size-class
היא ספרייה חדשה שמספקת תמיכה במחלקות של גודל חלון: קבוצה של נקודות עצירה (breakpoints) מוגדרות מראש של אזור התצוגה, שבעזרתן אפשר לעצב, לפתח ולבדוק פריסות של אפליקציות שניתנות לשינוי גודל. אפשר להשתמש ב-calculateWindowSizeClass
כדי לאחזר מופע של מחלקת גודל החלון, שבעזרתו אפשר לקבוע איך ממשק המשתמש צריך להיראות, למשל להציג סרגל ניווט במקום ניווט בתחתית החלון בגדלים גדולים יותר של חלונות. מידע נוסף ודוגמאות לשימוש מופיעים במאמרי העזרה שלWindowSizeClass
API. מידע נוסף על הגדרות של גודל חלון זמין בהנחיות הציבוריות בנושא תמיכה בגדלים שונים של מסכים.
שינויים ב-API
- נוספה הגבהה של כפתור פעולה צף כברירת מחדל ל-
BottomAppBar
, הוסרה lambda מסוג trailing מ-BottomAppBar
עם כפתור פעולה צף. (I92c47) - נוספו Material3
FilledIconButton
,FilledTonalIconButton
ו-OutlinedIconButton
. (Ib2bda) - בוצעו עדכונים ב-Snackbar API של Material 3 כדי לאפשר קבלת ערכי צבע לפעולה האופציונלית ולפעולת ההסרה. (Ibe4b4)
- השימוש החלקי (הורדה או מיקום) הוצא משימוש ב-
PointerInputChange
. אפשר להשתמש ב-consume()
כדי להחיל את השינוי באופן מלא. אפשר להשתמש ב-isConsumed
כדי לקבוע אם מישהו אחר כבר השתמש בשינוי. - הפונקציה
PointerInputChange::copy()
יוצרת עכשיו תמיד עותק שטחי. המשמעות היא שעותקים שלPointerInputChange
ינוצלו ברגע שאחד מהעותקים ינוצל. אם רוצים ליצורPointerInputChange
לא מאוגד, צריך להשתמש בבונה במקום זאת. (Ie6be4, b/225669674) - בוצעו שינויים ב-Cards API כדי לקבל את הצבעים של הרכיב והתוכן דרך ממשק
CardColors
, וכדי לתמוך במצב מושבת של כרטיסים שאפשר ללחוץ עליהם. (I927df) - הפרמטר
backgroundColor
קיבל את השםcontainerColor
בשדות טקסט של Material 3 כדי לשפר את העקביות עם רכיבים אחרים. (I6fbd9)
תיקוני באגים
- עדכנו את התקן
IconButton
כדי שיתאים למפרט Material3. (I09eab) - העברת הגובה של הסרגל העליון של material3 Scaffold אל הריווח הפנימי שמועבר לתוכן, כדי שהתוכן יוצג מתחת לסרגל האפליקציה העליון. אם מתעלמים מהערכים
PaddingValues
, יכול להיות שהתוכן יוסתר על ידי הסרגל העליון. (I83cbc, b/217776202)
גרסה 1.0.0-alpha09
6 באפריל 2022
androidx.compose.material3:material3:1.0.0-alpha09
משוחרר. גרסה 1.0.0-alpha09 מכילה את הקומיטים האלה.
תכונות חדשות
- נוסף Material 3 Switch API (I2c3ad)
שינויים ב-API
- נוספה תמיכה בתפריטים נפתחים עם שדות טקסט (שנקראים גם 'תפריטים נפתחים חשופים' או 'תיבות משולבות'). (I1b832)
- נוסף פרמטר צורה למערכת המשנה MaterialTheme ו-Shape. (I37426)
- נוסף פרמטר מורחב ל-
ExtendedFloatingActionButton
כדי לקבוע אם לחצן ה-FAB יורחב או יכווץ, עם אנימציות בין כל מצב. נוספה עומס יתר של לחצן פעולה צף מורחב ללחצני פעולה צפים מורחבים עם טקסט נגרר ללחצני פעולה צפים מורחבים ללא סמל. (Iba7f1)
גרסה 1.0.0-alpha08
23 במרץ 2022
androidx.compose.material3:material3:1.0.0-alpha08
משוחרר. גרסה 1.0.0-alpha08 מכילה את הקומיטים האלה.
תכונות חדשות
- הוספנו תמיכה בשדות טקסט של Material 3. (I795cc, b/199377790)
שינויים ב-API
תיקוני באגים
- תיקון ב-Material3 Button כדי לקרוא את ערך סגנון הטקסט שמוגדר כברירת מחדל מ-MaterialTheme. (Ie62fc)
גרסה 1.0.0-alpha07
9 במרץ 2022
androidx.compose.material3:material3:1.0.0-alpha07
משוחרר. גרסה 1.0.0-alpha07 מכילה את הקומיטים האלה.
שינויים ב-API
- עדכונים ב-Material 3 Surface API שמחזירים את הפונקציות העמוסות של רכיבי Surface שאפשר ללחוץ עליהם, וגם מוסיפים פונקציה לתמיכה ברכיבי Surface שאפשר לבחור ולהחליף ביניהם. (I4bf18)
- התכונות
LazyVerticalGrid
וLazyHorizontalGrid
יציבות עכשיו. (I307c0) -
LazyVerticalGrid/LazyHorizontalGrid
וכל ממשקי ה-API שקשורים אליו הועברו לחבילת המשנה .grid. צריך לעדכן את הייבוא מ-androidx.compose.foundation.lazy ל-androidx.compose.foundation.lazy.grid. (I2d446) - בוטל שינוי קודם שהסתמך רק על View עבור
WindowInsetsControllerCompat
, ועכשיו נדרש שוב Window, שנדרש לניהול של חלק מהדגלים של חלונות. הפונקציהViewCompat.getWindowInsetsController
הוצאה משימוש לטובתWindowCompat.getInsetsController
כדי לוודא שנעשה שימוש בחלון הנכון (למשל אם התצוגה היא בתיבת דו-שיח). (I660ae, b/219572936) - הוספנו
LazyVerticalGrid
API חדש להגדרת גדלים של צירים חוצים (I17723)
תיקוני באגים
- עדכונים ב-Card API בעקבות שינויים ב-Surface API (I3c8b9)
גרסה 1.0.0-alpha06
23 בפברואר 2022
androidx.compose.material3:material3:1.0.0-alpha06
משוחרר. גרסה 1.0.0-alpha06 מכילה את הקומיטים האלה.
שינויים ב-API
- נוסף
NavigationDrawerItem
שמייצג יעד יחיד במגירות (Ic396f, b/218286829) -
PermanentNavigationDrawer
ו-DismissibleNavigationDrawer
נוספו כממשקי API ניסיוניים. אלה המגירות שמתאימות למכשירים עם מסך גדול. (I5f8ab, b/218286829) - נוספה תמיכה בסרגל האפליקציות התחתון של Material 3 (Ic432a)
- השם של
NavigationDrawer
שונה לModalNavigationDrawer
(I1807d, b/218286829) - נוספו אסימונים וסיווג של רכיב Slider של Material 3 (I1ccee)
- נוספה הטמעה של כרטיסייה. דוגמאות לשימוש מופיעות במסמכי העזרה (Ie0146).
תיקוני באגים
- נפתרה בעיה שבה ניווט ליניארי של קורא המסך
TalkBack
בחר כותרת ריקה של סרגל האפליקציות העליון. (Id4690) IconSize
נוסף לקבוצהFloatingActionButtonDefaults
. (Ia71cf)- תיקון באג שגורם להסתרת לחצני
AlertDialog
כשמוסיפים טקסט ארוך עםLazyColumn
. (Ib2cc9, b/216663029)
גרסה 1.0.0-alpha05
9 בפברואר 2022
androidx.compose.material3:material3:1.0.0-alpha05
משוחרר. גרסה 1.0.0-alpha05 מכילה את הקומיטים האלה.
תכונות חדשות
נוספו רכיבים של Material Design 3
- תפריט נפתח
- כרטיסים
- Card, OutlinedCard, ElevatedCard
שינויים ב-API
- הפונקציה
Surface
שהוצאה משימוש שמקבלת קריאה חוזרת (callback) של onClick. צריך ליצור משטחים שאפשר ללחוץ עליהם באמצעותInteractionSource
ו-Modifier.clickable()
. (I211c6) - נוספה תמיכה בהגבהה של כפתור פעולה צף (FAB) במצב לחיצה ובמצב התמקדות. (Ibb584)
- ממשק
Surface
API שונה כך שיקבל InteractionSource, שמאפשר שליטה במראה שלו במצבים שונים. (Iafbc8)
תיקוני באגים
- נוספו צבעים שלישוניים חסרים בערכות צבעים דינמיות (I456c4, b/214588434)
גרסה 1.0.0-alpha04
26 בינואר 2022
androidx.compose.material3:material3:1.0.0-alpha04
משוחרר. גרסה 1.0.0-alpha04 מכילה את הקומיטים האלה.
שינויים ב-API
- הוספנו את
NonRestartableComposable
לשיטות שהן עומס יתר של שיטות קיימות ללא לוגיקה מורכבת. הפעולה הזו מצמצמת את הבדיקות של הממויזציה (equals) שנוצרות על ידי הקומפיילר לכל הפרמטרים שחוזרים על עצמם בפונקציה הפנימית שמופעלת. (I90490) - נוסף קו מפריד של Material 3. (Ica5fc)
- מסמנים את תיבת הסימון ואת לחצן הבחירה באמצעות הערה של API ניסיוני. (Ie44bb)
- הוספנו תמיכה באינדיקטורים של התקדמות Material 3. (Iff232, b/205023841)
תיקוני באגים
- עדכון של צבע מאגר תגים מושבת לערך שקוף (I6b248, b/213339737)
TextButton's
גרסה 1.0.0-alpha03
12 בינואר 2022
androidx.compose.material3:material3:1.0.0-alpha03
משוחרר. גרסה 1.0.0-alpha03 מכילה את הקומיטים האלה.
תיקוני באגים
- הוספת
LocalIndication
ל-MaterialTheme
של Material 3. (I7ce4e) - תיקון רדיוס הפינות שמוחל על תיבות סימון (I38b03, b/175198975, b/202309440)
עדכונים של יחסי תלות
- עכשיו תלוי ב-Kotlin
1.6.10
.
גרסה 1.0.0-alpha02
1 בדצמבר 2021
androidx.compose.material3:material3:1.0.0-alpha02
משוחרר. גרסה 1.0.0-alpha02 מכילה את הקומיטים האלה.
תכונות חדשות
- הוספת תמיכה בתיבת סימון ובלחצן בחירה.
- עודכן כך שיהיה תואם ל-Kotlin
1.6.0
שינויים ב-API
- הסרה של מגירה מהפיגום של Material 3. (I04f51)
- נוספה תמיכה ב-Material 3
Checkbox
. (Id5542) - נוספה תמיכה ב-Material 3
RadioButton
. (I20334)
תיקוני באגים
- הקטנת רדיוס האדווה של
IconButton
מ-40dp ל-20dp. (I68bbe, b/206674345) - הנתיב המהיר של מחרוזת היציאה עבור
Text
השתנה מ-compose.material
(I30b03) - תוקן כך שהלחצן המקודד תמיד יהיה מופעל. (Iea832, b/205335456)
גרסה 1.0.0-alpha01
27 באוקטובר 2021
androidx.compose.material3:material3:1.0.0-alpha01
משוחרר. גרסה 1.0.0-alpha01 מכילה את הקומיטים האלה.
תכונות חדשות
עיצוב ערכות נושא ב-Material Design 3 וצבע דינמי ב-Material You
רכיבים של Material Design 3
- לחצנים
- כפתור פעולה צף (FAB) וכפתור פעולה צף מורחב
- תיבות דו-שיח
- סרגל הניווט
- חלונית הזזה לניווט
- פס ניווט
- סרגל האפליקציות העליון
- תג
- סמל
- טקסט
- Surface
- פריסה
- צבע התוכן
מידע נוסף זמין בקטע Material Design 3 ו-Material You במדריך בנושא עיצוב Material ב-Compose.