‫Compose Material 3

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

מבנה

‫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-alpha29"
}

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-alpha29")
}

android {
    buildFeatures {
        compose = true
    }

    composeOptions {
        kotlinCompilerExtensionVersion = "1.1.1"
    }

    kotlinOptions {
        jvmTarget = "1.8"
    }
}

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

משוב

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

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

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

‫Compose Material3 A2UI גרסה 1.0

גרסה ‎1.0.0-alpha01

‫23 בספטמבר 2026

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

תכונות חדשות

רכיב ה-renderer של Jetpack Compose Agent-to-UI ‏ (A2UI) מספק הטמעה של פרוטוקול A2UI, שמאפשר לסוכני AI ליצור ממשקי משתמש עשירים ואינטראקטיביים שמציגים רכיבי Compose מקוריים – בלי להריץ קוד שרירותי. הספרייה הזו מספקת הטמעה מוכנה לשימוש של המפרט הרגיל של קטלוג בסיסי של A2UI, שנבנה באמצעות רכיבי Material Design 3.

שינויים ב-API

  • מעדכנים את סדר הרכיבים ב-A2uiBasicCatalogV כך שיתאים בדיוק למפרט הקטלוג הבסיסי. (I23093, ‏ b/547851648)
  • הוספנו ChecksProperty לכל ממשקי הרכיבים הרלוונטיים בקטע A2uiBasicCatalogV1, והפכנו את ערך המאפיין לזמין באמצעות פרמטר שמועבר אל TypedContent של כל רכיב. (I9f393, ‏ b/547851648)
  • בוצעה הוספה של A2uiBasicCatalogV1.ChoicePicker ושל MaterialA2uiBasicCatalogV1Defaults.choicePicker. (I875a6, b/547851648)
  • בוצעה הוספה של A2uiBasicCatalogV1.Modal ושל MaterialA2uiBasicCatalogV1Defaults.modal. (Icd553, ‏ b/547851648)
  • הוספנו AccessibilityProperty לכל ממשקי הרכיבים בקטע A2uiBasicCatalogV1, והפכנו את ערך המאפיין לזמין באמצעות פרמטר שמועבר אל TypedContent של כל רכיב. (I76b80, ‏ b/547851648)
  • הוספת את A2uiBasicCatalogV1.TextField ואת MaterialA2uiBasicCatalogV1Defaults.textField. (Ifdaec, ‏ b/547851648)
  • הוספת את A2uiBasicCatalogV1.Video ואת MaterialA2uiBasicCatalogV1Defaults.video. (I8595c, ‏ b/547851648)
  • הוספת את A2uiBasicCatalogV1.AudioPlayer ואת MaterialA2uiBasicCatalogV1Defaults.audioPlayer. ‫(Ida509, ‏ b/547851648)
  • הוספת את A2uiBasicCatalogV1.Slider ואת MaterialA2uiBasicCatalogV1Defaults.slider. (Ieb72d, ‏ b/547851648)
  • הוספת את A2uiBasicCatalogV1.CheckBox ואת MaterialA2uiBasicCatalogV1Defaults.checkBox. (I84525, ‏ b/547851648)
  • הוספת את A2uiBasicCatalogV1.Divider ואת MaterialA2uiBasicCatalogV1Defaults.divider. (I91208, ‏ b/547851648)
  • הוספת את A2uiBasicCatalogV1.Tabs ואת MaterialA2uiBasicCatalogV1Defaults.tabs. (Ic33d3, ‏ b/547851648)
  • הוספת את A2uiBasicCatalogV1.List ואת MaterialA2uiBasicCatalogV1Defaults.list. ‫(I89f73, ‏ b/547851648)
  • הוספת את A2uiBasicCatalogV1.Icon ואת MaterialA2uiBasicCatalogV1Defaults.icon. (I65524, ‏ b/547851648)
  • הוספת את A2uiBasicCatalogV1.Image ואת MaterialA2uiBasicCatalogV1Defaults.image. (I673b3, ‏ b/547851648)
  • הוספת את A2uiBasicCatalogV1.Button ואת MaterialA2uiBasicCatalogV1Defaults.button. ‫(I5215f, ‏ b/547851648)
  • נוספו A2uiBasicCatalogV1.Row מתוךA2uiBasicCatalogV1.Column ו-MaterialA2uiBasicCatalogV1Defaults.row מתוךMaterialA2uiBasicCatalogV1Defaults.column. (Ibcbe7, ‏ b/547851648)
  • נוסף MaterialImageComponent כדי לתמוך בעיבוד תמונות בקטלוג A2UI. בדיקה: MaterialImageComponentTest אל androidx-main
  • נוסף MaterialImageComponent כדי לתמוך בעיבוד תמונות בקטלוג A2UI. (I868fe)
  • בוצעה הוספה של A2uiBasicCatalogV1.Card ושל MaterialA2uiBasicCatalogV1Defaults.card. (Icf604, ‏ b/547851648)
  • הוצאו משימוש עומסי יתר (overloads) של Slider ו-RangeSlider ללא מצב (stateless), לטובת הגרסאות שלהם עם מצב (stateful). שינינו את השמות של activeRangeStart ושל activeRangeEnd ב-RangeSliderState ל-startValue ול-endValue, והוצאנו משימוש את ממשקי ה-API הישנים של Slider שלא קודמו ואת ממשקי ה-API הניסיוניים של Slider עם DeprecationLevel.HIDDEN. (If8995)
  • הוספנו A2uiSurface composable ו-A2uiSurfaceDefaults כדי לעבד משטחי A2UI. (I6e276, b/544713825)
  • נוסף קומפוזבל A2uiTestSurface כדי להעלות ולבדוק משטחים ורכיבים של A2UI בבידוד. (I03c8a, b/527415570)

תיקוני באגים

  • ‫compileSdk for Compose libraries updated to 37.1. כדי לעשות את זה, צריך לעדכן את compileSdk באופן טרנזיטיבי בכל האפליקציות והספריות שמשתמשות ב-Compose. (I05b0f)

