‫Compose Material 3

אפשר ליצור ממשקי משתמש של Jetpack Compose באמצעות רכיבי Material Design 3, הדור הבא של Material Design. ‫Material 3 כולל רכיבים ועיצובים מעודכנים, ותכונות התאמה אישית של Material You כמו צבע דינמי. הוא מתוכנן להיות עקבי עם הסגנון החזותי וממשק המשתמש החדשים של Android 12.
העדכון האחרון גרסה יציבה גרסה מועמדת להפצה גרסת בטא גרסת אלפא
‫17 ביוני 2026 1.4.0 - - ‎1.5.0-alpha22

מבנה

‫Compose הוא שילוב של שבעה מזהי קבוצות Maven בתוך androidx. כל קבוצה מכילה קבוצת משנה ממוקדת של פונקציונליות, ולכל אחת מהן יש קבוצה משלה של הערות לגבי הגרסה.

בטבלה הזו מוסברות הקבוצות ויש קישורים לכל קבוצה של הערות מוצר.

קבוצהתיאור
compose.animationליצור אנימציות באפליקציות Jetpack Compose כדי לשפר את חוויית המשתמש.
compose.compilerשינוי פונקציות עם הערה מסוג Composable והפעלת אופטימיזציות באמצעות פלאגין של Kotlin Compiler.
compose.foundationכתיבת אפליקציות ל-Jetpack Compose באמצעות אבני בניין מוכנות לשימוש והרחבת הבסיס כדי ליצור רכיבים משלכם למערכת העיצוב.
compose.materialאפשר ליצור ממשקי משתמש של Jetpack Compose באמצעות רכיבי 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, צריך להוסיף את מאגר Maven של Google לפרויקט. מידע נוסף זמין במאמר בנושא מאגר Maven של Google.

אתם יכולים להוסיף את יחסי התלות של הארטיפקטים שאתם צריכים בקובץ build.gradle של האפליקציה או המודול:

Groovy

dependencies {
    implementation "androidx.compose.material3:material3:1.4.0"
    implementation "androidx.compose.material3:material3-window-size-class:1.4.0"
    implementation "androidx.compose.material3:material3-adaptive-navigation-suite:1.5.0-alpha22"
}

android {
    buildFeatures {
        compose true
    }

    composeOptions {
        kotlinCompilerExtensionVersion = "1.1.1"
    }

    kotlinOptions {
        jvmTarget = "1.8"
    }
}

Kotlin

dependencies {
    implementation("androidx.compose.material3:material3:1.4.0")
    implementation("androidx.compose.material3:material3-window-size-class:1.4.0")
    implementation("androidx.compose.material3:material3-adaptive-navigation-suite:1.5.0-alpha22")
}

android {
    buildFeatures {
        compose = true
    }

    composeOptions {
        kotlinCompilerExtensionVersion = "1.1.1"
    }

    kotlinOptions {
        jvmTarget = "1.8"
    }
}

מידע נוסף זמין במאמר הוספת יחסי תלות ב-build.

משוב

המשוב שלכם עוזר לנו לשפר את Jetpack. נשמח לדעת אם גיליתם בעיות חדשות או אם יש לכם רעיונות איך לשפר את הספרייה הזו. כדאי לעיין בבעיות הידועות בספרייה הזו לפני שמדווחים על בעיה. כדי להוסיף הצבעה בדיווח על בעיה קיימת, לוחצים על כפתור הכוכב.

יצירת דיווח על בעיה חדשה

מידע נוסף זמין במאמרי העזרה בנושא Issue Tracker.

‫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:

חבילת הניווט המותאם של Material3 ב-Compose גרסה 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 מכילה את השמירות האלה.

תכונות חדשות

תיקוני באגים

  • איך פותרים בעיה שבה רכיב הניווט ממלא את כל המסך כשלמשטח הבסיס יש 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 של Compose Material3 Adaptive

גרסה ‎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 מכילה את השמירות האלה.

