הרכבת חומר 3
העדכון האחרון | גרסה יציבה | מועמד לפרסום | גרסת בטא | גרסת אלפא |
---|---|---|---|---|
4 בספטמבר 2024 | 1.3.0 | - | - | - |
מבנה
תהליך הכתיבה הוא שילוב של 7 מזהי קבוצות של Maven בדומיין androidx
. כל קבוצה
מכיל קבוצת משנה מטורגטת של פונקציונליות, שלכל אחת מהן יש גרסה משלה
הערות.
בטבלה הזו מוסבר על הקבוצות והקישורים לכל קבוצה של נתוני גרסה.
קיבוץ | תיאור |
---|---|
compose.animation | יוצרים אנימציות באפליקציות 'Jetpack פיתוח נייטיב' כדי להעשיר את חוויית המשתמש. |
compose.compiler | שינוי פונקציות @Composable והפעלת אופטימיזציות באמצעות פלאגין מהדר של Kotlin. |
compose.foundation | כתיבת אפליקציות ב-Jetpack פיתוח נייטיב עם אבני בניין מוכנות לשימוש והרחבת היסודות לבניית חלקים משלכם במערכת העיצוב. |
compose.material | בניית ממשקי משתמש ב-Jetpack פיתוח נייטיב עם רכיבים מוכנים לשימוש ב-Material Design. זו נקודת הכניסה ברמה הגבוהה יותר של 'כתיבה', שנועדה לספק רכיבים שתואמים לאלה שמתוארים באתר www.material.io. |
compose.material3 | בניית ממשקי משתמש ב-Jetpack פיתוח נייטיב עם רכיבי Material Design 3, הפיתוח הבא של עיצוב Material Design. Material 3 כולל עיצוב ורכיבים מעודכנים ותכונות התאמה אישית של Material You, כמו צבעים דינמיים, ונועד להיות אחיד עם הסגנון החזותי החדש של Android 12 וממשק המשתמש של המערכת. |
compose.runtime | אבני הבניין הבסיסיות של מודל התכנות וניהול המצבים של Compose, ושל זמן הריצה העיקרי של הפלאגין Compose Compiler לטירגוט. |
compose.ui | רכיבים בסיסיים בממשק המשתמש של הרכבה שנדרשים לאינטראקציה עם המכשיר, כולל פריסה, שרטוט וקלט. |
הצהרה על יחסי תלות
כדי להוסיף תלות בכתיבה, צריך להוסיף את מאגר Google Maven פרויקט. למאגר Maven של Google אפשר לקבל מידע נוסף.
מוסיפים את יחסי התלות של פריטי המידע הנדרשים בקובץ build.gradle
בשביל
האפליקציה או המודול שלך:
מגניב
dependencies { implementation "androidx.compose.material3:material3:1.3.0" implementation "androidx.compose.material3:material3-window-size-class:1.3.0" implementation "androidx.compose.material3:material3-adaptive-navigation-suite:1.3.0" } android { buildFeatures { compose true } composeOptions { kotlinCompilerExtensionVersion = "1.1.1" } kotlinOptions { jvmTarget = "1.8" } }
Kotlin
dependencies { implementation("androidx.compose.material3:material3:1.3.0") implementation("androidx.compose.material3:material3-window-size-class:1.3.0") implementation("androidx.compose.material3:material3-adaptive-navigation-suite:1.3.0") } android { buildFeatures { compose = true } composeOptions { kotlinCompilerExtensionVersion = "1.1.1" } kotlinOptions { jvmTarget = "1.8" } }
למידע נוסף על יחסי תלות, אפשר לעיין במאמר הוספת יחסי תלות של build.
משוב
המשוב שלך עוזר לנו לשפר את Jetpack. נשמח לשמוע אם גילית בעיות חדשות או אם יש לך רעיונות לשיפור הספרייה הזו. מומלץ לעיין בעיות קיימות בספרייה הזו לפני שיוצרים ספר חדש. אפשר להוסיף את ההצבעה שלך לבעיה קיימת על ידי לחיצה על לחצן הכוכב.
מקורות מידע בנושא מעקב אחר בעיות אפשר לקבל מידע נוסף.
הרכבת Material3 גרסה 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 מכילה את התחייבויות אלה.
תכונות חדשות
רכיבים ללא עיצוב שבהם אפשר להשתמש כדי לבנות רכיבים בעיצוב חדשני תלת-ממדי:
- פלטה טונלית
- סמל
- גודל משטח המגע
כתיבת גרסה 1.0 של חבילת הניווט הדינמית של Material3
גרסה 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)
תיקוני באגים
- צריכת ערכות inset של תוכן כברירת מחדל (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 לנתיבי המודולים החדשים. (Ibc421)
- צריך לעבור לשימוש בגרסת מנהל החלונות של סיווגי הגדלים של החלונות. (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
- עדכון של שם החבילה ל-Navigation suite מ-Navigation-Suite (I7eff7)
- רכיבי Material3 שחושפים
MutableInteractionSource
ב-API שלהם עודכנו ועכשיו הם חושפיםMutableInteractionSource
אפסי (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 מכילה את התחייבויות אלה.
תכונות חדשות
כתיבת גרסה 1.0 מותאמת של Material3
גרסה 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 מכילה את התחייבויות אלה.
תכונות חדשות
- תמיכה במוּדעוּת להיסטוריה בניווט פיגומים ובחישוב ערך (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
- שינוי התפקידים של פיגומים לכינויים של
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
תיקוני באגים
- חלוניות התיקון לא משתנות כשלא נעשה שימוש ב-
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 להתאמה ל-scaffold של הנחיית חלוניות:
- PaneScaffoldDirective
- calculateStandardPaneScaffoldDirective (החישוב של StandardPaneScaffoldDirective)
- calculateDensePaneScaffoldDirective
- אסטרטגיית התאמה
- ThreePaneScaffoldAdaptStrategies
- מדיניות צירים
ממשקי API של פירמוט חלוניות בגודל Material3:
- ממשקי API בסיסיים של פיגומים בחלוניות
כתיבת Material3 גרסה 1.3
גרסה 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) - חלונית ההזזה של Naver (
ModalDrawerSheet
ו-DismissibleDrawerSheet
) תומכת עכשיו בפיצ'ר 'חיזוי חזרה' ב-U+ כהצטרפות לשירות (Ie5b0b) - ב-
DropdownMenu
יש עכשיו תמיכה בצבע, צורה, גובה וגבול בהתאמה אישית. (I8e981,b/289554448, b/301887035, b/283654243) - המחוון עודכן כדי לשפר את הנגישות על ידי הוספת פער ואינדיקטור עצירה. (I3058e)
ProgressIndicator
עודכן כדי לשפר את הנגישות על ידי הוספת פער ואינדיקטור עצירה. (I21451)- נוסף סמן טקסט שמוגדר כברירת מחדל להסבר קצר עשיר, יש תמיכה בסמן טקסט בהתאמה אישית לשרטוט כעוגן
LayoutCoordinates
. (Ifd42c) שינויי תוכנה שעלולים לגרום לכשלים - ממשקי API חדשים מסוג pull-to-refresh:
- כדי להשתמש בערכים עשרוניים במקום ביחידות מסוג Dp, צריך לפשט את
PullToRefreshState
. - מצב
isRefreshing
נשלט על ידי המשתמש במקוםPullToRefreshState
. - חיבור הגלילה הפנימית הופרד מ-
PullToRefreshState
. היא מטופלת על ידי הממשקPullToRefreshBox
אוModifier.pullToRefresh
החדשים. - העדכון הזה הוא שינוי תוכנה שעלול לגרום לכשל בממשקי ה-API הניסיוניים הקודמים. (I0adeb, b/314496282, b/317177684, b/323787138, b/324573502, b/317177683) שינויים בשיבושים חזותיים
- כדי להשתמש בערכים עשרוניים במקום ביחידות מסוג Dp, צריך לפשט את
- צריך לעדכן את שכבת-העל של מצב המיקוד ל-0.1f כדי להבטיח ניגודיות צבעים מספקת. (I7ea77)
- התאמות קלות לצבעי השטח והרקע בברירת המחדל ב-
lightColorScheme
וב-darkColorScheme
. (I9db52) - הצבעים של פס ההזזה וצבע
ProgressIndicator
עודכנו בהתאם למפרטים החדשים של 'ניגודיות ללא טקסט'. (I26807) - עכשיו רכיבים משתמשים ב-
SurfaceContainer
וריאציות. רכיבים שחושבו באופן רשמי עםSurface
ו-TonalElevation
משתמשים עכשיו בתפקידיSurfaceContainer
כברירת מחדל, ולא מושפעים מגובה טונלי. (b/304584161) - התפקידים הבסיסיים של קונטיינרים מסוג 'משטח' ו'משטח' הותאמו מעט, כך שיהיה לנו יותר גוון בעיצובים כהים ובהירים. (I677a5)
- ממשקי API ניסיוניים מקודמים ליציבות!
- שיפורי ביצועים
גרסה 1.3.0-rc01
21 באוגוסט 2024
androidx.compose.material3:material3-*:1.3.0-rc01
משוחרר. גרסה 1.3.0-rc01 מכילה את ההתחייבויות האלה.
תיקוני באגים
- עכשיו
ModalBottomSheet
מופיע ראשון בסדר המעבר הסמנטי, ואחריו מגיע הדפוס. (I436f9, b/358594665)
גרסה 1.3.0-beta05
24 ביולי 2024
androidx.compose.material3:material3-*:1.3.0-beta05
משוחרר. גרסה 1.3.0-beta05 כוללת את ההתחייבויות האלה.
- תוקנה בעיה שבה תוכן ב-
BottomSheet
חסר או נחתך ב-Android N ו-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 כוללת את ההתחייבויות האלה.
תרומה חיצונית
- הגדרת
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 כך שיהיו בוליאניים, במקום lambda. התאמת תוכן התמיכה ב-PullToRefreshBox
(I75679)- יצירת ממשק אטום ב-
TooltipScope
ויצירת הטמעה פנימית לשימוש ב-TooltipBox
ובתווית. (I3833e) - נוספו שני מקשי צירוף חדשים אל
CarouselItemScope
–maskClip
ו-maskBorder
– כדי להוסיף בקלות צורה וגבול לכל פריט בקרוסלה (Id67a1) TimePickerState
הוא עכשיו ממשק שמאפשר להגדיר את השעה (I88546)- ממשק API מעודכן לעיצוב הקישורים: השדה
TextLinkStyles
הועבר אלTextStyle
והסיר אתTextDefaults
מחומר הלימוד. (I5477b)
תיקוני באגים
- הסמלים של הסטטוס וסרגל הניווט של
ModalBottomSheet
מגיבים עכשיו לסטטוס של העיצוב הכהה. (Ie1fe7, b/338342149) - סמנטיקה של גיליון סגור נוספה לרישום
ModalBottomSheet
. (0e61cb,b/328801864)
תרומה חיצונית
- הגדרת
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 עודכן לצורך קבלת קישורים מעוצבים בטקסט. באופן ספציפי, הסרנו את השיטות מ-
TextDefaults
לבנייתLinkAnnotations
בנושא מסוים ולניתוח HTML עם קישורים מעוצבים. במקום זאת, הוספנו מחלקהTextLinkStyles
שמאפשרת לעצב את הקישורים כפרמטר לתוכן הקומפוזבילי של טקסט. (I31b93)
גרסה 1.3.0-alpha06
1 במאי 2024
androidx.compose.material3:material3-*:1.3.0-alpha06
משוחרר. גרסה 1.3.0-alpha06 מכילה את התחייבויות אלה.
שינויי תוכנה שעלולים לגרום לכשלים
ממשקי API חדשים מסוג pull-to-refresh:
- כדי להשתמש בערכים עשרוניים במקום ביחידות מסוג Dp, צריך לפשט את
PullToRefreshState
. - מצב
isRefreshing
נשלט על ידי המשתמש במקוםPullToRefreshState
. - חיבור הגלילה הפנימית הופרד מ-
PullToRefreshState
. היא מטופלת על ידי הממשקPullToRefreshBox
אוModifier.pullToRefresh
החדשים. - העדכון הזה הוא שינוי תוכנה שעלול לגרום לכשל בממשקי ה-API הניסיוניים הקודמים. (I0adeb, b/314496282, b/317177684, b/323787138, b/324573502, b/317177683)
- כדי להשתמש בערכים עשרוניים במקום ביחידות מסוג Dp, צריך לפשט את
שינויים ב-API
- השדה
RippleConfiguration#isEnabled
הוסר והתפקידLocalRippleConfiguration
הוגדר כ-null. כדי להשבית גלים, במקום לספקRippleConfiguration
עםisEnabled = false
, צריך לספקnull
ל-LocalRippleConfiguration
. (I22725) ModalBottomSheet
משרטט בצורה מדויקת יותר את שורת הסטטוס כאשר התכונה מופעלת מקצה לקצה. עכשיו, בתוכן של גיליון תחתון מודלי אפשר לצרוך תוספות של חלונות כדי להציג תוכן גלוי מעל סרגל הניווט. השם של הפרמטרwindowInsets
שלModalBottomSheet
השתנה ל-contentWindowInsets
כדי לציין את המיקום של הרכיבים הפנימיים. הם כבר לא קשורים ללוגיקת החלון. הסוגcontentWindowInsets
השתנה לפונקציה שמחזירה אתWindowInsets
, כדי לאפשר פתרון בחלון החדש. (I39630, b/274872542, b/300280229, b/290893168)PrimaryScrollableTabRow
ו-SecondaryScrollableTabRow
משתמשים עכשיו בפריסה מותאמת אישית במקום הרכב משנה, שאמור לשפר את הביצועים. (I991e0)- בוצעה לחיצה על האפשרות של עיצוב מצב בקישורי טקסט בנוסף לעיצוב הרגיל, העברת העכבר מעל והתמקדות.
TextDefaults
methods קיבלו ארגומנטpressedStyle
שיתמוך בכך. (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
כדי לחשוף את המסיכה, שלפיה הפריט נחתך (I785d8) - בוצעה הסרה של
BasicTooltipState
מה-API הציבורי של Material 3. הפונקציונליות שלו משולבת עםTooltipState
עד שה-BasicTooltip
של הקרן יתייצב. (Icda29) - נוסף אובייקט
TextDefaults
שמכיל methods לבנייתLinkAnnotation
ולניתוח מחרוזת מתויגת ב-HTML שמחילה אתMaterialTheme
על הקישורים (I98532, b/139312671) ExposedDropdownMenuBoxScope
לא מאפשר יותר כיתות משנה. בתפריטים נפתחים חשופים יש עכשיוMenuAnchorType
, שצריך להעביר אלmenuAnchor
כדי לתמוך בצורה טובה יותר ב-a11y. יש להשתמש באפשרות הזו במקום להעביר אתfocusable
אלExposedDropdownMenu
, שהוצא משימוש.menuAnchor
כולל פרמטר חדש לשליטה במצבenabled
. (I55ee6, b/257209915, b/308840226)- צבע הגבול של
OutlinedButton
תוקן כשהוא מושבת. נוסף עומס יתר שלButtonDefaults.outlinedButtonBorder("enabled")
שמשתמש במצב מופעל. (Ie650b, b/318461363) - נוספה מחלקה חדשה ב-
CarouselItemInfo
כדי לעזור ללקוחות לקבל מידע על מידות הפריטים. (I9070c) - ה-constructor של
ColorScheme
ללא קונטיינרים של הפלטפורמה הוצא משימוש. עליך לעבור ל-constructor שכולל קונטיינרים של פני השטח. (I35c11) - [Outlined]שם
TextFieldDefaults
שלContainerBox
השתנה ל-Container
. (Ie8d3b)
תיקוני באגים
- אם המדיניות
sheetSwipeEnabled
מוגדרת כ-False,BottomSheetScaffold
לא יגלול יותר מהגלילה הפנימית. (I5e1c1, b/306464779) - הוסרה הערת הסכמה אחת (
ExperimentalMaterial3Api
) במסמך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) - עודכנה חלונית ההזזה של הניווט 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 של
DismissDirection
ו-DismissValue
שהוצאו משימוש. (I89ccd) - נוסף תג ניסיוני לאובייקט הנלווי של
CarouselState
של הקרוסלה. (I94154) - צריך להוציא משימוש את
LocalMinimumInteractiveComponentEnforcement
ולהוסיף אתLocalMinimumInteractiveComponentSize
כדי להחליף אותו. (I7a7ac) - constructor של
SearchBarColors
הוא ציבורי עכשיו. (I769ca) - הפרמטר
gesturesEnabled
נוסף אלSwipeToDismissBox
. (Idc59f, b/324170119) - ממשקי API של שדות טקסט שהוסרו שסומנו כממשקי 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)- שינוי הסדר של הפרמטרים בתוכן קומפוזבילי עם פס הזזה (I9f315)
- ההטמעה של
ExposedDropdownMenu
מתבצעת עכשיו באמצעותPopup
. ההתנהגות צריכה להיות זהה, למעט תפריטים שניתן להתמקד בהם, שכוללים שדות טקסט שניתנים לעריכה, ועשויים להיסגר כשמקלידים במקלדת.
תיקוני באגים
- התפקידים הבסיסיים של קונטיינרים מסוג 'משטח' ו'משטח' הותאמו מעט, כך שיהיה לנו יותר גוון בעיצובים כהים ובהירים. (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
? גלישה שלonValueChangeFinished
בrememberUpdatedState
. (I82ab2, b/322269951) - לרכיבי הניווט יש עכשיו תפקידים חדשים מסוג
SurfaceContainer
. עכשיו יש ב-DrawerDefaults
מאפיינים ייחודיים שלstandardContainerColor
ו-modalContainerColor
.DrawerDefaults.ModalDrawerElevation
נקראת עכשיו0.dp
. (I7fbac) - מתבצעת הסרה של
@Stable
מהמצבים שלSlider
כי אנחנו משנים אתstate.onValueChangeFinished
ל-var
. (Ied34a, b/322269951) - מפרט האנימציה
ModalBottomSheet
ו-StandardBottomSheet
הוא עכשיוTweenSpec
, עודכן מאנימציה של אביב. הפעולה הזו פותרת בעיה של חריגה גלויה לעין. מבנים שלSheetState
שהוצאו משימוש ללא צפיפות הוסרו. (I7babc, b/285847707)
תיקוני באגים
- עכשיו רכיבים משתמשים ב-
SurfaceContainer
וריאציות. רכיבים שחושבו באופן רשמי באמצעות 'משטח' ו-TonalElevation
משתמשים עכשיו בתפקידיםSurfaceContainer
כברירת מחדל, שלא מושפעים מגובה טונלי. (b/304584161) - תוקן באג שגרם לכך שצבע המאגר של
ElevatedFilterChip
שהושבת ושהצבע שלו בוטל. (I400e6, b/322407043) - תיקון אינדיקטור התקדמות ביניים כאשר ההתקדמות היא 0 (Id6582)
- תוקנה בעיה ב-
Slider
וב-RangeSlider
בפריסה בצד ימין (Iab0e1) - הוספת
SliderRangeTolerance
לחישוב הטווח של פס ההזזה כי עיגול מספר ממשי (Float) עלול להיות לא מדויק. (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) - עדכון הצבע של מאגר Sheets בתחתית המסך וצבע נקודת האחיזה לגרירה. (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 מכילה את התחייבויות אלה.
תכונות חדשות
- עדכון הכתיבה M3
ModalBottomSheet
כדי לתמוך בחיזוי חזרה ב-U+ (Iccf32, b/281967264, b/304850357) - עדכון כתיבה M3
SearchBar
כדי לתמוך בחזרה חזויה ב-U+ (I657f8) - המחוון עודכן כדי לשפר את הנגישות על ידי הוספת פער ואינדיקטור עצירה. (I3058e)
ProgressIndicator
עודכן כדי לשפר את הנגישות על ידי הוספת פער ואינדיקטור עצירה. (I21451)- הוספת סמן ברירת מחדל להסבר קצר עשיר – עכשיו API חדש של הסבר קצר עשיר מאפשר לשרטט סמן טקסט מותאם אישית עם עוגן
LayoutCoordinates
. (Ifd42c)
שינויים בהתנהגות
- רכיבי החומר הועברו לשימוש בממשקי ה-API החדשים של Ripple, וכבר לא מתקבלות שאילתות על
RippleTheme
.
שינויים ב-API
- הכיף הגדול של
drawStopIndicator
גלוי עכשיו לכולם. (I3f59f) - סימון הפונקציה
formatWithSkeleton
שלDatePicker
כפנימית (Ic65dc) - ב-
DropdownMenu
יש עכשיו תמיכה בצבע, צורה, גובה וגבול בהתאמה אישית. (I8e981, b/289554448, b/301887035, b/283654243) - רכיבי Material3 שחושפים
MutableInteractionSource
ב-API שלהם עודכנו עכשיו ועכשיו הם חושפיםMutableInteractionSource
אפסי שברירת המחדל שלו היאnull
. אין כאן שינויים סמנטיים: העברת ערך null פירושה שלא רוצים להניף את ה-MutableInteractionSource
, והוא ייווצר בתוך הרכיב במקרה הצורך. שינוי ל-null מאפשר לרכיבים מסוימים לא להקצות אף פעםMutableInteractionSource
, ומאפשר לרכיבים אחרים ליצור מכונה באופן מדורג רק כשהם צריכים. פעולה זו משפרת את הביצועים ברכיבים האלה. אם אתם לא משתמשים בMutableInteractionSource
שאתם מעבירים לרכיבים האלה, מומלץ להעביר במקום זאת ערך null. מומלץ גם לבצע שינויים דומים ברכיבים שלכם. (I41abb, b/298048146) - הפונקציה מוסיפה את
RippleConfiguration
ואתLocalRippleConfiguration
כדי לאפשר התאמה אישית של הדים עבור כל רכיב או עץ משנה באמצעות ערכים קבועים. לדוגמה, כדי לשנות את הצבע של רכיב שאין לך שליטה עליו, או כדי להשבית 'גלים' של רכיב. ברוב המקרים צריך להשתמש בערכי ברירת המחדל: ממשקי ה-API האלה מהווים פתח להתאמה אישית של רכיבים בודדים או של עצי משנה מוגבלים. כדי לבצע שינויים רחבים יותר ומערכות עיצוב בהתאמה אישית, מומלץ ליצור גלים משלכם באמצעותcreateRippleModifierNode
. (I7b5d6, b/298048146) - הוספת ממשק API של ripple API ב-Material3 שמחליף את
rememberRipple
שהוצא משימוש. בנוסף, המערכת מוסיפה גםCompositionLocal
,LocalUseFallbackRippleImplementation
זמני, כדי להחזיר רכיבי חומר 3 לשימוש בממשקי ה-API שלrememberRipple
/RippleTheme
שהוצאו משימוש. האפשרות הזו תוסר בגרסה היציבה הבאה, והיא נועדה לשמש כאמצעי עזר זמני בלבד להעברה במקרים שבהם בחרת לספקRippleTheme
בהתאמה אישית. (I34cbc, b/298048146)
תיקוני באגים
- הרכב המשנה הוסר בתוך
ModalBottomSheet
כדי לשפר את הביצועים. תוקנה בעיה שבהModalBottomSheet
עלול לקרוס בתרחישים ספציפיים בשילוב עםLookaheadScope
. (I2a198) - הרכב המשנה הוסר בתוך
BottomSheetScaffold
כדי לשפר את הביצועים. תוקנה בעיה שבהBottomSheetScaffold
קרס בתרחישים ספציפיים בשילוב עםLookaheadScope
. (Ie6401) - היישור של התג מתכוונן כך שיהיה קרוב יותר למרכז תוכן העוגן ביחס לפינה השמאלית העליונה. (I18a28)
- תיקון בעיה בעיה ב-
DateRangePicker
שבה כותרת הטקסט של חודש-חודש הועברה לקורא המסך כפעולה לביצוע, 'גישה באמצעות מתג' ו'גישה קולית'. (I2ac55) - תוקן באג בהזמנה של פרמטר אחד (
mediumTopAppBarColors
). (Ibe64a)
גרסה 1.2
גרסה 1.2.1
6 במרץ 2024
androidx.compose.material3:material3-*:1.2.1
משוחרר. גרסה 1.2.1 כוללת את ההתחייבויות האלה.
תיקוני באגים
- חוזרים ליציבות של מצבי פס ההזזה. רוצה להגדיר שוב את
State.onValueChangeFinished
? גלישה של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 כוללת את ההתחייבויות האלה.
בעיה ידועה
- באג לרינדור של התכונה 'צפייה בכתיבה הדדית' נוסף ל-
PrimaryTabRow
כחלק משינוי לשיפור הביצועים. הדרך לעקוף את הבעיה היא להשתמש ב-TabRow
עםTabRowDefaults.PrimaryIndicator
שינויים חשובים מאז 1.1.0
רכיבים חדשים ב-Material Design 3
- צריך למשוך כדי לרענן
- לחצן הפילוח
שיפורים ברכיבים קיימים של Material Design 3.
- סרגל אפליקציה תחתון (יישור RL, הסתרה אוטומטית בזמן גלילה)
- עדכון חזותי של הכרטיסיות
- תג (עדכון התאמה)
קידמה ממשקי 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) - הוצאה משימוש של
DismissDirection
ו-DismissValue
ממשקי API. המשבצות האלה מוזגו אלSwipeToDismissValue
, שהערכים שלהן מציינים גם את המיקום וגם את הכיוון שלSwipeToDismissBox
.DismissState.progress
מסומן עכשיו כFloatRange
בין0.0
ל-1.0
. הוסרוDismissState
פריטים שמורים ו-Buildor שהוצאו משימוש. רכיב, מצב ואובייקט ברירת מחדל מסוגSwipeToDismiss
סומנו כניסיוניים. (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
כציבורי. (Ie0c48, b/308432421) - מתבצעת הוספה של
ModalBottomSheetProperties
. מתבצעת העברה שלsecurePolicy
אלModalBottomSheetProperties
. מתבצעת הוספה שלisFocusable
ושלshouldDismissOnBackPress
אלModalBottomSheetProperties
. הבוליאני החדש האלה עוזר לקבוע כיצד גיליון תחתון של מודל צריך לטפל באירועי IME. (Iea56f, b/278216859) - המצבים
RangeSlider
ו-Slider
עודכנו כדי להסיר אתinitialOnValueChange
, את הקידומות הראשוניות ואת ה-kdocs המתאים. (I57d30) - צריך להוציא משימוש את המחלקה
ChipBorder
ואת הקריאות לפונקציות שמשויכות אליה. במקום זאת, מומלץ להשתמש ישירות ב-BorderStroke
. (I89cc2) - ממשקי ה-API של הסבר קצר בסיסי הם עכשיו
@ExperimentalFoundationApi
. (I30b0b) TabRow
ו-ScrollableTabRow
כבר לא הוצאו משימוש. הווריאנטים הראשיים והמשניים החדשים מסומנים כניסיוניים. (I0def6)- צ'יפים של סינון וסינון משתמשים עכשיו ישירות ב-
BorderStroke
. (I07a8d) SegmentedButton
משתמש עכשיו ישירות ב-BorderStroke
. (I89b9b)- שינו את השם של הפונקציה
AlertDialog
הגנרית ל-BasicAlertDialog
ומוציאים משימוש את הפונקציה הקודמת. (Idbe52) - שינוי השם של
SwipeToDismiss
ממשקי ה-API ל-SwipeDismiss
וקידום ממשקי ה-API החדשים שלSwipeDismiss
ליציבות. (I14cbe) - הוספה של
tonalElevation
ו-shadowElevation
להסבר קצר על ממשקי API. בנוסף, אנחנו מעבירים את ממשקי ה-API שלTooltipBox
,PlainTooltip
ו-RichTooltip
חזרה לגרסה ניסיונית כי הם שוחררו בטעות כיציבים. (If0f66, b/293939035) - קידום ממשקי API ניסיוניים של צ'יפים ניסיוניים ליציבות. (Iea2c3)
- הוסרה ההערה
@ExperimentalMaterial3Api
מהכרטיסים שניתן ללחוץ עליהם ב-Material3. (I88dbf)
תיקוני באגים
- תוקנה בעיה שבה
SwipeToDismiss
קרס בתרחישים מסוימים עם פריסות Lookahead ופריסות מוטמעות של Lookahead. (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
כמו lambda. הגרסאות האלה אמורות להיות איכותיות יותר בהשוואה לגרסאות הקודמות. (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
הוחלף בשיטות הפתיחה והסגירה, וההיסט חשוף עכשיו כצף במקום כאובייקט מצב. אפשר לגשת לקיזוז ישירות דרךcurrentOffset
. (I0a72c) - נוספו פונקציות שאינן קומפוזביליות כדי ליצור ישירות
DatePickerState
ו-DateRangePickerState
. אפשר להשתמש בפונקציות האלה כחלופה לפונקציות הקומפוזביליותrememberDatePickerState
ו-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
ניתן לשינוי באופן בלתי הפיך, כך שעדכוני הצבעים ספציפיים יכולים להיות פחות יעילים, אבל השימוש בצבעים יותר יעיל יותר. הסיבה לשינוי הזה היא שברוב האפליקציות לא יהיה עדכון של צבעים ספציפיים כתרחיש לדוגמה העיקרי. זה עדיין אפשרי, אבל הוא יבנה מחדש את הנתונים מבעבר, וכתוצאה מכך נצמצם משמעותית את מספר המינויים לפי מדינה בכל הקוד של Material Code, וזה ישפיע על האתחול ועל עלות זמן הריצה של יותר תרחישים לדוגמה של משתמשים רגילים. (Ic447d, b/297212873) - גובה טונלי כבר לא מבצע אנימציה במצבי אינטראקציה שונים כדי להתאים למפרט. (Icdd12)
שינויים ב-API
- נוסף
BottomAppBar
חדש שמקבל כפרמטרBottomAppBarScrollBehavior
כדי להסתיר אותו באופן אוטומטי כשגוללים בתוכן. נוסף גםFabPosition.EndOverlay
, כך שאפשרת ה-FAB להוסיף שכבת-על לסרגל האפליקציה התחתון במקום להיות מעוגנת מעליו. (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
מטמיעים אתDraggableState
(I9b116)- משנים את הצורה לפרמטר נדרש. שינוי השם של
position
ל-index
בפונקציה ליצירת צורות. (I34941) - היא מעדכנת את
DatePicker
formatWithSkeleton
כך שתכלול מפה שמשמשת כמטמון לשיפור הביצועים. (I3195f) - הוספנו את
BasicTooltipBox
אלcompose.foundation
, ועדכנו אתPlainTooltipBox
ואתRichTooltipBox
לשימוש ב-TooltipBox
עם תכנים קומפוזביליים חדשים שלPlainTooltip
ו-RichTooltip
. (I79e1d)
תיקוני באגים
dynamicLightColorScheme
ו-dynamicDarkColorScheme
מחזירים עכשיו צבעי Chroma גבוהים יותר לתפקידים של פני השטח ו-surfaceContainer
. (I5e901)- תוקנה בעיה שבה רכיבים מסוימים שמשתמשים בתת-רכיב (למשל
BottomSheetScaffold
) בתוך פיגם בתוךLookaheadScope
ניסו לקרוא את הגודל שלהם מוקדם מדי. (I297b4, I871f1, b/295536718)
גרסה 1.2.0-alpha06
23 באוגוסט 2023
androidx.compose.material3:material3-*:1.2.0-alpha06
משוחרר. גרסה 1.2.0-alpha06 מכילה את התחייבויות אלה.
תיקוני באגים
- בוצע תיקון של חישוב
offset
שלDropdownMenu
, כך שהקיזוזים של x תלויים אך ורק בכיוון הפריסה המקומי, והקיזוזים של y לא יבוטלו יותר כשהתפריט נמצא קרוב לתחתית המסך. (Iccc74, b/294103942) - בוצע תיקון של חישוב
offset
שלDropdownMenu
, כך שהקיזוזים של 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 מכילה את התחייבויות אלה.
תכונות חדשות
- ממשק API ניסיוני של לחצן מפולח (Ifc8fb)
- למפרידים יש עכשיו פרמטר שקובע את הכיוון ותומך בקווים מפרידים אנכיים. (I4c899, b/288438593)
שינויים ב-API
- אנחנו מעבירים את התלות בצפיפות לרמת הרכיב. האפשרות הזאת רלוונטית לרכיבים הבאים:
SwipeToDismiss
ורכיבים מבוססי גיליון. צריך להשתמש בעומס-היתר החדש שמסופק כאשר הצפיפות היא פרמטר. (I1846e) - הערות נוספות שמציינות ערכי קלט מותרים לתכנים קומפוזביליים (Ief234)
- אפשר להוסיף פרמטר של סמל ללחצן פילוח, לסמנטיקה המפוצלת כדי שניתן יהיה לבחור את הלחצנים המפולחים להטמעת בחירה יחידה, וניתן יהיה להחליף ביניהם כדי להטמיע בחירה מרובה, באמצעות
SelectableSegmentedButtonRow
ו-ToggelableSegmentedButtonRow
בהתאמה. (I38740) - שם המחיצה השתנה ל-
HorizontalDivider
. נוספה פונקציונליותVerticalDivider
. (I5975c) - כדי למזער את פורמט Autobox, משנים את השימוש ב-
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
. (Ic203c, b/277774590)
שינויים ב-API
- פותחים את בונה הצבעים של הרכיבים. (I8c4a6)
- הוספת פרמטר שניתן להתמקד בו לשני ממשקי ה-API של ההסברים הקצרים, כדי שהמפתחים יוכלו להשתמש בהסבר הקצר להשתמש באירועי מגע או לא. יש לנקוט משנה זהירות, והפעולה הזו עלולה לשבש את המעבר האוטומטי של המיקוד לנגישות. (Ie32d8)
- נגישות אופטימלית לביצועים ולהקצאות זיכרון. (Iede48)
- חשיפת
DefaultSizeClasses
ויצירתStandardSizeClasses
עבורWindowSizeClasses
(I91838) - שינוי
WindowWidth/HeightSizeClass
למחלקות של ערך צף (Ie686e)
תיקוני באגים
- הפרמטר
contentWindowInsets
של Scaffold מתייחס עכשיו לרכיבים נצרכים של חלונות. חשוב לשים לב שהתנהגות המרווח הפנימי של התוכן שמבוסס עלtopBar
ו-bottomBar
נשארת ללא שינוי כשהפרמטרים האלה מסופקים. (I08b73, b/264601542) - כדאי לתקן את היישור של סרגל האפליקציה העליון במרכז כדי לוודא שכותרת ארוכה לא מוצגת מעל סמלי הפעולות או סמל הניווט. (I4369f, b/236994621)
- מיקומי כרטיסיות אוכפים עכשיו רוחב תוכן מינימלי של 24.dp. הדבר מספק משטח מגע נגיש לאינדיקטורים של כרטיסיות. (Id8861)
- בלוחות צבעים דינמיים מ-
dynamicLightColorScheme
ומ-dynamicDarkColorScheme
יש עכשיו תמיכה בתפקידים חדשים על פני השטח. (I1252e) - עדכון ההתאמה של התראת התג כך שלא ייחתך כשמתנגשים עם סבא/סבתא. (Idf75a)
גרסה 1.2.0-alpha02
24 במאי 2023
androidx.compose.material3:material3-*:1.2.0-alpha02
משוחרר. גרסה 1.2.0-alpha02 מכילה את התחייבויות אלה.
שינויים ב-API
- צריך להוסיף את הפרמטר insets של החלון ל-
ModalBottomSheet
.- ניתן עכשיו רישום של
ModalBottomSheet
מאחורי שורת הסטטוס כאשרwindowInsets
מוגדר כאפס - פונקציית ברירת המחדל של
ModalBottomSheet
עודכנה כדי להישאר מחוץ לסרגלי המערכת, כולל הניווט - הטיפול בתמונה של שורת הסטטוס מתאפשר על ידי נקודת האחיזה לגרירה במצב 'קצה-לקצה'.
BottomSheetDefaults
כולל insets של חלונות עבורBottomSheetWindow
. (I31200, b/274872542, b/272973615, b/272334475, b/268432129, b/275849044, b/275b/275
- ניתן עכשיו רישום של
- צריך להוציא משימוש את
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) - נוצרו ממשקים ציבוריים של
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) TimePicker
הוסר מ-API היציב. צפויים שינויים נוספים ב-State API (I3f39a)- האפליקציה
ModalBottomSheet
הועברה ל-Android בלבד. לא מומלץ להשתמש ב-ModalBottomSheet
במחשב, והפונקציונליות לא מתוחזקת באופן פעיל. (Ib3778)
תיקוני באגים
- תוקנה פעולת הסגירה
AlertDialog
כך שתופיע מתחת לפעולת האישור כשהפעולות נערמו זו על זו כדי להתאים לרוחב של תיבת הדו-שיח. התיקון הזה נועד להתאים את ההטמעה למפרט של עיצוב חדשני תלת-ממדי. (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) - צריך להוסיף את הפרמטר insets של החלון ל-
ModalBottomSheet
.- ניתן עכשיו רישום של
ModalBottomSheet
מאחורי שורת הסטטוס כאשרwindowInsets
מוגדר כאפס - פונקציית ברירת המחדל של
ModalBottomSheet
עודכנה כדי להישאר מחוץ לסרגלי המערכת, כולל הניווט - הטיפול בתמונה של שורת הסטטוס מתאפשר על ידי נקודת האחיזה לגרירה במצב 'קצה-לקצה'.
BottomSheetDefaults
כולל insets של חלונות עבורBottomSheetWindow
. (I31200, b/274872542, b/272973615, b/272334475, b/268432129, b/275849044, b/275b/275
- ניתן עכשיו רישום של
גרסה 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
TimePicker
הוסר מ-API היציב. צפויים שינויים נוספים ב-State API (I3f39a)- האפליקציה
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
. הוא מאפשר להשתמש בפריסות שונות, בהתאם לתצורת המסך (Ia0e16) - התכונה
SearchBarDefaults
סומנה כניסיונית. (I65561) - נוסף גובה הצללית ל-
BottomSheetScaffold
(I94e0f) - נוספה תמיכה בהצגת החלונית לבחירת תאריך ללא חלק הכותרת. ה-API משתנה כדי לאפשר העברה של כותרת null כשיוצרים חלונית לבחירת תאריך. עכשיו אפשר להעביר ערכים ריקים של כותרת, שם פריט ו-
showToggleMode = false
כדי להציג כלי בחירה ללא GUI. (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
כדי לאפשר הגדרה של תאריכים אחרי היצירה הראשונית של המצב, וגם איפוס של בחירות על ידי הגדרת חותמות זמן ריקות. צריך להפעיל שיקול דעת כשמגדירים תאריכים באופן ידני, והפונקציהsetSelection
החדשה תגרום לחריגה במקרה שתאריך שצוין לא עומד בתנאי מוקדם (עיינו במסמכי התיעוד). (Ifa645, b/268609314, b/270427389) - שינוי השם של
SheetValue
המכווצים לשםPartiallyExpanded
כדי לתאר בצורה מדויקת וגמישה יותר את ההתנהגות במצב הזה. (Ia1491) - שמות הפרמטרים של
ListItem
עודכנו ל- _content במקום ל- _text. מקבלי ברירת המחדל הם עכשיוReadOnlyComposables
במקומות הרלוונטיים. (I69a25) - שדרוג ממשקי ה-API של פני השטח האינטראקטיביים מניסיוני. (I90d59, b/261561812)
תיקוני באגים
- תוקנה בעיה שבה המצב
HalfExpanded
שלModalBottomSheet
חושב בצורה שגויה והגיליון נראה צף. (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 מכילה את התחייבויות אלה.
תכונות חדשות
- צריך להוסיף תוכן קומפוזבילי עם קלט זמן שפועל עם
rememberTimePickerState()
, הוא תואם למפרט של M3 לקלט זמן (Ia4fab) - הוספנו Material 3
DateRangePicker
API לבחירת טווח תאריכים. (I7a6c3, b/267194809) - נוספה תמיכה במצב קלט של Material 3 לבחירת טווחי תאריכים באמצעות ה-API של
DateRangePicker
. (Ifdbc4) - עכשיו אפשר להתאים אישית את הצבעים של שדות הטקסט:
- הצבעים של השדה להזנת הקלט והטקסט של ה-placeholder, על סמך המיקוד ומצב השגיאה. השם של הפרמטר
textColor
השתנה ל-unfocusedTextColor
, והשם של הפרמטרplaceholderColor
השתנה ל-unfocusedPlaceholderColor
. - צבע המאגר של שדות טקסט שמולאו על סמך מצב שגיאה עם הפרמטר
errorContainerColor
החדש.
- הצבעים של השדה להזנת הקלט והטקסט של ה-placeholder, על סמך המיקוד ומצב השגיאה. השם של הפרמטר
- הצבעים של שדות הטקסט בתפריט הנפתח החשופים עודכנו בפרמטרים כדי לתמוך ב-API החדש של הקידומת והסיומת. (I9c8b4, b/254284181, b/264766350)
שינויים ב-API
- ביטול של חלק מהגרסאות של Slider API והסרת עומסי יתר מיותרים של פס הזזה שמכוסה על ידי ה-Slider הניסיוני החדש, עם אגודל ונתיב מותאמים אישית. אנחנו מקדמים את
RangeSlider
כדי לשמור על יציבות. (Ie8fbd) - השם של
defaultElevation
השתנה בפונקציות הגובה של הצ'יפ ל-elevation
. (I0f872) - ממשקי ה-API הבאים של שדות הטקסט ב-Material 3 כבר לא ניסיוניים:
TextField
,OutlinedTextField
,textFieldWithLabelPadding
,textFieldWithoutLabelPadding
,outlinedTextFieldPadding
. (Ieb5c0, b/261561819) TimePickers
is24Hour
משתמש בהגדרת המערכת (I18856)- הערה ניסיונית הוסרה מ-Scaffold API. (Ibb51e, b/261565765, b/261436953)
תיקוני באגים
- עכשיו צורת ברירת המחדל של
ModalBottomSheet
היא תמידSheetDefaults.ExpandedShape
. (I0dfca) - שיפורי נגישות ב-Material 3
DatePicker
וב-DateRangePicker
. (I5087e) - צריך לתקן באג שאילוץ הגובה המקסימלי מופץ ועלול לקרוס. (I30d8c)
- תפקידים סמנטיים הוסרו מפלטפורמות שאפשר ללחוץ עליהן ולבחירה בהן, עודכנו רכיבים שבהם הם השתמשו כדי להגדיר תפקידים באמצעות matching.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)
- קידום של
ListItem
,ListItemDefaults
ו-ListItemColors
API לא ניסיוני (I7e7fa, b/261438882) - קידום של
SliderPositions
,SliderDefaults.Thumb
ושלSliderDefaults.Track
ליציבות והוספת ממשקי API לא ניסיוניים שלSlider
ו-RangeSlider
שמכילים סימוני 'אהבתי' ו'מעקב' מותאמים אישית. נוציא משימוש גם את ממשקי ה-API הקודמים שלSlider
ו-RangeSlider
. (Ie5ea6, b/261566890) - השדה
Modifier.tooltipAnchor()
הוגדר כגלוי לכולם, כך שהמפתחים יכולים להעביר אותו לעוגן כדי לציין הסבר קצר שצריך להציג בלחיצה ארוכה. ממשק ה-API שלPlainTooltipBox
עודכן כך שלא יהיה יותר אפס שלTooltipState
, והוא מוגדר עכשיו כברירת מחדל. (Ie2fb7) ProgressIndicatorDefaults.circularTrackColor
סומן כ-@Composable
לצורך עקביות. (Id29cc)- שוחזר הנכס
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
ב'פלטפורמות'. המאפיין הזה ישמש בשינוי מאוחר יותר שיקבע את סדר המעבר על סמך המשמעות הסמנטית של אלמנטים כמו פלטפורמות. I63379 - סימון ממשקי ה-API שקשורים לחלונית ההזזה לניווט כיציבים. (Iab01e, b/261439597)
- הוספנו פרמטר של צבע מסלול לאינדיקטורי התקדמות מעגליים, ופרמטר של מגבלת קווים לאינדיקטורי התקדמות מעגליים ולינאריים. (Ie668c, b/216325962, b/222964817)
- יותר ערך אפסי של סוג החזרה של פונקציות מוסתרות שהוצאה משימוש (Ibf7b0)
- הוספה של
Modifier.minimumInteractiveComponentSize
. אפשר להשתמש בו כדי לשמור בגודל 48.dp לפחות כדי להבחין בין אינטראקציות מגע אם הרכיב יהיה קטן יותר. (I33f58, b/258495559) - נוסף API ניסיוני לתוכן קומפוזבילי
AlertDialog
שמכיל משבצת תוכן. (Iec4a2)
תיקוני באגים
- ההתקדמות של מדדי ההתקדמות מוגבלת עכשיו כראוי לטווח הצפוי שלה. (I8a7eb, b/262262727)
בעיה ידועה
- בעדכון מ-
androidx.compose.foundation:1.4.0-alpha03
ל-androidx.compose.foundation:1.4.0-alpha04
, יכול להיות שתופיע הודעת השגיאהjava.lang.NoSuchFieldError
. כאן הבעיה דווחה בארגון. נשלח תיקון, ויהיה זמין בעדכון הבא של 'כתיבה'. כדי לעקוף את הבעיה, עליך לעדכן את הספריות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()
. השם החדש הואconsumeWindowInsets()
ואת השםwithConsumedWindowInsets()
לשםonConsumedWindowInsetsChanged()
. המשנים הפכו לגלויים לכולם. (Ie44e1) - הוספת מרווח פנימי חדש לתוכן שמוגדר כברירת מחדל ללחצן הטקסט עם סמל לשימוש. (I8f662)
- נוספו צבעים מושבתים לסרגל הניווט ולרכבת. (Ia7892, b/258867034)
- נוסף ממשק API של Modifier להרצת שאילתות על פרטי גלילה של ישויות אב. (I2ba9d, b/203141462)
- נעשה שימוש ב-
Clickable
כדי לעכב באופן תקין אינטראקציות עם העיתונות, כאשר תנועות עשויות להפוך לאירועי גלילה. - בוצע תיקון של
Clickables
לעיכוב תקין של הדים בזמן שימוש בתוךScrollable ViewGroup
. - חלונית ההזזה ו-Sheets עודכנו כדי להשהות לחיצות בצורה נכונה במקרה שתנועות יכולות להפוך לאירועי גלילה.
עדכונים בנושא תלות
Compose UI
ו-Compose Material
תלויים עכשיו במחזור החיים 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
ל-Material3 Text,TextField
ו-OutlinedTextField
, המאפשר להגדיר את הגובה המינימלי של הרכיב מבחינת מספר השורות (I4af1d) - להוציא משימוש את הפונקציה
TopAppBarDefaults smallTopAppBarColors
לטובת פונקצייתtopAppBarColors
חדשה שבה צריך להשתמש כשיוצריםTopAppBar
. (Ie6cb9) - הפרמטר
minLines
נוסף לערכיBasicText
ול-BasicTextField
. הוא מאפשר להגדיר את הגובה המינימלי של תכנים קומפוזביליים כאלה מספר השורות (I24294, b/122476634)
תיקוני באגים
- מצמידים את התוכן של
IconButton
ו-IconToggleBotton
ב-Material3 לצורת שכבת המצב של הרכיב (למשל, צורה מעגלית). (I9da8f) - מעדכנים את סרגלי האפליקציות Medium ו- Large באפליקציות בחלק העליון של המסך כדי להחיל את אותו צבע רקע על פני השטח כולו, וכדי לאפשר הגדרה של צבעי ברירת המחדל שמוגדרים עם ערכי צבעים שקופים. (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 ומברשת. (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 כוללת את ההתחייבויות האלה.
תיקוני באגים
- מעדכנים את סרגלי האפליקציות Medium ו- Large באפליקציות בחלק העליון של המסך כדי להחיל את אותו צבע רקע על פני השטח כולו, וכדי לאפשר הגדרה של צבעי ברירת המחדל שמוגדרים עם ערכי צבעים שקופים. (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
רכיבים בעיצוב חדשני 3
- תג
- סרגל האפליקציה התחתון
- לחצנים
- FAB ו-FAB מורחב
- כרטיסים
- תיבת סימון
- צ'יפים
- תיבות דו-שיח
- קו מפריד
- תפריט נפתח
- רשימה
- סרגל הניווט
- חלונית הזזה לניווט
- רכבת ניווט
- אינדיקטור התקדמות
- לחצן בחירה
- פס הזזה
- החלפה
- כרטיסיות
- שדות טקסט
- סרגל האפליקציה העליון
- סמל
- שליחת הודעת טקסט
- סוג המסך
- Surface (שטח)
- פריסה
- צבע התוכן
סיווג גודל החלון
material3-window-size-class
היא ספרייה חדשה שמספקת תמיכה בסיווגים של גודל החלונות: קבוצה של נקודות עצירה (breakpoint) מקובעות של אזור התצוגה שאפשר לתכנן, לפתח ולבדוק מולן פריסות של אפליקציות שניתן לשנות את הגודל שלהן. אפשר להשתמש בפונקציהcalculateWindowSizeClass
כדי לאחזר מופע של סיווג גודל חלון, וכך לקבוע איך ממשק המשתמש ייראה. למשל, הצגת רכבת ניווט במקום ניווט תחתון לחלונות גדולים יותר. למידע נוסף ולשימוש לדוגמה, עיינו במסמכי העזרה של API עבורWindowSizeClass
.בפוסט הזה בבלוג אפשר לקרוא פרטים נוספים.
גרסה 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
תיקוני באגים
- מיפוי הצבע של העיצוב הכהה עודכן לטון 90 של 'On Error Container' (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
- ערכות inset של רכיבי ברירת מחדל שנוספו לרכיבי m3 בגרסת בטא01 כבר לא כוללות ערכות IME.
- רכיב הפיגומים של Material3 כולל עכשיו פרמטר
contentWindowInsets
, שמאפשר לציין את כמות הרכיבים הפנימיים לטיפול במיקום התוכן. (Icf11a, b/243713323) - מוציאה משימוש את הפונקציה הניסיונית
SmallTopAppBar
של Material 3 ומציגה פונקצייתTopAppBar
מקבילה. עליך להעביר את במכשיר החדש. (I74404, b/226918634) - הוספת שליטה על התנהגויות של החלקה והצמדה בסרגל העליון של האפליקציה. (I15c81)
- מסירה את כניסת הפיסקה מהמחיצה, ומעבירה את הצבע לפרמטר האחרון. (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
לתכונה 'קומפוזבילי' ולספק ערכי ברירת מחדל למצב של סרגל האפליקציה העליון ולמפרט האנימציה. (I642b3) - חתימות של רכיבי FAB עודכנו כך שיתאימו ל-Platform API (I3afaa)
- נוספה תמיכה מובנית בסרגלי אפליקציות מובילים, בחלונית הזזה, בסרגל ניווט וברכבת. כשמשתמשים ברכיבים האלה בנפרד או עם Scaffold, המפתחים יטפלו באופן אוטומטי בהטמעות. הערה: השינוי הזה לא מוסיף טיפול אוטומטי בסמלים בשורת הסטטוס ושקיפות של הסטטוס וסרגלי הניווט. כדאי להמשיך לעשות זאת ידנית כדי ליהנות מחוויית השימוש הטובה ביותר, מקצה לקצה. (I7e4e6, b/183161866)
- ברירות המחדל של הרכיבים עודכנו כדי לצמצם את פלטפורמת ה-API לשיפורי גמישות וביצועים עתידיים. (I31820)
- הפרמטרים של הצ'יפ והחלונית בחלונית ההזזה לניווט עודכנו מחדש כדי לשמור על עקביות ב-API (I45d0b)
- הפונקציה
startIndent
הוסרה מהמחיצה והעברת הצבע להיות הפרמטר האחרון.(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
- שינוי סדר הפרמטרים של הכרטיסייה 'כרטיסייה' ו'סמל הלידים' כדי לשמור על עקביות ב-API (Ie2637)
- האלגוריתם
BadgeDefaults
סומן כניסיוני. (I98ef3) - מסירים את הפונקציה של חלונית ההזזה לניווט שהוצאה משימוש. (I4f2db)
- שינוי הסדר של הפרמטרים של פס הזזה ב-Material 3 כדי לשמור על עקביות ב-API (I0aee7)
- שינוי הסדר של הפרמטרים
NavigationBar
ו-NavigationRail
כדי לשמור על עקביות ב-API (I51cda) - שינוי הסדר של הפרמטרים ב-Material 3 כדי לשמור על עקביות בכל ה-API. (If4ae1)
- שינוי הסדר של הפרמטרים של פס הזזה ב-Material 3 כדי לשמור על עקביות בתוך ה-API (I62673)
- השם של הפרמטר של הסמלים השתנה ל'פעולות' בהתאם לסרגל האפליקציה העליון (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) - מוסיפים תפקידים של צבעי הדגשה וקווי מתאר. (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
- שינוי שם הפרמטר מערכים לערך ב-
RangeSlider
(I3b79a) - שינויים ב-API בהטמעה של
InputChip
כדי לתמוך במצב שניתן לבחירה בהתאם למפרט של Material Design. תמיכה נוספת בצבעיFilterChip
במצב המושבת שנבחר. (I55244, b/235792432) - הוספת FAB של
BottomAppBar
שמוגדר כברירת מחדל (Ida4c8) ColorScheme.surfaceColorAtElevation
התווסף (Id41af)- הממשקים בספריות הכתיבה נוצרים עכשיו באמצעות jdk8 שיטות ברירת מחדל של הממשק (I5bcf1)
WindowWidthSizeClass
ו-WindowHeightSizeClass
מטמיעים עכשיו את התכונה 'דומה', כך שאפשר להשוות ביניהם באמצעות אופרטורים (<, <=, >=, >) וממשקי 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. (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
- השם של התוכן הקומפוזבילי
TextFieldDefaults.BorderStroke
שונה עם קו גבול מהטווחOutlinedTextField
לערךTextFieldDefaults.BorderBox
. (I5f295) - שינויים חזותיים ב-Switch m3 (Iab30e)
- אפשר להעביר צבעים ללחצני הסמל הרגילים. (Ia2445)
תיקוני באגים
- צריך להוסיף בדיקת שגיאות בקוד ל-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
היא ספרייה חדשה שמספקת תמיכה בסיווגים של גודל החלונות: קבוצה של נקודות עצירה (breakpoint) מקובעות של אזור התצוגה שאפשר לתכנן, לפתח ולבדוק מולן פריסות של אפליקציות שניתן לשנות את הגודל שלהן. אפשר להשתמש בפונקציהcalculateWindowSizeClass
כדי לאחזר מופע של סיווג גודל חלון, וכך לקבוע איך ממשק המשתמש ייראה. למשל, הצגת רכבת ניווט במקום ניווט תחתון לחלונות גדולים יותר. למידע נוסף ולשימוש לדוגמה, עיינו במשאבי העזרה של ה-API ל-WindowSizeClass
. מידע נוסף על ההגדרות של סיווג גודל החלונות זמין בהדרכה הציבורית לגבי תמיכה במסכים בגדלים שונים.
שינויים ב-API
- הוספת גובה FAB שמוגדר כברירת מחדל עבור
BottomAppBar
, הסרת lambda בסוף מ-BottomAppBar
עם FAB. (I92c47) - הפונקציה מוסיפה את Material3
FilledIconButton
,FilledTonalIconButton
ו-OutlinedIconButton
. (Ib2bda) - המערכת מעדכנת את ה-API של סרגל הכתובות של Material 3 כדי לאשר ערכי צבעים לפעולה האופציונלית ולביטול הפעולה. (Ibe4b4)
- האפשרות 'צריכה חלקית (מיקום למטה' או 'מיקום נמוך') הוצאה משימוש ב-
PointerInputChange
. אפשר להשתמש ב-consume()
כדי לקבל את השינוי באופן מלא. אפשר להשתמש ב-isConsumed
כדי לבדוק אם מישהו אחר ביצע את השינוי בעבר. - מעכשיו,
PointerInputChange::copy()
תמיד יוצר עותק שטחי שימוש. פירוש הדבר הוא שעותקים שלPointerInputChange
ייצרוך לאחר מימוש אחד מהעותקים. כדי ליצורPointerInputChange
ללא גבולות, צריך להשתמש ב-constructor. (Ie6be4, b/225669674) - שינויים ב-Card API לקבלת צבעי הקונטיינר והתוכן דרך ממשק
CardColors
, ולתמיכה במצב מושבת עבור שאפשר ללחוץ עליהם. (I927df) - השם של הפרמטר
backgroundColor
השתנה ל-containerColor
בשדות טקסט של Material 3 כדי לשפר את העקביות עם רכיבים אחרים. (I6fbd9)
תיקוני באגים
- עדכונים של
IconButton
הסטנדרטי כדי להתאים אותו למפרט של Material3. (I09eab) - מזיזים את גובה העמודה העליונה של חומר3 פיגוע למרווח הפנימי שמועבר לתוכן, כך שהתוכן יוצג מתחת לסרגל העליון של האפליקציה. אם המערכת מתעלמת מהמדיניות
PaddingValues
, יכול להיות שהתוכן מוסתר על ידי הסרגל העליון. (I83cbc, b/217776202)
גרסה 1.0.0-alpha09
6 באפריל 2022
androidx.compose.material3:material3:1.0.0-alpha09
משוחרר. גרסה 1.0.0-alpha09 מכילה את התחייבויות אלה.
תכונות חדשות
- נוסף ממשק API של Material 3 Switch (I2c3ad)
שינויים ב-API
- נוספה תמיכה בתפריטים נפתחים עם שדות טקסט (מוכר גם כ'תפריטים נפתחים חשופים' או 'תיבות משולבות'). (I1b832)
- פרמטר הצורה נוסף למערכת המשנה MaterialTheme ו-Form. (I37426)
- נוסף פרמטר מורחב אל
ExtendedFloatingActionButton
כדי לקבוע אם לחצן ה-FAB מורחב או מכווץ, עם אנימציות בין כל מצב. נוסף עומס יתר מורחב של FAB עבור FAB מורחב עם טקסט בסוף עבור 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
- הוספה של מחיצת ברירת מחדל לתפריט (I01374)
- פרמטר של צבע
surfaceTint
נוסף למחלקהColorScheme
. (I2f558)
תיקוני באגים
- תיקון בלחצן Material3 כדי לקרוא את ערך ברירת המחדל של סגנון הטקסט מתוך 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 שמחזירים את בפונקציות עמוסות מדי עבור פלטפורמות קליקביליות, וגם לתמיכה ב'פלטפורמות' שניתן לבחור או להחליף. (I4bf18)
LazyVerticalGrid
ו-LazyHorizontalGrid
יציבים עכשיו. (I307c0)LazyVerticalGrid/LazyHorizontalGrid
וכל ממשקי ה-API הקשורים הועברו אל חבילת המשנה grid. יש לעדכן את הפריטים המיובאים מ-androidx.compose.foundation.lazy ל-androidx.compose.foundation.lazy.grid. (I2d446)- בוטל שינוי קודם שהסתמך אך ורק על 'תצוגה עבור'
WindowInsetsControllerCompat
, ושוב נדרש חלון שנדרשת לניהול חלק מהסימונים של החלונות. הוצא משימושViewCompat.getWindowInsetsController
לטובתWindowCompat.getInsetsController
כדי לוודא שהחלון הנכון שבו נעשה שימוש (לדוגמה, אם התצוגה נמצאת בתיבת דו-שיח). (I660ae, b/219572936) - נוסף API חדש של
LazyVerticalGrid
להגדרת גדלים של צירים שונים (I17723)
תיקוני באגים
- עדכונים ל-Card API בעקבות שינויים בפלטפורמת המסך 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) - נוספו מחלקה ואסימונים של 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
- תפריט נפתח
- כרטיסים
שינויים ב-API
- פונקציה שהוצאה משימוש של
Surface
שמשתמשת ב-onClick קריאה חוזרת. כדי ליצור פלטפורמות שאפשר ללחוץ עליהן, צריך להשתמש במאפייןInteractionSource
וModifier.clickable()
. (I211c6) - נוספה תמיכה בהגבהה דחוסה וממוקדת עבור FAB. (Ib584)
- שיניתי את ה-API של
Surface
כדי לקבל 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
לשיטות של עומס יתר שיטות קיימות ללא לוגיקה מורכבת. הפעולה הזו מפחיתה את המהדר (compiler) שיצרה בדיקות שינון (שווה) לכל הפרמטרים חוזרים בפונקציה הפנימית שנקראת. (I90490) - נוספה מחיצת חומר 3. (Ica5fc)
- סימון תיבת הסימון ולחצן הרדיו באמצעות ממשק API ניסיוני הערה. (Ie44b)
- נוספה תמיכה במדדי התקדמות של Material 3. (Iff232, b/205023841)
תיקוני באגים
- צריך לעדכן את הצבע של מאגר
TextButton's
שהושבת כך שיהיה שקוף (I6b248, b/213339737)
גרסה 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
רכיבים בעיצוב חדשני 3
- לחצנים
- FAB ו-FAB מורחב
- תיבות דו-שיח
- סרגל הניווט
- חלונית הזזה לניווט
- רכבת ניווט
- סרגל האפליקציה העליון
- תג שירות
- סמל
- שליחת הודעת טקסט
- סוג המסך
- פריסה
- צבע התוכן
לקבלת מידע נוסף, עיינו בקטע Material Design 3 ו-Material You במדריך Material Design בקטע 'כתיבה'.