‫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

  • עדכון שם החבילה מ-navigation-suite ל-navigationsuite (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 מכילה את השמירות האלה.

תכונות חדשות

‫Compose Material3 Adaptive Version 1.0

גרסה ‎1.0.0-alpha06

‫7 בפברואר 2024

הגרסאות androidx.compose.material3:material3-adaptive:1.0.0-alpha06,‏ androidx.compose.material3:material3-adaptive-android:1.0.0-alpha06 וגם androidx.compose.material3:material3-adaptive-desktop:1.0.0-alpha06 יוצאות. גרסה ‎1.0.0-alpha06 מכילה את השמירות האלה.

תכונות חדשות

  • נוספו אפשרויות התנהגות נוספות לThreePaneScaffoldNavigator ניווט אחורה. (I858aa)
  • נוסף תוכן אופציונלי של יעד להיסטוריית הניווט. (Ibd7e6)

גרסה ‎1.0.0-alpha05

‫24 בינואר 2024

הגרסאות androidx.compose.material3:material3-adaptive:1.0.0-alpha05,‏ androidx.compose.material3:material3-adaptive-android:1.0.0-alpha05 וגם androidx.compose.material3:material3-adaptive-desktop:1.0.0-alpha05 יוצאות. גרסה ‎1.0.0-alpha05 מכילה את השמירות האלה.

תכונות חדשות

  • תמיכה בהתחשבות בהיסטוריה בניווט בתבנית ובחישוב ערכים (I71d46)

גרסה ‎1.0.0-alpha04

‫10 בינואר 2024

הגרסאות androidx.compose.material3:material3-adaptive:1.0.0-alpha04,‏ androidx.compose.material3:material3-adaptive-android:1.0.0-alpha04 וגם androidx.compose.material3:material3-adaptive-desktop:1.0.0-alpha04 יוצאות. גרסה ‎1.0.0-alpha04 מכילה את השמירות האלה.

תכונות חדשות

  • הוספנו תמיכה מקצה לקצה בפריסות של חלוניות (I1b462)

שינויים ב-API

  • הועברו מאפייני גבולות הציר ב-Posture לרשימה של פרטי הציר (I24f90)

תיקוני באגים

  • התיקון AnimatedPane לא הורכב מחדש (c3f573d)

גרסה ‎1.0.0-alpha03

‫13 בדצמבר 2023

הגרסאות androidx.compose.material3:material3-adaptive:1.0.0-alpha03,‏ androidx.compose.material3:material3-adaptive-android:1.0.0-alpha03 וגם androidx.compose.material3:material3-adaptive-desktop:1.0.0-alpha03 יוצאות. גרסה ‎1.0.0-alpha03 מכילה את השמירות האלה.

שינויים ב-API

  • שינוי התפקידים ב-scaffold לכינויים של ThreePaneScaffoldRole. (I65bd1)
  • יצירת מחלקת בסיס לתפקידי פיגום (I4784d)
  • הסרת פרמטר מיותר מהתוכן של AnimatedPane (Ibc73b)
  • משנה את השם של collectWindowSizeAsState ומחזיר ערכים גולמיים במקום זאת (I480f4)

גרסה ‎1.0.0-alpha02

‫29 בנובמבר 2023

הגרסאות androidx.compose.material3:material3-adaptive:1.0.0-alpha02,‏ androidx.compose.material3:material3-adaptive-android:1.0.0-alpha02 וגם androidx.compose.material3:material3-adaptive-desktop:1.0.0-alpha02 יוצאות. גרסה ‎1.0.0-alpha02 מכילה את השמירות האלה.

שינויים ב-API

  • פיצול של ממשקי API לניווט מממשקי API של scaffold דינמי. (Ic4045)
  • הסרה של כיתה GutterSize. (I785b3)

תיקוני באגים

  • החלוניות הקבועות לא מוחלפות כשלא משתמשים ב-AnimatedPane (d88f181)

גרסה ‎1.0.0-alpha01

‫15 בנובמבר 2023

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

תכונות חדשות

ממשקי API של תנאים דינמיים ב-Material3:

ממשקי API של הנחיית פיגום של חלונית דינמית ב-Material3:

ממשקי API של Material3 adaptive pane scaffold:

‫Compose Material3 גרסה 1.5

גרסה ‎1.5.0-alpha29

‫23 בספטמבר 2026

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

שינויים ב-API

  • שינוי שעלול לגרום לבעיות בקוד המקור: הפרמטר onValueChange הוא עכשיו פרמטר חובה בפונקציות Slider ו-RangeSlider, והסדר שלו ברשימת הפרמטרים השתנה

תיקוני באגים

  • ‫DatePicker now resolves in 1 frame by computing month navigation availability directly from the displayed month index. (I08db7)
  • ‫TimeInput משתמשת עכשיו באופן פנימי בממשקי ה-API החדשים של שדות הטקסט TextFieldState. (Ia7492, b/353692863)
  • ‫DateInput משתמשת עכשיו באופן פנימי בממשקי ה-API החדשים של שדות הטקסט TextFieldState. ‫(I5ad3d, ‏ b/353692863)
  • ‫Slider ו-RangeSlider מטפלים עכשיו ב-onValueChange וב-onValueChangeFinished ישירות בהטמעות שלהם, במקום להעביר אותם אל SliderState ו-RangeSliderState. (I959ac)

גרסה ‎1.5.0-alpha28

‫9 בספטמבר 2026

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

שינויים ב-API

  • שינינו את השם של ה-API של קרוסלת מוצרים עם כמה היבטים ופישטנו אותו. עכשיו הוא נקרא modifier‏ carouselParallaxScrollEffect (I46b17)
  • הוסרו עומסי יתר (overloads) של ToggleButton שהוצאו משימוש. נוספו פונקציות עזר (contentPaddingFor,‏ shapesFor) וקבועים שמוגדרים כברירת מחדל (כולל size) ל-ToggleButtonDefaults,‏ ElevatedToggleButtonDefaults,‏ FilledTonalToggleButtonDefaults ו-OutlinedToggleButtonDefaults. (I998cf)

  • הוצאו משימוש עומסי יתר (overloads) של Slider ו-RangeSlider ללא מצב (stateless), לטובת הגרסאות שלהם עם מצב (stateful). שינינו את השמות של activeRangeStart ושל activeRangeEnd ב-RangeSliderState ל-startValue ול-endValue, והוצאנו משימוש את ממשקי ה-API הישנים של Slider שלא קודמו ואת ממשקי ה-API הניסיוניים של Slider עם DeprecationLevel.HIDDEN. (If8995)

    כדי להעביר את Slider, מ: kotlin var value by remember { mutableFloatStateOf(0.5f) } Slider(value = value, onValueChange = { value = it }) אל: kotlin val state = remember { SliderState(value = 0.5f) } Slider(state = state)

    כדי להעביר את RangeSlider, מ: kotlin var range by remember { mutableStateOf(0.2f..0.8f) } RangeSlider(value = range, onValueChange = { range = it }) אל: kotlin val state = remember { RangeSliderState(startValue = 0.2f, endValue = 0.8f) } RangeSlider(state = state)

  • הוספת פרמטרים בוליאניים של הפעלה ופרמטרים של צבע מושבת ל-ScrollField (Iab612)

תיקוני באגים

  • הוספת תמיכה בהדגשת מיקוד המקלדת עבור ScrollField. (If21d6)
  • לבצע התאמות במשוב העיצוב כדי להשתמש ב-TimePicker אקספרסיבי במצב חיוג. (I8795e)
  • שינוי ההזחה של TimePicker במצב גלילה ובמצב קלט. (Iddb33)
  • העדכונים משנים את החישוב של הגובה או הפריסה של המתג בהתאם למספר הפריטים ב-TimePicker.kt במצב לא מוגבל. (I30700)
  • תוקנה בעיה שגרמה לחיתוך של פקדי AM/PM ב-TimePicker כשהופעלו טקסט גדול או שינוי גודל הגופן. (Iaca60)
  • הרכיבים SecureTextField ו-OutlinedSecureTextField (וגם העומסים העודפים של BasicSecureTextField שהוצאו משימוש) עודכנו כך שישתמשו ב-TextObfuscationMode.System כברירת המחדל של מצב ההסתרה במקום ב-TextObfuscationMode.RevealLastTyped. (I76c7e)

גרסה ‎1.5.0-alpha27

‫26 באוגוסט 2026

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

שינויים ב-API

  • השם של RichTimePickerDialog שונה ל-VibrantTimePickerDialog, השם של richColors שונה ל-vibrantColors ב-TimePickerDefaults וב-TimeInputDefaults, השם של richContainerColor ושל richShape שונה ל-vibrantContainerColor ול-vibrantShape ב-TimePickerDialogDefaults, והשם של מאפייני צבע לא נבחרים שונה ל-periodSelectorContainerColor, ל-periodSelectorContentColor, ל-timeSelectorContainerColor, ל-timeSelectorContentColor ול-clockDialContentColor. (Iea5aa)
  • עדכון של Rich TimePicker API כדי לאפשר תיבת דו-שיח של גלילה או קלט שלא נכללת בתוך תיבה אחרת. (I2b3b6)
  • הוספנו את האפשרויות SelectableDropdownMenuItem ו-CheckableDropdownMenuItem לפריטים בתפריט הבעות הפנים שאפשר לבחור ולסמן. העדכון של DropdownMenuItem עם צורה לשימוש ב-MenuItemColors, והוספה של MenuDefaults.itemVibrantColors() לתמיכה ב-MenuItemColors מלא חיים. (I160ca)
  • נוספו עומסים של ToggleButton,‏ ElevatedToggleButton,‏ FilledTonalToggleButton ו-OutlinedToggleButton עם משבצות ButtonSize ו-icon. שמות השיטות ToggleButtonDefaults, ElevatedToggleButtonDefaults, FilledTonalToggleButtonDefaults ו-OutlinedToggleButtonDefaults פושטו ל-colors() ול-border(). (Iab484)
  • הוסרו עומסים עודפים (overloads) שהוצאו משימוש של pinnedScrollBehavior ו-enterAlwaysScrollBehavior מ-TopAppBarDefaults. במקום זאת, צריך להשתמש בעומסים העודפים שמקבלים ScrollableState. (Idef9d)
  • הוסר ה-API הניסיוני שהוצא משימוש LocalMotionScheme מתוך MaterialTheme. במקום זאת, אתם צריכים להשתמש ב-MaterialTheme.motionScheme. (I4b61d)
  • נוספו TimeInputDefaults ו-TimeInputColors ל-TimeInput. (I7534e)

תיקוני באגים

  • תוקנה בעיה שבה ScrollDisplayModeToggle הכריז על 'מעבר למצב גלילה' בזמן שהיה במצב גלילה. (I2d588)
  • תוקנה הבעיה שבה DropdownMenuItem בלי סמל מוביל לא יישר סמלים נגררים לסוף של פריט התפריט. ‫(Ia24ff, b/542873381)

גרסה ‎1.5.0-alpha26

‫12 באוגוסט 2026

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

שינויים ב-API

  • הוספנו את ElevatedToggleButtonDefaults, את FilledTonalToggleButtonDefaults ואת OutlinedToggleButtonDefaults, וניקינו מאפייני צורה לא סמנטיים ב-ToggleButtonDefaults. (Ia0a85)
  • תוקנה בעיית ניגודיות של נגישות בתווית האופקית NavigationItemבנושאים עם ניגודיות גבוהה. הצבע של התווית מוגדר עכשיו באמצעות selectedTextColorTopIconPosition (צבע התווית של פריט אנכי, שלא השתנה) ו-selectedTextColorStartIconPosition (צבע התווית של פריט אופקי, שמוגדר עכשיו כך שיתאים ל-selectedIconColor). כדי לבטל את העדכון הזה, צריך להעביר את ShortNavigationBarItemDefaults/WideNavigationRailItemDefaults.colors().copy(selectedTextColorStartIconPosition = MaterialTheme.colorScheme.secondary) (I85855, ‏ b/490910896)
  • הסרנו את משתני ההיסט של הגלילה מ-SearchBarScrollBehavior, ועכשיו אפשר לגשת אליהם דרך המחלקה החדשה SearchBarScrollState. (Ib24e4)
  • העברנו את BottomAppBar ואת השיטות שמשויכות אליו למצב יציב. ה-APIs האלה לא דורשים יותר את ההסכמה לשימוש ב-@ExperimentalMaterial3Api. (I42c61)
  • מצב הבחירה הפעיל שנשמר ב-TimePickerState בכל שחזור של מצב, והוספנו פרמטר initialSelection לפונקציית היצרן TimePickerState. (Iad905)
  • הפונקציה ExposedDropdownMenu היא עכשיו פונקציית הרחבה ב-ExposedDropdownMenuBoxScope במקום חברה. יכול להיות שתצטרכו לעדכן את הקוד באמצעות ייבוא חדש. ‫(Ie8a65, ‏ b/356452026)

תיקוני באגים

  • תוקנה בעיה שבה התאמה אישית חלקית של צבעים ב-MenuDefaults.itemColors החליפה צבעים שלא סופקו ב-Color.Unspecified. (Iea847)
  • תוקנו ההודעות של TalkBack כך שערכי זמן מפורמטים ייקראו ב-TimePicker שניתן לגלול בו. ‫(Ice981)
  • תוקן קראש ב-ExposedDropdownMenu כשהגובה של המסך קטן מהגובה של התפריט. (I6adf1)
  • תוקנה בעיה של ריווח שגוי של תוכן בפס ניווט רחב. המרווח הפנימי התחתון הוא עכשיו 0. כדי לחזור לגרסה הקודמת של העדכון, אפשר להגדיר את contentPadding = PaddingValues(0.dp,44.dp,0.dp,44.dp). (I572bb)
  • עדכנו את ממשק ה-API הציבורי בהתאם למשוב שקיבלנו לאחרונה על ה-API. (I71aff, b/532657001)

External Contribution

  • תוקנה בעיה שגרמה לכך ש-Material3 Slider Label לא הוצג בזמן גרירת פס ההזזה באמצעות העיגול שלו עם עכבר. (I97a6d, ‏ b/533483487)

גרסה ‎1.5.0-alpha25

‫29 ביולי 2026

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

שינויים ב-API

  • שינינו את השם של הפרמטר trailingIcon ל-trailingContent בצורה, סימנו את התיבה ובחרנו את העומסים העודפים DropdownMenuItem תוך שמירה על תאימות בינארית. (I2ecbd)
  • נוספו מאפיינים חדשים של צבעי בחירה ומאגר ל-MenuItemColors, ושם המאפיין trailingIcon שונה ל-trailingContent בבונה הצבעים החדש, תוך שמירה על תאימות בינארית. (I20b92)
  • שיפור של ScrollField הנגישות והתמיכה בניווט באמצעות המקלדת. (If7477)
  • הסרה של ממשקי ComponentOverride API‏ (I3784b)
  • הפונקציות SliderState.Saver ו-RangeSliderState.Saver עם 2 פרמטרים הוצאו משימוש, ועכשיו יש עומסים חדשים שמקבלים שלבים. SliderState כבר לא מטמיע באופן ציבורי את DraggableState. (I7c91b)
  • הוצאה של BasicAlertDialog API מסטטוס ניסיוני (If157c)
  • השינוי של ButtonGroupScope ב-ButtonGroup ל-sealed interface. פיצלנו את Modifier.animateWidth לשתי גרסאות עומס יתר כדי לאפשר השמטה של compressionLimit ופתרון דינמי של כיוון הפריסה, ושינינו את סוג הפרמטר compressionLimit מ-PaddingValues ל-Dp. (I8ef39)
  • השם של TonalToggleButton שונה לFilledTonalToggleButton. הוספנו אנימציות של קווי מתאר חלקים לגבולות של OutlinedToggleButton. המאפיין ToggleButtonDefaults.shapes הוצא משימוש לטובת shapesFor. (Icb433)
  • קידום של LinearTrackStopIndicatorSize,‏ LinearIndicatorTrackGapSize ו-CircularIndicatorTrackGapSize לגרסה יציבה. (I794d0)
  • הוצא משימוש ה-API ‏SplitButtonLayout. במקומו צריך להשתמש ב-API ‏SplitButton (Ic9840)

תיקוני באגים

  • עדכון של מעבר המיקוד במקרה של שגיאה בקלט TimePickerTextField ב-TimePicker.kt. (Ieceec)
  • תוקן הצורה של פריט ברשימה מחולקת כשיש ברשימה רק פריט אחד. (I2ea1c, b/479721696)
  • עדכון של KDocs ל-TimePickerDialog.kt. (Ia5fb8)

גרסה ‎1.5.0-alpha24

‫15 ביולי 2026

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

תכונות

  • הוספת גרסת גלילה חדשה ל-TimePicker (I46f6b)
  • נוספה ספרייה חדשה (material3-ripple I1b3a3) שמוסיפה תמיכה בציור אדוות שמציגות את המיקוד באופן חזותי באמצעות טבעות מיקוד מוסטות במקום שכבת אטימות. הספרייה החדשה הזו מחליפה את material-ripple, והשימוש בה דומה:
    • אם אתם משתמשים ב-material3 עצמו, אתם יכולים להשתמש בהגדרת האדווה המובנית של material3 שמשולבת עם ערכת הנושא ומשתמשת ב-material3-ripple באופן פנימי כפרט הטמעה.
    • אם השתמשתם ב-material-ripple ישירות או שאתם רוצים לתמוך בטבעות פוקוס מוסטות בלי להסתמך על material3, אתם יכולים להשתמש ישירות בספרייה החדשה material3-ripple.

שינויים ב-API

  • הפרמטר ScrollIndicatorState של פס הגלילה השתנה כך שלא ניתן להגדיר אותו כ-nullable. (Iab7c7, b/529445739)
  • מוסיפים מחדש את ההערה @ExperimentalMaterial3Api לממשקי ה-API של AppBarWithSearch. (I0b61a)
  • העברנו את ממשקי ה-API של SearchBarState ושל SearchBar לגרסה יציבה. ממשקי API ישנים יותר של SearchBar שהוצאו משימוש באמצעות onExpandedChange. (Ia3793)

תיקוני באגים

  • תוקנה בעיה של עיכוב בעיבוד, שבה הסמנים RichTooltip ו-PlainTooltip הופיעו באיחור במהלך אנימציית הכניסה. ‫(I874b6, ‏ b/395753083)
  • עדכון ערכי השוליים של וריאנט הקלט/הגלילה של TimePicker. (I83f00)
  • SplitButton קודם מודדים את הכפתור האחרון כדי לוודא שיש מקום. (Id3a1e)
  • תוקנה בעיית נגישות שבה משתמשים בגישה באמצעות מתגים לא יכלו להפעיל שדות טקסט שניתנים לעריכה בתוך ExposedDropdownMenuBox. (I0ea17)
  • תוקן סדר ההכרזות של TalkBack ב-TextField וב-OutlinedTextField כשמופיעה תחילית או סיומת. (Ie79e7)
  • עדכון השוליים של TimePicker ומיקום הנקודתיים (I6bfeb)
  • פתרון בעיות בסדר המיקוד ב-TalkBack עבור ScrollField. (I4ca9f, ‏ b/526870141)
  • עודכנו יחסי התלות של Compose ב-Material 3 לגרסה 1.12.0-beta01. (Ie9417)
  • הוספנו הגבלה לתיבות הטיפ כך שהן לא יחרגו מגבולות החלון, כדי שלא ייחתכו במסכים קטנים או בהגדרות של גופן גדול. (I421ff)
  • עדכון ScrollField עם מעברים בין מספרים יותר מובנים ושינוי הגודל או הטיפוגרפיה (Ic1614)

גרסה ‎1.5.0-alpha23

‫1 ביולי 2026

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

תכונות - רכיב expressive timepicker (Iaa45f) - נוספו וריאציות חדשות לא אינטראקטיביות של רכיבי standard list item ו-segmented list item, בהתאם למפרטים של Material Expressive. הגרסה הלא-מפורטת הוצאה משימוש. (Ide4de, b/491994186)

שינוי התנהגות - תוקנה בעיה שבה הגובה המינימלי של פריטים ברשימה עם עיצוב מיוחד לא השתנה בהתאם לשורות התוכן. הוספנו את ה-feature flag isExpressiveListItemHeightBasedOnTextLinesFixEnabled כדי לעזור במיגרציה. (Ibbb91, ‏ b/484693233)

שינויים ב-API

  • ממשקי ה-API של פריטי רשימה עם הבעה כבר לא ניסיוניים. (I2836a)
  • הסרה של ממשקי ComponentOverride API‏ (I820c4)
  • הסרת פרמטר ההיסט שלא בשימוש מ-DropdownMenuPopup. הוספנו את מאפייני ברירת המחדל של התפריט לברירות המחדל של התפריט. השם של תווית הקבוצות עודכן מ-MenuDefaults.Label ל-MenuDefaults.DropdownMenuGroupLabel. הוספת את disabledContainerColor אל MenuDefaults.selectableItemColors ואל MenuDefaults.selectableItemVibrantColors. נוסף פרמטר Modifier לפונקציות הניתנות להגדרה ב-MenuDefaults שמחזירות פריסה. (I3d2b1)
  • נוסף getter ציבורי flingAnimationSpec ל-TopAppBarDefaults כדי לחשוף את מפרט אנימציית ההטלה שמוגדר כברירת מחדל. (Ic1daa)
  • העברה של TopAppBar, ‏ MediumFlexibleTopAppBar,‏ LargeTopAppBar,‏ LargeFlexibleTopAppBar,‏ TwoRowsTopAppBar,‏ FlexibleBottomAppBar,‏ FlexibleContentPadding,‏ FlexibleBottomAppBarHeight,‏ FlexibleHorizontalArrangement,‏ FlexibleFixedHorizontalArrangement מניסיוני ללא ניסיוני. כבר לא צריך להביע הסכמה לשימוש בממשקי ה-API ובמשתנים האלה באמצעות @ExperimentalMaterial3ExpressiveApi. (Ia4af6)
  • העברה של ExpandedDockedSearchBarWithGap ו-ExpandedFullScreenContainedSearchBar למצב לא ניסיוני (Ie152d)

תיקוני באגים

  • ניקוי פרטי ה-API (Ia8066)
  • תיקון סדר הניווט במקלדת של Scaffold. (I77194, ‏ b/462577176)
  • הסרת הדרישה לcompileSdk 37 (If78b4)
  • הוספנו תמיכה בנגישות לרכיב ScrollField. באופן ספציפי יותר, ב-ScrollField יש עכשיו אפשרות לבחור פריט, והפריט שנבחר מונפש בלחיצה עם הכרזות שנבחרו או לא נבחרו ב-Talkback. (I7bdb7)
  • תוקן באג שבו יש ריווח פנימי נוסף בתחתית אם הוגדר ריווח פנימי של IME לתוכן של ה-scaffold של חבילת הניווט. (I86d9d, ‏ b/389467593)

גרסה ‎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

  • הוספת צורות לרכיב timepicker 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 DropdownMenuItem עם פרמטרים מסומנים ונבחרים שכוללים supportingText כ-lambda נגרר. הפרמטר 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 lambda עבור DropdownMenuItem. במקום זאת, מעבירים אותו מיד אחרי trailingIcon. (I5694b, ‏ b/503047115)
  • קידום ToggleButtons לגרסה יציבה. (I8a771, b/497876827)
  • קידום ממשקי API של תפריטים עם אפשרויות הבעה. הסרת DropdownMenuItem כי זהו API ניסיוני שהוצא משימוש והיה חלק מגרסה 1.5.0-alpha. (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 ואת השיטות שמשויכות אליו למצב יציב. כבר לא צריך להביע הסכמה @ExperimentalMaterial3Api לשימוש בממשקי ה-API האלה. ‫(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 הוספנו דגל תכונה לרכיבים שניתנים לגרירה שמופיעות בהם שגיאות לא ברורות של יעד. המרכיבים כוללים את ModalBottomSheet, BottomSheetScaffold, SwipeToDismissBox ו-WideNavigationRail (I5b0e5, ‏ b/487941042, ‏ b/478210200, ‏ b/477038695)
  • נוספו DropdownMenuItemTrailingLabel שוליים (padding) של ממשק משתמש אופטימליים לשימוש עם פונקציית ברירת המחדל ומצביע לתפריטים מפולחים (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 כך שיכלול את מפרטי הריפוד הנכונים של Material3. כדי לבטל את ההסכמה ולחזור להתנהגות הקודמת, צריך להגדיר את הערך 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 כך שאם הערך הוא true, ל-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. PartiallyExpanded anchor נשמר במעבר הפריסה הראשון שלו כדי לאפשר חישוב פריסה. (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) של SheetStateconfirmValueChange עם ערכים שגויים כשמעבירים נקודת אחיזה לגרירה אל BottomSheetScaffold. חשוב לזכור ש-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)
  • ממשקי DatePicker API שמשתמשים במחלקות Java Time לא מסומנים יותר כניסיוניים. (I5039c, ‏ b/457537971)

תיקוני באגים

  • תיקון קריסה של DatePicker עיצוב תאריך ב-API 23‏ (I67a94, ‏ b/452713222)
  • תוקן באג של יישור חזותי בדוגמה של אינדיקטור אנימציה מפואר, כשמשתמשים בו עם שורות כרטיסיות שאפשר לגלול בהן. (Iae0f3, ‏ b/466790304)
  • תוקנה בעיה שבה בבורר AM/PM של TimePicker לא נעשה שימוש בסגנון הטקסט שהוגדר במפרט של 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 מכילה את השמירות האלה.

תכונות חדשות

  • הוספנו קרוסלה עם יחסי גובה-רוחב שונים (I15247, ‏ b/411232854)

שינויים ב-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 והוספה של רכיב overflow indicator composable כברירת מחדל ב-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 composable שמקבלים lambda של 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)
  • הוספת רכיב לעקיפת ברירת המחדל של תבנית הניווט (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הפונקציות 'צבעים' ו'העתקת פונקציות' צריכות להיות ברמה 'מוסתר'. (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
  • נוסף TimePickerDialog API שאפשר להשתמש בו בשביל 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-alpha‏ (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)
  • עדכונים ב-DatePickers API. הסרנו את תאריך הסיום null שמוגדר כברירת מחדל עבור DateRangePicker, ועכשיו חובה להעביר אותו. הוספנו גם הבהרה לגבי השימוש בחצות UTC בייצוג התאריך במאמרי העזרה של ה-API, וסימנו את הפונקציות האחרונות לקבלת ערכים ולהגדרת ערכים שמשתמשות בממשקי java.time API כניסיוניות בשלב הזה. ‫(I121b3, ‏ b/427952972)
  • העברת סמל עם tint: ColorProducer param API מניסיוני ללא ניסיוני. (Ia0133)
  • הוסרו ההערות הניסיוניות מ-DatePicker, מ-DateRangePicker וממצבי התמיכה, מהמחלקות ומהסוגים שלהם. (I0e4e0, b/391848485)
  • הערך שמוגדר כברירת מחדל ל-focusable שונה ל-false כדי לתקן את המיקוד של נגישות, והפרמטר 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 composable. (I1d4d2)
  • עכשיו אפשר לצפות בcurrentItem של קרוסלה מתוך CarouselState. (Ie87e9)

תיקוני באגים

  • תוקנה בעיה שבה צורה שרירותית ב-FAB שמועברת ל-FloatingToolbar לא החילה את הצל שלה בצורה נכונה. (Icdcc9, b/423336922)
  • כל קרוסלות התמונות משתמשות עכשיו בתפקיד הסמנטי Carousel כברירת מחדל. (I7af12)
  • תוקנה תנועה שגויה של האגודל כשמצב פס ההזזה עודכן באמצעות LaunchedEffect (Id9f31, b/302774166)

גרסה ‎1.4.0-alpha15

‫20 במאי 2025

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

שינויים ב-API

  • נוספה יצירה מקומית: MotionTheme.LocalMotionScheme. ההרשאה הזו מאפשרת גישה לערכת התנועה של העיצוב מ-CompositionLocalConsumerModifierNodes, באמצעות currentValueOf(MotionTheme.LocalMotionScheme). (I014b1)
  • השימוש בבונה ColorScheme ללא תפקידי צבע קבועים הוצא משימוש. צריך לעבור לקונסטרוקטור שכולל תפקידים קבועים. (Iad0ee)
  • רכיב הטקסט M3 תומך עכשיו ב-TextAutoSize. (I7f524)
  • הוספת API ליצירת וריאציות של גודל כפתור מפוצל והוספת דוגמאות. ‫(Ice30b)

תיקוני באגים

  • תוקנה בעיה שגרמה למיקום שגוי של Snackbar ו-FloatingActionButton כשהופעלה התכונה 'מקצה לקצה'. ‫Scaffold מחיל עכשיו בצורה נכונה שוליים פנימיים אופקיים על הרכיבים האלה. (Ib7c30, ‏ b/244400727)
  • תיקון התנועה של BottomSheet מהרחבה מלאה להרחבה חלקית. האפקט של BottomSheetMotionScheme עכשיו מהיר יותר כשמסתירים או מכווצים אותו, ומרחבי כשמרחיבים אותו. (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 ומעלה או desugaring. (I70f29, ‏ b/266202516, ‏ b/281859606)
  • הוספת רכיב CenteredTrack שאפשר להשתמש בו כדי להוסיף פס הזזה עם מסלול שמתחיל מהמרכז. (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)
  • הסרת מקש הצירוף ומקור האינטראקציה מפריטים שניתן ללחוץ עליהם ולעבור ביניהם כברירת מחדל. במקום זאת, כדאי להשתמש בו כפרט הטמעה. (I95ed6)
  • הכפתור ButtonGroup עודכן כך שיוצג בתפריט נפתח אם יש יותר מדי כפתורים שלא נכנסים למסך. (I7b88b)

תיקוני באגים

  • ה-Bottomsheet צורך עכשיו את החלקים העליונים של המסך כשהוא קטן יותר מההיסט הנוכחי. כך המשתמשים יכולים לספק שוליים עליונים להתנהגות מורחבת. המינוי BottomSheetDefaults.windowInsets כולל עכשיו את WindowInsets.safeDrawing.Top. (I0ab67, b/321877275, b/336962418, b/342093067)
  • הופעלו אנימציות כניסה/יציאה (הנמכה/החלקה) לסמלים/אווטארים מובילים של צ'יפים ולסמלים נגררים כשהם מתווספים או מוסרים. ההגדרה הזו מועילה בעיקר לצ'יפים שאפשר לבחור (מסנן, קלט), אבל היא חלה באופן כללי. (I9af21)
  • תוקנה התנהגות לא תקינה של פס הזזה מימין לשמאל שנגרמה בגלל LookaheadScope. (Ieb152, b/408118041)
  • תיקון הקריסה של Bottom AppBar שקשורה לגלילה עם ממשק משתמש מוסתר של המערכת. (Ic6140, ‏ b/405996228)

גרסה ‎1.4.0-alpha12

‫9 באפריל 2025

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

שינויים ב-API

  • הוסרו פרמטרים ספציפיים ל-Android מ-ModalBottomSheetProperties (Iab97f, ‏ b/362539765)
  • הוספת פונקציות של עומס יתר לגודל ברירת המחדל של נקודות האחיזה לגרירה (I0ed0d)
  • הוספנו פונקציות חדשות NavigationSuiteScaffold וNavigationSuiteScaffoldLayout כדי לתמוך בסוגי פריסות חדשים, והוספנו תמיכה בתוכן של פעולה ראשית אופציונלית. (Ib262a, ‏ b/353144478)
  • הוצאה משימוש של Modifier.weight עם פרמטר המילוי ב-ButtonGroup. הוספת גרסה ללא מילוי. (Id32bb)
  • שינוי השם של ברירות המחדל של הרכיבים xSmall- ו-xLarge- IconButton כך שיאיית את extra. (Ib6e0f)
  • הוספנו פונקציות חדשות של NavigationSuite, NavigationSuiteItem ו-NavigationSuiteColors כדי לתמוך בסוגים חדשים של פריסות. (I203d6)
  • הוספנו פונקציות חדשות NavigationSuiteTypes ו-navigationSuiteType שכוללות את אפשרויות הפריסה האלה (If68f9)

תיקוני באגים

  • המיפוי של ColorScheme.contentColorFor הוא עכשיו surfaceDim אל onSurface. (I8891a)
  • עדכנו את ההטמעה של DateInputTextField כדי לפתור בעיה שבה שדה להזנת קלט לא שיקף תאריך שהוגדר באופן פרוגרמטי. (I6c8d1, b/401143451)
  • תוקן סדר ההתמקדות של TalkBack בסרגל הניווט ובסרגל הניווט הרחב (I6cf6f, b/407048224)

גרסה ‎1.4.0-alpha11

‫26 במרץ 2025

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

שינויים ב-API

  • עדכון השימוש באותיות רישיות במאפיינים שניתנים להרכבה באובייקטים שמוגדרים כברירת מחדל עבור לחצן ומתג. מוסיפים שיטות ב-ToggleButtonDefaults וב-ButtonDefaults כדי להגדיר מרווח פנימי מומלץ לתוכן, צורות, גודל סמל, ריווח בין סמלים וסגנון טקסט בהתאם לגובה של מאגר התוכן. (Iea69e)
  • הוסרו פונקציות וקבועים ניסיוניים שהוצאו משימוש מ-FloatingToolbar. (I8f339)
  • רכיבי הגובה חולקים עכשיו ממשק משותף, ויש להם בנאים ומאפיינים ציבוריים. (Ibb172)
  • הוספת משנה animateWidth ב-ButtonGroupScope שצריך להשתמש בו עם רכיבי צאצא של קבוצת לחצנים כדי להנפיש את רכיבי הצאצא בצורה נכונה. (Ia3bb6)

תיקוני באגים

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

גרסה ‎1.4.0-alpha10

‫12 במרץ 2025

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

שינויים ב-API

  • הפונקציה TabRowDefaults.tabIndicatorOffset הוצאה משימוש לטובת TabIndicatorScope.tabIndicatorOffset. (Ib36b3)
  • תיקון שגיאת כתיב במרווח הפנימי הקטן של תוכן בהגדרות ברירת המחדל של הכפתור. (I19bfe)
  • האפשרויות TabRow ו-ScrollableTabRow הוצאו משימוש, ועכשיו יש וריאציות ראשיות ומשניות של כל אחת מהן. השורות בכרטיסיות 'ראשי' ו'משני' מניבות ביצועים טובים יותר ומדויקות יותר בהתאם למפרט. (I918e2)
  • הוספת את rememberSliderState ואת rememberRangeSliderState. (I8e384)
  • הוספנו את shouldAutoSnap ל-SliderState כדי לשלוט במנגנון ההצמדה האוטומטית. השבתה של המנגנון הזה יכולה להיות שימושית ליצירת אנימציות בהתאמה אישית. (I07745)
  • הרוחב המינימלי של הכרטיסייה בשורת הכרטיסיות שניתן לגלול בה הוא עכשיו פרמטר. הגרסאות של שורות הכרטיסיות הראשיות והמשניות כבר לא ניסיוניות. (If6f15, b/226665301)
  • הכיתה ExitAlwaysFloatingToolbarScrollBehavior הוגדרה כציבורית, כך שאפשר ליצור אותה בלי להשתמש בהרכבה. (Ibf31c)

גרסה ‎1.4.0-alpha09

‫26 בפברואר 2025

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

שינויים ב-API

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

תכונות חדשות

  • נוסף TimePickerDialog API שאפשר להשתמש בו בשביל 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. בגרסה עם לחצן הפעולה הצף, ההגדרה הזו חלה על לחצן הפעולה הצף, ובגרסה בלי לחצן הפעולה הצף, היא חלה על התוכן הראשי. (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

  • עדכונים ב-TopAppBar API. משנים את השם של סרגלי האפליקציות העליונים בגודל בינוני וגדול עם כתובית ל-*FlexibleTopAppBar. איחדנו את הווריאציות של הצבעים לפונקציה אחת TopAppBarDefault.topAppBarColors() והוספנו פרמטר צבע subtitle שיוחל על רכיב ה-Composable של הכתובית שסופק (I41b65)
  • הסרה של WideNavigationRailArrangement API לטובת Arrangement.Vertical (Id0341)
  • מוסיפים VerticalSlider @Composable חדש. (I2bfba)
  • נוסף טראק חדש @Composable שמאפשר לציין פינות חיצוניות מותאמות אישית של טראקים וסמלי טראקים. (I436a4)
  • מעדכנים את ממשקי ה-API של סרגל הכלים הצף כדי להשתמש באובייקט FloatingToolbarColors במקום בצבע קונטיינר יחיד. (I9a054)
  • הוספה ושימוש בהערה ניסיונית חדשה ExperimentalMaterial3ComponentOverrideApi (Ia1eaf)
  • ‫Modifier.indicatorLine מקבל עכשיו צורה לתיבת הטקסט כדי לטפל בחיתוך. (I8c5f3, ‏ b/380704151)
  • שינוי השם של הפונקציות הניסיוניות FloatingAppBar ל-FloatingToolbar (I1dbf8)
  • נוסף floatingToolbarVerticalNestedScroll חדש שאפשר לצרף למאגר תגים עם אפשרות גלילה כדי לעדכן את מצב ההרחבה של סרגל הכלים הצף על סמך תנועת גלילה שחוצה סף. (I6d65f)
  • השקנו API חדש ליצירת סרגל כלים צף עם לחצן פעולה צף (FAB) שמצורף אליו. ממשק ה-API מספק אפשרויות גמישות להתאמה אישית, שמאפשרות לכם לסדר את סרגל הכלים בצורה אופקית או אנכית, ולמקם את ה-FAB בתחילת סרגל הכלים או בסופו. (I9e350)

תיקוני באגים

  • תוקנה בעיית נגישות ב-Snackbar שגרמה להכרזה על עצמו כשסוגרים אותו כשההגדרה TalkBack מופעלת. (/I9db53)

External Contribution

  • הפכו את BasicTooltip לנפוץ ב-Foundation ואת BasicTooltip/Tooltip ב-Material3. (Ifc2e6)

גרסה ‎1.4.0-alpha05

‫12 בדצמבר 2024

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

שינויים ב-API

  • כדי לשפר את הקריאות, מחליפים את הסוג בערך WideNavigationRailState.current/target של enum (I2d6ab)
  • SplitButton שינוי Shape API ממחלקת נתונים למחלקה לצורך תאימות בינארית. (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, כפי שמתואר במסמך. ההטמעה הזו תואמת לגרסה 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)
  • גורמים לשינוי הערך של רכיב Slider של Material כשלוחצים על מקשי בקרה. (I1c442)

גרסה ‎1.4.0-alpha02

‫16 באוקטובר 2024

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

שינויים ב-API

  • עדכונים בכלי לבחירת תאריכים כדי להבטיח שימוש עקבי במיקום בכל DatePicker וDateRangePicker כשמגדירים מיקום ישירות דרך DatePickerState או DateRangePickerState. שימו לב: כשמגדירים את המאפיין Locales ישירות למדינה, אתם צריכים לוודא שהטקסטים של הכותרת והכותרת הראשית מותאמים לשפה ולתרבות המקומיות בהתאם, כי הטקסט שמוגדר כברירת מחדל עדיין יוחל בהתאם ל-Locale של פלטפורמת ברירת המחדל. (I37073, b/326490763, b/321657276)
  • SheetState.isAnimationRunning מוצג עכשיו. (I9a3d7)
  • DatePickerColors מקבלים עכשיו עדיפות על פני צבעים סותרים שמוגדרים בסגנונות הטקסט של הטיפוגרפיה של העיצוב. חשוב גם לשים לב שהעדכון הזה משנה את המיקום של הפרמטר 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)
  • מוסיפים משנה כדי להנפיש את ההצגה וההסתרה של הלחצן הראשי לפעולה, למשל כשגוללים את התוכן. (I8338d)
  • הוספת צורות וריווח של קבוצת לחצנים מחוברים ל-ButtonGroupDefaults לשימוש בדוגמה. (I68e30)
  • הוספת ריווח אופקי ללחצן האחרון בלחצן מפוצל והפעלת מרכוז אופטי שמחושב לפי ההבדלים בין הפינות של ההתחלה והסוף (I122e2)
  • אנחנו מציגים MotionScheme חדש של Material שמאפשר להגדיר סכמה לתנועה של הרכיב. הסכמה מוגדרת דרך MaterialTheme. (Id50c2)

תיקוני באגים

  • החלת אינדקס נכון של מעבר בין רכיבים על רכיבי Scaffold Child 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 וב-Android O (a10a2d)
  • הגדלנו את הגבולות הסמנטיים של פס ההזזה כדי ש-TalkBack יציג כמו שצריך את אינדיקטורי המיקוד סביב התמונות הממוזערות. (0b5a1d)

גרסה ‎1.3.0-beta04

‫26 ביוני 2024

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

גרסה ‎1.3.0-beta03

‫12 ביוני 2024

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

External Contribution

  • הגדרת androidx.compose.material3.DropdownMenu כזמין מקבוצת מקורות נפוצה. (If62c0)

גרסה ‎1.3.0-beta02

‫29 במאי 2024

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

שינויים ב-API

  • ‫Modifier.pullToRefreshIndicator תומך בהעלאה, מעדכן את ממשקי ה-API של 'משיכה לרענון' כך שההגדרה 'מופעל' תהיה בוליאנית ולא למדה. תמיכה בהתאמת תוכן ב-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 הוגדר כמאפיין שאפשר להשאיר ריק. כדי להשבית את האפקט, במקום לספק 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 עד ש-BasicTooltip של Foundation יתייצב. (Icda29)
  • נוסף אובייקט TextDefaults שמכיל שיטות ליצירת LinkAnnotation ולניתוח מחרוזת עם תגי HTML שמחילות MaterialTheme על הקישורים (I98532, b/139312671)
  • ExposedDropdownMenuBoxScope לא מאפשר יותר שימוש במחלקות משנה. לתפריטים הנפתחים שמוצגים יש עכשיו MenuAnchorType שצריך להעביר ל-menuAnchor כדי לשפר את הנגישות. צריך להשתמש בפרמטר הזה במקום להעביר את focusable אל ExposedDropdownMenu, שיצא משימוש. ל-menuAnchor יש פרמטר חדש לשליטה במצב enabled. (I55ee6, b/257209915, b/308840226)
  • תוקן צבע הגבול של OutlinedButton כשהוא מושבת. נוספה ButtonDefaults.outlinedButtonBorder("enabled") עומס יתר שמקבל את המצב המופעל. ‫(Ie650b, ‏ b/318461363)
  • נוספה מחלקה חדשה, CarouselItemInfo, כדי לעזור ללקוחות לקבל מידע על גדלי הפריטים. (I9070c)
  • הוצאנו משימוש את ה-constructor‏ ColorScheme בלי קונטיינרים של משטחים. צריך להעביר את הקוד אל בנאי שכולל מאגרי פלטפורמות. (I35c11)
  • [עם קווי מתאר]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 Nav Drawer (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 והספירות (enums) DismissDirection ו-DismissValue שהוצאו משימוש. (I89ccd)
  • נוסף תג ניסיוני לאובייקט הנלווה CarouselState של Carousel. (I94154)
  • הוצאנו משימוש את LocalMinimumInteractiveComponentEnforcement והשקנו את LocalMinimumInteractiveComponentSize במקומו. (I7a7ac)
  • ה-constructor‏ SearchBarColors גלוי עכשיו לכולם. (I769ca)
  • הוספת פרמטר gesturesEnabled אל SwipeToDismissBox. (Idc59f, b/324170119)
  • הוסרו ממשקי API של שדות טקסט שסומנו כניסיוניים וככאלה שיצאו משימוש. (I1305f)

גרסה ‎1.3.0-alpha03

‫20 במרץ 2024

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

שינויים ויזואליים שעלולים לגרום לכשלים

  • צריך לעדכן את שכבת העל של מצב המיקוד ל-0.1f כדי להבטיח ניגודיות צבעים מספקת. (I7ea77)
  • שינויים קלים בצבעי ברירת המחדל של הרקע והמשטח ב-lightColorScheme וב-darkColorScheme. (I9db52)

תכונות חדשות

  • נוספו פרמטרים להתאמה אישית של ExposedDropdownMenu. בפרט, לתפריטים יש עכשיו פרמטר focusable (ברירת המחדל היא true) שצריך להגדיר ל-false כשעובדים עם שדות טקסט שאפשר לערוך. (I4184c, ‏ b/323694447, ‏ b/278609042)

שינויים ב-API

  • הסימון ScaffoldSubcomposeInMeasureFix הוסר. (Ie2a4b)
  • העסק NavigationRailItemColors מסומן עכשיו כ@Immutable. (If6112, b/327660613)
  • העסק NavigationBarItemColors מסומן עכשיו כ@Immutable. (I42a30, b/298064514)
  • שינוי הסדר של הפרמטרים בקומפוזיציה Slider Track. (I9f315)
  • האפשרות ExposedDropdownMenu מיושמת עכשיו באמצעות Popup. ההתנהגות צריכה להיות זהה, למעט תפריטים שניתן להתמקד בהם עם שדות טקסט שניתנים לעריכה, שאפשר לסגור אותם כשמקלידים במקלדת.

תיקוני באגים

  • התפקידים הבסיסיים של Surface ו-Surface container שונו מעט, ועכשיו יש יותר גוון בעיצובים בהירים וכהים. (I677a5)
  • עדכנו את המחוון ואת הצבעים ProgressIndicator בהתאם למפרטים החדשים של ניגודיות בין רכיבים שאינם טקסט. (I26807)
  • צריך לעדכן את שכבת העל של מצב המיקוד ל-0.1f כדי להבטיח ניגודיות צבעים מספקת. (I7ea77)
  • שינויים קלים בצבעי ברירת המחדל של הרקע והמשטח ב-lightColorScheme וב-darkColorScheme. (I9db52)

גרסה ‎1.3.0-alpha02

6 במרץ 2024

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

שינויים ב-API

  • החזרת המצב היציב של פס ההזזה. הופך את State.onValueChangeFinished ל-val שוב. הוספת onValueChangeFinished ל-rememberUpdatedState. ‫(I82ab2, ‏ b/322269951)
  • רכיבי הניווט משתמשים עכשיו בתפקידים החדשים SurfaceContainer. במאפיין DrawerDefaults יש עכשיו מאפיינים נפרדים של standardContainerColor ו-modalContainerColor. המוצר DrawerDefaults.ModalDrawerElevation נקרא עכשיו 0.dp. (I7fbac)
  • הסרנו את @Stable מהמצבים של Slider כי אנחנו משנים את state.onValueChangeFinished ל-var. (Ied34a, ‏ b/322269951)
  • ModalBottomSheet וStandardBottomSheet אנימציה של קפיץ, עכשיו 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. צבע המאגר של SurfaceContainerHighestFilledCard. (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 מכילה את השמירות האלה.

תכונות חדשות

  • עדכון של Compose M3 ModalBottomSheet לתמיכה בתכונה 'חזרה עם חיזוי' ב-U+ (Iccf32, ‏ b/281967264, ‏ b/304850357)
  • בוצע עדכון של Compose M3 SearchBar כדי לתמוך בתכונה 'חזרה עם חיזוי' ב-U+ (I657f8)
  • הוספנו רווח ואינדיקטור עצירה לפס ההזזה כדי לשפר את הנגישות. (I3058e)
  • בוצע עדכון ב-ProgressIndicator כדי לשפר את הנגישות על ידי הוספת רווח ואינדיקטור עצירה. (I21451)
  • הוספנו סמן טקסט ברירת מחדל לתיאור הכלים המתקדם. ה-API החדש של תיאור הכלים המתקדם מאפשר עכשיו לצייר סמן טקסט מותאם אישית בהינתן עוגן LayoutCoordinates. (Ifd42c)

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

  • רכיבי Material הועברו לשימוש בממשקי ה-API החדשים של אפקט הגל, והם כבר לא שולחים שאילתות ל-RippleTheme.

שינויים ב-API

  • הכיף drawStopIndicator גלוי עכשיו לכולם. (I3f59f)
  • סימון הפונקציה DatePicker של formatWithSkeleton כפנימית (Ic65dc)
  • ‫DropdownMenu תומך עכשיו בצבע, בצורה, בגובה ובגבול בהתאמה אישית. (I8e981, b/289554448, b/301887035, b/283654243)
  • רכיבי Material3 שחשפו MutableInteractionSource ב-API שלהם עודכנו כך שהם חושפים עכשיו MutableInteractionSource שניתן להגדיר כ-null, ומוגדר כברירת מחדל ל-null. אין כאן שינויים סמנטיים: העברת הערך null פירושה שאתם לא רוצים להעלות את MutableInteractionSource, והוא ייווצר בתוך הרכיב אם יהיה צורך בכך. שינוי ל-null מאפשר לרכיבים מסוימים לא להקצות MutableInteractionSource אף פעם, ולרכיבים אחרים ליצור מופע רק כשצריך, וכך לשפר את הביצועים של הרכיבים האלה. אם אתם לא משתמשים ב-MutableInteractionSource שמועבר לרכיבים האלה, מומלץ להעביר במקומו null. מומלץ גם לבצע שינויים דומים ברכיבים שלכם. (I41abb, ‏ b/298048146)
  • הוספנו את RippleConfiguration ואת LocalRippleConfiguration כדי לאפשר התאמה אישית של אפקטי הגלים לכל רכיב או עץ משנה באמצעות ערכים קבועים. לדוגמה, כדי לשנות את הצבע של רכיב שאין לכם שליטה בו, או כדי להשבית את האפקט של גלי ההדף ברכיב. ברוב המקרים כדאי להשתמש בערכי ברירת המחדל: ממשקי ה-API האלה הם פתרון למקרים שבהם צריך להתאים אישית רכיבים בודדים או עצי משנה מוגבלים. לשינויים רחבים יותר ולמערכות עיצוב מותאמות אישית, עדיף ליצור אפקט אדווה משלכם באמצעות createRippleModifierNode. (I7b5d6, ‏ b/298048146)
  • נוסף ripple API חדש ב-material3 שמחליף את rememberRipple שהוצא משימוש. בנוסף, נוסף CompositionLocal זמני, LocalUseFallbackRippleImplementation, כדי להחזיר את השימוש ברכיבי material3 לממשקי ה-API שהוצאו משימוש rememberRipple / RippleTheme. ההגדרה הזו תוסר בגרסה היציבה הבאה, והיא נועדה רק כעזר זמני להעברה במקרים שבהם אתם מספקים RippleTheme מותאם אישית. ‫(I34cbc, ‏ b/298048146)

תיקוני באגים

  • הוסר רכיב משנה בתוך ModalBottomSheet כדי לשפר את הביצועים. תוקנה בעיה שגרמה לקריסה של ModalBottomSheet בתרחישים ספציפיים בשילוב עם LookaheadScope. (I2a198)
  • הוסר רכיב משנה בתוך BottomSheetScaffold כדי לשפר את הביצועים. תוקנה בעיה שגרמה לקריסה של BottomSheetScaffold בתרחישים ספציפיים בשילוב עם LookaheadScope. (Ie6401)
  • המיקום של התג משתנה כך שהוא קרוב יותר למרכז של תוכן העוגן ביחס לפינה השמאלית העליונה. (I18a28)
  • תוקנה בעיית נגישות ב-DateRangePicker שבה הכותרת של הטקסט 'חודש-שנה' הועברה כפעולה למשתמשים של קורא המסך, גישה באמצעות מתג ו-Voice Access. (I2ac55)
  • תוקן באג בסדר הפרמטרים mediumTopAppBarColors. (Ibe64a)

גרסה 1.2

גרסה 1.2.1

6 במרץ 2024

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

תיקוני באגים

  • הופכים את מצבי פס ההזזה ליציבים שוב. הופך את State.onValueChangeFinished ל-val שוב. הוספת onValueChangeFinished לrememberUpdatedState. (Ie8fd0, ‏ b/322269951)
  • הסרנו את @Stable מהמצבים של Slider כי אנחנו משנים את state.onValueChangeFinished ל-var. (I82ba1, b/322269951)
  • תיקון צבעים בהתאמה אישית NavigationBar כדי להעתיק אותם מברירות המחדל. (80a779, ‏ b/326894020)
  • תיקון רגרסיה ב-ExposedDropdownMenu כדי להפוך אותו שוב לניתן למיקוד (3fcec1, b/323694447)
  • תוקנה בעיה של שמירת צבע הכפתור במטמון (3e5bbcb/327371655)

גרסה 1.2.0

‫7 בפברואר 2024

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

בעיה ידועה

  • באג בעיבוד של View-Compose interop נוסף בגרסה 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)
  • פונקציות ליצירת Mark 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 של הסברים קצרים על כלים נקראים עכשיו @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 קורס בתרחישים מסוימים עם פריסות Lookahead ו-Lazy מקוננות. (Ica8d1, ‏ b/297226562)

גרסה ‎1.2.0-alpha10

‫18 באוקטובר 2023

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

שינויים ב-API

  • העלאת Badge ו-BadgedBox לגרסה יציבה. (I67f16, b/261565132)
  • הוספת securePolicy כפרמטר ל-ModalBottomSheet, כדי שהמשתמשים יוכלו להגדיר את ההתנהגות של WindowManager.LayoutParams.FLAG_SECURE. ‫(Icdac8, ‏ b/296250262)
  • נוספו עומסים חדשים של LinearProgressIndicator ו-CircularProgressIndicator שמקבלים progress כביטוי למדא. הגרסאות האלה אמורות להניב ביצועים טובים יותר מהגרסאות הקודמות. (I824e6, b/295616656)
  • משנה את השם של StandardSizeClasses ל-AllSizeClasses. (I8cb07)
  • שילוב של פונקציות חישוב של מחלקות גודל חלון. (Iad935)

תיקוני באגים

  • תיקנו קריסה של DatePicker כשלוחצים במהירות על לחצני החצים לניווט כשהחודש שמוצג נמצא בקצה של טווח השנים המותר. (I46f36, ‏ b/290954897, ‏ b/297002119)
  • [סרגל ניווט] תמיכה בצבע שקוף לאינדיקטור. ‫(Ie0a9b, ‏ b/267289987)

גרסה ‎1.2.0-alpha09

‫4 באוקטובר 2023

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

שינויים ב-API

  • העברנו את ModalNavigationDrawer וDismissibleNavigationDrawer לשימוש בממשקי API חדשים של AnchoredDraggable. השיטה DrawerState של animateTo הוחלפה בשיטות 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)
  • תוקן באג שגרם לכך ש-ModalBottomSheet לא התקשר ל-onDismissedRequest כשסגרו אותו בהחלקה כלפי מטה בגיליון. (Idfdd8)

גרסה ‎1.2.0-alpha07

‫6 בספטמבר 2023

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

תכונות חדשות

  • נוספה תמיכה בסמלים עם שיקוף אוטומטי בגרסה compose material 1.6.0-alpha05. פרטים על סמלים עם שיקוף אוטומטי זמינים בהערות על הגרסה.

שינויים ב-API

  • ‫SliderState 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)
  • כדי למזער את ההמרה האוטומטית של ערכים פרימיטיביים לאובייקטים, כדאי להשתמש ב-FloatRange במקום ב-ClosedFloatingPointRange בממשקי Material3 API ניסיוניים. (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 לממשקים ציבוריים. נוספו RichTooltipStateImpl וPlainTooltipStateImpl למצבי ברירת מחדל. נוספו פונקציות remember*State כדי לקבל את המצבים המיושמים האלה. הוסר TooltipSync לטובת TooltipDefault.GlobalMutatorMutex. (I7813d)
  • עדכנו את DatePickerColors כדי לכלול אפשרויות נוספות להתאמה אישית של המפריד בבוחר התאריכים, הניווט והצבעים של שדות קלט הטקסט. (I1a685, b/274626815)
  • ‫DatePickerState ו-DateRangePickerState הן עכשיו ממשקי API ציבוריים עם הטמעות ברירת מחדל שאפשר לאחזר באמצעות 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. הוא מאפשר להשתמש בפריסות שונות, בהתאם להגדרת תצורה של מסך (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)
  • שם המצב 'מצומצם' 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)
  • נוסף Material 3 DateRangePicker API לבחירת טווח תאריכים. (I7a6c3, ‏ b/267194809)
  • הוספנו תמיכה במצב קלט של Material 3 לבחירת טווחי תאריכים באמצעות DateRangePicker API. (Ifdbc4)
  • עכשיו אפשר להתאים אישית את הצבעים של שדות הטקסט:
    • צבעים של שדה להזנת קלט ושל טקסט placeholder בהתאם למצב המיקוד ולמצב השגיאה. הפרמטר 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)

תיקוני באגים

  • צורת ברירת המחדל של ModalBottomSheet היא עכשיו תמיד SheetDefaults.ExpandedShape. (I0dfca)
  • שיפורים בנגישות של Material 3‏ DatePicker ושל DateRangePicker. (I5087e)
  • תוקן באג שבו מגבלת הגובה המקסימלי מועברת ועלולה לגרום לקריסה. (I30d8c)
  • הוסרו תפקידים סמנטיים מפלטפורמות שניתן ללחוץ עליהן ולבחור אותן, ורכיבים שעשו בהם שימוש עודכנו כדי להגדיר תפקידים באמצעות modifier.semantics (I793d9)

גרסה ‎1.1.0-alpha06

‫8 בפברואר 2023

‫androidx.compose.material3:material3:1.1.0-alpha06 וגם androidx.compose.material3:material3-window-size-class:1.1.0-alpha06 מופצים. גרסה ‎1.1.0-alpha06 מכילה את השמירות האלה.

תכונות חדשות

  • שדות טקסט תומכים עכשיו בטקסט של קידומת וסיומת (Ia8578, ‏ b/179884561)
  • נוספה פונקציה TimePicker להצגת כלי לבחירת שעה בהתאם למפרט Material 3, לשימוש בשילוב עם TimePickerState ועם שיטת הנוחות rememberTimePickerState (I71910)
  • שדה להזנת תאריך מוצג עכשיו במצב תצוגה במיקום DatePicker. הוספנו תמיכה במעבר בין מצב של בוחר תאריכים לבין מצב של הזנת תאריך. (Ieeff7)
  • נוסף API ל-RichTextTooltips. (I58ef3)
  • הטמעה של גיליון תחתון מודאלי ב-Material 3, כולל ModalBottomSheet ו-ModalBottomSheetDefaults. בנוסף, נוספו SheetState ו-rememberSheetState שאפשר להשתמש בהם ברכיבי גיליון עתידיים. (I0853a, ‏ b/244189383)

שינויים ב-API

  • ייצוב API‏ showSnackbar (I195c2, ‏ b/261424370)
  • ייצוב ממשקי ה-API של צ'יפ העזרה והצעות קשורות (Ibb67b, ‏ b/261424370)
  • קידום של ממשקי API‏ ListItem, ListItemDefaults ו-ListItemColors לגרסה לא ניסיונית (I7e7fa, ‏ b/261438882)
  • העברנו את ממשקי ה-API‏ SliderPositions, ‏SliderDefaults.Thumb ו-SliderDefaults.Track לגרסה יציבה והוספנו את ממשקי ה-API‏ Slider ו-RangeSlider שאינם ניסיוניים ומכילים תמונות ממוזערות ורצועות בהתאמה אישית. בנוסף, אנחנו מוציאים משימוש את ממשקי ה-API הקודמים של Slider ושל RangeSlider. ‫(Ie5ea6, b/261566890)
  • הגדרנו את Modifier.tooltipAnchor() כגלוי לכולם, כדי שמפתחים יוכלו להעביר אותו לרכיב Anchor כדי לציין שצריך להציג הסבר קצר בלחיצה ארוכה. העדכון של PlainTooltipBox API לא מאפשר יותר להגדיר את TooltipState כ-nullable, ועכשיו יש לו ערך ברירת מחדל. (Ie2fb7)
  • הערך ProgressIndicatorDefaults.circularTrackColor סומן כ-@Composable כדי לשמור על עקביות. (Id29cc)
  • שחזור הפונקציה לקבלת מאפיין LocalMinimuTouchTargetEnforcement וסימונה כפונקציה שהוצאה משימוש, והפניה אוטומטית אל LocalMinimumInteractiveComponentEnforcement. (I60dd5)

גרסה ‎1.1.0-alpha05

‫26 בינואר 2023

‫androidx.compose.material3:material3:1.1.0-alpha05 וגם androidx.compose.material3:material3-window-size-class:1.1.0-alpha05 מופצים. גרסה ‎1.1.0-alpha05 מכילה את השמירות האלה.

תכונות חדשות

  • DatePickerDialog ותמיכה בנגישות
  • נוספו תמונה ממוזערת ומסלול בהתאמה אישית אל RangeSlider.

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

  • ‫Compose UI ו-Compose Material תלויים עכשיו ב-Lifecycle 2.6.0.

גרסה ‎1.1.0-alpha04

‫11 בינואר 2023

‫androidx.compose.material3:material3:1.1.0-alpha04 וגם androidx.compose.material3:material3-window-size-class:1.1.0-alpha04 מופצים. גרסה ‎1.1.0-alpha04 מכילה את השמירות האלה.

תכונות חדשות

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

שינויים ב-API

  • נוספה תכונת הסמנטיקה IsContainer בפלטפורמות השונות של Google. הנכס הזה ישמש בשינוי מאוחר יותר שקובע את סדר המעבר בין רכיבים על סמך המשמעות הסמנטית של רכיבים כמו משטחים. (I63379)
  • סימון ממשקי API שקשורים לחלונית ההזזה לניווט כיציבים. (Iab01e, ‏ b/261439597)
  • נוסף פרמטר של צבע הרקע לאינדיקטורים של התקדמות מעגלית, ופרמטר של קצה הקו לאינדיקטורים של התקדמות מעגלית ולינארית. (Ie668c, ‏ b/216325962, ‏ b/222964817)
  • הוספנו עוד פונקציות שהוצאו משימוש ומוסתרות, עם אפשרות להחזרת ערך null (Ibf7b0)
  • מוסיפים את Modifier.minimumInteractiveComponentSize. אפשר להשתמש בה כדי להזמין לפחות 48dp בגודל כדי להבחין בין אינטראקציות של מגע אם הרכיב יהיה קטן יותר. (I33f58, b/258495559)
  • נוסף API ניסיוני לרכיב AlertDialog שאפשר להרכיב ויש לו משבצת תוכן. (Iec4a2)

תיקוני באגים

  • ההתקדמות באינדיקטורים של ההתקדמות מוגבלת עכשיו לטווח הצפוי. (I8a7eb, ‏ b/262262727)

בעיה ידועה

  • כשמעדכנים מ-androidx.compose.foundation:1.4.0-alpha03 ל-androidx.compose.foundation:1.4.0-alpha04, יכול להיות שתיתקלו בשגיאה java.lang.NoSuchFieldError. כאן דווחה הבעיה במקור. תיקון נשלח, והוא יהיה זמין בעדכון הבא של כלי הכתיבה. כפתרון עקיף, אפשר לעדכן את הספריות androidx.compose.material ו-androidx.compose.material3 לגרסה האחרונה(1.1.0-alpha04) או לשנמך את androidx.compose.foundation לגרסה 1.4.0-alpha03.

גרסה ‎1.1.0-alpha03

‫7 בדצמבר 2022

‫androidx.compose.material3:material3:1.1.0-alpha03 וגם androidx.compose.material3:material3-window-size-class:1.1.0-alpha03 מופצים. גרסה ‎1.1.0-alpha03 מכילה את השמירות האלה.

שינויים ב-API

  • שינינו את השם של consumedWindowInsets() ל-consumeWindowInsets() ושל withConsumedWindowInsets() ל-onConsumedWindowInsetsChanged(), והפכנו את ה-Modifiers לציבוריים. (Ie44e1)
  • להוסיף ריווח חדש של תוכן ברירת מחדל ללחצן טקסט עם סמל לשימוש. (I8f662)
  • נוספו צבעים מושבתים לסרגל הניווט ולפס הניווט. (Ia7892, b/258867034)
  • נוסף Modifier API לשליחת שאילתות לגבי פרטי גלילה של רכיבי צאצא. (I2ba9d, ‏ b/203141462)
  • המאפיין הזה משמש ב-Clickable כדי להשהות נכון אינטראקציות של לחיצה, במקרים שבהם תנועות יכולות להפוך לאירועי גלילה.
  • תוקן באג שגרם לכך ש-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 Medium וב-Large top app bars מאפשרים להחיל את אותו צבע רקע על כל המשטח שלהם, ולהגדיר ערכי צבע שקופים כדי לשנות את צבעי ברירת המחדל. (I67659, b/249688556, b/250838918)

גרסה ‎1.1.0-alpha01

24 באוקטובר 2022

‫androidx.compose.material3:material3:1.1.0-alpha01 וגם androidx.compose.material3:material3-window-size-class:1.1.0-alpha01 מופצים. גרסה ‎1.1.0-alpha01 מכילה את השמירות האלה.

תיקוני באגים

  • בוצעו תיקונים בסרגל האפליקציות העליון כשמחילים כותרת עם TextStyle ו-Brush. ‫(If667e)

גירסה 1.0

גרסה 1.0.1

‫9 בנובמבר 2022

‫androidx.compose.material3:material3:1.0.1 וגם androidx.compose.material3:material3-window-size-class:1.0.1 מופצים. גרסה 1.0.1 מכילה את השמירות האלה.

תיקוני באגים

  • העדכונים ב-Material3 Medium וב-Large top app bars מאפשרים להחיל את אותו צבע רקע על כל המשטח שלהם, ולהגדיר ערכי צבע שקופים כדי לשנות את צבעי ברירת המחדל. (I67659, b/249688556, b/250838918)

גרסה 1.0.0

24 באוקטובר 2022

‫androidx.compose.material3:material3:1.0.0 וגם androidx.compose.material3:material3-window-size-class:1.0.0 מופצים. גרסה 1.0.0 מכילה את השמירות האלה.

התכונות העיקריות בגרסה 1.0.0

זו הגרסה היציבה הראשונה של Compose Material 3!

התאמת עיצוב של Material Design 3 וצבע דינמי של Material You

רכיבים של Material Design 3

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

  • ‫material3-window-size-class היא ספרייה חדשה שמספקת תמיכה במחלקות של גודל חלון: קבוצה של נקודות עצירה (breakpoints) באזור התצוגה, שמאפשרות לכם לעצב, לפתח ולבדוק פריסות של אפליקציות שניתן לשנות את הגודל שלהן. אפשר להשתמש ב-calculateWindowSizeClass כדי לאחזר מופע של מחלקת גודל חלון, שבעזרתו אפשר לקבוע איך ממשק המשתמש צריך להיראות, למשל להציג סרגל ניווט במקום ניווט בתחתית המסך לגדלים גדולים יותר של חלונות. מידע נוסף ודוגמאות לשימוש מופיעים במאמרי העזרה של WindowSizeClass API.

  • פרטים נוספים זמינים בפוסט הזה בבלוג.

גרסה ‎1.0.0-rc01

‫5 באוקטובר 2022

‫androidx.compose.material3:material3:1.0.0-rc01 וגם androidx.compose.material3:material3-window-size-class:1.0.0-rc01 מופצים. גרסה ‎1.0.0-rc01 מכילה את השמירות האלה.

שינויים ב-API

  • הוספנו פרמטר של משבצת לתמיכה ב-API של שדה טקסט לטקסט (Iaac0d, ‏ b/227146125)

גרסה ‎1.0.0-beta03

‫21 בספטמבר 2022

‫androidx.compose.material3:material3:1.0.0-beta03 וגם androidx.compose.material3:material3-window-size-class:1.0.0-beta03 מופצים. גרסה ‎1.0.0-beta03 מכילה את השמירות האלה.

שינויים ב-API

  • ‫ExposedDropdownMenuDefaults עכשיו אפשר לראות את ערך הריווח הפנימי של פריטים בתפריט. (I34ee1)
  • ב-ExposedDropdownMenuBoxScope יש עכשיו משנה Modifier.menuAnchor() שצריך להעביר לשדה הטקסט כדי להבטיח התנהגות נכונה של נגישות. (I27fa3)
  • הוספנו שתי שיטות עמוסות מדי ל-Slider API הנוכחי כדי לאפשר למשתמשים להעביר את האגודל או את פס ההזזה כדי לאכלס את פס ההזזה. (I21c00)

תיקוני באגים

  • מיפוי הצבעים של העיצוב הכהה עבור On Error Container עודכן לטון 90 (Ic5612)
  • בוצע תיקון שמאפשר להגדיר רקע שקוף לסרגלי אפליקציות קטנים בחלק העליון של Material 3. (I645e2, ‏ b/245575782)

גרסה ‎1.0.0-beta02

‫7 בספטמבר 2022

‫androidx.compose.material3:material3:1.0.0-beta02 וגם androidx.compose.material3:material3-window-size-class:1.0.0-beta02 מופצים. גרסה ‎1.0.0-beta02 מכילה את השמירות האלה.

שינויים ב-API

  • השוליים הפנימיים של רכיבי ברירת המחדל שהוצגו ברכיבי m3 בגרסה beta01 כבר לא כוללים שוליים פנימיים של IME.
  • לרכיב Material3 Scaffold יש עכשיו פרמטר contentWindowInsets, שמאפשר לציין את כמות השוליים הפנימיים לטיפול במשבצת התוכן. (Icf11a, ‏ b/243713323)
  • הוצאה משימוש של הפונקציה הניסיונית Material 3 SmallTopAppBar והוספה של פונקציה מקבילה TopAppBar. עליך להעביר את השימוש שלך לשיטה החדשה. (I74404, ‏ b/226918634)
  • הוספת שליטה בהתנהגויות של הטלת האפליקציה ושל הצמדתה לסרגל האפליקציות העליון. (I15c81)
  • הסרה של startIndent מ-Divider, העברה של color לפרמטר האחרון. ‫(If7be2)

תיקוני באגים

  • האם תיבות הדו-שיח יזוהו על ידי משתמשי TalkBack באמצעות הכרזה על המילה 'תיבת דו-שיח' כשהן מוצגות. (I857ef)

גרסה ‎1.0.0-beta01

‫24 באוגוסט 2022

‫androidx.compose.material3:material3:1.0.0-beta01 וגם androidx.compose.material3:material3-window-size-class:1.0.0-beta01 מופצים. גרסה ‎1.0.0-beta01 מכילה את השמירות האלה.

הפניית API

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

שינויים ב-API

  • עדכנו את סרגל האפליקציות העליון של Material 3 כך שיעבור ממצב מכווץ לחלוטין למצב מורחב לחלוטין. בנוסף, עודכנה פונקציית ההתנהגות TopAppBarDefaults כך שתהיה Composables ותספק ערכי ברירת מחדל למצב של סרגל האפליקציות העליון ולמפרט האנימציה שלו. (I642b3)
  • בוצע עדכון של חתימות רכיב ה-FAB כך שיתאימו ל-Surface 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

  • שינוי הסדר של פרמטרים של כרטיסייה וסמל מוביל בכרטיסייה כדי לשמור על עקביות ב-API (Ie2637)
  • התכונה BadgeDefaults סומנה כניסיונית. (I98ef3)
  • הסרת פונקציה שהוצאה משימוש בחלונית ההזזה לניווט. (I4f2db)
  • שינוי הסדר של הפרמטרים של Slider ב-Material 3 כדי לשמור על עקביות ב-API‏ (I0aee7)
  • שינוי הסדר של הפרמטרים NavigationBar ו-NavigationRail כדי לשמור על עקביות ב-API (I51cda)
  • שינוי הסדר של הפרמטרים ב-Material 3 כדי לשמור על עקביות ב-API. (If4ae1)
  • שינוי הסדר של הפרמטרים של Slider ב-Material 3 כדי לשמור על עקביות ב-API (I62673)
  • שינינו את שם הפרמטר icons (סמלים) ל-actions (פעולות) כדי ליצור עקביות עם סרגל האפליקציות העליון (Id75be)
  • סימון Badge ו-BadgedBox כניסיוניים כי יישור העוגן עדיין משתנה. (I1712e, b/236524516)
  • שינוי הערות @ExperimentalMaterial3Api בווריאנטים של לחצני סמלים ל-@OptIn (I070b5)
  • הפרדנו את התוכן של מגירת הניווט לרכיב שאפשר להוסיף לו כדי לתמוך בציון רוחב מותאם אישית. (Ia7f10)
  • הסרה של Divider מ-MenuDefaults ומ-TabDefaults (I4e33c)

גרסה ‎1.0.0-alpha15

‫27 ביולי 2022

‫androidx.compose.material3:material3:1.0.0-alpha15 וגם androidx.compose.material3:material3-window-size-class:1.0.0-alpha15 מופצים. גרסה ‎1.0.0-alpha15 מכילה את השמירות האלה.

תכונות חדשות

  • מאפשר גרירה של סרגל האפליקציות העליון מהסרגל עצמו. ‫(I65c00, ‏ b/205873416)

שינויים ב-API

  • עדכונים בממשקי ה-API‏ FilterChip ו-ElevatedFilterChip להסרת המשבצת selectedIcon ולקידום השימוש החוזר ב-leadingIcon להצגת מצב נבחר. (Ie5dc2)
  • הוספת תפקידי צבעים שונים של שכבת מגן ומתאר. (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, הוסרה lambda בסוף מ-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 עבור Extended FABs עם טקסט נגרר עבור 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 Button כדי לקרוא את ערך סגנון הטקסט שמוגדר כברירת מחדל מ-MaterialTheme. (Ie62fc)

גרסה ‎1.0.0-alpha07

9 במרץ 2022

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

שינויים ב-API

  • עדכונים ב-Material 3 Surface API שמחזירים את הפונקציות העמוסות של רכיבי Surface שאפשר ללחוץ עליהם, וגם מוסיפים פונקציה לתמיכה ברכיבי Surface שאפשר לבחור ולהפעיל או להשבית. (I4bf18)
  • הבעיות ב-LazyVerticalGrid וב-LazyHorizontalGrid נפתרו. (I307c0)
  • ‫LazyVerticalGrid/LazyHorizontalGrid וכל ממשקי ה-API שקשורים אליו הועברו לחבילת המשנה ‎ .grid. צריך לעדכן את הייבוא מ-androidx.compose.foundation.lazy ל-androidx.compose.foundation.lazy.grid. (I2d446)
  • השינוי הקודם שבוצע, שבו הסתמכנו רק על View עבור WindowInsetsControllerCompat, בוטל, ושוב נדרש Window, שנדרש לניהול של חלק מהדגלים של Window. הוצא משימוש ViewCompat.getWindowInsetsController לטובת WindowCompat.getInsetsController כדי לוודא שנעשה שימוש בחלון הנכון (למשל אם התצוגה היא בתיבת דו-שיח). (I660ae, ‏ b/219572936)
  • הוספנו LazyVerticalGrid API חדש להגדרת גדלים של צירים חוצים (I17723)

תיקוני באגים

  • עדכונים ב-Card API בעקבות שינויים ב-Surface API ‏ (I3c8b9)

גרסה ‎1.0.0-alpha06

23 בפברואר 2022

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

שינויים ב-API

  • ‫NavigationDrawerItem נוסף שמייצג יעד יחיד במגירות (Ic396f, ‏ b/218286829)
  • ‫PermanentNavigationDrawer וגם DismissibleNavigationDrawer נוספו כ-API ניסיוניים. אלה מגירות שמתאימות למכשירים עם מסכים גדולים. (I5f8ab, b/218286829)
  • נוספה תמיכה בסרגל האפליקציות התחתון של Material 3‏ (Ic432a)
  • השם של NavigationDrawer שונה לModalNavigationDrawer (I1807d, ‏ b/218286829)
  • נוספו אסימונים וסיווג של רכיב Slider של Material 3‏ (I1ccee)
  • נוספה הטמעה של כרטיסייה. דוגמאות לשימוש מופיעות במסמכי התיעוד (Ie0146)

תיקוני באגים

  • תוקנה בעיה שבה קורא המסך TalkBack בחר בכותרת ריקה של סרגל האפליקציות העליון במהלך ניווט ליניארי. (Id4690)
  • IconSize נוסף לרשימה FloatingActionButtonDefaults. (Ia71cf)
  • תוקן באג שגרם להסתרת לחצני AlertDialog כשמוסיפים טקסט ארוך עם LazyColumn. (Ib2cc9, b/216663029)

גרסה ‎1.0.0-alpha05

‫9 בפברואר 2022

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

תכונות חדשות

נוספו רכיבים של Material Design 3

שינויים ב-API

  • הפונקציה Surface הוצאה משימוש. היא מקבלת קריאה חוזרת של onClick. צריך ליצור משטחים שאפשר ללחוץ עליהם באמצעות InteractionSource ו-Modifier.clickable(). (I211c6)
  • נוספה תמיכה בהגבהה של לחצן הפעולה הצף (FAB) במצב לחיצה ובמצב התמקדות. (Ibb584)
  • בוצע שינוי ב-API של Surface כדי לקבל InteractionSource שמאפשר לשלוט בהצגה שלו במצבים שונים. (Iafbc8)

תיקוני באגים

  • נוספו צבעים שלישוניים חסרים לערכות צבעים דינמיות (I456c4, ‏ b/214588434)

גרסה ‎1.0.0-alpha04

‫26 בינואר 2022

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

שינויים ב-API

  • נוסף NonRestartableComposable לשיטות שהן עומס יתר של שיטות קיימות ללא לוגיקה מורכבת. הפעולה הזו מצמצמת את הבדיקות של הממויזציה (equals) שנוצרות על ידי הקומפיילר לכל הפרמטרים שחוזרים על עצמם בפונקציה הפנימית שמופעלת. (I90490)
  • נוסף קו הפרדה של Material 3. (Ica5fc)
  • מסמנים את תיבת הסימון ואת לחצן הבחירה באמצעות הערה של API ניסיוני. (Ie44bb)
  • הוספנו תמיכה באינדיקטורים של התקדמות Material 3. (Iff232, b/205023841)

תיקוני באגים

  • עדכון צבע של מאגר תגים מושבת TextButton's לצבע שקוף (I6b248, b/213339737)

גרסה ‎1.0.0-alpha03

‫12 בינואר 2022

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

תיקוני באגים

  • הוספת LocalIndication ל-MaterialTheme של Material 3. (I7ce4e)
  • תיקון רדיוס הפינות שמוחל על תיבות סימון (I38b03, ‏ b/175198975, ‏ b/202309440)

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

  • עכשיו תלוי ב-Kotlin 1.6.10.

גרסה ‎1.0.0-alpha02

1 בדצמבר 2021

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

תכונות חדשות

  • הוספנו תמיכה בתיבת סימון ובלחצן בחירה.
  • העדכון בוצע כדי שתהיה תאימות ל-Kotlin 1.6.0

שינויים ב-API

  • הסרת חלונית הזזה מהפיגום של Material 3. (I04f51)
  • הוספנו תמיכה ב-Material 3 Checkbox. (Id5542)
  • הוספנו תמיכה ב-Material 3 RadioButton. (I20334)

תיקוני באגים

  • הקטנת רדיוס האדווה של IconButton מ-40dp ל-20dp. (I68bbe, b/206674345)
  • המחרוזת של היציאה בנתיב מהיר עבור Text השתנתה מ-compose.material (I30b03)
  • תוקן כך שהלחצן המקודד תמיד יהיה מופעל. (Iea832, ‏ b/205335456)

גרסה ‎1.0.0-alpha01

‫27 באוקטובר 2021

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

תכונות חדשות

התאמת עיצוב של Material Design 3 וצבע דינמי של Material You

רכיבים של Material Design 3

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