תכונות חדשות

  • הוספנו תמיכה מקצה לקצה ב-pane scaffolds (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)
  • יצירת מחלקה בסיסית לתפקידי scaffold ‏ (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 של פיגום אדפטיבי. (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:

‫Compose Material3 גרסה 1.5

גרסה ‎1.5.0-alpha22

‫17 ביוני 2026

‫androidx.compose.material3:material3-*:1.5.0-alpha22 מופץ. גרסה ‎1.5.0-alpha22 מכילה את השמירות האלה.

שינויים ב-API

  • נוסף getter ציבורי snapAnimationSpec ל-TopAppBarDefaults כדי לחשוף את מפרט האנימציה של הצמדה כברירת מחדל. (Ic7b37, ‏ b/519193808)
  • הוספת צורות לשיטות פנימיות ופרטיות של TimePicker.kt API ‏ (I9d09e, ‏ b/441573791)
  • תמיכה בצורות ב-AnimatedPane (Ie7c60, ‏ b/470517507)
  • תיקון הניגודיות של לחצני ההחלפה של AM/PM ב-TimePicker (Ifc0b7, ‏ b/339079853)
  • הוצאה מניסוי של ממשקי ה-API של Expressive FloatingToolbar. (I5a4d8, b/497887216)
  • הסרת transformOriginState שיצא משימוש מ-DropdownMenuPopupPositionProvider. (I0d5b0, b/505481611)
  • העדכנו את pinnedScrollBehavior ואת enterAlwaysScrollBehavior כך שיקבלו ScrollableState, שמטפל אוטומטית במקרים מיוחדים כמו פריסות הפוכות ותוכן שגללו אותו מראש. העומסים מדור קודם הוצאו משימוש. העברת השימושים ב-isScrollingContentAtStart לעומסים החדשים עם הפרמטר scrollableState. קידמנו את TopAppBarScrollBehavior וממשקי API קשורים לגרסה יציבה. (Ib83cf, b/519193808)
  • העדכנו את pinnedScrollBehavior ואת enterAlwaysScrollBehavior כך שיקבלו ScrollableState, שמטפל אוטומטית במקרים מיוחדים כמו פריסות הפוכות ותוכן שגללו אותו מראש. קידמנו את TopAppBarScrollBehavior וממשקי API קשורים לגרסה יציבה. (Ieda4b, b/405129274)
  • צריך לעדכן את DropdownMenuPositionProvider כדי להסיר את MutableState מtransformOrigin. מכווצים MenuAnchorPosition ממשק אטום לכיתה אחת. הוספנו MenuAnchorPositionScope שמכיל מידע שאפשר להשתמש בו כדי ליצור מועמדים מותאמים אישית ל-x ול-y. (I21f2b, b/505481611)
  • קידום ממשקי ה-API של ButtonGroup לגרסה יציבה. הסרה של ממשקי API ניסיוניים שיצאו משימוש והוצגו בגרסה 1.5.0-אלפא. (Idaf96, ‏ b/497876828)

תיקוני באגים

  • תוקן באג שבו האנימציה של הדחיסה של ButtonGroup לא טיפלה בצורה נכונה בריווח פנימי לא סימטרי של לחצנים או בפריסות מימין לשמאל, ויכלה לקרוס עם IllegalArgumentException בצפיפויות מסוימות של תצוגה. (I35074, b/516743181)
  • תיקון מנגנון הטיפול בשגיאות במצב קלט טקסט של TimePicker ‏ (If4541, ‏ b/405054265)

גרסה ‎1.5.0-alpha21

‫3 ביוני 2026

‫androidx.compose.material3:material3-*:1.5.0-alpha21 מופץ. גרסה ‎1.5.0-alpha21 מכילה את השמירות האלה.

שינויים ב-API

  • הוספת צורות ל-API של רכיב בחירת השעה (I57f28, ‏ b/441573791)
  • נוסף compressionLimit ל-animateWidth שמציין את הריווח הפנימי של הפריט שנדחס, שמציין את הדחיסה המקסימלית שאפשר לדחוס את הפריט. הוצאה משימוש של animateWidth API בלי הפרמטר compressionLimit. (I4a725, ‏ b/418822334, ‏ b/403281052)
  • הסרת העוגן PartiallyExpanded של BottomSheet ושל ModalBottomSheet כבר לא מתבצעת באופן פרוגרמטי על סמך תנאי הפריסה. המשתמשים יכולים עכשיו לשלוט במיקום העוגן באופן מפורש דרך rememberBottomSheetState. אפשר להפעיל את ההתנהגות הקודמת של הרכיבים האלה על ידי השבתת ה-feature flag‏ isBottomSheetPartiallyExpandedDeterministicEnabled או על ידי שימוש בפונקציות rememberModalBottomSheetState ו-rememberStandardBottomSheetState שהוצאו משימוש. הדגל isAnchoredDraggableComponentsAnchorRecoveryEnabled הוסר עכשיו מדגלי התכונות. (Ia4167, ‏ b/478210200, ‏ b/512076811)
  • הוספנו מחדש תג ניסיוני ל-PullToRefreshDefaults.loadingIndicatorColor ול-PullToRefreshDefaults.loadingIndicatorContainerColor (Ib9d15, ‏ b/513225663)
  • הפרמטרים SelectableChipColors עודכנו כך שיהיו ציבוריים (I559e0, ‏ b/512576750)
  • הוספת הפרמטר horizontalArrangement אל MenuItems (Ie8088, ‏ b/497891817)
  • מסמנים מחדש את הפונקציה contentPaddingFor של הלחצן כניסיונית. (I07d3e, ‏ b/500355872)
  • הוספנו את roundedShape ואת tonalColors() גם ב-TextFieldDefaults וגם ב-OutlinedTextFieldDefaults, שהם ההגדרות החזותיות לסגנון אקספרסיבי. (Id9185, b/448728288)
  • הוצאנו משימוש את TextFieldLabelPosition.Attached והוספנו את תת-הסוגים Inside ו-Cutout, שמאפשרים יותר התאמה אישית, כמו OutlinedTextField עם מיקום של תווית בתוך המודעה. בנוסף, הוצאנו משימוש את התג OutlinedTextFieldDefaults.contentPadding() והוספנו את התגים OutlinedTextFieldDefaults.contentPaddingWithLabel() ו-OutlinedTextFieldDefaults.contentPaddingWithoutLabel() כדי לתמוך בשני מיקומי התוויות. ‫(I40f62, ‏ b/448728288)

תיקוני באגים

  • תוקנה בעיית נגישות ב-TimePicker שבה המיקוד במקלדת אבד כשעברו משעות לדקות בחוגה. שיפור הנגישות של מוקד ההקלדה. (I7dd81, ‏ b/498361169)

External Contribution

  • שיפרנו את הפיזיקה של תנועת הדחייה של BottomSheet כדי להעניק חוויה חלקה יותר. (I21df5)

גרסה ‎1.5.0-alpha20

‫19 במאי 2026

‫androidx.compose.material3:material3-*:1.5.0-alpha20 מופץ. גרסה ‎1.5.0-alpha20 מכילה את השמירות האלה.

שינויים ב-API

  • הוסרה הפונקציה shouldUsePrecisionPointerComponentSizing (I882c3, ‏ b/498698039)
  • תוקנה הבעיה שבה חץ העזרה הקופצת הופיע בצד הלא נכון כשהעזרה הקופצת התהפכה בגלל קצוות המסך. (Idc314, ‏ b/479224210)
  • השקנו את rememberBottomSheetState כ-API מאוחד למצב BottomSheet. הוצאנו משימוש את rememberModalBottomSheetState ו-rememberStandardBottomSheetState לטובת ה-API המאוחד החדש. (I2724e, b/500005697)
  • הסרה של ממשקי API ניסיוניים שהוצאו משימוש WideNavigationRail (Iaadd6, ‏ b/497891040)
  • הוצאה של ממשקי SplitButton API מסטטוס ניסיוני. (I4d395, ‏ b/497876691)
  • הוצאה משימוש של ממשקי ה-API עם פרמטרים מסומנים ונבחרים שכוללים supportingText כ-lambda בסוף.DropdownMenuItem הפרמטר supportingText הועבר ומופיע עכשיו מיד אחרי trailingIcon. ‪(Icaf79, b/503047115)

תיקוני באגים

  • עדכון של הגורם המטפל בחלונית ההזזה לניווט כדי לאפשר חזרה בזמן הפתיחה של החלונית, במקום רק כשהיא פתוחה לגמרי (I714ae,‏ b/418556231)

גרסה ‎1.5.0-alpha19

‫6 במאי 2026

‫androidx.compose.material3:material3-*:1.5.0-alpha19 מופץ. גרסה ‎1.5.0-alpha19 מכילה את השמירות האלה.

תכונות חדשות

  • הטיפוגרפיה תומכת עכשיו במשפחת גופנים שמוגדרת כברירת מחדל, שתמוזג עם סגנונות הטקסט שסופקו אם לא הוגדרה להם משפחת גופנים באופן מפורש. (I2e305, ‏ b/500356360)

שינויים ב-API

  • הפונקציה מסירה את supportingText כפונקציית למבדה מסוג trailing עבור DropdownMenuItem. במקום זאת, מעבירים אותו מיד אחרי trailingIcon. ‫(I5694b, ‏ b/503047115)
  • קידום ToggleButtons לגרסה יציבה. (I8a771, ‏ b/497876827)
  • קידום ממשקי API של תפריטים עם אפשרויות הבעה. מסירים את DropdownMenuItem כי זה ממשק API ניסיוני מיושן ששימש להבעה והיה חלק מגרסה 1.5.0-אלפא. (I1d556, ‏ b/497885285)
  • הוצאת ממשקי API של לחצן פעולה צף ותפריט לחצן פעולה צף מהשלב הניסיוני (Ie509c, ‏ b/497892373)
  • קידום ממשקי API של לחצנים עם הבעה. הסרת ה-API הניסיוני שיצא משימוש SmallButtonContentPaddingשהושק בגרסה 1.5.0-alpha. ‫(Iee31e, ‏ b/497873833)
  • החזרת ממשקי API של הזמנות scaffold למצב ניסיוני (I01492, b/489424245)
  • הוספת עומס יתר של בנאי Typography (I8b3b3, ‏ b/500356360)
  • החזרת מבצעים מסוג MaterialShapes ו-LoadingIndicator לגרסה יציבה. (I30e69, ‏ b/497876695, ‏ b/497877850)

תיקוני באגים

  • תוקנה באג בהטמעה של רכיב ההזזה שגרם להחלת ריווח פנימי מטבעות המיקוד המוטבעים על המסלול ועל לחצן ההזזה כשהרכיב לא במיקוד. ‫(I16315, ‏ b/506158497)
  • תוקנה בעיה ב-ModalBottomSheet שבה imePadding הוחל ללא תנאי, ולכן לא הייתה אפשרות לשלוט בהתנהגות של IME באמצעות contentWindowInsets. ‫(Ied801, ‏ b/289824811)
  • [FAB] תיקון קריסה ב-Modifier.animateFloatingActionButton שנגרמה בגלל עיגול של מספר שלם לעומת עיגול של מספר עשרוני (I2d25f, ‏ b/489769219)
  • תיקון מצב שבו המיקוד נלכד בתוך הכלי לבחירת טווח תאריכים. לחיצה על Tab מעבירה את המיקוד לתאריכים ומחוצה להם, ומקשי החיצים מעבירים את המיקוד בין התאריכים. (I7f3ea, b/498332749)
  • החזרת השינויים בלחצנים בגודל בינוני וגדול למצב מצביע מדויק, וגם גודל ברירת המחדל של סמל תיבת הדו-שיח למצב מצביע מדויק (I58d8c, ‏ b/496938250, ‏ b/500356640)
  • תוקן באג שגורם למיקוד המקלדת להיתקע בכלי לבחירת תאריך שאינו תיבת דו-שיח. בנוסף, תוקן סדר המיקוד של כפתורי הסגירה והאישור שלא היה תואם לסדר החזותי שלהם. (Ibbe2e, ‏ b/500454457)

גרסה ‎1.5.0-alpha18

‫22 באפריל 2026

‫androidx.compose.material3:material3-*:1.5.0-alpha18 מופץ. גרסה ‎1.5.0-alpha18 מכילה את השמירות האלה.

תכונות חדשות

  • הוספת עומסים של FilterChip, ElevatedFilterChip ו-InputChip עם שינוי צורה. הוספת ברירות מחדל חדשות של צורה, ריווח וצבע לעומסים העודפים האלה. (I84717, b/442678355)
  • הוספנו תמיכה בטבעת מיקוד מוזחת באמצעות API אופציונלי, באמצעות המקומי החדש LocalRippleThemeConfiguration. (I0551a, ‏ b/282184440).

שינויים ב-API

  • השם של rememberWithGapSearchBarState שונה ל-rememberSearchBarWithGapState. (I5f54b, ‏ b/498697243)
  • ממשקי ה-API‏ RippleThemeConfiguration ו-LocalRippleThemeConfiguration עברו לשלב יציב, ועכשיו אפשר להגדיר את האפקט של הגלים כך שיוצג כטבעת מיקוד פנימית, במקום כסימן מיקוד מבוסס אטימות. ממשקי API שמשתמשים בממשקי ה-API של הגדרת material-ripple הוצאו משימוש. (Ide5d0, b/485893129)
  • קידום של ממשקי API‏ WavyProgressIndicator (Id72a3, ‏ b/497877853)
  • קידום materialExpressTheme, expressiveLightColorScheme (I40eab, b/497876844)
  • הפונקציה BottomSheet composable הועברה אל BottomSheet.kt (If7e33, ‏ b/500091309)
  • הוספת הערה Material3ExpressiveApi שלא דורשת OptIn. (Ib9f2e, ‏ b/499994043)
  • הוספת DropdownMenuPopupPositionProviders ל-DropdownMenuPopup, כך שהמפתחים יכולים עכשיו להגדיר את המיקום של התפריט ביחס לעוגן. האפשרות הזו מאפשרת להוסיף תפריטי משנה לתפריטים נפתחים. עכשיו אפשר ליצור תפריטי משנה מדורגים באמצעות מיקומי עוגן חדשים. מעבירים את אפשרויות המיקום החדשות האלה אל rememberDropdownMenuPopupPositionProvider כדי להגדיר את התפריט. למידע על הטמעה מלאה, אפשר לעיין בדוגמה של תפריט הקטלוג. (Ic1ace, b/476161294)

תיקוני באגים

  • עדכון רכיבי Material3 כדי לתמוך בסימון של טבעת מיקוד מוזחת (I88006, ‏ b/498610244, ‏ b/467984300, ‏ b/498281359)
  • נפתרה בעיה בדוגמאות של TimePicker שבה המיקוד של TalkBack עבר, מה שאפשר הזנת זמן לא חוקית (I51690, b/498364606)

גרסה ‎1.5.0-alpha17

‫8 באפריל 2026

‫androidx.compose.material3:material3-*:1.5.0-alpha17 מופץ. גרסה ‎1.5.0-alpha17 מכילה את השמירות האלה.

שינויים ב-API

  • העברנו את TopAppBarScrollBehavior ואת השיטות שמשויכות אליו למצב יציב. כבר לא צריך להביע הסכמה לשימוש בממשקי ה-API האלה.@ExperimentalMaterial3Api (Ieb2d1, ‏ b/496918628)

גרסה ‎1.5.0-alpha16

‫25 במרץ 2026

‫androidx.compose.material3:material3-*:1.5.0-alpha16 מופץ. גרסה ‎1.5.0-alpha16 מכילה את השמירות האלה.

תכונות חדשות

  • קידום של Typography constructors ו-attrs, נוסף Typography constructor שמקבל FontFamily ברירת מחדל שמוחלת על כל TextStyles בסולם. (I3f6f1, b/236358112)
  • קידום של ממשקי API ניסיוניים של רכיבי slider לגרסה יציבה. (I5efb3, ‏ b/304811984)

שינויים ב-API

  • isAnchoredDraggableComponentsAnchorRecoveryEnabled feature flag הוספנו לרכיבים שניתנים לגרירה שמופיעות בהם שגיאות לא ברורות של יעד. המרכיבים כוללים את ModalBottomSheet, BottomSheetScaffold, SwipeToDismissBox ו-WideNavigationRail (I5b0e5, ‏ b/487941042, ‏ b/478210200, ‏ b/477038695)
  • הוספנו DropdownMenuItemTrailingLabel פונקציית ברירת מחדל וריווחים בממשק המשתמש שעברו אופטימיזציה לשימוש במצביעים בתפריטים מפולחים (I28977, ‏ b/485937388)
  • הוספנו מרווחים פנימיים לתיבות דו-שיח כשהערך של ComposeMaterial3Flags.isPrecisionPointerComponentSizingEnabled הוא true, והוספנו AlertDialogDefaults.IconSize לסמל. ‫(Ib9652, ‏ b/485932651)
  • בוצעה אופטימיזציה לחישובים של הגודל הפנימי המינימלי של BasicTextField. אם תרצו להשבית את האפליקציות האלה, תוכלו לעשות זאת דרך ComposeFoundationFlags#isBasicTextFieldMinSizeOptimizationEnabled. (I70ade)
  • סדר הפרמטרים ב-SearchBarDefaults.InputField עודכן כדי לשמור על תאימות לקוד המקור. (I20e3b, ‏ b/486964336)
  • הסרה של ממשקי API שהוצאו משימוש FilterChip ו-AssistChip עם הפרמטר horizontalSpacing (Iec623, ‏ b/483762893)
  • הפרמטר isAtTop ב-TopAppBarDefaults.pinnedScrollBehavior וב-TopAppBarDefaults.enterAlwaysScrollBehavior שונה ל-isAtStart (If7323, ‏ b/405129274)

תיקוני באגים

  • רכיבי BottomSheet מכבדים עכשיו את MaterialTheme.motionScheme במהלך גלילה מקוננת ומחוות גרירה. (I5fe22, b/452071842, b/384959324)
  • תוקנה בעיה שבה ריווח של תווית הסמל הוחל כשהפריט כלל selectedLeadingIcon שלא מוצג כרגע (Iba820)

גרסה ‎1.5.0-alpha15

‫25 בפברואר 2026

‫androidx.compose.material3:material3-*:1.5.0-alpha15 מופץ. גרסה ‎1.5.0-alpha15 מכילה את השמירות האלה.

תכונות חדשות

שינויים ב-API

  • בוצע רפקטורינג של MaterialTheme כדי להשתמש ב-CompositionLocal יחיד לנתוני ערכת הנושא. עכשיו אפשר לגשת ללוקאלים של קומפוזיציה דרך MaterialTheme.LocalMaterialTheme.current או currentValueOf(MaterialTheme.LocalMaterialTheme) ב-CompositionLocalAccessorScope (Idee2e,‏ b/483676974)
  • עדכון של ריווח ברירת המחדל של התוכן בלחצן הטקסט המודגש בהתאם למפרט הנכון. הסרנו גם את ההוצאה משימוש של TextButtonContentPadding ושל TextButtonWithIconContentPadding. (I67283)
  • הוספת פרמטר להשבתת הטיפול בלחצן 'הקודם' מ-BottomSheet (Iff81e, ‏ b/483763626)
  • העברת תוכנית תנועה מניסיונית (If822f, ‏ b/484003769)
  • נוספו הפרמטרים enabled ו-threshold ל-PullToRefreshBox ב-Material3. (I5610b, ‏ b/369044003)
  • מחליפים את horizontalSpacing ב-horizontalArrangement ב-FilterChip וב-ElevatedFilterChip. הוספת ברירות מחדל של horizontalArrangement אל FilterChipDefaults. (If3d6a, b/304853782)
  • שיפרנו את KDoc עבור TopAppBarDefaults התנהגויות גלילה כדי להסביר טוב יותר את השימוש בתוכן הפוך ובתוכן שנגלל מראש. (I247dd, ‏ b/405129274)
  • מחליפים את הפרמטר horizontalSpacing בפרמטר horizontalArrangmenet. הוספת ברירות מחדל של horizontalArrangement אל AssistChipDefaults. (I15cec, ‏ b/304853782)
  • הוספת getter ל-shouldUsePrecisionPointerComponentSizing (I234ce)
  • הוספנו עומסים יתרים ל-TopAppBarDefaults.enterAlwaysScrollBehavior ול-TopAppBarDefaults.pinnedScrollBehavior שמקבלים פרמטר isAtTopState. ההגדרה הזו מאפשרת זיהוי מותאם אישית של at top state כשמשתמשים בהתנהגויות גלילה. (I785b9, b/405129274)
  • מוסיפים את הפרמטרים contentPadding ו-horizontalArrangement ל-InputChip ול-ElevatedInputChip. הוספת ברירות המחדל horizontalArrangement ו-contentPadding אל InputChipDefaults. ‫(Iae39c, ‏ b/304853782)
  • נוספו גדלים וערכי ריווח מדויקים יותר של מצביעים עבור לחצנים, והוצא משימוש הערך TextButtonContentPadding val. (I6d7b6, ‏ b/479879803)
  • הוספנו את rememberWithGapSearchBarState לשימוש עם ExpandedDockedSearchBarWithGap. (Ia3361)

תיקוני באגים

  • תוקנה הבעיה שבה הצללות לא מוצגות בחלוניות צפות (Ie6108, ‏ b/470517507)
  • צריך לעדכן את TextButtons כך שיכלול את מפרטי הריווח הנכונים של Material 3. כדי לבטל את ההסכמה ולחזור להתנהגות הקודמת, צריך להגדיר את הערך של isTextButtonContentPaddingFixEnabled כ-false באפליקציה. (I66c8e)

גרסה ‎1.5.0-alpha14

‫11 בפברואר 2026

‫androidx.compose.material3:material3-*:1.5.0-alpha14 מופץ. גרסה ‎1.5.0-alpha14 מכילה את השמירות האלה.

פתרון אפשרי

  • isAnchoredDraggableComponentsStrictOffsetCheckEnabled נוסף. הדגל הזה קובע אם נדרש אתחול של ההיסטים הפנימיים של מסילות BottomSheetScaffold, ModalBottomSheet, SwipeToDismissBox ו-WideNavigation. כשההגדרה מושבתת, הרכיבים לא יציבו את התוכן שלהם עד שההיסט יאותחל. הדגל הזה יכול לעזור לעקוף באופן זמני באג שגורם לרכיבים האלה להחזיר חריגה בגלל שההיסט לא אותחל. (I36870, b/477038695, b/478210200, b/471818801, b/475249572, b/475598146)

שינויים ב-API

  • מוסיפים את isTextButtonContentPaddingFixEnabled שאם הוא נכון, TextButton מקבל מפרטי שוליים פנימיים נכונים. (Ib986e)
  • נוסף פרמטר indicatorPadding ל-WideNavigationRailItem. (I3d5dc)
  • מוסיפים את הפרמטרים contentPadding ו-horizontalArrangement ל-SuggestionChip ול-ElevatedSuggestionChip. הוספת ברירות המחדל horizontalArrangement ו-ContentPadding אל SuggestionChipDefaults. יצירת כיתה ChipArrangement. (Ida874, b/304853782)
  • מעדכנים את האפשרויות בתפריט שאפשר לבחור כדי שיכללו פרמטר לתמיכה בטקסט. הוצאה משימוש של ממשקי ה-API הקודמים שלא כללו את פרמטר הטקסט התומך. כדאי גם להוסיף את גדלי ברירת המחדל המומלצים לסמלים המובילים ולסמלים הנלווים. (I89e4b, b/417731599)
  • הפריסה של סרגל אינטראקטיבי עודכנה כדי לשפר את היישור של טקסט מרובה שורות. כדי למזער את השיבושים בממשק המשתמש, הוספנו את הדגל isSnackbarStylingFixEnabled שיעזור לכם במיגרציה. צריך להפעיל את הדגל הזה באופן ידני באפליקציה. הוא יוסר בגרסה עתידית. (I37d63, b/322866101)
  • תוקן באג ב-BottomSheetScaffold, ב-ModalBottomSheet, ב-SwipeToDismissBox וב-WideNavigationRail שגרם לכך שהעוגנים לא חושבו מחדש במקרים מסוימים. התיקון הזה מוסתר מאחורי feature flag‏, ComposeMaterial3Flags#isAnchoredDraggableComponentsInvalidationFixEnabled. (I9acb1, b/478210200)
  • הוספת פרמטר של ריווח פנימי של תוכן ל-WideNavigationRail ול-ModalWideNavigationRail כדי לאפשר התאמה אישית של הריווח הפנימי שמוגדר כברירת מחדל. (I49106)

תיקוני באגים

  • אם מגדירים את BottomSheetScaffold sheetPeekHeight ל-0, העוגן partiallyExpanded מושבת. ה-anchor של PartiallyExpanded נשמר במעבר הפריסה הראשון כדי לאפשר חישוב פריסה. ‫(Ia33a4, ‏ b/465158677)
  • SheetState#targetValue מעדיף את העוגן הנוכחי אם ההפרש הנוכחי תקף. כך מונעים את העדכון המיידי של initialValue. (Ied2c4, b/477279704)
  • תיקון של מצב שבו הסמל של WideNavigationRailItem לא ממוקם במרכז אנכית אם הגובה של הפריט משתנה. (Ib8c83)

גרסה ‎1.5.0-alpha13

‫28 בינואר 2026

‫androidx.compose.material3:material3-*:1.5.0-alpha13 מופץ. גרסה ‎1.5.0-alpha13 מכילה את השמירות האלה.

שינויים ב-API

  • הוספנו תמיכה בסרגל החיפוש animationSpecForContentExpand ובסרגל החיפוש animationSpecForContentCollapse. (I033a5)

תיקוני באגים

  • תוקנה הבעיה שבה התוכן של SearchBar מורחב לא השתמש בצבע שמותאם לעיצוב (I878e0, ‏ b/379441904)
  • תוקן באג שגרם לכך ש-BottomSheetScaffold הפעיל את הקריאה החוזרת (callback) של SheetState עם ערכים שגויים כשמעבירים ל-BottomSheetScaffold נקודת אחיזה לגרירה.confirmValueChange חשוב לשים לב שאפשר להשתמש ב-confirmValueChange רק כדי לבטל שינויים במצב. אפשר להשתמש ב-snapshotFlow כדי לעקוב אחרי שינויים במצב. (Ice9ee, ‏ b/465824174, ‏ b/477031833)

גרסה ‎1.5.0-alpha12

‫14 בינואר 2026

‫androidx.compose.material3:material3-*:1.5.0-alpha12 מופץ. גרסה ‎1.5.0-alpha12 מכילה את השמירות האלה.

שינויים ב-API

  • עדכונים TopAppBarDefaults (enterAlways והתנהגויות מוצמדות) לתמיכה ב-lazyListState,‏ scrollState ו-reverseScrolling. העדכון הזה פותר בעיות שקשורות לכיוון הפריסה ומטפל בצורה נכונה בתוכן שמוצג בגלילה. (I9d5c2, b/262234750)
  • מוסיפים את הפרמטרים contentPadding ו-horizontalSpacing ל-AssistChip ול-ElevatedAssistChip. הוספת ברירות המחדל HorizontalSpacing ו-ContentPadding אל AssistChipDefaults. ‫(I2ac90, ‏ b/304853782)
  • ממשקי ה-API של DatePicker שמבוססים על מחלקות Java Time כבר לא מסומנים כניסיוניים. (I5039c, b/457537971)

תיקוני באגים

  • תיקון קריסה בפורמט תאריך ב-API 23‏ (I67a94, ‏ b/452713222)DatePicker
  • תוקן באג של יישור חזותי בדוגמה של אינדיקטור אנימציה מפואר, כשמשתמשים בו עם שורות כרטיסיות שניתן לגלול בהן. ‫(Iae0f3, ‏ b/466790304)
  • תוקנה בעיה שבה בבורר של TimePicker בפורמט AM/PM לא נעשה שימוש בסגנון הטקסט שמוגדר במפרט של Material Design. (Ie908a, ‏ b/469788786)
  • תוקנה קריסה ב-HorizontalFloatingToolbar שיכולה להתרחש במצב לרוחב כשהמקלדת הווירטואלית מוצגת. (Ia13c1, ‏ b/466692323)
  • תוקנה בעיה שגרמה לכך שהכותרת TopAppBar חפפה לactions שלה כשלא סופק navigationIcon. הכותרת מוגבלת עכשיו לשטח הזמין שלה. (I2ba97, b/428697836)
  • תמיכה ב-RTL עם עוגנים להרחבת חלונית (I0770b, ‏ b/467775639)

גרסה ‎1.5.0-alpha11

‫17 בדצמבר 2025

‫androidx.compose.material3:material3-*:1.5.0-alpha11 מופץ. גרסה ‎1.5.0-alpha11 מכילה את השמירות האלה.

תכונות חדשות

  • ExpandedFullScreenContainedSearchBar נוסף. (Ie472d,b/454658635)
  • הוספנו תמיכה ביצירת קרוסלות בכמה יחסי גובה-רוחב באמצעות רשתות עצלות. (I2b109, b/462137656)
  • עכשיו אפשר להשתמש בפריטים אקספרסיביים של רשימת Material, עם תמיכה באינטראקציות ובעיצוב מפולח. נוספו שדות צבע נוספים ל-ListItemColors. ‪(I54057, b/441569230)
  • ממשקי ה-API של Multi-browse ושל קרוסלה לא מוכלת יציבים עכשיו. (I7a558, b/401537465)
  • מוסיפים את הפרמטרים contentPadding ו-horizontalSpacing ל-FilterChip ול-ElevatedFilterChip. הוספת ברירות המחדל HorizontalSpacing ו-ContentPadding אל FilterChipDefaults. (Iec6e3, ‏ b/455596578)

תיקוני באגים

  • אם מגדירים את BottomSheetScaffold sheetPeekHeight ל-0, העוגן partiallyExpanded מושבת. (I52dc9, b/465158677)

גרסה ‎1.5.0-alpha10

‫3 בדצמבר 2025

‫androidx.compose.material3:material3-*:1.5.0-alpha10 מופץ. גרסה ‎1.5.0-alpha10 מכילה את השמירות האלה.

תכונות חדשות

שינויים ב-API

  • ה-feature flag‏ isCheckboxStylingFixEnabled מסופק עכשיו דרך אובייקט ComposeMaterial3Flags. (I97baf, ‏ b/457504316)
  • הפרמטר disabledCheckmarkColor ב-CheckboxColors הועבר לסוף רשימת הפרמטרים כדי להבטיח תאימות בינארית. (I734d8, ‏ b/457504316)

תיקוני באגים

  • החזרת כל מקשי החיצים שמשנים את ערכי המחוון כדי לתקן את הבעיה של מיקוד שנלכד במכשירים מסוימים ללא מקש Tab. (I154dd, b/460912699)

גרסה ‎1.5.0-alpha09

‫19 בנובמבר 2025

‫androidx.compose.material3:material3-*:1.5.0-alpha09 מופץ. גרסה ‎1.5.0-alpha09 מכילה את השמירות האלה.

תכונות חדשות

  • הוספת עדכונים לתפריט עם תיאורים מושכים. היא כוללת פריט חדש בתפריט שאפשר להפעיל או להשבית, פריט בתפריט שאפשר לבחור, קבוצות בתפריט ותפריט קופץ. הוא כולל גם ערכי ברירת מחדל חדשים של תפריטים ב-MenuDefaults. (I5cdd4, ‏ b/417731597, ‏ b/448646125, ‏ b/448646896, ‏ b/448646891)
  • ב-Modifier.minimumInteractiveComponentSize יש עכשיו שני AlignmentLines: MinimumInteractiveTopAlignmentLine ו-MinimumInteractiveLeftAlignmentLine חדשים שגלויים לכולם. הקווים האלה מסמנים את הקצוות החזותיים של רכיב לפני שמוסיפים לו רווח כדי לעמוד בדרישות המינימליות של משטח המגע. (I7f485, ‏ b/458124197)
  • ExpandedDockedSearchBarWithGap נוסף. (Idb7f8)

שינויים ב-API

  • הוספת בדיקות כדי לאפשר שינוי גודל של רכיב המצביע המדויק. (I8108d)
  • הוספת Modifier.align אל ButtonGroupScope (I03890, ‏ b/416590906)
  • הסרה של רכיבי API ניסיוניים שהוצאו משימוש ModalBottomSheet שהיו לפחות בגרסה יציבה אחת. (Ifbe1d, b/449757604)
  • עומס יתר חדש של ButtonGroup עם הפרמטר verticalAlignment. ‫(I23a37, ‏ b/416590906)
  • הוסרו ממשקי API ניסיוניים מוסתרים שהוצאו משימוש, שנכללו לפחות בגרסה יציבה אחת. (I4f68d, ‏ b/449754465, ‏ b/449749933, ‏ b/401311419, ‏ b/449749928, ‏ b/449756019)

תיקוני באגים

  • הוספת הסבר קצר לכפתור לאפשרויות נוספות של סרגל הכלים הצף. (Ife952, ‏ b/422781172)
  • תיקון של חיתוך האינדיקטור של WideNavigationRail אם הוא מוגדר לרוחב גדול יותר באמצעות גודל תווית גדול יותר. ‫(I9d740, ‏ b/444728723)
  • עדכון לחצנים נגררים של לחצן מפוצל כדי למרכז את הסמל באופן אופטי בהתאם לצורה הנתונה, גם ב-RTL. (Icab82)

גרסה ‎1.5.0-alpha08

‫5 בנובמבר 2025

‫androidx.compose.material3:material3-*:1.5.0-alpha08 מופץ. גרסה ‎1.5.0-alpha08 מכילה את השמירות האלה.

שינויים ב-API

  • נוספו הנכסים hourInput ו-minuteInput לממשק של TimePickerState. המאפיינים האלה נועדו להכיל את הקלט הגולמי והלא מאומת מהמשתמש. מאפייני השעה והדקה הקיימים נשארים ומייצגים את השעה האחרונה הידועה שתקפה. (I09d74, b/394612017)

תיקוני באגים

  • תוקן באג שבו אי אפשר היה להשתמש ב-Switch עם ReusableContent בלי אנימציה. ‫(I61093, b/455909150)

גרסה ‎1.5.0-alpha07

‫22 באוקטובר 2025

‫androidx.compose.material3:material3-*:1.5.0-alpha07 מופץ. גרסה ‎1.5.0-alpha07 מכילה את השמירות האלה.

שינויים ב-API

  • שיפור SearchBar.InputField עם פרמטר keyboardOptions, שמאפשר אופטימיזציה של הזנת טקסט על ידי ציון אפשרויות מקלדת ופרמטר lineLimits שמאפשר ציון של גלילת טקסט (Id08a4, ‏ b/416991049)

תיקוני באגים

  • תוקן באג ברכיב Slider שגרם לכך שאינטראקציות של לחיצה לא הופקו במגע. השינוי הזה מבטיח ש-PressInteraction.Press יופק באופן מיידי ב-awaitFirstDown, ויספק משוב חזותי מיידי. (If9e25, b/308501482)
  • תוקנה בעיה שגרמה לכך שהחץ Tooltip לא שינה כיוון בזמן גלילה. הפונקציה TooltipBox מפעילה עכשיו רה-קומפוזיציה בכל פעם שהחלון הקופץ של הסבר קצר עובר לצד אחר, וכך מבטיחה שהכיוון של סמן טקסט מתעדכן בצורה נכונה. (I5ad1e, ‏ b/438875827)

גרסה ‎1.5.0-alpha06

‫8 באוקטובר 2025

‫androidx.compose.material3:material3-*:1.5.0-alpha06 מופץ. גרסה ‎1.5.0-alpha06 מכילה את השמירות האלה.

שינויים ב-API

  • נוספו צבעים לגלילה ב-AppBarWithSearch. בנוסף, צבע הרקע של שדה להזנת קלט בסרגל החיפוש שקוף כברירת מחדל. צבע ברירת המחדל של התיבה של סרגל החיפוש עצמו נשאר ללא שינוי. (I4fe32)
  • נוסף קומפוזבל של אינדיקטור גלישה כברירת מחדל ל-FloatingToolbar. (I6a6f8, ‏ b/415833723)
  • עדכון isExpanded ל-isShowing עבור ממשקי API של תפריטים בקבוצת לחצנים. ‫(I86309, ‏ b/412419514)
  • העדכון של initialIsExpanded ל-initialIsShowing והוספה של רכיב ברירת מחדל להצגת תוכן שגולש מעבר לגבולות ב-ButtonGroupDefaults. ‫(I6e67c, ‏ b/412419514)
  • הסרת התכונה של גרירה לשינוי גודל מ-API ציבורי (Ic85ba, ‏ b/437953743, ‏ b/442636084)

תיקוני באגים

  • תיקון סדר המיקוד של מקשי הניווט במקלדת, וגם תיקון שלו עבור שפות שנקראות מימין לשמאל. (Ibba27, b/422220597)
  • תיקון הניווט במקלדת ברשת לבחירת שנה בבוחר התאריכים. (I02363, ‏ b/422425720, ‏ b/446814683)
  • תוקנה הניווט במקלדת ברשת לבחירת תאריכים בחלוניות לבחירת תאריכים. (I594ef, b/422220597, b/422223115)
  • תוקן באג שגרם לכך שסרגל הכלים מחוץ למסך קיבל את מיקוד המקלדת. (I01a73, b/422786812)
  • ניווט במקלדת באמצעות RangeSlider קבוע ומחוון. (Ib6bcf, ‏ b/424845268, ‏ b/422942624)

גרסה ‎1.5.0-alpha04

‫10 בספטמבר 2025

‫androidx.compose.material3:material3-*:1.5.0-alpha04 מופץ. גרסה ‎1.5.0-alpha04 מכילה את השמירות האלה.

תכונות חדשות

  • נוספו Text עומסים יתרים של פונקציות קומפוזביליות שמקבלים ביטוי למדא ColorProducer שמאפשר שינויים יעילים בצבעים בלי להפעיל רה-קומפוזיציה מלאה. (I9ff25, b/407055128)

שינויים ב-API

  • שינוי השם של Scrim() ל-LevitatedPaneScrim() והסתרת המאפיינים של הכיתות Levitated ו-Reflowed. (I090e1, ‏ b/427953101)
  • הסתרת API‏ calculatePosture() כפנימי (Ie7227, ‏ b/424442112)
  • חשיפת PaneScaffoldHorizontalOrder כ-API ציבורי חתום (Ia4ebe)
  • סימון ממשקי API שקשורים לגודל החלון ולמיקום שלו כניסיוניים. (I4ee96)

תיקוני באגים

  • תוקן סדר הניווט במקלדת כך שהמיקוד עובר מלחצן הפעולה הצפה לפריט הראשון בחלק העליון. (Icaaa1, b/422762939)
  • שיפור הנגישות של חלונית הזזה לניווט באמצעות המקלדת: אי אפשר יותר להתמקד בחלונית הזזה כשסוגרים אותה, אפשר לסגור אותה באמצעות מקש Esc, והתוכן שלה מקבל את המיקוד כשפותחים אותה. (Idb995, ‏ b/422793544, ‏ b/422793651, ‏ b/422797424)
  • תצוגת השעון של הכלי לבחירת שעה מגיבה עכשיו לניווט/קלט מהמקלדת. ‫(I9d5d9, b/425710631)
  • שימוש בעוגן התחלתי חדש כשמשנים את רשימת העוגנים של הרחבת החלונית (I91cd1, ‏ b/438829477)

גרסה ‎1.5.0-alpha03

‫27 באוגוסט 2025

‫androidx.compose.material3:material3-*:1.5.0-alpha03 מופץ. גרסה ‎1.5.0-alpha03 מכילה את השמירות האלה.

שינוי בהתנהגות

  • הגודל של תיבת הסימון והצבעים של האינדיקטור הותאמו בהתאם למפרט. כדי לצמצם את השיבושים בממשק המשתמש, נוסף הדגל isCheckboxStylingFixEnabled כדי לעזור במיגרציה. צריך להפעיל אותו ידנית באפליקציות. הדגל הזה יוסר בסופו של דבר בגרסה עתידית. (I5bcd3, b/304300693)

שינויים ב-API

  • נוסף הפרמטר contentPadding עבור TopAppBar (Ia5fea)
  • הוספת שינוי ברירת מחדל של רכיב ל-scaffold של חבילת הניווט (I85312)

תיקוני באגים

  • הפרמטר containerColor ב-TimePickerDialog מוחל עכשיו בצורה נכונה, ואפשר להתאים אישית את צבע הרקע של תיבת הדו-שיח. (I47f89, b/403183883)
  • כשמכווצים את סרגל הניווט של חלון מודאלי, המיקוד לא הולך לאיבוד יותר, ועכשיו אפשר לסגור אותו בתגובה להקשה על מקש Esc. (4255257)
  • ב-Snackbar יש עכשיו סדר מיקוד נכון במקלדת ללחצני הפעולה והסגירה, וגם לחצן הסגירה תומך בהצגת תיאור קצר. (11fa13d)

גרסה ‎1.5.0-alpha02

‫13 באוגוסט 2025

‫androidx.compose.material3:material3-*:1.5.0-alpha02 מופץ. גרסה ‎1.5.0-alpha02 מכילה את השמירות האלה.

שינויים ב-API

  • ב-PullToRefreshDefaults, שינינו את השם של shape ל-indicatorShape ואת השם של containerColor ל-indicatorContainerColor והוספנו את indicatorMaxDistance לשימוש באינדיקטורים. (Ib6cbe)
  • הסרת תג הוצאה משימוש מ-PullToRefreshDefaults.indicatorColor (Iaaee2)
  • הוספנו את AppBarWithSearch, במקום TopSearchBar, עם תמיכה בסמלי ניווט ופעולה. (I213a5)

תיקוני באגים

  • תוקן באג שבו לחיצה על מקש החזרה עדכנה באופן שגוי את ההיסט של מגירת האפליקציות. ‫(I85624, ‏ b/427778135)
  • ‫SwipeToDismissBox עכשיו, אם לא קיימים עוגנים אחרים, המערכת חוזרת ל-targetValue שהוגדר. ‫BottomSheetScaffold עכשיו, אם לא קיימים עוגנים אחרים, המערכת חוזרת ל-targetValue. (I73d5e, ‏ b/428856426)
  • תוקן המרווח הפנימי של הכפתור ב-AlertDialog כשהוא מוערם אנכית. (Ia2118)
  • ‫[FAB] תיקון באג שבו עדיין אפשר ללחוץ על כפתור הפעולה הצף אחרי שהוא מוסתר על ידי Modifier.animateFloatingActionButton (I8ea6c, b/430336834)
  • ‫[Slider] תוקן הניווט במקלדת עבור Slider‏ (I3a405)

גרסה ‎1.5.0-alpha01

‫30 ביולי 2025

‫androidx.compose.material3:material3-*:1.5.0-alpha01 מופץ. גרסה ‎1.5.0-alpha01 מכילה את השמירות האלה.

תכונות חדשות

  • הוספנו עוד ספק מיקום לתיאורי הכלים, כך שעכשיו מפתחים יכולים לשלוט במיקום של תיאור הכלי ביחס לעוגן – מעל, מתחת, משמאל או מימין. הוספת API שמקבל צורה של חץ, כדי שאפשר יהיה לספק צורות מותאמות אישית נוספות. (Ie513c)

שינויים ב-API

  • TextFieldColors שיטות לחישוב צבעי רכיבים על סמך מצב הן עכשיו ציבוריות. (I03165)
  • ההערה 'השעיה' הוסרה מהקריאה החוזרת של onDismiss. (Ie3166)
  • הפונקציות DatePickerState.getDisplayedMonth(): YearMonth? ו-DateRangePickerState.getDisplayedMonth(): YearMonth? עודכנו כך שיחזירו ערך שאינו ניתן לאיפוס. ‫(Ice09c, ‏ b/427952972)
  • מסירים את ModalWideNavigationRailDefaults, מעבירים את התוכן שלו אל WideNavigationRailDefaults ומשנים את השמות שקשורים לצורה שלו. (Ic5e61)
  • WideNavigationRailItemהפונקציות colors ו-copy deprecated צריכות להיות ברמה Hidden. (Id7e82)
  • שינוי הרמה של ממשקי API שהוצאו משימוש WideNavigationRail ל'אזהרה' והפיכתם לניסיוניים. (I89085)

תיקוני באגים

  • הפונקציה מוודאת ש-DatePicker מכבדת את הלוקאל שלה מבחינת עיצוב מספרים. בעבר, אם DatePicker הוגדר ללוקאל ערבי, יכול להיות שהוא עיבד באופן שגוי ספרות לטיניות אם הלוקאל של מערכת המכשיר השתמש במערכת מספור שונה. (Iccf76, b/432616196)
  • תוקנה בעיה (LinearProgressIndicator) שגרמה לכך שסימן העצירה לא הוצג בצורה תקינה בפריסות מימין לשמאל. (I0734c)
  • הקו המפריד PrimaryScrollableTabRow ו-SecondaryScrollableTabRow מתרחב עכשיו לגודל המסך המלא, גם אם התוכן בכרטיסייה לא מתרחב עד סוף המסך. ‫(Ic1e9c, ‏ b/261741384)

‫Compose Material3 גרסה 1.4

גרסה 1.4.0

‫24 בספטמבר 2025

‫androidx.compose.material3:material3-*:1.4.0 מופץ. גרסה 1.4.0 מכילה את השמירות האלה.

שינויים חשובים מאז גרסה 1.3.0:

הודעות על שינויים בספרייה

לא מומלץ יותר להשתמש בספרייה androidx.compose.material.icons כדי להציג סמלי Material ב-Compose, כי סמלי Material הם הדרך החדשה לעשות זאת. הפסקנו לפרסם עדכונים לספרייה הזו, והיא הוסרה מהגרסה האחרונה של ספריית Material 3. עדיין אפשר להפנות אליה באופן ידני אם אתם עדיין לא יכולים לבצע מיגרציה.

במקום זאת, מומלץ להוריד קובץ XML של פריט גרפי וקטורי שניתן לשרטוט מהכרטיסייה Android בכתובת https://fonts.google.com/icons כדי לקבל גישה לסמלים המעוצבים העדכניים ביותר: סמלי Material.

למה אנחנו כבר לא ממליצים על הספרייה? ספריית הסמלים (Material Icons) הוחלפה במראה החדש יותר של Material Symbols. ראינו שהספרייה יכולה להאריך באופן משמעותי את משך זמן של תהליך build של האפליקציות, כי היא כוללת את כל הסמלים השונים, שאולי לא נדרשים.

מידע נוסף זמין בכתובת: https://developer.android.com/develop/ui/compose/graphics/images/material

שינויים בהתנהגות

  • הספרייה הזו כבר לא מוסיפה תלות ב-material-icons-core, ולכן אם הפרויקט שלכם הסתמך על כך, תצטרכו להוסיף את התלות הזו באופן מפורש בקובצי build.gradle[.kts]. ‫(I735ff, ‏ b/349894318)

  • הצבע של התווית הפעילה של NavigationBarItem ושל NavigationRailItem משתנה מonSurface לצבע המשני כדי לשפר את השימושיות, את הניגודיות בין הצבעים ואת העקביות במערכת (Ibc297). כדי לחזור להתנהגות הקודמת, מעתיקים את צבעי ברירת המחדל ומשנים את selectedTextColor ל-MaterialTheme.colorScheme.onSurface.

  • רכיבי Material 3 משתמשים עכשיו ב-MotionScheme החדש כדי להגדיר את התנועה שלהם. (Ie0f93)

  • שינויים בתנועה של אינדיקטור התקדמות מעגלי לא מוגדר (I3c07e)

רכיבים חדשים של Material Design 3

שיפורים ברכיבים קיימים של Material Design 3

  • הטקסט תומך עכשיו ב-autoSize
  • נוספו מעצבים של Material 3 ל-BasicTextField2
  • נוסף API‏ TimePickerDialog שאפשר להשתמש בו בשביל TimePicker, TimeInput או בשביל גרסה שאפשר להחליף בינה לבין גרסה אחרת.
  • ממשקי API חדשים של סרגל החיפוש:
    • סרגלי חיפוש מכווצים ותצוגות חיפוש מורחבות הם עכשיו רכיבים נפרדים שאפשר להוסיף לאפליקציה:
    • ‫SearchBar מייצג סרגל חיפוש במצב מכווץ.
    • ‫ExpandedFullScreenSearchBar ו-ExpandedDockedSearchBar מייצגים את סרגל החיפוש במצב המורחב. הקישורים האלה נפתחים בחלון חדש.
    • ‫SearchBarState כדי לשלוט במצב של סרגל החיפוש
  • ממשקי API ניסיוניים הועברו לגרסה יציבה.
  • שיפרנו את הביצועים.

גרסה ‎1.4.0-rc01

‫10 בספטמבר 2025

‫androidx.compose.material3:material3-*:1.4.0-rc01 מופץ. גרסה ‎1.4.0-rc01 מכילה את השמירות האלה.

גרסה ‎1.4.0-beta03

‫27 באוגוסט 2025

‫androidx.compose.material3:material3-*:1.4.0-beta03 מופץ. גרסה ‎1.4.0-beta03 מכילה את השמירות האלה.

גרסה ‎1.4.0-beta02

‫13 באוגוסט 2025

‫androidx.compose.material3:material3-*:1.4.0-beta02 מופץ. גרסה ‎1.4.0-beta02 מכילה את השמירות האלה.

שינויים בתלות

שינויים ב-API

  • ב-PullToRefreshDefaults, שינינו את השם של shape ל-indicatorShape ואת השם של containerColor ל-indicatorContainerColor והוספנו את indicatorMaxDistance לשימוש באינדיקטורים. (Ib6cbe)
  • הסרת תג הוצאה משימוש מ-PullToRefreshDefaults.indicatorColor (Iaaee2)
  • ‫BasicAlertDialogOverrideScope קודם בטעות לגרסה יציבה וההערה הניסיונית שלו הוסרה ב-aosp/3701846. סימון התנועה כפנימית. היא תישאר כניסיונית וציבורית בגרסה 1.5.0-אלפא (I9182a)

תיקוני באגים

  • תוקן באג שבו לחיצה על מקש החזרה עדכנה באופן שגוי את ההיסט של מגירת האפליקציות. ‫(I85624, ‏ b/427778135)

גרסה ‎1.4.0-beta01

‫30 ביולי 2025

‫androidx.compose.material3:material3-*:1.4.0-beta01 מופץ. גרסה ‎1.4.0-beta01 מכילה את השמירות האלה.

שינויי תוכנה שעלולים לגרום לכשלים

  • הסרנו את כל ממשקי ה-API הציבוריים שתויגו בסימן ExperimentalMaterial3ExpressiveApi או ExperimentalMaterial3ComponentOverrideApi. כדי להמשיך ליהנות מהתכונות האלה, צריך לעבור אל 1.5.0-alpha. (Ie4ae0)
  • בגרסה הבאה, שמות ה-API הבאים שיוצבו יציבים ישונו.pullToRefresh (Ib6cbe)

תכונות חדשות

  • Tooltip תומך עכשיו בצורה מותאמת אישית של סמן המיקום ובמיקום מותאם אישית של סמן המיקום (מעל, מתחת, מימין או משמאל לנקודת העיגון). (Ie513c)

שינויים ב-API

  • ההערה 'השעיה' הוסרה מהקריאה החוזרת של onDismiss. (Ie3166)
  • הפונקציות DatePickerState.getDisplayedMonth(): YearMonth? ו-DateRangePickerState.getDisplayedMonth(): YearMonth? עודכנו כך שיחזירו ערך שאינו ניתן לאיפוס. ‫(Ice09c, ‏ b/427952972)
  • מסירים את ModalWideNavigationRailDefaults, מעבירים את התוכן שלו אל WideNavigationRailDefaults ומשנים את השמות שקשורים לצורה שלו. (Ic5e61)

תיקוני באגים

  • הפונקציה מוודאת ש-DatePicker מכבדת את הלוקאל שלה מבחינת עיצוב מספרים. בעבר, אם DatePicker הוגדר ללוקאל ערבי, יכול להיות שהוא עיבד באופן שגוי ספרות לטיניות אם הלוקאל של מערכת המכשיר השתמש במערכת מספור שונה. (Iccf76, b/432616196)
  • תוקנה בעיה (LinearProgressIndicator) שגרמה לכך שסימן העצירה לא הוצג בצורה תקינה בפריסות מימין לשמאל. (I0734c)
  • הקו המפריד PrimaryScrollableTabRow ו-SecondaryScrollableTabRow מתרחב עכשיו לגודל המסך המלא, גם אם התוכן בכרטיסייה לא מתרחב עד סוף המסך. ‫(Ic1e9c, ‏ b/261741384)

גרסה ‎1.4.0-alpha18

‫16 ביולי 2025

‫androidx.compose.material3:material3-*:1.4.0-alpha18 מופץ. גרסה ‎1.4.0-alpha18 מכילה את השמירות האלה.

תכונות חדשות

  • ‫ModalBottomSheetProperties מספק עכשיו את האפשרות להשבית את dismissRequest בלחיצה על מסך חצי שקוף. (I8e715)
  • הוספת תמיכה ב-trackCornerSize ל-Track של RangeSlider. (Iec529)

שינויים ב-API

  • הפרמטר railExpanded הפך לפרמטר חובה עבור WideNavigationRailItem, נוסף הפרמטר modalContentColor עבור WideNavigationRailColors והפרמטר WideNavigationRailDefaults.modalContainerShape הועבר אל ModalWideNavigationRailDefaults.containerShape. (Id60c5)
  • מעבירים את הפרמטר של פונקציית הצבעים החדשה של WideNavigationRail כך שיהיה האחרון, ומוציאים את הפונקציה הישנה משימוש. (Iac7f7)
  • ‫PullToRefresh הוא עכשיו API יציב (I18537)
  • עדכונים ב-API של DatePickers. הסרנו את תאריך הסיום null שמוגדר כברירת מחדל עבור DateRangePicker, ועכשיו חובה להעביר אותו. בנוסף, הבהרנו את השימוש בחצות UTC בייצוג התאריך במסמכי התיעוד של ה-API, וסימנו את הפונקציות האחרונות של getters ו-setters שמשתמשות בממשקי java.time API כניסיוניות לעת עתה. (I121b3, ‏ b/427952972)
  • העברת ה-API של פרמטר tint: ColorProducer Icon למצב לא ניסיוני. (Ia0133)
  • הוסרו ההערות הניסיוניות מ-DatePicker, מ-DateRangePicker וממצבי התמיכה, מהמחלקות ומהסוגים שלהם. (I0e4e0, b/391848485)
  • שינינו את ערך ברירת המחדל של המאפיין focusable ל-false כדי לתקן את המיקוד של a11y, והוספנו את הפרמטר hasAction ל-TooltipBox. (I62998)
  • הוצאה מניסוי של ממשקי ה-API‏ WideNavigationRail, ShortNavigationBar ו-NavigationItem. (I3ca3c)
  • הסרנו את ההערות @ExperimentalMaterial3Api מחלק מהפונקציות, המחלקות התומכות והאובייקטים של סרגל האפליקציות העליון. (I0a9b7)

גרסה ‎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 API onDismissed. (Iee780)
  • הוספנו את הפרמטר userScrollEnabled לרכיבי Carousel שאפשר להרכיב. (I1d4d2)
  • עכשיו אפשר לצפות ב-currentItem של קרוסלה מ-CarouselState. (Ie87e9)

תיקוני באגים

  • תוקנה בעיה שבה צורה שרירותית בלחצן פעולה צף שהועבר ל-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)
  • הוספנו את הערך max items (מספר הפריטים המקסימלי) ל-AppBarRow. הערך הזה נחוץ כדי להטמיע בצורה נכונה את מפרט החומרים בסרגלי האפליקציות העליונים. (I92ce4)
  • נוספה שיטה ב-TooltipScope לקבלת layoutCoordinates של העוגן. הוצאנו משימוש את השיטה drawCaret כי מפתחים יכולים להשתמש בשיטה החדשה הזו כדי לקבל את גבולות העוגן layoutCoordinates וליצור צורה מתאימה שמכילה סמן טקסט. (Ia2e12, b/329470609)
  • נוסף תמיכה ב-java.time Date Pickers: נוספו עומסים של rememberDatePickerState/rememberDateRangePickerState שמקבלים אובייקטים של java.time (לדוגמה, initial 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 composable, שמטפל בפריטים שלא נכנסים לגבולות שלו. (I742bd)
  • מעדכנים את ה-API ‏DatePicker ו-DateRangePicker כדי לבקש מיקוד כשעוברים למצב של הזנת תאריך. החלפנו את הפרמטר הבוליאני requestFocus בפרמטר אופציונלי focusRequester שמקבל FocusRequester. (I14b69)
  • הסרת מקש modifier ומקור האינטראקציה מפריטים ברירת המחדל שאפשר ללחוץ עליהם או להפעיל ולכבות אותם. במקום זאת, כדאי להשתמש בו כפרט הטמעה. (I95ed6)
  • הכפתור ButtonGroup עודכן כך שיוצג בתפריט נפתח אם יש יותר מדי כפתורים שלא נכנסים למסך. (I7b88b)

תיקוני באגים

  • ה-Bottomsheet צורך עכשיו את החלק העליון של המסך כשהוא קטן יותר מההיסט הנוכחי. כך המשתמשים יכולים לספק שוליים עליונים להתנהגות מורחבת. המינוי BottomSheetDefaults.windowInsets כולל עכשיו את WindowInsets.safeDrawing.Top. (I0ab67, ‏ b/321877275, ‏ b/336962418, ‏ b/342093067)
  • הופעלו אנימציות כניסה/יציאה (fade/slide) לסמלים/אווטרים מובילים של צ'יפים ולסמלים נגררים כשהם מתווספים או מוסרים. היתרון הזה רלוונטי בעיקר לצ'יפים שאפשר לבחור (מסנן, קלט), אבל הוא חל באופן כללי. (I9af21)
  • תוקנה התנהגות לא תקינה של פס הזזה מימין לשמאל שנגרמה בגלל LookaheadScope. (Ieb152, ‏ b/408118041)
  • תיקון הקריסה של 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)
  • הוספת פונקציות עומס יתר לגודל ברירת המחדל של ידית הגרירה (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 לריווח מומלץ של תוכן, צורות, גודל סמל, ריווח סמלים וסגנון טקסט בהתאם לגובה של רכיב ה-container. (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. הוסר פרמטר ה-lambda‏ expanded והוספו פרמטרים נפרדים לגובה המורחב והמכווץ. (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)
  • עכשיו אפשר לקבוע איך FloatingToolbar עם לחצן FAB יגיב לגלילה באמצעות 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 לקבוצת ה-insets שרכיבי Material לוקחים בחשבון כברירת מחדל, כדי למנוע חפיפה של התוכן עם מגרעת במסך. זהו שינוי בהתנהגות שישפיע על האופן שבו רכיבים שמודעים ל-inset מוצגים סביב מגרעת במסך. זה כולל את ערך ברירת המחדל של הפרמטר WindowInsets לרכיבי Material 3 עם מודעות ל-inset, ואת הערכים של WindowInsets שמופיעים באובייקטים של ברירות המחדל של הרכיבים גם ב-Material 2 וגם ב-Material 3. אם השינוי הזה גורם להתנהגות לא רצויה, צריך לציין ידנית את הפרמטר WindowInsets לכל רכיב בנפרד. (I43ee9, b/362508045)

שינויים ב-API

  • עדכונים ב-API של TopAppBar. משנים את השם של סרגלי האפליקציות העליונים הבינוניים והגדולים עם כתובית ל-*FlexibleTopAppBar. איחדנו את הווריאציות של הצבעים לפונקציה אחת TopAppBarDefault.topAppBarColors() והוספנו פרמטר צבע subtitle שיוחל על רכיב הניתן להרכבה של כתובית שסופק (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)
  • נוסף tooltip 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)

תכונות חדשות

  • הצגת רכיב 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)
  • גורמים למחוון של חומר לשנות את הערך שלו כשמקשי הבקרה נלחצים. (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 ישירות למצב, אתם צריכים לוודא שהטקסטים של הכותרת והכותרת הראשית מותאמים בהתאם, כי הטקסט שמוגדר כברירת מחדל עדיין יוחל בהתאם ללוקאל של פלטפורמת ברירת המחדל. (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 שונו ל'רגיל' ו'מובלט'. עכשיו אפשר לגשת לשתי הפונקציות דרך אובייקט ה-companion‏ 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

  • קרוסלה
  • ‫[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 וב-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 מ-material. (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 הוגדר כ-nullable. כדי להשבית את האפקט, במקום לספק RippleConfiguration עם isEnabled = false, מספקים null ל-LocalRippleConfiguration. (I22725)
  • ModalBottomSheet כשמפעילים את התכונה 'מקצה לקצה', הציור של שכבת הצללה מעל סרגל הסטטוס מדויק יותר. מעכשיו, התוכן של גיליון תחתון מודאלי יכול להשתמש בשוליים הפנימיים של החלון, וכך לאפשר הצגת תוכן מעל סרגל הניווט. הפרמטר ModalBottomSheet windowInsets שונה ל-contentWindowInsets כדי לציין איפה יחולו השוליים הפנימיים. הם כבר לא קשורים ללוגיקה של החלון. הסוג contentWindowInsets השתנה לפונקציה שמחזירה WindowInsets, כדי לאפשר את הפתרון שלו בחלון החדש. (I39630, ‏ b/274872542, ‏ b/300280229, ‏ b/290893168)
  • ‫PrimaryScrollableTabRow ו-SecondaryScrollableTabRow משתמשים עכשיו בפריסה מותאמת אישית במקום בהרכבה משנית, מה שאמור לשפר את הביצועים. (I991e0)
  • נוספה לקישורי טקסט אפשרות לעיצוב מצב לחיצה, בנוסף לעיצוב רגיל, עיצוב במצב ריחוף ועיוצב במצב מיקוד. בכל אחת מהשיטות TextDefaults יש ארגומנט 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 כדי לחשוף את מסיכת ה-Rect שמשמשת לחיתוך הפריט (I785d8)
  • הוסר BasicTooltipState מה-API הציבורי של Material 3. הפונקציונליות שלו משולבת עם TooltipState עד ש-Foundation BasicTooltip יתייצב. (Icda29)
  • נוסף אובייקט TextDefaults שמכיל שיטות ליצירת LinkAnnotation ולניתוח מחרוזת עם תגי HTML שחלים על הקישורים (I98532, b/139312671)MaterialTheme
  • ExposedDropdownMenuBoxScope לא מאפשר יותר שימוש במחלקות משנה. לתפריטים הנפתחים שמוצגים יש עכשיו MenuAnchorType שצריך להעביר אל menuAnchor כדי לשפר את הנגישות. צריך להשתמש בשיטה הזו במקום להעביר את focusable אל ExposedDropdownMenu, שיצאה משימוש. ל-menuAnchor יש פרמטר חדש לשליטה במצב enabled. (I55ee6, ‏ b/257209915, ‏ b/308840226)
  • תוקן צבע הגבול של OutlinedButton כשהוא מושבת. נוספה ButtonDefaults.outlinedButtonBorder("enabled") overload שמקבלת את המצב המופעל. ‫(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)
  • עדכון של מגירת הניווט ב-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. (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 לערך שוב. עוטפים את 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, אחרי עדכון מאנימציה של קפיץ. הבעיה של חריגה גלויה נפתרה. הוצאנו משימוש את ה-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)
  • מעדכן את צבע המאגר של Bottom 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 מכילה את השמירות האלה.

תכונות חדשות

  • 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 לערך שוב. עוטפים את 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

שיפורים ברכיבים קיימים של 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)
  • מסמנים פונקציות ליצירת Modifier כ-@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, הקידומות הראשוניות ומסמכי ה-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 של תיאורי כלים. בנוסף, אנחנו מעבירים את ממשקי ה-API‏ TooltipBox, PlainTooltip ו-RichTooltip בחזרה למצב ניסיוני, כי הם שוחררו בטעות כגרסאות יציבות. (If0f66, b/293939035)
  • קידום של ממשקי API ניסיוניים של שבבים לגרסה יציבה. (Iea2c3)
  • הסרנו את ההערה @ExperimentalMaterial3Api מהכרטיסים של Material3 שאפשר ללחוץ עליהם. (I88dbf)

תיקוני באגים

  • תוקנה בעיה שבה SwipeToDismiss קורס בתרחישים מסוימים עם פריסות Lazy ו-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 כביטוי למדא. הגרסאות האלה אמורות להיות יעילות יותר מהגרסאות הקודמות. (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. אפשר להשתמש בפונקציות האלה כחלופה לפונקציות Composable‏ 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 הוא עכשיו 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)
  • תוקן באג שגרם לכך שלא בוצעה קריאה ל-onDismissedRequest כשסוגרים את ModalBottomSheet בהחלקה כלפי מטה בגיליון. (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 implements DraggableState (I9b116)
  • שינוי הצורה לפרמטר חובה. משנים את השם של position ל-index בפונקציית העזר של הצורה. (I34941)
  • עדכון של DatePicker formatWithSkeleton כך שיכלול מפה שמשמשת כמטמון לשיפור הביצועים. (I3195f)
  • הוספנו את BasicTooltipBox ל-compose.foundation ועדכנו את PlainTooltipBox ואת RichTooltipBox כדי להשתמש ב-TooltipBox עם רכיבי PlainTooltip ו-RichTooltip חדשים שניתנים להרכבה. (I79e1d)

תיקוני באגים

  • הפונקציות dynamicLightColorScheme ו-dynamicDarkColorScheme מחזירות עכשיו צבעים עם כרומה גבוהה יותר לתפקידים של משטח ו-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 מכילה את השמירות האלה.

תיקוני באגים

  • תוקן החישוב של DropdownMenuoffset כך שהיסטים של x תלויים רק בכיוון הפריסה המקומי, והיסטים של y לא יתהפכו יותר כשהתפריט קרוב לחלק התחתון של המסך. (Iccc74, ‏ b/294103942)
  • תוקן החישוב של DropdownMenuoffset כך שהיסטים של 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)

תכונות חדשות

  • נוספה פונקציית עומס יתר (overload) ל-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 מתחשב עכשיו ב-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)
  • נוספה פונקציית עומס יתר (overload) ל-Slider שהיא גרסה עם שמירת מצב של הרכיב. נוצר SliderState שמכיל את כל המידע על הרצועה הפעילה הנוכחית, את המדידות של הרכיבים של Slider ואת הלוגיקה של הגרירה והמחוות. (I124a5)
  • שינוי השם של מאפיין הסמנטיקה isContainer ל-isTraversalGroup (I121f6)
  • הוספנו את TextStyle.merge(...) שעבר אופטימיזציה עם רשימת פרמטרים מלאה. (Iad234, ‏ b/246961787)
  • הפכנו את TooltipState,‏ RichTooltipState ו-PlainTooltipState לממשקי API ציבוריים. נוספו RichTooltipStateImpl וPlainTooltipStateImpl למצבים שמוגדרים כברירת מחדל. נוספו פונקציות remember*State כדי לקבל את המצבים המיושמים האלה. הסרנו את TooltipSync לטובת TooltipDefault.GlobalMutatorMutex. (I7813d)
  • עדכנו את DatePickerColors כך שיכלול אפשרויות נוספות להתאמה אישית של המפריד בבוחר התאריכים, הניווט והצבעים של שדות הזנת הטקסט. (I1a685, b/274626815)
  • ‫DatePickerState ו-DateRangePickerState הם עכשיו ממשקים ציבוריים עם הטמעות ברירת מחדל שאפשר לאחזר באמצעות rememberDatePickerState ו-rememberDateRangePickerState. (I71c52)
  • הסרנו את dateValidator מ-DatePicker ומ-DateRangePicker והוספנו ממשק SelectableDates שאפשר להגדיר במצב כדי לשלוט בתאריכים או בשנים שאפשר לבחור בממשק המשתמש. (Ic2fc6)
  • הוסר TimePicker מ-API יציב, צפויים שינויים נוספים ב-API של המצב (I3f39a)
  • 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 מכילה את השמירות האלה.

תיקוני באגים

  • תוקן באג שגרם להעברה שגויה של modifier לשני קומפוזיציות. (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

  • הוסר TimePicker מ-API יציב, צפויים שינויים נוספים ב-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 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)

תיקוני באגים

  • תוקנה בעיה שבה המצב של ModalBottomSheetHalfExpanded חושב בצורה שגויה והגיליון נראה כאילו הוא צף. (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)
  • אפשר עכשיו להתאים אישית את הצבעים של שדות הטקסט:
    • צבעי שדה להזנת קלט והטקסט לדוגמה בהתאם למצב המיקוד ולמצב השגיאה. הפרמטר textColor קיבל את השם החדש unfocusedTextColor, והפרמטר placeholderColor קיבל את השם החדש unfocusedPlaceholderColor.
    • צבע המאגר של שדות טקסט מלאים על סמך מצב השגיאה עם הפרמטר החדש errorContainerColor.
  • הצבעים של שדה הטקסט בתפריט הנפתח שמוצג עודכנו עם פרמטרים לתמיכה ב-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)

תיקוני באגים

  • צורת ברירת המחדל היא עכשיו תמיד SheetDefaults.ExpandedShape.ModalBottomSheet (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 לגרסה יציבה והוספנו את ממשקי ה-API ‏Slider ו-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 מכילה את השמירות האלה.

תכונות חדשות

  • ‫DatePicker API ראשוני לבחירת תאריך יחיד דרך ממשק משתמש של לוח שנה. ממשק ה-API הזה עדיין עובר שינויים. (I722b9)
  • הוספנו תמיכה בהצגת טיפים פשוטים באמצעות PlainTooltipBox. (I0cdfb)
  • סרגל החיפוש (Iad128)
  • ‫SwipeToDismiss (I458a8, b/242889540)

שינויים ב-API

  • נוספה מאפיין סמנטי IsContainer בפלטפורמות השונות של Google. הנכס הזה ישמש בשינוי מאוחר יותר שקובע את סדר המעבר בין רכיבים על סמך המשמעות הסמנטית של רכיבים כמו משטחים. (I63379)
  • סימון ממשקי API שקשורים לחלונית ההזזה לניווט כגרסה יציבה. ‫(Iab01e, ‏ b/261439597)
  • נוסף פרמטר של צבע הרקע לאינדיקטורים של התקדמות מעגלית, ופרמטר של קצה הקו לאינדיקטורים של התקדמות מעגלית וליניארית. ‫(Ie668c, ‏ b/216325962, ‏ b/222964817)
  • מאפיין המציין אם ערך יכול להיות ריק (nullability) של סוגי החזרה נוספים של פונקציות שהוצאו משימוש ומוסתרות (Ibf7b0)
  • מוסיפים Modifier.minimumInteractiveComponentSize. אפשר להשתמש בו כדי להזמין לפחות 48dp בגודל כדי להבחין בין אינטראקציות של מגע אם הרכיב יהיה קטן יותר. (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. כאן דווחה הבעיה במקור. שלחנו תיקון, והוא יהיה זמין בעדכון הבא של 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() שונה ל-consumeWindowInsets(), השם withConsumedWindowInsets() שונה ל-onConsumedWindowInsetsChanged() והמשנים הפכו לציבוריים. (Ie44e1)
  • להוסיף ריווח חדש של תוכן ברירת מחדל ללחצן טקסט עם סמל לשימוש. (I8f662)
  • נוספו צבעים מושבתים לסרגל הניווט ולפס הניווט. (Ia7892, ‏ b/258867034)
  • נוסף Modifier API כדי לשאול על פרטי גלילה של רכיבי צאצא. (I2ba9d, ‏ b/203141462)
  • המאפיין הזה משמש ב-Clickable כדי להשהות אינטראקציות של לחיצה בצורה נכונה, במקרים שבהם תנועות יכולות להפוך לאירועי גלילה.
  • תוקנה הבעיה שבה Clickables לא עיכב את האדוות בצורה נכונה, כשנעשה בו שימוש בתוך Clickables.Scrollable ViewGroup
  • עדכנו את מגירות הצד ואת הגיליונות כדי להשהות לחיצות בצורה נכונה במקרים שבהם תנועות יכולות להפוך לאירועי גלילה.

עדכונים של תלות

  • ‫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 מאפשר להחיל את אותו צבע רקע על כל המשטח שלהם, ולהגדיר צבעים שונים מצבעי ברירת המחדל באמצעות ערכי צבע שקופים. (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 מאפשר להחיל את אותו צבע רקע על כל המשטח שלהם, ולהגדיר צבעים שונים מצבעי ברירת המחדל באמצעות ערכי צבע שקופים. (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

סיווג גודל החלון

  • ‫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

  • הוספנו פרמטר slot לתמיכה ב-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

כדי לראות את העיצובים, הרכיבים והפונקציות העדכניים ביותר שזמינים, אפשר לעיין בסקירה הכללית של הפניית ה-API של Compose Material 3.

שינויים ב-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)
  • שינוי הסדר של פרמטרים של פס הזזה ב-Material 3 כדי לשמור על עקביות ב-API (I0aee7)
  • שינוי הסדר של הפרמטרים NavigationBar ו-NavigationRail כדי לשמור על עקביות ב-API (I51cda)
  • כדי לשמור על עקביות ב-API, צריך לשנות את סדר הפרמטרים ב-Material 3. (If4ae1)
  • שינוי הסדר של הפרמטרים של פס ההזזה ב-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)
  • הוספת תפקידי צבע שונים של מסך חצי שקוף ומתאר. (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. (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

  • נוספה הגבהה של FAB כברירת מחדל ל-BottomAppBar, הוסרה למבדא בסוף מ-BottomAppBar עם FAB. (I92c47)
  • הוספת Material3 FilledIconButton,‏ FilledTonalIconButton ו-OutlinedIconButton. (Ib2bda)
  • עדכון Material 3 Snackbar API כדי לקבל ערכי צבע לפעולה האופציונלית ולפעולת ההסרה. (Ibe4b4)
  • האפשרות 'צריכה חלקית' (ירידה או מיקום) הוצאה משימוש ב-PointerInputChange. אפשר להשתמש ב-consume() כדי להחיל את השינוי באופן מלא. אפשר להשתמש ב-isConsumed כדי לקבוע אם מישהו אחר כבר השתמש בשינוי.
  • הפונקציה PointerInputChange::copy() יוצרת עכשיו תמיד עותק שטחי. המשמעות היא שעותקים של PointerInputChange ינוצלו ברגע שאחד מהעותקים ינוצל. אם רוצים ליצור PointerInputChange לא מאוגד, צריך להשתמש ב-constructor. ‫(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 יורחב או יכווץ, עם אנימציות בין כל מצב. נוסף עומס יתר של Extended FAB עבור כפתורי FAB מורחבים עם טקסט נגרר עבור ExtendedFABs ללא סמל. (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 שמחזירים את הפונקציות העמוסות של רכיבי 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)
  • נוספו אסימונים וסיווגים של Material 3 Slider ‏ (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 שהוצאה משימוש שמקבלת קריאה חוזרת (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

מידע נוסף זמין בקטע Material Design 3 ו-Material You במדריך בנושא התאמת העיצוב של Google Material Design ב-Compose.