הרכבת חומרים 3

אפשר ליצור ממשקי משתמש ב-Jetpack Compose באמצעות רכיבי Material Design 3, הדור הבא של Material Design. ‫Material 3 כולל רכיבים וערכות נושא מעודכנים ותכונות התאמה אישית של Material You, כמו צבעים דינמיים. הוא מעוצב כך שיהיה עקבי עם הסגנון החזותי החדש של Android 12 וממשק המשתמש של המערכת.
העדכון האחרון גרסה יציבה גרסה מועמדת להפצה גרסת בטא גרסת אלפא
‫16 ביולי 2025 1.3.2 - - 1.4.0-alpha18

מבנה

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

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

קיבוץתיאור
compose.animationליצור אנימציות באפליקציות Jetpack Compose כדי לשפר את חוויית המשתמש.
compose.compilerשינוי פונקציות @Composable והפעלת אופטימיזציות באמצעות פלאגין של מהדר Kotlin.
compose.foundationכתיבת אפליקציות ב-Jetpack Compose באמצעות אבני בניין מוכנות לשימוש והרחבת הבסיס כדי ליצור רכיבים משלכם למערכת העיצוב.
compose.materialאפשר ליצור ממשקי משתמש של Jetpack פיתוח נייטיב באמצעות רכיבי Material Design מוכנים לשימוש. זוהי נקודת הכניסה ברמה הגבוהה ביותר של Compose, שנועדה לספק רכיבים שתואמים לאלה שמתוארים בכתובת www.material.io.
compose.material3אפשר ליצור ממשקי משתמש ב-Jetpack Compose באמצעות רכיבי Material Design 3, הדור הבא של Material Design. ‫Material 3 כולל רכיבים וערכות נושא מעודכנים ותכונות התאמה אישית של Material You, כמו צבעים דינמיים. הוא מעוצב כך שיהיה עקבי עם הסגנון החזותי החדש של Android 12 וממשק המשתמש של המערכת.
compose.runtimeאבני הבניין הבסיסיות של מודל התכנות וניהול המצב של Compose, וזמן הריצה המרכזי של הפלאגין של מהדר Compose לטירגוט.
compose.uiרכיבים בסיסיים בממשק המשתמש של Compose שנדרשים כדי ליצור אינטראקציה עם המכשיר, כולל פריסה, ציור וקלט.

הצהרה על יחסי תלות

כדי להוסיף תלות ב-Compose, צריך להוסיף את מאגר Google Maven לפרויקט. מידע נוסף זמין במאמר בנושא מאגר Maven של Google.

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

Groovy

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

android {
    buildFeatures {
        compose true
    }

    composeOptions {
        kotlinCompilerExtensionVersion = "1.1.1"
    }

    kotlinOptions {
        jvmTarget = "1.8"
    }
}

Kotlin

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

android {
    buildFeatures {
        compose = true
    }

    composeOptions {
        kotlinCompilerExtensionVersion = "1.1.1"
    }

    kotlinOptions {
        jvmTarget = "1.8"
    }
}

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

משוב

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

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

מידע נוסף זמין במאמרי העזרה בנושא כלי המעקב אחר בעיות.

‫Compose Material3 Common Version 1.0

גרסה 1.0.0-alpha01

‫17 באפריל 2024

הגרסאות androidx.compose.material3:material3-common:1.0.0-alpha01, androidx.compose.material3:material3-common-android:1.0.0-alpha01 ו-androidx.compose.material3:material3-common-desktop:1.0.0-alpha01 יוצאות. גרסה 1.0.0-alpha01 מכילה את הקומטים האלה.

תכונות חדשות

רכיבים ללא עיצוב שאפשר להשתמש בהם כדי ליצור רכיבי Material Design:

‫Compose Material3 Adaptive Navigation Suite Version 1.0

גרסה 1.0.0-alpha07

‫1 במאי 2024

הגרסאות androidx.compose.material3:material3-adaptive-navigation-suite:1.0.0-alpha07, androidx.compose.material3:material3-adaptive-navigation-suite-android:1.0.0-alpha07 ו-androidx.compose.material3:material3-adaptive-navigation-suite-desktop:1.0.0-alpha07 יוצאות. גרסה 1.0.0-alpha07 מכילה את הקומטים האלה.

שינויים ב-API

  • הפיכת ממשקי API של חבילת הניווט ללא ניסיוניים (If62af)

תיקוני באגים

  • צריכת תמונות ממוזערות של תוכן כברירת מחדל (50266df)

גרסה 1.0.0-alpha06

‫17 באפריל 2024

הגרסאות androidx.compose.material3:material3-adaptive-navigation-suite:1.0.0-alpha06, androidx.compose.material3:material3-adaptive-navigation-suite-android:1.0.0-alpha06 ו-androidx.compose.material3:material3-adaptive-navigation-suite-desktop:1.0.0-alpha06 יוצאות. גרסה 1.0.0-alpha06 מכילה את הקומטים האלה.

שינויים ב-API

  • הוספה של containerColor ו-contentColor אל NavigationSuiteScaffoldDefaults. (I64e3a, b/331993720)
  • הוספת הפונקציה itemColors אל NavigationSuiteDefaults. ‫(Idf719, ‏ b/328480012)
  • הופכים את NavigationSuiteScope לאטום. (Iefa57)

גרסה 1.0.0-alpha05

‫6 במרץ 2024

הגרסאות androidx.compose.material3:material3-adaptive-navigation-suite:1.0.0-alpha05, androidx.compose.material3:material3-adaptive-navigation-suite-android:1.0.0-alpha05 ו-androidx.compose.material3:material3-adaptive-navigation-suite-desktop:1.0.0-alpha05 יוצאות. גרסה 1.0.0-alpha05 מכילה את הקומטים האלה.

שינויים ב-API

  • הופכים את ה-constructor‏ NavigationSuiteItemColors לציבורי. (Ica83a, b/324886877)

גרסה 1.0.0-alpha04

‫21 בפברואר 2024

הגרסאות androidx.compose.material3:material3-adaptive-navigation-suite:1.0.0-alpha04, androidx.compose.material3:material3-adaptive-navigation-suite-android:1.0.0-alpha04 ו-androidx.compose.material3:material3-adaptive-navigation-suite-desktop:1.0.0-alpha04 יוצאות. גרסה 1.0.0-alpha04 מכילה את הקומיטים האלה.

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

  • מעדכנים את יחסי התלות של Material3 Adaptive לנתיבי המודולים החדשים. (Ibc421)
  • מעבר לשימוש בגרסה של Window Manager של מחלקות גודל חלון. (I3794d)

גרסה 1.0.0-alpha03

‫7 בפברואר 2024

הגרסאות androidx.compose.material3:material3-adaptive-navigation-suite:1.0.0-alpha03, androidx.compose.material3:material3-adaptive-navigation-suite-android:1.0.0-alpha03 ו-androidx.compose.material3:material3-adaptive-navigation-suite-desktop:1.0.0-alpha03 יוצאות. גרסה 1.0.0-alpha03 מכילה את הקומיטים האלה.

שינויים ב-API

  • עדכון שם החבילה ל-navigationsuite מ-navigation-suite‏ (I7eff7)
  • רכיבי Material3 שחושפים MutableInteractionSource בממשק ה-API שלהם עודכנו כך שהם חושפים עכשיו MutableInteractionSource שניתן להגדיר כ-null, ומוגדר כ-null כברירת מחדל. אין כאן שינויים סמנטיים: העברת הערך null פירושה שאתם לא רוצים להעלות את MutableInteractionSource, והוא ייווצר בתוך הרכיב אם יהיה צורך בכך. שינוי ל-null מאפשר לרכיבים מסוימים לא להקצות MutableInteractionSource אף פעם, ולרכיבים אחרים ליצור מופע רק כשצריך, וכך לשפר את הביצועים של הרכיבים האלה. אם אתם לא משתמשים ב-MutableInteractionSource שמועבר לרכיבים האלה, מומלץ להעביר במקומו null. מומלץ גם לבצע שינויים דומים ברכיבים שלכם. (I41abb, ‏ b/298048146)

גרסה 1.0.0-alpha02

‫13 בדצמבר 2023

הגרסאות androidx.compose.material3:material3-adaptive-navigation-suite:1.0.0-alpha02, androidx.compose.material3:material3-adaptive-navigation-suite-android:1.0.0-alpha02 ו-androidx.compose.material3:material3-adaptive-navigation-suite-desktop:1.0.0-alpha02 יוצאות. גרסה 1.0.0-alpha02 מכילה את הקומיטים האלה.

תכונות חדשות

תיקוני באגים

  • תוקן באג שגורם לרכיב הניווט למלא את המסך כולו כשהמשטח הבסיסי מכיל את modifier.fillMaxSize. (c9cf250, ‏ b/312664933)

גרסה 1.0.0-alpha01

‫15 בנובמבר 2023

androidx.compose.material3:material3-adaptive-navigation-suite:1.0.0-alpha01 משוחרר. גרסה 1.0.0-alpha01 מכילה את הקומיטים האלה.

תכונות חדשות

‫Compose Material3 Adaptive Version 1.0

גרסה 1.0.0-alpha06

‫7 בפברואר 2024

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

תכונות חדשות

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

גרסה 1.0.0-alpha05

‫24 בינואר 2024

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

תכונות חדשות

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

גרסה 1.0.0-alpha04

‫10 בינואר 2024

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

תכונות חדשות

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

שינויים ב-API

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

תיקוני באגים

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

גרסה 1.0.0-alpha03

‫13 בדצמבר 2023

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

שינויים ב-API

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

גרסה 1.0.0-alpha02

‫29 בנובמבר 2023

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

שינויים ב-API

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

תיקוני באגים

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

גרסה 1.0.0-alpha01

‫15 בנובמבר 2023

androidx.compose.material3:material3-adaptive:1.0.0-alpha01 משוחרר. גרסה 1.0.0-alpha01 מכילה את הקומיטים האלה.

תכונות חדשות

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

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

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

‫Compose Material3 גרסה 1.4

גרסה 1.4.0-alpha18

‫16 ביולי 2025

androidx.compose.material3:material3-*:1.4.0-alpha18 משוחרר. גרסה 1.4.0-alpha18 מכילה את הקומטים האלה.

תכונות חדשות

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

שינויים ב-API

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

גרסה 1.4.0-alpha17

‫2 ביולי 2025

androidx.compose.material3:material3-*:1.4.0-alpha17 משוחרר. גרסה 1.4.0-alpha17 מכילה את הקומטים האלה.

תכונות חדשות

  • עדכון האנימציה של קבוצת הלחצנים כך שתופעל עד 75% מהאנימציה כשלוחצים על הלחצן במקום ללחוץ עליו. (593942a, b/423596967)

תיקוני באגים

  • תוקנה בעיה שבה פריט בקרוסלה יכול היה, במקרים מסוימים, לחרוג מגודל הרכיב הגדול במהלך חישובי הפריסה, מה שגרם לחיתוך של הווידג'ט כולו. ‫(I1c3d7, b/397489534)
  • תוקן באג שגרם לדילוג על beforeContentPadding כשגללו קרוסלות עם היסטים חופפים של התחלה וסיום. (c3d5f3a, ‏ b/420618979)
  • עדכון ההתנהגות המופעלת של SwipeToDismiss כדי להתבסס על מצב ההסכמה במקום על המצב הנוכחי. ההתנהגות הקיימת משוחזרת, כך שההתנהגות של רכיב העוגן מושבתת רק כשהרכיב מגיע למצב של ביטול. (3844e07, ‏ b/425006844)
  • עכשיו אפשר לפתוח את התפריט הקופץ של ExposedDropdownMenu באמצעות קלט מהמקלדת. בנוסף, תיקנו את הבעיה שבה אי אפשר להגיע לתפריט באמצעות המקלדת בגרסה שניתנת לעריכה. (46ead03)

גרסה 1.4.0-alpha16

‫18 ביוני 2025

androidx.compose.material3:material3-*:1.4.0-alpha16 משוחרר. גרסה 1.4.0-alpha16 מכילה את הקומטים האלה.

תכונות חדשות

  • נוסף רכיב קרוסלה של תמונות עם יישור למרכז (I6f6d3)

שינויים ב-API

  • הטמעה של החלפות XR בסרגל הכלים האנכי (Ia1604)
  • נוספו פונקציות גלילה פרוגרמטיות ל-CarouselState (I12f8e)
  • הוספת ComponentOverride ל-ModalWideNavigationRail (I4f440)
  • הוספת ComponentOverride ל-WideNavigationRail (I6354f)
  • יצירת ComponentOverride עבור HorizontalFloatingToolbar (I51116)
  • יצירת ComponentOverride עבור ShortNavigationBar (I30e24)
  • SwipeToDismissBoxState הפניות אל confirmValueChange סומנו כהפניות שיצאו משימוש. במקום זאת, המשתמשים צריכים להשתמש בפונקציית הקריאה החוזרת של SwipeToDismissBox API onDismissed. (Iee780)
  • הוספנו את הפרמטר userScrollEnabled לרכיבי Carousel composable. (I1d4d2)
  • עכשיו אפשר לצפות ב-currentItem של קרוסלה מ-CarouselState. (Ie87e9)

תיקוני באגים

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

גרסה 1.4.0-alpha15

‫20 במאי 2025

androidx.compose.material3:material3-*:1.4.0-alpha15 משוחרר. גרסה 1.4.0-alpha15 מכילה את הקומטים האלה.

שינויים ב-API

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

תיקוני באגים

  • תוקנה בעיה שבה המיקום של Snackbar ושל FloatingActionButton היה שגוי כשההגדרה 'מקצה לקצה' הופעלה. הכלי Scaffold מחיל עכשיו נכון את השוליים הפנימיים האופקיים על הרכיבים האלה. (Ib7c30, ‏ b/244400727)
  • מתקנים את התנועה של BottomSheet מהרחבה מלאה להרחבה חלקית. האפקט של BottomSheet עכשיו הוא MotionScheme כשמסתירים או מכווצים, ומרחבי כשמרחיבים. (Ifa46f, ‏ b/416063171)
  • הבונה ColorScheme ללא תפקידים של מאגר משטחים סומן כנסתר ולא מומלץ יותר לשימוש. (Ia7237)
  • הסרנו דרישה של CircularWavyProgressIndicator Size.minDimension > 0, שבעבר גרמה לחריגה, כדי לאפשר גמישות רבה יותר. ‫(Ic9418, ‏ b/377531195)
  • היפר-קישורים ב-Text(AnnotatedString) מקבלים עכשיו עיצוב Material כברירת מחדל. (I78288, ‏ b/339843816)
  • תוקנה בעיה שבה הפונקציה toShape() ב-RoundedPolygon שומרת במטמון נתיב וגורמת לבעיה כשמתבצעות כמה קריאות ל-createOutline בגדלים שונים. (I4026d)

גרסה 1.4.0-alpha14

‫7 במאי 2025

androidx.compose.material3:material3-*:1.4.0-alpha14 משוחרר. גרסה 1.4.0-alpha14 מכילה את הקומטים האלה.

שינויים ב-API

  • נוסף AppBarColumn חדש שפועל באותו אופן כמו AppBarRow אבל עבור תוכן שמוצג בעמודה. (Iaf6bd)
  • הוספנו את מספר הפריטים המקסימלי ל-AppBarRow. ההגדרה הזו נדרשת כדי להטמיע בצורה נכונה את מפרט החומרים עבור סרגלי אפליקציות עליונים. (I92ce4)
  • נוספה שיטה ב-TooltipScope כדי לקבל את layoutCoordinates של העוגן. הוצאנו משימוש את השיטה drawCaret כי מפתחים יכולים להשתמש בשיטה החדשה הזו כדי לקבל את גבולות העוגן layoutCoordinates וליצור צורה מתאימה שמכילה סימן קרט. (Ia2e12, b/329470609)
  • נוספה תמיכה בjava.time בכלי לבחירת תאריכים: נוספו עומסים של rememberDatePickerState/rememberDateRangePickerState שמקבלים אובייקטים של java.time (לדוגמה, LocalDate ראשוני, YearMonth). נוספו גם פונקציות הרחבה באובייקטים של המצב כדי לקבל או להגדיר ערכים באמצעות סוגים כמו LocalDate ו-YearMonth. נדרש API מגרסה 26 ואילך או ביטול סוכר. ‫(I70f29, ‏ b/266202516, ‏ b/281859606)
  • הוספנו את הקומפוזבל CenteredTrack שמאפשר להשתמש ב-Slider עם מסלול שמתחיל מהמרכז. (I5b1d6)

תיקוני באגים

  • שיפרנו את הביצועים של אינדיקטורים מתקדמים של התקדמות: סוגים ליניאריים נטענים עכשיו ב-8.5% מהר יותר עם 11% פחות הקצאות, בעוד שסוגים מעגליים נהנים משיפור משמעותי של 47% במהירות ו-39% פחות הקצאות. (I595d8)

גרסה 1.4.0-alpha13

‫23 באפריל 2025

androidx.compose.material3:material3-*:1.4.0-alpha13 משוחרר. גרסה 1.4.0-alpha13 מכילה את הקומטים האלה.

שינויים ב-API

  • הפרמטרים isAppearanceLightStatusBars ו-isAppearanceLightNavigationBars נוספו מחדש ל-ModalBottomSheetProperties כפרמטרים ל-Android בלבד. (Id4bc0)
  • מוסיפים רכיב AppBarRow שאחראי על טיפול בפריטים שחורגים מהגבולות שלו. (I742bd)
  • מעדכנים את ה-API של DatePicker ו-DateRangePicker כדי לבקש מיקוד כשעוברים למצב של הזנת תאריך. החלפנו את הפרמטר הבוליאני requestFocus בפרמטר אופציונלי focusRequester שמקבל FocusRequester. (I14b69)
  • הסרת מקש הצירוף ומקור האינטראקציה מהפריטים שניתן ללחוץ עליהם ומהפריטים שניתן להפעיל ולכבות כברירת מחדל. במקום זאת, כדאי להשתמש בו כפרט הטמעה. (I95ed6)
  • הכפתור ButtonGroup עודכן כך שיוצג בתפריט נפתח אם יש יותר מדי כפתורים שלא נכנסים למסך. (I7b88b)

תיקוני באגים

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

גרסה 1.4.0-alpha12

‫9 באפריל 2025

androidx.compose.material3:material3-*:1.4.0-alpha12 משוחרר. גרסה 1.4.0-alpha12 מכילה את הקומטים האלה.

שינויים ב-API

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

תיקוני באגים

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

גרסה 1.4.0-alpha11

‫26 במרץ 2025

androidx.compose.material3:material3-*:1.4.0-alpha11 משוחרר. גרסה 1.4.0-alpha11 מכילה את הקומטים האלה.

שינויים ב-API

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

תיקוני באגים

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

גרסה 1.4.0-alpha10

‫12 במרץ 2025

androidx.compose.material3:material3-*:1.4.0-alpha10 משוחרר. גרסה 1.4.0-alpha10 מכילה את הקומטים האלה.

שינויים ב-API

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

גרסה 1.4.0-alpha09

‫26 בפברואר 2025

androidx.compose.material3:material3-*:1.4.0-alpha09 משוחרר. גרסה 1.4.0-alpha09 מכילה את הקומטים האלה.

שינויים ב-API

  • שינוי השם של שדות ההגדרה של DragHandle במצב ברירת המחדל, הפרדה בין מצב לחיצה למצב גרירה, הגדרה של הגדלים שמוגדרים כברירת מחדל כגלויים לכולם. (I787b9)
  • עדכונים ב-API של TowRowsTopAppBar. הוסר פרמטר ה-lambda‏ expanded והוספו פרמטרים נפרדים לגובה המורחב והמכווץ. (Idd677, ‏ b/306697446, ‏ b/229134133, ‏ b/268068946)

תיקוני באגים

  • סרגלי האפליקציות התחתונים פועלים עכשיו בהתאם לשירות 'גילוי באמצעות מגע' (למשל, TalkBack) ולהשאיר אותם גלויים בכל פעם שהשירות מופעל. (I4b34d)

גרסה 1.4.0-alpha08

‫12 בפברואר 2025

androidx.compose.material3:material3-*:1.4.0-alpha08 משוחרר. גרסה 1.4.0-alpha08 מכילה את הקומטים האלה.

תכונות חדשות

  • הוספנו API של TimePickerDialog שאפשר להשתמש בו בשביל TimePicker, TimeInput או כדי להחליף בין גרסאות. (Id2d83)

  • ממשקי API חדשים של סרגל החיפוש:

    • עכשיו, סרגלי חיפוש מכווצים ו'תצוגות' חיפוש מורחבות הם רכיבים נפרדים שניתנים להרכבה.
    • ‫SearchBar מייצג את סרגל החיפוש במצב המכווץ.
    • ‫ExpandedFullScreenSearchBar ו-ExpandedDockedSearchBar מייצגים את סרגל החיפוש במצב מורחב. הקישורים האלה נפתחים בחלון חדש.
    • ‫SearchBarState כדי לשלוט במצב של סרגל החיפוש
    • ‫TopSearchBar כדי להוסיף טיפול בתוספות והתנהגות גלילה
    • עומס יתר חדש של InputField שמשתמש ב-SearchBarState (Ie0723, ‏ b/261496232, ‏ b/283311462, ‏ b/350916229, ‏ b/352872248)

שינויים ב-API

  • תמיכה בשינוי צורה של פינות לחצני סמלים בלחיצה. (I21843)
  • ממשקי ה-API של שדה טקסט לקישוט או תיבת קישוט כבר לא ניסיוניים. (I31d95)
  • הוספנו דוגמאות וערכי ברירת מחדל לגרסה המחוברת של ButtonGroup. (I5c8ce)
  • הופכים את פרמטר המצב לאחרון ב-NavigationSuiteScaffold וב-NavigationSuiteScaffoldLayout. (I9cc7b)

תיקוני באגים

  • הוספנו ל-FloatingToolbars פעולות נגישות מותאמות אישית, כך ששירותי נגישות יכולים עכשיו להרחיב או לכווץ את כל הווריאציות של FloatingToolbar. בגרסה עם לחצן ה-FAB, ההגדרה הזו חלה על לחצן ה-FAB, ובגרסה בלי לחצן ה-FAB, ההגדרה הזו חלה על התוכן הראשי. (I26420)
  • FloatingToolbars עכשיו מתבוננים בשירות של חקר המגע (לדוגמה, ‫TalkBack) וסרגל הכלים יורחב ויוצג בכל פעם שהשירות יופעל. (I02172)
  • תוקנה קריסה באינדיקטורים של ההתקדמות והטעינה במקרה של העברת Float.NaN כהתקדמות. ‫(I4fa96, ‏ b/352364576)

גרסה 1.4.0-alpha07

‫29 בינואר 2025

androidx.compose.material3:material3-*:1.4.0-alpha07 משוחרר. גרסה 1.4.0-alpha07 מכילה את הקומטים האלה.

תכונות חדשות

  • הוספנו גמישות רבה יותר בהתאמה אישית של המראה של תיבות הסימון באמצעות API חדש. ‫API שמספק פרמטרים של קו, שמאפשרים שליטה רבה יותר באופן שבו מוצגים סימן הווי והתיבה עם הקו. (I65a88)
  • הוספנו את TwoRowsTopAppBar API, חלופה עם יותר אפשרויות להתאמה אישית לסרגלי אפליקציות בגודל בינוני וגדול, ליצירת סרגלי אפליקציות עליונים עם שתי שורות. למפתחים יש עכשיו שליטה בתוכן של הכותרות והכתוביות במצבים המכווץ והמורחב, עם אפשרות להתאמה אישית של הגובה בכל מצב. (I0be3c, ‏ b/306697446, ‏ b/229134133, ‏ b/268068946)

שינויים ב-API

  • שינינו את השם של וריאציה ניסיונית BottomAppBar ל-FlexibleBottomAppBar, כדי לספק יותר שליטה על סידור התוכן והגובה שלו. (Iaa448)
  • עדכון השמות של מאפיינים באובייקט ברירת המחדל של קבוצת לחצנים ל-CapitalCase. השם של animateFraction עודכן כדי לשקף בצורה מדויקת יותר את ההתנהגות שהוא מייצג. (I545cd)
  • הוספת עומסים יתרים לכפתורים נפוצים שמאפשרים צורות מונפשות באינטראקציה של לחיצה. נוספו צורות של לחצנים שנשמרו במטמון. (I5ec20)
  • עכשיו אפשר לקבוע איך לחצן פעולה צף (FAB) עם FloatingToolbar יגיב לגלילה באמצעות FloatingToolbarScrollBehavior. בסרגלי כלים שממוקמים לאורך קצה מרכזי (כמו מרכז עליון או מרכז תחתון), מומלץ להשתמש בהתנהגות גלילה כדי להסתיר את הרכיב כולו בזמן הגלילה, למראה נקי יותר. הפעולה הזו גם מונעת את המצב שבו הלחצן הראשי לא ממוקם במרכז, מצב שעלול לקרות כשמשתמשים בדגל expanded לצורך כיווץ. (I33f67)
  • עדכון של ממשקי ה-API הניסיוניים TopAppBar לשימוש ב-Alignment.Horizontal במקום ב-TopAppBarTitleAlignment בהתאמה אישית של יישור הכותרת וכותרת המשנה. (I70ca2)
  • ‫SliderState#onValueChange עכשיו גלוי לכולם כדי לתת למשתמשים יותר שליטה (I104eb)
  • הוספת NavigationSuiteScaffoldState כדי לאפשר אנימציה של רכיב הניווט. בנוסף, הוספנו עומסים של NavigationSuiteScaffold ו-NavigationSuiteScaffoldLayout עם פרמטר מצב. (I6a8c9, b/328674235)

תיקוני באגים

  • העברת הכיתות IconButtonColors ו-IconToggleButtonColors מ-IconButtonDefaults.kt בחזרה אל IconButton.kt. (I3c233)

External Contribution

  • הפוסט SliderState#isDragging גלוי עכשיו לכולם. (I8458a)

גרסה 1.4.0-alpha06

‫15 בינואר 2025

androidx.compose.material3:material3-*:1.4.0-alpha06 משוחרר. גרסה 1.4.0-alpha06 מכילה את הקומטים האלה.

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

  • הוספנו את displayCutout לקבוצת השוליים הפנימיים שרכיבי Material לוקחים בחשבון כברירת מחדל, כדי למנוע חפיפה בין התוכן לבין החלק החסר במסך. זהו שינוי בהתנהגות שישפיע על האופן שבו רכיבים שמודעים לשינוי גודל חלון התצוגה מתנהגים סביב חיתוך המסך. זה כולל את ערך ברירת המחדל של הפרמטר WindowInsets לרכיבי Material 3 עם מודעות ל-inset, ואת הערכים של WindowInsets שמופיעים באובייקטים של ברירות המחדל של הרכיבים גם ב-Material 2 וגם ב-Material 3. אם השינוי הזה גורם להתנהגות לא רצויה, צריך לציין באופן ידני את הפרמטר WindowInsets לכל רכיב. ‫(I43ee9, ‏ b/362508045)

שינויים ב-API

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

תיקוני באגים

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

External Contribution

  • הפונקציה BasicTooltip נפוצה ב-Foundation וBasicTooltip/Tooltip ב-Material3. (Ifc2e6)

גרסה 1.4.0-alpha05

‫12 בדצמבר 2024

androidx.compose.material3:material3-*:1.4.0-alpha05 משוחרר. גרסה 1.4.0-alpha05 מכילה את הקומטים האלה.

שינויים ב-API

  • החלפת סוג בערך WideNavigationRailState.current/target של enum כדי לשפר את הקריאות (I2d6ab)
  • SplitButton שינוי Shape API מ-data class ל-class לצורך תאימות בינארית. (I53812)
  • נוסף API של תיאור קצר שכולל פרמטר onDismissRequest, כדי שהיוצרים יוכלו להחליט מה יקרה כשמשתמש ילחץ מחוץ לתיאור הקצר. הוצאנו משימוש את ה-API הישן שלא מכיל את הפרמטר החדש הזה. (I99aef)
  • שינוי השם של opticalCentering ל-horizontalCenterOptically. הופכים את התוסף לפנימי. החלפת פרמטר הריווח בהיסט מקסימלי להתחלה ולסיום. (I0b904)
  • משנים את WideNavigationRailState כך שיכלול את הערך הנוכחי או ערך היעד, ומסירים את סוגי הנתונים המנויים לטובת ערך בוליאני. (Idfa29, ‏ b/356039090)
  • מוסיפים NavigationBarItemComponentOverride. (I3a06a)

תיקוני באגים

  • תיקון ההתנהגויות של סרגל האפליקציות העליון והתחתון כדי לשנות את הצבע באופן מהימן כשגוללים את התוכן עד הסוף. (Idc4e8, b/293665988)
  • פונקציות של התנהגות גלילה בסרגלי אפליקציות עליונים ותחתונים מחזירות עכשיו התנהגות שנשמרה, כדי לשפר את הביצועים בכל ההרכבות מחדש. (I0fdbe, b/207957336)
  • פרמטר הצירוף מוחל עכשיו אחרי צירופים פנימיים כמו התנהגות וסמנטיקה של גרירה, במקום לפני. ההגדרה הזו משפיעה על הסדר שבו המערכת מחילה את שינויי המחיר. (I8d83f)
  • הגיליון התחתון המורחב נשאר מורחב גם אחרי שינוי הגודל. (I2870b, b/324934884)
  • הפניית סימונים של סרגל הניווט והסטטוס בצורה נכונה למאפייני חלונות. ‫(Ie674d, ‏ b/362539765)
  • מעבירים את פרמטר השינוי ל-scaffolds root, כמו שמתואר במסמך. ההטמעה הזו תואמת ל-M2. ‫(I0235e, ‏ b/372311595)

External Contribution

  • פונקציית DatePickerDialog שעברה המרה. (I7dced)

גרסה 1.4.0-alpha04

‫13 בנובמבר 2024

androidx.compose.material3:material3-*:1.4.0-alpha04 משוחרר. גרסה 1.4.0-alpha04 מכילה את הקומטים האלה.

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

  • החזרת שינויי הצבע שהוצגו ב-aosp/3212478 ל-iconButtonColors, ‏ iconToggleButtonColors, ‏ outlinedIconButtonColors, ‏ outlinedIconToggleButtonColors ו-outlinedIconToggleButtonBorder. העברנו את ההתנהגות שבוטלה עכשיו לקבוצה חדשה של פונקציות שנקראות iconButtonVibrantColors וכן הלאה, כדי להדגיש את הצבעים עם הניגודיות הגבוהה שמוחזרים. (Iffd8d)

תכונות חדשות

  • רכיב Introduce VerticalDragHandle (I6c770)

שינויים ב-API

  • שינוי השם של DismissibleModalWideNavigationRailDefaults לModalWideNavigationRailDefaults. (I8e877)
  • מוסיפים NavigationBarComponentOverrides. (I8a3f3)
  • מוסיפים NavigationRailComponentOverride. (I83e13)
  • הוספנו את WideNavigationRailState כדי לטפל בכיווץ ובהרחבה של החלונית, אפשרנו לסגור את ModalWideNavigationRail ומחקנו את DismissibleModalWideNavigationRail. (I88568)
  • הוספת ברירות מחדל של גדלים xSmall,‏ medium,‏ large ו-xLarge לברירות המחדל של לחצן ההפעלה/ההשבתה. (Ie95d1)
  • מוסיפים את גדלי ברירת המחדל xSmall,‏ medium,‏ large ו-xLarge לברירות המחדל של הכפתורים. ‫(If8b6d)

תיקוני באגים

  • הצבע של הסמל האחרון בסמל המסנן עודכן מ'ראשי' ל-OnSurfaceContainer, בהתאם למפרט. כל צבעי המתאר של הסמלים עודכנו מ'מתאר' ל'וריאציית מתאר', בהתאם למפרט. (I68bd4)

גרסה 1.4.0-alpha03

‫30 באוקטובר 2024

androidx.compose.material3:material3-*:1.4.0-alpha03 משוחרר. גרסה 1.4.0-alpha03 מכילה את הקומטים האלה.

שינויים ב-API

  • ה-constructor של SheetState עם density הוצא משימוש, ועכשיו משתמשים בספי צפיפות מיקום ומהירות. (Ifd16e)
  • נוסף rememberTooltipPositionProvider שמכיל לוגיקה מעודכנת של מיקום. הוצאו משימוש rememberPlainTooltipPositionProvider ו-rememberRichTooltipPositionProvider. (Ie66e2)
  • בנוסף, ModalBottomSheetProperties מאפשרת התאמה אישית של הצבעים של שורת המצב וסרגל הניווט. כברירת מחדל, העדכונים האלה מתבססים על צבע התוכן ולא על הסטטוס של העיצוב הכהה במערכת. (Ib874e, ‏ b/362539765)
  • שיפרנו את חוויית הקלט בבוחרי תאריכים: במצב קלט, שדה הטקסט של התאריך יסומן כדי לאפשר הזנת טקסט מיידית. השינוי מוסיף פרמטר requestFocus ל-DatePicker ול-DateRangePicker. כדי למנוע את המיקוד, מעבירים את הערך false. ‫(I12d09, ‏ b/286399710, ‏ b/340102743)
  • שמירת ברירות המחדל של הצורה במטמון באובייקט Shape. הגדרת ברירות המחדל של הצורה @Composable עבור כפתור החלפת מצב. הצורה מצטמצמת לצורה אחת כברירת מחדל, כי הווריאציות מפנות לאותו קובץ טוקנים. (Iaa014)

תיקוני באגים

  • אופטימיזציה של ההתנהגות של Scaffold contentPadding כדי להימנע מהרכבה מחדש של תוכן הגוף בכל פעם ש-contentPadding משתנה. (I8c8e2, b/373904168)
  • השם של TextFieldLabelScope progress שונה לlabelMinimizedProgress
  • השם של TextFieldLabelPosition Default שונה לAttached. הוסרו חברים בממשק. (If75c6)
  • תוקנה בעיה ב-DatePicker במצב קלט שבה שגיאות אימות יכלו לגרום לשינוי הגובה של הרכיב. ‫(I2e229, ‏ b/280462363)
  • גורמים למחוון של Material לשנות את הערך שלו כשלוחצים על מקשי בקרה. (I1c442)

גרסה 1.4.0-alpha02

‫16 באוקטובר 2024

androidx.compose.material3:material3-*:1.4.0-alpha02 משוחרר. גרסה 1.4.0-alpha02 מכילה את הקומטים האלה.

שינויים ב-API

  • עדכנו את כלי בחירת התאריכים כדי להבטיח שימוש עקבי באזוריות בכל DatePicker וDateRangePicker כשמגדירים אזוריות ישירות דרך DatePickerState או DateRangePickerState. שימו לב: כשמגדירים את המאפיין Locales ישירות למצב, אתם צריכים לוודא שטקסט הכותרת והכותרת הראשית מותאמים בהתאם, כי טקסט ברירת המחדל שלהם עדיין יוחל בהתאם ל-Locale של פלטפורמת ברירת המחדל. (I37073, b/326490763, b/321657276)
  • המאפיין SheetState.isAnimationRunning נחשף עכשיו. (I9a3d7)
  • DatePickerColors עכשיו קודם כל נלקחים בחשבון הצבעים שמוגדרים ב-DatePickerColors, ורק אחר כך הצבעים שמוגדרים בסגנונות הטקסט של הטיפוגרפיה בעיצוב. חשוב גם לשים לב שהעדכון הזה משנה את המיקום של הפרמטר color בפונקציות של בוחר התאריכים, ומוסיף פרמטר contentColor להתאמה אישית של צבעי הטקסט בכותרת ובשם. (I30d03, ‏ b/347031394)
  • משנים את השם של SplitButton ל-SplitButtonLayout ומסירים את ממשקי ה-API של וריאציות הצבע SplitButton. כדי ליצור וריאציות, נעשה שימוש חוזר בווריאציות של הלחצנים שסופקו על ידי SplitButtonDefaults. (I44c36)
  • ‫ModalBottomSheet כולל עכשיו את הפרמטר sheetGestureEnabled (I856cb, ‏ b/288211587)
  • שם האפשרות standardMotionScheme ושם האפשרות expressiveMotionScheme שונו ל'רגיל' ו'מובלט'. עכשיו אפשר לגשת לשתי הפונקציות דרך אובייקט העזר MotionScheme על ידי קריאה לפונקציות MotionScheme.standard() ו-MotionScheme.expressive(). (Iceccf)
  • הוספת הפרמטר maxWidth לתיאורי הכלים הפשוטים והמתקדמים. ברירת המחדל היא מפרט העיצוב של 200dp לתיאורי כלים פשוטים ו-320dp לתיאורי כלים עשירים. (I30ce9)

תיקוני באגים

  • התאריכים DatePicker ו-DateRangePicker מתעדכנים עכשיו בצורה נכונה בחודש שמוצג, כשהם מוגדרים באמצעות displayedMonthMillis של המצב שלהם. (If9e47, b/333414302)
  • התוכן של ModalBottomSheet מוזז עכשיו מהסטטוס בר. (I5114c, b/321877275, b/336962418, b/342093067)
  • [Bottom Sheet] Change back callback priority to PRIORITY_DEFAULT to allow IME keyboard to dismiss first. (I447fb)
  • תיקנו קריסות ב-DatePicker וב-DateRangePicker כששנת המינימום לבחירה מוגדרת לשנה עתידית. (I78656, ‏ b/319395747)
  • פתרון בעיה בכלי לבחירת תאריכים כדי לעדכן את ממשק המשתמש כשמחילים מופע מעודכן של SelectableDates. (Iad59a, ‏ b/290135807, ‏ b/339898760)

גרסה 1.4.0-alpha01

‫2 באוקטובר 2024

androidx.compose.material3:material3-*:1.4.0-alpha01 משוחרר. גרסה 1.4.0-alpha01 מכילה את הקומטים האלה.

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

  • הספרייה לא מוסיפה יותר תלות ב-material-icons-core, לכן אם הפרויקט שלכם הסתמך על זה, תצטרכו להוסיף את התלות הזו באופן מפורש בקובצי build.gradle[.kts]. (I735ff, b/349894318)
  • הצבע של התווית הפעילה של NavigationBarItem ושל NavigationRailItem משתנה מ-onSurface ל-secondary כדי לשפר את נוחות השימוש, את הניגודיות של הצבעים ואת העקביות במערכת (Ibc297). כדי לחזור להתנהגות הקודמת, מעתיקים את צבעי ברירת המחדל ומשנים את selectedTextColor ל-MaterialTheme.colorScheme.onSurface.
  • רכיבי Material 3 משתמשים עכשיו ב-MotionScheme החדש כדי להגדיר את התנועה שלהם. (Ie0f93)
  • שינויים בתנועה של אינדיקטור התקדמות מעגלי לא מוגדר (I3c07e)
  • מעדכנים את הצבעים OutlinedIconButtonColors וOutlinedIconToggleButtonColors כדי לשפר את ניגודיות הצבעים. (I2743d)
  • עדכון הצבע של הקונטיינר והתוכן של FilledIconToggleButtonColors ו-FilledTonalIconToggleButtonColors. (Ic5d0f)
  • צבע הגבול של OutlinedButton עודכן מoutline לoutlineVariant. (057f00)

שינויים ב-API

  • הוספנו פרמטר אופציונלי reverseLayout לפונקציה TopAppBar של enterAlwaysScrollBehavior כדי לשפר את התמיכה בתוכן שהוגדר עם reverseLayout. (I4e0e5)
  • ‫SegmentedButton תומך עכשיו בארגומנט contentPadding. ‫(I5ad91, ‏ b/358414376)
  • ל-PullToRefreshState אין יותר הטמעה שמוגדרת כברירת מחדל עבור isAnimating (I6a593)
  • נוספו עומסים חדשים של Material TextField ו-OutlinedTextField שמשתמשים ב-TextFieldState. הוספנו ממשקי API של תיבות עיטור שתואמים ל-TextFieldDecorator. (If13a1)
  • נוסף פרמטר לשליטה בlabelPosition של שדה הטקסט. שימוש ב-alwaysMinimize מאפשר להציג את התווית ואת ה-placeholder בשדה טקסט בו-זמנית, גם כשהשדה לא מודגש. (I1ef2c)
  • נוספו רכיבי Material‏ SecureTextField ו-OutlinedSecureTextField לשדות להזנת סיסמה. (I7e22d)
  • נוסף היקף לתוויות של שדות טקסט כדי לשאול על התקדמות האנימציה. (If5ec8)
  • הוספנו תמיכה ב-MotionEvent.CLASSIFICATION_DEEP_PRESS בהסברים הקצרים. (I62e6a)
  • המשתנה isAfternoon של TimePickerState הוא עכשיו ערך של תוסף במקום משתנה בממשק, והשם שלו שונה ל-isPm (I89a97)
  • עדכון של סוג הגופן כדי לתמוך בסולמות של גופנים מודגשים. (Ifa13c)
  • הוספנו את ModalWideNavigationRail API ושינינו את השם של ממשקי ModalExpandedNavigationRail API ל-DismissibleModalWideNavigationRail. (Ic9118)
  • העדכון של FloatingAppBarScrollBehavior מאפשר חישוב אוטומטי של screenOffset ולא מחייב @Composable. (Idf349)
  • עדכונים ב-API‏ LoadingIndicator כדי לתקן את השמות באובייקט ברירת המחדל שלו. נוסף קבוע LoadingIndicatorElevation ב-PullToRefresh. (I1d72b)
  • עדכונים ב-API‏ LoadingIndicator כדי לתקן את השמות באובייקט ברירת המחדל שלו. נוסף קבוע LoadingIndicatorElevation ב-PullToRefresh. (I1d72b)
  • נוספו פרמטרים amplitude ו-waveSpeed לווריאציות הלא מוגדרות של LinearWavyProgressIndicator ו-CircularWavyProgressIndicator. (I2a0c5)
  • תמיכה בשינוי הצורה של לחצן הפעלה/השבתה עם סמל בהתאם למצב הלחיצה או הסימון שלו. (Ibc781)
  • עדכון של סוג הגופן כדי לתמוך בסולמות של גופנים מודגשים. (Ifa13c)
  • הצורה SplitButton משתנה בהתאם למצב ברירת המחדל או למצב הלחיצה. הוסר AnimatedTrailingButton api כי TrailingButton api יכול להציע את אותן התאמות אישיות (I95066)
  • מוסיפים משנה כדי להנפיש את ההצגה וההסתרה של ה-FAB, למשל כשמגללים את התוכן. (I8338d)
  • הוספת צורות וריווח של קבוצת לחצנים מחוברים ל-ButtonGroupDefaults לשימוש בדוגמה. (I68e30)
  • הוספת ריווח אופקי ללחצן האחרון בלחצן מפוצל והפעלת מרכוז אופטי שמחושב לפי ההבדלים בין הפינות בהתחלה ובסוף (I122e2)
  • אנחנו משיקים Material חדש MotionScheme שמאפשר להגדיר סכמה לתנועה של הרכיב. הסכמה מוגדרת דרך MaterialTheme. (Id50c2)

תיקוני באגים

  • החלת אינדקס נכון של מעבר בין רכיבים על רכיבי Scaffold צאצא מסוג Composables. הסדר הוא topBar, bottomBar, fab, content, snackbar. (I5936b)
  • תוקנה בעיה ברכיבים DatePicker ו-DateRangePicker שבה בחלק מהלוקאלים ובפורמטים מסוימים, חלק מרכיבי התאריך (לדוגמה, שמות החודשים) לא התחילו באות גדולה. (I1430f)
  • שילוב של טוקנים של רכיבי FAB ו-FAB Menu (עדכונים חזותיים קלים בריווח ובטקסט) (Ib57f3)
  • ‫ModalBottomSheet מופיע עכשיו ראשון בסדר המעבר הסמנטי, ואחריו שכבת ה-scrim. (I436f9, ‏ b/358594665)
  • תיקון של בעיה שבה סרגל האפליקציה התחתון לא נעלם לגמרי כשגוללים מתחת ללחצן הניווט במצב 'מקצה לקצה' (I3ee21)

‫Compose Material3 גרסה 1.3

גרסה 1.3.2

‫9 באפריל 2025

androidx.compose.material3:material3-*:1.3.2 משוחרר. גרסה 1.3.2 מכילה את הקומטים האלה.

תיקוני באגים

  • ‫ListItem מתקן את החישוב של הגובה הפנימי שלו, ועכשיו הוא שומר את כמות המקום המתאימה בפריסה.
  • הסרת ריווח פנימי מיותר של התווית NavigationBarItem, והתאמה נכונה למפרט.
  • תיקון הפריסה של TabRow במצב מימין לשמאל.

גרסה 1.3.1

‫30 באוקטובר 2024

androidx.compose.material3:material3-*:1.3.1 משוחרר. גרסה 1.3.1 מכילה את ההתחייבויות האלה.

תיקוני באגים

  • התאריכים DatePicker ו-DateRangePicker מתעדכנים עכשיו בצורה נכונה בחודש שמוצג, כשהם מוגדרים באמצעות displayedMonthMillis של המצב שלהם. (If9e47, b/333414302)
  • תיקנו קריסות ב-DatePicker וב-DateRangePicker כששנת המינימום לבחירה מוגדרת לשנה עתידית. (I78656, ‏ b/319395747)
  • פתרון בעיה בכלי לבחירת תאריכים כדי לעדכן את ממשק המשתמש כשמחילים מופע מעודכן של SelectableDates. (Iad59a, ‏ b/290135807, ‏ b/339898760)
  • משנים את העדיפות של הקריאה החוזרת (callback) שמשמשת את התכונה 'גיליונות תחתונים' ל-PRIORITY_DEFAULT כדי לאפשר למקלדת IME להיסגר קודם. (I447fb)

גרסה 1.3.0

‫4 בספטמבר 2024

androidx.compose.material3:material3-*:1.3.0 משוחרר. גרסה 1.3.0 מכילה את ההתחייבויות האלה.

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

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

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

  • קרוסלה
  • ‫[ModalBottomSheet] עכשיו יש תמיכה בתכונה 'חזרה עם חיזוי' ב-U+ (Iccf32, ‏ b/281967264, ‏ b/304850357)
  • ‫[SearchBar] תומך עכשיו בחיזוי החזרה ב-U+‎ (I657f8)
  • חלונית ההזזה לניווט (ModalDrawerSheet ו-DismissibleDrawerSheet) תומכת עכשיו בתכונה 'חזרה עם חיזוי' ב-U+‎ כהסכמה להצטרפות (Ie5b0b)
  • ‫DropdownMenu תומך עכשיו בצבע, בצורה, בגובה ובגבול בהתאמה אישית. (I8e981,b/289554448, b/301887035, b/283654243)
  • המחוון עודכן כדי לשפר את הנגישות. נוספו לו רווח ואינדיקטור עצירה. (I3058e)
  • בוצע עדכון ב-ProgressIndicator כדי לשפר את הנגישות על ידי הוספת רווח ואינדיקטור לעצירה. (I21451)
  • נוסף סמן ברירת מחדל לתיאור כלי עשיר, תמיכה בסמן מותאם אישית לציור בהינתן עוגן LayoutCoordinates. ‫(Ifd42c) שינויי תוכנה שעלולים לגרום לכשלים
  • ממשקי API חדשים של משיכה לרענון:
    • הפונקציה PullToRefreshState פשוטה יותר, ועכשיו אפשר להשתמש בה בערכים חלקיים במקום ביחידות Dp.
    • המצב של isRefreshing נשלט על ידי המשתמש ולא על ידי PullToRefreshState.
    • הפרדנו את חיבור הגלילה המקונן מ-PullToRefreshState. היא מטופלת על ידי PullToRefreshBox או Modifier.pullToRefresh החדשים.
    • העדכון הזה הוא שינוי שובר תאימות לממשקי API ניסיוניים קודמים. ‫(I0adeb, ‏ b/314496282, ‏ b/317177684, ‏ b/323787138, ‏ b/324573502, ‏ b/317177683) שינויים שמשפיעים על המראה
  • צריך לעדכן את שכבת העל של מצב המיקוד ל-0.1f כדי להבטיח ניגודיות צבעים מספקת. (I7ea77)
  • שינויים קלים בברירות המחדל של צבע הרקע והמשטח ב-lightColorScheme וב-darkColorScheme. (I9db52)
  • העדכון כולל שינוי של המחוון ושל הצבעים ProgressIndicator בהתאם למפרט החדש של ניגודיות בין רכיבים שאינם טקסט. (I26807)
  • SurfaceContainer וריאציות נמצאות עכשיו בשימוש ברכיבים. רכיבים שבהם נעשה שימוש ב-Surface וב-TonalElevation כדי לחשב באופן רשמי את הצבע, משתמשים עכשיו כברירת מחדל בתפקידי SurfaceContainer, שלא מושפעים מהעלאת הטון. (b/304584161)
  • התפקידים של Surface ו-Surface container שונו קצת, ועכשיו יש יותר גוון בעיצובים בהירים וכהים. (I677a5)
  • ממשקי API ניסיוניים הועברו לגרסה יציבה.
  • שיפורי ביצועים

גרסה 1.3.0-rc01

‫21 באוגוסט 2024

androidx.compose.material3:material3-*:1.3.0-rc01 משוחרר. גרסה 1.3.0-rc01 מכילה את הקומטים האלה.

תיקוני באגים

  • ‫ModalBottomSheet מופיע עכשיו ראשון בסדר המעבר הסמנטי, ואחריו שכבת ה-scrim. (I436f9, ‏ b/358594665)

גרסה 1.3.0-beta05

‫24 ביולי 2024

androidx.compose.material3:material3-*:1.3.0-beta05 משוחרר. גרסה 1.3.0-beta05 מכילה את הקומטים האלה.

  • תוקנה בעיה שבה תוכן BottomSheet חסר או נחתך ב-Android N וב-Android O‏ (a10a2d)
  • הגדלנו את הגבולות הסמנטיים של פס ההזזה כדי ש-TalkBack יציג כמו שצריך את סימני ההתמקדות סביב התמונות הממוזערות. (0b5a1d)

גרסה 1.3.0-beta04

‫26 ביוני 2024

androidx.compose.material3:material3-*:1.3.0-beta04 משוחרר. גרסה 1.3.0-beta04 מכילה את הקומטים האלה.

גרסה 1.3.0-beta03

‫12 ביוני 2024

androidx.compose.material3:material3-*:1.3.0-beta03 משוחרר. גרסה 1.3.0-beta03 מכילה את ההתחייבויות האלה.

External Contribution

  • הפיכת androidx.compose.material3.DropdownMenu לזמין ממקור נפוץ. (If62c0)

גרסה 1.3.0-beta02

‫29 במאי 2024

androidx.compose.material3:material3-*:1.3.0-beta02 משוחרר. גרסה 1.3.0-beta02 מכילה את הקומטים האלה.

שינויים ב-API

  • ‫Modifier.pullToRefreshIndicator תומך בהעלאה, מעדכן את ממשקי ה-API של Pull To Refresh כך שההגדרה enabled תהיה בוליאנית ולא למדה. תמיכה בהתאמת תוכן ב-PullToRefreshBox (I75679)
  • הפיכת TooltipScope לממשק אטום ויצירת הטמעה פנימית לשימוש ב-TooltipBox וב-Label. (I3833e)
  • נוספו שני משנים חדשים ל-CarouselItemScope – maskClip ו-maskBorder – כדי להוסיף בקלות צורה ומסגרת לכל פריט בקרוסלה (Id67a1)
  • ‫TimePickerState הוא עכשיו ממשק שמאפשר להגדיר את השעה (I88546)
  • עדכון ה-API לעיצוב הקישורים: העברת TextLinkStyles אל TextStyle והסרת TextDefaults מהחומר. (I5477b)

תיקוני באגים

  • סמלי הסטטוס וסרגל הניווט ב-ModalBottomSheet מגיבים עכשיו לסטטוס של העיצוב הכהה. (Ie1fe7, b/338342149)
  • נוספה סמנטיקה של סגירת גיליון ל-ModalBottomSheet scrim. (0e61cb,b/328801864)

External Contribution

  • הפיכת androidx.compose.material3.AlertDialog לזמין ממערך מקורות נפוץ (Ia33f5)
  • הפיכת ModalBottomSheet לזמין מקבוצת מקורות משותפת (Id7cc7)

גרסה 1.3.0-beta01

‫14 במאי 2024

androidx.compose.material3:material3-*:1.3.0-beta01 משוחרר. גרסה 1.3.0-beta01 מכילה את הקומטים האלה.

שינויים ב-API

  • שימוש ב-DpSize במקום ב-CaretProperties. הסרה של CaretProperties. שינוי השם של CaretScope לTooltipScope. (Id9a76)
  • ה-API לעדכון קישורים עם עיצוב Material בטקסט עודכן. הסרנו את השיטות מה-TextDefaults ליצירת LinkAnnotations עם נושאים ולניתוח HTML עם קישורים שמותאמים לנושאים. במקום זאת, הוספנו מחלקה TextLinkStyles שמאפשרת לעצב את הקישורים כפרמטר ל-Text composable. (I31b93)

גרסה 1.3.0-alpha06

‫1 במאי 2024

androidx.compose.material3:material3-*:1.3.0-alpha06 משוחרר. גרסה 1.3.0-alpha06 מכילה את הקומטים האלה.

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

  • ממשקי API חדשים של משיכה לרענון:

    • הפונקציה PullToRefreshState פשוטה יותר, ועכשיו אפשר להשתמש בה בערכים חלקיים במקום ביחידות Dp.
    • המצב של isRefreshing נשלט על ידי המשתמש ולא על ידי PullToRefreshState.
    • הפרדנו את חיבור הגלילה המקונן מ-PullToRefreshState. היא מטופלת על ידי PullToRefreshBox או Modifier.pullToRefresh החדשים.
    • העדכון הזה הוא שינוי שובר תאימות לממשקי API ניסיוניים קודמים. (I0adeb, ‏ b/314496282, ‏ b/317177684, ‏ b/323787138, ‏ b/324573502, ‏ b/317177683)

שינויים ב-API

  • השדה RippleConfiguration#isEnabled הוסר, והשדה LocalRippleConfiguration הפך לשדה שאפשר להשאיר ריק. כדי להשבית את האפקט, במקום לספק RippleConfiguration עם isEnabled = false, מספקים null ל-LocalRippleConfiguration. (I22725)
  • ModalBottomSheet כשמפעילים את ההגדרה 'מקצה לקצה', הציור של שכבת המסך מעל סרגל הסטטוס מדויק יותר. מעכשיו, התוכן של גיליון תחתון מודאלי יכול להשתמש בשוליים הפנימיים של החלון, וכך לאפשר הצגת תוכן מעל סרגל הניווט. הפרמטר ModalBottomSheet windowInsets שונה ל-contentWindowInsets כדי לציין איפה יחולו השוליים הפנימיים. הם כבר לא קשורים ללוגיקה של החלון. הסוג contentWindowInsets השתנה לפונקציה שמחזירה WindowInsets, כדי לאפשר את הפתרון שלה בחלון החדש. (I39630, ‏ b/274872542, ‏ b/300280229, ‏ b/290893168)
  • רכיבי PrimaryScrollableTabRow ו-SecondaryScrollableTabRow משתמשים עכשיו בפריסה מותאמת אישית במקום בהרכבה משנית, מה שאמור לשפר את הביצועים. (I991e0)
  • נוספה אפשרות לעיצוב של מצב לחיצה בקישורי טקסט, בנוסף לעיצוב רגיל, לעיצוב של מצב ריחוף ולעיצוב של מצב מיקוד. בכל אחת מהשיטות האלה יש ארגומנט pressedStyle כדי לתמוך בכך.TextDefaults (Ic473f, ‏ b/139312671)

תיקוני באגים

  • עכשיו נקודות העיגון של מגירת הניווט תואמות לרוחב של drawerContent. ‫(Ibc72f, ‏ b/245355396)
  • הריווח הפנימי העליון של התווית מחושב עכשיו לפי גודל הגופן של המערכת.OutlinedTextField (Idc781)
  • המיקום הקבוע של החבילה הוא CalendarLocale. (Ifa235)
  • [תנועת חזרה עם חיזוי] עדכון אנימציות של תנועת חזרה עם חיזוי לשימוש בעקומת אינטרפולציה של (0.1, 0.1, 0, 1) (I2591a)

גרסה 1.3.0-alpha05

‫17 באפריל 2024

androidx.compose.material3:material3-*:1.3.0-alpha05 משוחרר. גרסה 1.3.0-alpha05 מכילה את הקומטים האלה.

תכונות חדשות

  • ב-SearchBar וב-DockedSearchBar יש עכשיו עומסים חדשים שמקבלים פרמטר של שדה טקסט. כך אפשר לעצב את שדה הטקסט בנפרד משאר סרגל החיפוש, וגם להעביר שדות טקסט מותאמים אישית. שדה הטקסט של ההטמעה הנוכחית זמין עכשיו בתור SearchBarDefaults.InputField. ‫(I50c73, ‏ b/275074248, ‏ b/278773336, ‏ b/326627700)
  • הפונקציה lambda drawTick נוספה ל-API הציבורי כדי להתאים אישית את סימני התיק אם צריך (I0c048)

שינויים ב-API

  • נוספה אפשרות לעיצוב קישורי טקסט במצב לחיצה, בנוסף לעיצוב רגיל, עיצוב במצב ריחוף ועריכה (I5f864, b/139312671)
  • בוצע עדכון של CarouselItemInfo כדי לחשוף את ה-Rect של המסכה שמשמש לחיתוך הפריט (I785d8)
  • הוסר BasicTooltipState מה-API הציבורי של Material 3. הפונקציונליות שלו משולבת עם TooltipState עד ש-BasicTooltip של Foundation יתייצב. (Icda29)
  • נוסף אובייקט TextDefaults שמכיל שיטות ליצירת LinkAnnotation ולניתוח מחרוזת עם תגי HTML שחלים על הקישורים (I98532, b/139312671)MaterialTheme
  • ExposedDropdownMenuBoxScope לא מאפשרת יותר שימוש במחלקות משנה. לתפריטים הנפתחים שמוצגים יש עכשיו MenuAnchorType שצריך להעביר אל menuAnchor כדי לשפר את הנגישות. צריך להשתמש בשיטה הזו במקום להעביר את focusable אל ExposedDropdownMenu, שיצא משימוש. ל-menuAnchor יש פרמטר חדש לשליטה במצב enabled. (I55ee6, ‏ b/257209915, ‏ b/308840226)
  • תוקן צבע הגבול של OutlinedButton כשהוא מושבת. נוספה פונקציית ButtonDefaults.outlinedButtonBorder("enabled") עמוסה מדי שמקבלת את המצב המופעל. ‫(Ie650b, ‏ b/318461363)
  • נוספה מחלקה חדשה, CarouselItemInfo, כדי לעזור ללקוחות לקבל מידע על גדלי הפריטים. ‫(I9070c)
  • השימוש בבונה ColorScheme ללא קונטיינרים של משטחים הוצא משימוש. צריך לעבור אל ה-constructor שכולל מאגרי מידע של משטחים. (I35c11)
  • ‫[Outlined]TextFieldDefaults ContainerBox שונה ל-Container. (Ie8d3b)

תיקוני באגים

  • אם הערך של sheetSwipeEnabled הוא False, לא תהיה יותר גלילה של BottomSheetScaffold מגלילה מקוננת. (I5e1c1, b/306464779)
  • הסרנו חלק מההערות מסוג ExperimentalMaterial3Api OptIn ב-IconButtonSamples.kt. (I111d1)

גרסה 1.3.0-alpha04

‫3 באפריל 2024

androidx.compose.material3:material3-*:1.3.0-alpha04 משוחרר. גרסה 1.3.0-alpha04 מכילה את הקומטים האלה.

תכונות חדשות

  • נוספו שתי גרסאות ניסיוניות של קרוסלת Material3 – HorizontalMultiBrowseCarousel ו-HorizontalUncontainedCarousel (I88d64)
  • עודכן ה-Nav Drawer של Compose M3 (‏ModalDrawerSheet ו-DismissibleDrawerSheet) כדי לתמוך בתכונה 'חזרה עם חיזוי' ב-U+ כהסכמה (Ie5b0b)
  • נוסף API חדש ב-Icon כדי לאפשר העברת גוון צבע כ-lambda כדי למנוע קומפוזיציה מחדש. (I5b5a2)
  • ממשקי ה-API של סרגל האפליקציות העליון תומכים עכשיו בגבהים מותאמים אישית גם לקטעים קבועים וגם לקטעים שאפשר לכווץ. (Ib8b0c, ‏ b/323403446)

שינויים ב-API

  • ממשקי ה-API של סרגל האפליקציות העליון תומכים עכשיו בגבהים מותאמים אישית גם לקטעים קבועים וגם לקטעים שאפשר לכווץ. תוקנה בעיה שגרמה לכך שסרגלי אפליקציות עליונים עם שורה אחת הורכבו מחדש יותר מדי פעמים בזמן גלילת התוכן. תוקנה בעיה שבה MediumTopAppBar כותרות נחתכו במכשירים עם הגדרות גדולות של גופן או תצוגה. (Ib8b0c, b/323403446, b/300953236, b/286296147, b/330410290, b/308540676)
  • ‫SegmentedButton וממשקי ה-API המשויכים יציבים עכשיו (I8a158)
  • הגרסאות SwipeToDismissBox, ‏ SwipeToDismissBoxDefaults, ‏ SwipeToDismissBoxState ו-SwipeToDismissBoxValue מסומנות עכשיו כגרסאות יציבות. (I5f000)
  • הוסרו ממשקי ה-API וסוגי ה-enum ‏DismissDirection ו-DismissValue שהוצאו משימוש. (I89ccd)
  • נוסף תג ניסיוני לאובייקט הנלווה CarouselState של Carousel. (I94154)
  • הוצאנו משימוש את LocalMinimumInteractiveComponentEnforcement והשקנו את LocalMinimumInteractiveComponentSize במקומו. (I7a7ac)
  • ה-constructor של SearchBarColors הוא עכשיו ציבורי. (I769ca)
  • נוסף פרמטר gesturesEnabled ל-SwipeToDismissBox. (Idc59f, b/324170119)
  • הוסרו ממשקי API של שדות טקסט שסומנו ככאלה שיצאו משימוש וכניסיוניים. (I1305f)

גרסה 1.3.0-alpha03

‫20 במרץ 2024

androidx.compose.material3:material3-*:1.3.0-alpha03 משוחרר. גרסה 1.3.0-alpha03 מכילה את הקומטים האלה.

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

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

תכונות חדשות

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

שינויים ב-API

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

תיקוני באגים

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

גרסה 1.3.0-alpha02

‫6 במרץ 2024

androidx.compose.material3:material3-*:1.3.0-alpha02 משוחרר. גרסה 1.3.0-alpha02 מכילה את הקומטים האלה.

שינויים ב-API

  • החזרת המצב היציב של פס ההזזה. הופך את State.onValueChangeFinished ל-val שוב. הוספת onValueChangeFinished לrememberUpdatedState. ‫(I82ab2, ‏ b/322269951)
  • רכיבי הניווט משתמשים עכשיו בתפקידים החדשים של SurfaceContainer. ב-DrawerDefaults יש עכשיו מאפיינים נפרדים של standardContainerColor ו-modalContainerColor. השם של DrawerDefaults.ModalDrawerElevation הוא עכשיו 0.dp. (I7fbac)
  • הסרנו את @Stable מהמצבים של Slider כי אנחנו משנים את state.onValueChangeFinished לvar. (Ied34a, ‏ b/322269951)
  • ModalBottomSheet ו-StandardBottomSheet animation spec הוא עכשיו TweenSpec, אחרי עדכון מאנימציית קפיצה. הבעיה של חריגה גלויה נפתרה. הוסרו בנאים (constructors) שהוצאו משימוש SheetState ללא צפיפות. (I7babc, b/285847707)

תיקוני באגים

  • SurfaceContainer וריאציות נמצאות עכשיו בשימוש ברכיבים. רכיבים שבהם צבע חושב באופן רשמי באמצעות Surface ו-TonalElevation משתמשים עכשיו בתפקידי SurfaceContainer כברירת מחדל, שלא מושפעים מהגבהה טונאלית. (b/304584161)
  • תוקן באג שגרם לכך שצבע המאגר של ElevatedFilterChip כשהוא לא נבחר והוא מושבת היה שחור. (I400e6, ‏ b/322407043)
  • תיקון אינדיקטור התקדמות לא מוגדר כשההתקדמות היא 0 (Id6582)
  • תוקנה בעיה שקשורה ל-Slider ול-RangeSlider בפריסה מימין לשמאל (Iab0e1)
  • הוספת SliderRangeTolerance לחישוב טווח המחוון כי עיגול של מספרים עשרוניים יכול להיות לא מדויק. (Ic918a, b/324934900)
  • חשוב לוודא שהלחצנים של DatePickerDialog מוצגים כשמטמיעים DateRangePicker או כשמציגים בוחר תאריכים מכל סוג במסכים קטנים עם גופנים גדולים יותר. ‫(Ie4758, ‏ b/325107799, ‏ b/277768544)
  • ‫Menu משתמש עכשיו בתפקיד SurfaceContainer כדי להגדיר את צבע המאגר. השם של MenuDefaults.TonalElevation הוא עכשיו 0.dp. (I135b7)
  • ‫TextField משתמש עכשיו בתפקיד SurfaceContainerHighest כדי להגדיר את צבע המאגר. (I4dced)
  • צ'יפים מורחבים מסתמכים עכשיו על התפקיד SurfaceContainerLow (I7cd2f)
  • הצבע של הקונטיינר DatePicker הוא עכשיו SurfaceContainerHigh. השם של DatePickerDefaults.TonalElevation הוא עכשיו 0.dp. (Ida753)
  • עדכון הצבע של מאגר התוכן של דפי התחתית ושל ידית הגרירה. (I72a0a)
  • הצבע של הקונטיינר RichTooltip הוא עכשיו SurfaceContainer. (Ia8b45)
  • הצבע של הקונטיינר SearchBar הוא עכשיו SurfaceContainerHighest. השם של SearchBarDefaults.TonalElevation הוא עכשיו 0.dp. (I88604)
  • העדכונים משביתים את המתג ומבטלים את הבחירה במסלולים או בסמלים כדי להשתמש בתפקיד הצבע SurfaceContainerHighest. (I7687a)
  • הצבע של הקונטיינר AlertDialog הוא עכשיו SurfaceContainerHigh. (Ie0433)
  • הצבע של הקונטיינר BottomAppBar הוא עכשיו SurfaceContainer. הצבע של TopAppBar onScroll הוא עכשיו SurfaceContainer. (I41630)
  • הצבע של הקונטיינר ElevatedCard הוא עכשיו SurfaceContainerLow. FilledCardצבע המאגר של SurfaceContainerHighest. (I35141)
  • הצבע של הקונטיינר ElevatedButton הוא עכשיו SurfaceContainerLow. כשמבטלים את הבחירה בFilledIconButton, צבע הרקע שלו עכשיו הוא SurfaceContainerHighest. (I792c9)
  • מעדכן את התפקיד של צבע המאגר TimePicker וצבע לוח השעון ל-SurfaceContainerHighest. (I43b93)

גרסה 1.3.0-alpha01

‫21 בפברואר 2024

androidx.compose.material3:material3-*:1.3.0-alpha01 משוחרר. גרסה 1.3.0-alpha01 מכילה את הקומיטים האלה.

תכונות חדשות

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

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

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

שינויים ב-API

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

תיקוני באגים

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

גרסה 1.2

גרסה 1.2.1

‫6 במרץ 2024

androidx.compose.material3:material3-*:1.2.1 משוחרר. גרסה 1.2.1 מכילה את הקומטים האלה.

תיקוני באגים

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

גרסה 1.2.0

‫7 בפברואר 2024

androidx.compose.material3:material3-*:1.2.0 משוחרר. גרסה 1.2.0 מכילה את הקומיטים האלה.

בעיה ידועה

  • באג בעיבוד של אינטראופרביליות בין View ל-Compose הופיע בגרסה PrimaryTabRow כחלק משינוי לשיפור הביצועים. הפתרון האפשרי הוא להשתמש ב-TabRow עם TabRowDefaults.PrimaryIndicator

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

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

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

ממשקי API ניסיוניים קודמו לגרסה יציבה!

שיפורים בביצועים

גרסה 1.2.0-rc01

‫24 בינואר 2024

androidx.compose.material3:material3-*:1.2.0-rc01 משוחרר. גרסה 1.2.0-rc01 כוללת את הקומיטים האלה.

תיקוני באגים

  • תוקן באג בסדר הפרמטרים mediumTopAppBarColors. (Ibe64a)
  • תוקנה באג שהופיע בגרסה 1.2.0-beta02 ב-CardDefaults.cardColors, שגרם לכך ש-contentColor לא התעדכן על סמך ערך הפרמטר containerColor. (Iee041, ‏ b/319671246)
  • תוקן באג ב-disabledContentColor שהופיע ב-1.2.0-beta02, והוסף אופטימיזציה קלה. (I6dda1, b/318428829)

גרסה 1.2.0-beta02

‫10 בינואר 2024

androidx.compose.material3:material3-*:1.2.0-beta02 משוחרר. גרסה 1.2.0-beta02 מכילה את הקומיטים האלה.

באג מוכר

  • באג ב-IconButtonColors יקצה כברירת מחדל את disabledContentColor לגרסת אלפא (0.38f) של LocalContentColor במקום למשתמש שצוין contentColor. הפתרון הזמני הוא להגדיר במפורש את disabledContentColor. נפתור את הבעיה הזו במהדורה הבאה.

שינויים ב-API

  • הוספת האפשרות להפעיל חצים של תיאורי כלים לממשקי API רגילים של Tooltip. (Ibf767)
  • השמות של SwipeToDismissState, rememberSwipeToDismiss וגם SwipeToDismissValue שונו ל-_SwipeToDismissBox_. (I68d6d)

תיקוני באגים

  • תוקן ערך הריפוד בסוף ListItem כדי להתאים למפרט. (Ibd68b, ‏ b/305342674)
  • צבע המתאר של כרטיס עם מתאר ממופה עכשיו בצורה נכונה ל-OutlineVariant. (I75480, b/310979715)
  • הצבע הדינמי נלקח עכשיו מתפקידי צבע שהוגדרו במערכת. השינוי הזה משפר את הניגודיות של תוכן נגיש, ומתאים יותר את הצבע הדינמי למפרט של Material. (I1de96)
  • תוקן הטיפול בלחצן ModalBottomSheet חזרה ב-Android T/13 ומעלה כשמשתמשים ב-android:enableOnBackInvokedCallback="true". ‫(I728dc, ‏ b/306196110)

גרסה 1.2.0-beta01

‫13 בדצמבר 2023

androidx.compose.material3:material3-*:1.2.0-beta01 משוחרר. גרסה 1.2.0-beta01 מכילה את הקומיטים האלה.

שינויים ב-API

  • סימון של TabIndicatorScope כניסיוני. (I45c88)
  • הסרה של ממשקי API ניסיוניים שהוצאו משימוש עבור תיאור הכלים. (I438cb)
  • לשנות עומסים חדשים של TabRow כך שלא ישתמשו בהרכבות משנה. כתוצאה מכך, יש דרך אחרת ליצור את האינדיקטורים TabRow באמצעות משנים מותאמים אישית. (Ife741)
  • הוצאה משימוש של ממשקי ה-API ‏DismissDirection ו-DismissValue. הן אוחדו ל-SwipeToDismissValue, שהערכים שלו מציינים גם את המיקום וגם את הכיוון של SwipeToDismissBox. הערך DismissState.progress מסומן עכשיו כFloatRange בין 0.0 לבין 1.0. הפונקציות DismissState deprecated Saver ו-Constructor הוסרו. הרכיב SwipeToDismiss, האובייקט state והאובייקט defaults סומנו מחדש כניסיוניים. (Ib54f2)

תיקוני באגים

  • האינדיקטור שמוגדר כברירת מחדל ל-PullToRefresh הוא עכשיו חץ פתוח במקום משולש מלא. (I67be3)

גרסה 1.2.0-alpha12

‫29 בנובמבר 2023

androidx.compose.material3:material3-*:1.2.0-alpha12 משוחרר. גרסה 1.2.0-alpha12 מכילה את הקומיטים האלה.

שינויים ב-API

  • ‫RangeSlider מקבל עכשיו טווח Kotlin (למשל, 0f..1f) במקום מחלקה של ערך FloatRange בהתאמה אישית. ב-SnapFlingBehavior.kt נעשה עכשיו שימוש גם בטווח Kotlin. (I025cb)
  • מסמנים פונקציות ליצירת משני סימון כ-@Stable. (Ib109f)

גרסה 1.2.0-alpha11

‫15 בנובמבר 2023

androidx.compose.material3:material3-*:1.2.0-alpha11 משוחרר. גרסה 1.2.0-alpha11 מכילה את הקומיטים האלה.

תכונות חדשות

  • הטמעה של PullToRefreshContainer ושל PullToRefreshState, שביחד מספקים הטמעה של משיכה לרענון ב-Material3. (I16456, ‏ b/261760718)

שינויים ב-API

  • מסמנים את SwipeToDismissBox DismissDirection ואת DismissValue כניסויים. (I517b0)
  • שינוי השם של SwipeToDismiss לSwipeToDismissBox. משנים את השם של background ל-backgroundContent ואת השם של dismissContent ל-content lambda. (I7f4d3)
  • מגדירים את ה-constructor של ChipElevation ושל SelectableChipElevation כ-public. (Ie0c48, b/308432421)
  • מתבצעת הוספה של ModalBottomSheetProperties. מתבצעת העברה של securePolicy אל ModalBottomSheetProperties. הוספה של isFocusable ו-shouldDismissOnBackPress אל ModalBottomSheetProperties. הערכים הבוליאניים החדשים האלה עוזרים לקבוע איך גיליון תחתון של חלון קופץ צריך לטפל באירועי IME. (Iea56f, b/278216859)
  • עדכנו את המצבים RangeSlider ו-Slider כדי להסיר את initialOnValueChange, הקידומות הראשוניות ומסמכי ה-kdoc המתאימים. (I57d30)
  • הוצאה משימוש של המחלקה ChipBorder והבקשות המשויכות להפעלת פונקציות, והמלצה להשתמש ישירות ב-BorderStroke במקום זאת. (I89cc2)
  • ממשקי ה-API של Foundation Tooltip נקראים עכשיו @ExperimentalFoundationApi. (I30b0b)
  • המאפיינים TabRow ו-ScrollableTabRow כבר לא מוצאים משימוש. הווריאנטים החדשים 'ראשי' ו'משני' מסומנים כניסיוניים. (I0def6)
  • הצ'יפים של המסננים והקלט משתמשים עכשיו ישירות ב-BorderStroke. (I07a8d)
  • הבית SegmentedButton משתמש עכשיו ב-BorderStroke ישירות. (I89b9b)
  • שינינו את השם של הפונקציה הכללית AlertDialog ל-BasicAlertDialog והוצאנו משימוש את הפונקציה הקודמת. (Idbe52)
  • שינוי השם של ממשקי SwipeToDismiss API ל-SwipeDismiss, והעברת ממשקי SwipeDismiss API החדשים למצב יציב. (I14cbe)
  • הוספת tonalElevation וshadowElevation לממשקי API של תיאורי כלים. בנוסף, אנחנו מעבירים את ממשקי ה-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. המאפיין animateTo של DrawerState הוחלף בשיטות open ו-close, וההיסט נחשף עכשיו כערך מסוג float במקום כאובייקט מצב. אפשר לגשת להיסט ישירות דרך currentOffset. (I0a72c)
  • נוספו פונקציות לא מורכבות ליצירה ישירה של DatePickerState ושל DateRangePickerState. אפשר להשתמש בפונקציות האלה כחלופה לפונקציות Composable‏ rememberDatePickerState ו-rememberDateRangePickerState כשצריך. ‫(I70326, ‏ b/291524052)
  • לסוגי המודעות 'קבועה' ו'ניתנת לגלילה' TabRows יש עכשיו וריאציות ראשיות ומשניות. הם ממופים בצורה נכונה להתנהגות הצבע והאינדיקטור כפי שמוגדר ב-Material3.
  • ‫PrimaryScrollableTabRow ו-SecondaryScrollableTabRow חושפים עכשיו את מצב הגלילה. (Iec8f5, b/260572337)
  • הוספת פרמטר חדש, sheetMaxWidth, שמפתחים יכולים להגדיר כדי לציין רוחב מקסימלי שהגיליון יתפרס על פניו. אפשר להעביר את הערך Dp.Unspecified לפרמטר אם רוצים גיליון שמשתרע על כל רוחב המסך. (Ifb7c9, ‏ b/266697696)
  • הוספנו בחזרה את ממשקי ה-API‏ PlainTooltipBox ו-RichTooltipBox כשיטות שיצאו משימוש. (I246fa)

תיקוני באגים

  • תוקן קראש שמתרחש כשמאתחלים את DatePicker עם DatePickerFormatter שיש לו תבניות תאריכים מסוימות שנשארות זהות כשממירים אותן לתבניות תאריכים (כמו YY). (I01f29)

גרסה 1.2.0-alpha08

‫20 בספטמבר 2023

androidx.compose.material3:material3-*:1.2.0-alpha08 משוחרר. גרסה 1.2.0-alpha08 מכילה את הקומיטים האלה.

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

  • ‫ColorScheme הוא עכשיו Immutable, ולכן עדכונים של צבעים בודדים פחות יעילים, אבל שימוש נפוץ יותר בצבעים יעיל יותר. הסיבה לשינוי הזה היא שברוב האפליקציות, עדכון של צבעים ספציפיים לא נחשב לתרחיש שימוש עיקרי. האפשרות הזו עדיין קיימת, אבל היא תרכיב מחדש יותר מבעבר. כתוצאה מכך, נצמצם באופן משמעותי את מספר המינויים למצבים בכל קוד Material, וזה ישפיע על עלות האתחול וזמן הריצה של תרחישי שימוש סטנדרטיים יותר. ‫(Ic447d, ‏ b/297212873)
  • ההנפשה של הגבהה טונלית במצבי אינטראקציה שונים לא תואמת יותר למפרט. (Icdd12)

שינויים ב-API

  • נוספה BottomAppBar חדשה שמקבלת כפרמטר BottomAppBarScrollBehavior כדי להסתיר אותו אוטומטית כשמגללים את התוכן. בנוסף, הוספנו FabPosition.EndOverlay אפשרות להצגת ה-FAB כשכבת-על על סרגל האפליקציות התחתון ב-scaffold, במקום להצגה מעליו. (Iecb47)
  • נוסף רכיב Label פשוט שמבוסס על BasicTooltipBox ולא נסגר כשמקישים מחוץ לגבולות התווית. (I821f9)

תיקוני באגים

  • הוסר השימוש ב-rememberSaveable להצגת הסברים קצרים. (Icc131, ‏ b/299500338)
  • הוספנו דגל זמני כדי לקבוע אם רכיב Scaffold ימדוד את הצאצאים שלו במהלך המדידה או במהלך המיקום. כברירת מחדל, המדידה תתבצע במדידה. אם נתקלתם בבעיות בהתנהגות החדשה, אתם יכולים לדווח על בעיה. (I0b354)
  • מודעה אופקית קבועה מקצה לקצה ב-BottomSheet באמצעות המידה הנכונה של רוחב המסך במכשיר. ‫(I1df0c, ‏ b/299058752)
  • תוקן באג שגרם לכך ש-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 מחזירות עכשיו צבעים עם כרומה גבוהה יותר לתפקידים של surface ו-surfaceContainer. (I5e901)
  • תוקנה בעיה שבה חלק מהרכיבים שמשתמשים ב-Subcomposition (למשל BottomSheetScaffold) בתוך Scaffold בתוך LookaheadScope ניסו לקרוא את הגודל שלהם מוקדם מדי. (I297b4, I871f1, b/295536718)

גרסה 1.2.0-alpha06

‫23 באוגוסט 2023

androidx.compose.material3:material3-*:1.2.0-alpha06 משוחרר. גרסה 1.2.0-alpha06 מכילה את הקומיטים האלה.

תיקוני באגים

  • תוקן החישוב של DropdownMenuoffset כך שהיסטים של x תלויים רק בכיוון הפריסה המקומי, והיסטים של y לא יתהפכו יותר כשהתפריט קרוב לחלק התחתון של המסך. (Iccc74, ‏ b/294103942)
  • תוקן החישוב של DropdownMenuoffset כך שהיסטים של x תלויים רק בכיוון הפריסה המקומי, והיסטים של y לא יתהפכו יותר כשהתפריט קרוב לחלק התחתון של המסך. (Ib87a2, b/294103942)

גרסה 1.2.0-alpha05

‫9 באוגוסט 2023

androidx.compose.material3:material3-*:1.2.0-alpha05 משוחרר. גרסה 1.2.0-alpha05 מכילה את הקומיטים האלה.

שינויים ב-API

  • עדכונים לתיבת הסימון ולצבעים TriStateCheckbox. ההגדרה CheckboxDefaults.colors() disabledUncheckedColor משפיעה עכשיו רק על הגבול של תיבת הסימון. במקרים מיוחדים שבהם צריך להגדיר את הצבע הפנימי של התיבה כשהיא מושבתת ולא מסומנת, צריך ליצור מופע מותאם אישית של CheckboxColors עם ערכי הצבע הרצויים. (I77d17, ‏ b/291943198)

גרסה 1.2.0-alpha04

‫26 ביולי 2023

androidx.compose.material3:material3-*:1.2.0-alpha04 משוחרר. גרסה 1.2.0-alpha04 מכילה את הקומיטים האלה.

תכונות חדשות

  • ‫Experimental Segmented Button API‏ (Ifc8fb)
  • עכשיו יש למחיצות פרמטר לשליטה בכיוון, כדי לתמוך במחיצות אנכיות. ‫(I4c899, ‏ b/288438593)

שינויים ב-API

  • אנחנו מעבירים את התלות בצפיפות לרמת הרכיב. ההמלצה הזו רלוונטית לרכיבים הבאים: SwipeToDismiss ורכיבים שמבוססים על גיליון. צריך להשתמש בעומס החדש שצוין, שבו הצפיפות היא פרמטר. ‫(I1846e)
  • הערות נוספות לציון קלט מותר לרכיבים הניתנים להרכבה (Ief234)
  • הוספת פרמטר של סמל ללחצן מפולח, פיצול הסמנטיקה כך שניתן לבחור לחצנים מפולחים כדי להטמיע בחירה יחידה, וניתן להפעיל או להשבית אותם כדי להטמיע בחירה מרובה, עם SelectableSegmentedButtonRow ו-ToggelableSegmentedButtonRow בהתאמה. (I38740)
  • השם של הקו המפריד שונה ל-HorizontalDivider. נוספה פונקציונליות VerticalDivider. (I5975c)
  • כדי למזער את ההמרה האוטומטית של ערכים פרימיטיביים לאובייקטים (autoboxing), צריך לשנות את השימוש ב-ClosedFloatingPointRange ל-FloatRange הקל יותר בממשקי API ניסיוניים של Material3. (I4aab5)
  • נוספה אפשרות חדשה ליישור התחלתי עבור FabPosition (Ib7aea, ‏ b/170592777)

תיקוני באגים

  • ModalBottomSheet מכבד את כיוון הפריסה המקומי. (Ib4f44, ‏ b/285628622)

גרסה 1.2.0-alpha03

‫21 ביוני 2023

androidx.compose.material3:material3-*:1.2.0-alpha03 משוחרר. גרסה 1.2.0-alpha03 מכילה את הקומיטים האלה.

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

  • הגופן includeFontPadding מוגדר עכשיו כברירת מחדל כ-false בטיפוגרפיה של Material 3. גם סגנון גובה השורה שמוגדר כברירת מחדל השתנה ל-Trim.None ו-Alignment.Center, והערך lineHeight (ב-sp) נוסף ל-TextStyle של Typography. אם רוצים להתאים אישית את הערכים האלה, אפשר לעיין במסמכי ה-API. בפוסט הזה בבלוג מוסבר לעומק על השינויים האלה. (I6266f, ‏ Icabc3)

תכונות חדשות

  • נוסף עומס יתר ל-RangeSlider שהוא גרסה עם שמירת מצב של הרכיב. נוצר RangeSliderState שמכיל את כל המידע על הרצועה הפעילה הנוכחית, את המדידות של הרכיבים של RangeSlider ואת הלוגיקה של הגרירה והמחוות. (I8c270)
  • סרגל החיפוש תומך עכשיו בהצללות באמצעות הפרמטר shadowElevation שנוסף לאחרונה. (Ia5369, ‏ b/271040353)
  • ColorScheme תומך עכשיו בתפקידים חדשים של SurfaceContainer.
  • עכשיו אפשר להשבית את שכבת העל של הגבהה טונאלית של פני השטח באמצעות LocalTonalElevationEnabled composition local. (‫Ic203c, b/277774590)

שינויים ב-API

  • פותחים את הקונסטרוקטורים של צבעי הרכיבים. (I8c4a6)
  • הוספנו פרמטר שאפשר להתמקד בו לשני ממשקי ה-API של תיאורי הכלים, כדי שמפתחים יוכלו להגדיר אם תיאור הכלי יצרוך אירועי מגע או לא. חשוב לזכור שהפעולה הזו עלולה לשבש את המעבר האוטומטי בין רכיבי הנגישות. (Ie32d8)
  • נגישות אופטימלית לביצועים ולהקצאות זיכרון. (Iede48)
  • חשיפת DefaultSizeClasses ויצירת StandardSizeClasses עבור WindowSizeClasses (I91838)
  • שינוי WindowWidth/HeightSizeClass למחלקות של ערכי float ‏ (Ie686e)

תיקוני באגים

  • הפרמטר contentWindowInsets של Scaffold מתחשב עכשיו ב-window insets שנצרכו. שימו לב: אם מציינים את הפרמטרים topBar ו-bottomBar, אופן ההתנהלות של ריווח התוכן לא משתנה. (I08b73, b/264601542)
  • מתקנים את היישור של סרגל האפליקציות העליון המרכזי כדי לוודא שכותרת ארוכה לא מוצגת מעל סמלי הפעולות או סמל הניווט. (I4369f, ‏ b/236994621)
  • המיקומים של הכרטיסיות אוכפים עכשיו רוחב תוכן מינימלי של 24dp. כך מספקים יעד נגיש למגע עבור אינדיקטורים של כרטיסיות. (Id8861)
  • לוחות צבעים דינמיים מ-dynamicLightColorScheme ומ-dynamicDarkColorScheme תומכים עכשיו בתפקידים חדשים של פלטפורמות. (I1252e)
  • עדכון היישור של התראות התגים כך שלא ייחתכו כשהן מתנגשות עם סבא או סבתא רבא. (Idf75a)

גרסה 1.2.0-alpha02

‫24 במאי 2023

androidx.compose.material3:material3-*:1.2.0-alpha02 משוחרר. גרסה 1.2.0-alpha02 מכילה את הקומיטים האלה.

שינויים ב-API

  • מוסיפים את הפרמטר window insets ל-ModalBottomSheet.
    • המסך החצי שקוף של ModalBottomSheet יכול להיות מוצג מאחורי שורת הסטטוס אם הערך של windowInsets מוגדר לאפס
    • עדכנו את פונקציונליות ברירת המחדל של ModalBottomSheet כך שהיא לא תכלול את סרגלי המערכת, כולל הניווט
    • במצב 'מקצה לקצה', הטיפול בהזחה של שורת הסטטוס מתבצע באמצעות ידית הגרירה.
    • ‫BottomSheetDefaults כולל שוליים פנימיים של חלונות ל-BottomSheetWindow. (I31200, b/274872542, b/272973615, b/272334475, b/268432129, b/275849044, b/275486106, b/268433162)
  • הוצאה משימוש של Indicator והוספה של Primary/SecondaryIndicator בהתאם למפרט של M3. האפשרות PrimaryIndicator מתאימה לרוחב התוכן של הכרטיסייה, ואילו האפשרות SecondaryIndicator מתאימה לרוחב המלא שזמין. הפונקציה SecondaryIndicator שוות ערך לפונקציה Indicator שהוצאה משימוש, ויכולה להחליף אותה ישירות. (I27604)
  • נוספה אפשרות להעביר ScrollState כשיוצרים DropdownMenu או ExposedDropdownMenu כדי לשלוט במצב הגלילה האנכית של הפריטים שמוצגים בתפריט. (Ia0734, ‏ b/185304441)
  • נוסף עומס יתר ל-Slider שהוא גרסה עם שמירת מצב של הרכיב. נוצר SliderState שמכיל את כל המידע על הרצועה הפעילה הנוכחית, את המדידות של הרכיבים של Slider ואת הלוגיקה של הגרירה והמחוות. (I124a5)
  • שינוי השם של מאפיין הסמנטיקה isContainer ל-isTraversalGroup (I121f6)
  • הוספנו את TextStyle.merge(...) שעבר אופטימיזציה עם רשימה מלאה של פרמטרים. (Iad234, ‏ b/246961787)
  • יצרנו ממשקי API ציבוריים ל-TooltipState, ל-RichTooltipState ול-PlainTooltipState. נוספו RichTooltipStateImpl וPlainTooltipStateImpl למצבי ברירת מחדל. נוספו פונקציות remember*State כדי לקבל את המצבים המיושמים האלה. הוסר TooltipSync לטובת TooltipDefault.GlobalMutatorMutex. (I7813d)
  • עדכנו את DatePickerColors כך שיכלול אפשרויות נוספות להתאמה אישית של המפריד בבוחר התאריכים, הניווט והצבעים של שדות הזנת הטקסט. ‫(I1a685, b/274626815)
  • ‫DatePickerState ו-DateRangePickerState הם עכשיו ממשקים ציבוריים עם הטמעות ברירת מחדל שאפשר לאחזר באמצעות rememberDatePickerState ו-rememberDateRangePickerState. (I71c52)
  • הסרנו את dateValidator מ-DatePicker ומ-DateRangePicker והוספנו ממשק SelectableDates שאפשר להגדיר במצב כדי לשלוט באילו תאריכים או שנים אפשר לבחור בממשק המשתמש. (Ic2fc6)
  • הוסר מ-API יציב, צפויים שינויים נוספים ב-API של המצב (I3f39a)TimePicker
  • ModalBottomSheet עברה ל-Android בלבד. לא מומלץ להשתמש ב-ModalBottomSheet במחשב, והפונקציונליות לא מתוחזקת באופן פעיל. (Ib3778)

תיקוני באגים

  • תוקנה AlertDialog פעולת הסגירה כך שתופיע מתחת לפעולת האישור כשהפעולות מוערמות זו על גבי זו כדי להתאים לרוחב של תיבת הדו-שיח. התיקון הזה מתאים את ההטמעה למפרט של Material Design. ‏(I029de, ‏ b/235454277)
  • תוקן באג ב-ListItem שגרם לשימוש בריווח שגוי בשלושה פריטים. (I6e235)
  • ‫ModalBottomSheet יכולה להציג עכשיו מקלדת IME (מספרים Idc508, ‏ b/262140644, ‏ b/268380384, ‏ b/272483584)

גרסה 1.2.0-alpha01

‫10 במאי 2023

הגרסאות androidx.compose.material3:material3:1.2.0-alpha01 ו-androidx.compose.material3:material3-window-size-class:1.2.0-alpha01 יוצאות לאור. גרסה 1.2.0-alpha01 מכילה את הקומיטים האלה.

גרסה 1.1

גרסה 1.1.2

‫20 בספטמבר 2023

הגרסאות androidx.compose.material3:material3:1.1.2 ו-androidx.compose.material3:material3-window-size-class:1.1.2 יוצאות לאור. גרסה 1.1.2 מכילה את הקומיטים האלה.

תיקוני באגים

  • תוקנה הבעיה שבה שינוי הועבר באופן שגוי לשני רכיבים הניתנים להרכבה. (b/282761472)
  • הפונקציה TimePickerState מחזירה שעות שגויות כשהיא מאותחלת עם 23 שעות. (b/278242122)
  • תוקן מצב ההפעלה הראשוני של המתג לאימות של שעה ודקה. (b/269768197, b/282790635)
  • תוקנה בעיה שבה state.hour החזיר ערך שגוי לשעה 23:00. (b/282761472, b/278242122)

גרסה 1.1.1

‫21 ביוני 2023

הגרסאות androidx.compose.material3:material3:1.1.1 ו-androidx.compose.material3:material3-window-size-class:1.1.1 יוצאות לאור. גרסה 1.1.1 מכילה את הקומיטים האלה.

תיקוני באגים

  • מוסיף קריאה ל-ModalBottomSheet בלי הפרמטר windowInset לצורך תאימות בינארית. (Ib7959)
  • מוסיפים את הפרמטר window insets ל-ModalBottomSheet.
    • המסך החצי שקוף של ModalBottomSheet יכול להיות מוצג מאחורי שורת הסטטוס אם הערך של windowInsets מוגדר לאפס
    • עדכנו את פונקציונליות ברירת המחדל של ModalBottomSheet כך שהיא לא תכלול את סרגלי המערכת, כולל הניווט
    • במצב 'מקצה לקצה', הטיפול בהזחה של שורת הסטטוס מתבצע באמצעות ידית הגרירה.
    • ‫BottomSheetDefaults כולל שוליים פנימיים של חלונות ל-BottomSheetWindow. (I31200, b/274872542, b/272973615, b/272334475, b/268432129, b/275849044, b/275486106, b/268433162)

גרסה 1.1.0

‫10 במאי 2023

הגרסאות androidx.compose.material3:material3:1.1.0 ו-androidx.compose.material3:material3-window-size-class:1.1.0 יוצאות לאור. גרסה 1.1.0 מכילה את הקומיטים האלה.

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

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

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

ממשקי API ניסיוניים קודמו לגרסה יציבה!

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

גרסה 1.1.0-rc01

‫19 באפריל 2023

הגרסאות androidx.compose.material3:material3:1.1.0-rc01 ו-androidx.compose.material3:material3-window-size-class:1.1.0-rc01 יוצאות לאור. גרסה 1.1.0-rc01 כוללת את הקומיטים האלה.

שינויים ב-API

  • הוסר מ-API יציב, צפויים שינויים נוספים ב-API של המצב (I3f39a)TimePicker
  • ModalBottomSheet עברה ל-Android בלבד. לא מומלץ להשתמש ב-ModalBottomSheet במחשב, והפונקציונליות לא מתוחזקת באופן פעיל. (Ib3778)

גרסה 1.1.0-beta02

‫5 באפריל 2023

הגרסאות androidx.compose.material3:material3:1.1.0-beta02 ו-androidx.compose.material3:material3-window-size-class:1.1.0-beta02 יוצאות לאור. גרסה 1.1.0-beta02 מכילה את הקומיטים האלה.

שינויים ב-API

  • לפרמטר SheetState יש עכשיו ערך אופציונלי skipHiddenState
  • לפרמטר rememberStandardBottomSheetState יש עכשיו ערך אופציונלי skipHiddenState
  • לתג BottomSheetScaffold יש עכשיו עוגן מוסתר מוגדר, אבל הוא מושבת כברירת מחדל
  • התיעוד של SheetState.requireOffset עודכן
  • השם של BottomSheetDefaults.MinimizedShape השתנה לBottomSheetDefaults.HiddenShape (I839f4, ‏ b/273870234)

תיקוני באגים

  • לא להחליף את לוח השעון משעה לדקה כשהתכונה 'גילוי באמצעות מגע' מופעלת. (I717d0)
  • הסמנטיקה של נקודות האחיזה לגרירה ModalBottomSheet ו-BottomSheetScaffold מוזגה עכשיו. (I05afb)
  • הפרמטרים BottomSheetScaffold, containerColor ו-contentColor משפיעים עכשיו רק על התוכן. (I992cb)
  • BottomSheetScaffold nestedScroll לתוכן של גיליון אלקטרוני יש עכשיו אפשרות להטלה. (I992cb)

גרסה 1.1.0-beta01

‫22 במרץ 2023

הגרסאות androidx.compose.material3:material3:1.1.0-beta01 ו-androidx.compose.material3:material3-window-size-class:1.1.0-beta01 יוצאות לאור. גרסה 1.1.0-beta01 מכילה את הקומיטים האלה.

שינויים ב-API

  • מוסיפים פרמטר של סוג פריסה ל-TimePicker composable. הוא מאפשר להשתמש בפריסות שונות, בהתאם לתצורת המסך (Ia0e16)
  • SearchBarDefaults סומן כניסיוני. (I65561)
  • נוספה הגבהה של הצל ל-BottomSheetScaffold (I94e0f)
  • נוספה תמיכה בהצגת בוררי התאריכים ללא חלק הכותרת. שינויים ב-API כדי לאפשר העברה של כותרת null כשיוצרים כלי לבחירת תאריך. מעכשיו אפשר להעביר כותרת, שם ו-showToggleMode = false עם הערך null כדי להציג כלי לבחירת תמונות ללא כותרת. ‫(Id3f3a, ‏ b/266132421, ‏ b/267194809)

תיקוני באגים

  • סרגלי החיפוש מפסיקים להתמקד באופן אוטומטי כשהם לא פעילים. ‫(I22a7c, ‏ b/261444487)
  • עדכנו את DateRangePicker כדי לאפשר בחירת טווח עם אותו תאריך להתחלה ולסיום. (I16529, ‏ b/272882497)
  • שדות טקסט ממקמים עכשיו את רכיבי הטקסט שלהם בצורה נכונה כשגודל הגופן קטן מהצפוי. יכול להיות שיהיה שינוי של כמה פיקסלים באפליקציות, בהתאם להגדרות הגופן ולסקריפט. (I8b8d0)
  • לפעולות סמנטיות בגיליון התחתון יש עכשיו תוויות. (I277b0)

גרסה 1.1.0-alpha08

‫8 במרץ 2023

הגרסאות androidx.compose.material3:material3:1.1.0-alpha08 ו-androidx.compose.material3:material3-window-size-class:1.1.0-alpha08 יוצאות לאור. גרסה 1.1.0-alpha08 מכילה את הקומיטים האלה.

תכונות חדשות

  • הוספנו תמיכה ב-BottomSheetScaffold וב-BottomSheetScaffoldState. (I063d4)

שינויים ב-API

  • נוספה פונקציונליות ל-DatePickerState ול-DateRangePickerState שמאפשרת להגדיר תאריכים אחרי היצירה הראשונית של המצב, וגם לאפס את הבחירות על ידי הגדרת חותמות זמן של null. צריך להיזהר כשמגדירים תאריכים באופן ידני, והפונקציה החדשה setSelection תציג חריגה אם תאריך שסופק לא יעמוד בתנאי מוקדם (ראו תיעוד). (Ifa645, ‏ b/268609314, ‏ b/270427389)
  • שינינו את השם של Collapsed SheetValue ל-PartiallyExpanded כדי לתאר בצורה מדויקת וגמישה יותר את ההתנהגות במצב הזה. (Ia1491)
  • השמות של הפרמטרים ListItem עודכנו ל-‎_content במקום ‎_text. הפונקציות לקבלת ערכי ברירת מחדל הן עכשיו ReadOnlyComposables במקומות הרלוונטיים. (I69a25)
  • העברת ממשקי API אינטראקטיביים של Surface מניסיוניים לזמינים. (I90d59, ‏ b/261561812)

תיקוני באגים

  • תוקנה בעיה שבה המצב של ModalBottomSheetHalfExpanded חושב בצורה שגויה והגיליון נראה כאילו הוא צף. (I45e84, ‏ b/268411386)
  • הוספת סימן וי confirmValueChange להקשה על מסך ההסתרה עבור ModalBottomSheet. ‫(I2311a, ‏ b/270425759)
  • העברת פעולות סמנטיות BottomSheet לנקודת אחיזה לגרירה. (I158ba)
  • ModalBottomSheet עכשיו הפוקוס מוגדר על ההפעלה, והאפליקציה מטפלת בכפתור 'הקודם'. (I4d2ab)
  • האפשרות ModalBottomSheet onDismissRequest מטופלת עכשיו גם במהלך גלילה מהירה מקונטיינר אחד לקונטיינר אחר. ‫(I655c5, ‏ b/268433166)

גרסה 1.1.0-alpha07

‫22 בפברואר 2023

הגרסאות androidx.compose.material3:material3:1.1.0-alpha07 ו-androidx.compose.material3:material3-window-size-class:1.1.0-alpha07 יוצאות לאור. גרסה 1.1.0-alpha07 מכילה את הקומיטים האלה.

תכונות חדשות

  • הוספת רכיב Time Input שאפשר להשתמש בו עם rememberTimePickerState(), בהתאם למפרט M3 של Time Input ‏ (Ia4fab)
  • נוסף API של Material 3 DateRangePicker לבחירת טווח תאריכים. (I7a6c3, ‏ b/267194809)
  • הוספנו תמיכה במצב קלט של Material 3 לבחירת טווחי תאריכים באמצעות DateRangePicker API. (Ifdbc4)
  • עכשיו אפשר להתאים אישית את הצבעים של שדות הטקסט:
    • צבעי שדה הקלט וטקסט ה-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() כציבורי, כדי שמפתחים יוכלו להעביר אותו לרכיב העוגן כדי לציין שצריך להציג הסבר קצר בלחיצה ארוכה. ממשק PlainTooltipBox API עודכן כך שאי אפשר יותר להגדיר את TooltipState כ-nullable, ועכשיו יש לו ערך ברירת מחדל. (Ie2fb7)
  • ProgressIndicatorDefaults.circularTrackColor סומן כ@Composable לצורך עקביות. (Id29cc)
  • שחזור של getter של מאפיין LocalMinimuTouchTargetEnforcement וסימון שלו כמאפיין שהוצא משימוש, והפניה אוטומטית אל LocalMinimumInteractiveComponentEnforcement. (I60dd5)

גרסה 1.1.0-alpha05

‫26 בינואר 2023

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

תכונות חדשות

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

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

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

גרסה 1.1.0-alpha04

‫11 בינואר 2023

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

תכונות חדשות

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

שינויים ב-API

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

תיקוני באגים

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

בעיה ידועה

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

גרסה 1.1.0-alpha03

‫7 בדצמבר 2022

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

שינויים ב-API

  • השמות של consumedWindowInsets() ו-withConsumedWindowInsets() שונו ל-consumeWindowInsets() ו-onConsumedWindowInsetsChanged(), והמשנים הפכו לציבוריים. (Ie44e1)
  • הוספה של ריווח חדש כברירת מחדל ללחצן טקסט עם סמל. (I8f662)
  • נוספו צבעים מושבתים לסרגל הניווט ולסרגל הצד. (Ia7892, b/258867034)
  • נוסף Modifier API כדי לשלוח שאילתות לגבי פרטי גלילה של רכיבי צאצא. (I2ba9d, ‏ b/203141462)
  • משמש ב-Clickable כדי להשהות נכון אינטראקציות של לחיצה, כשמחוות יכולות להפוך לאירועי גלילה.
  • תוקנה הבעיה שבה לא היה עיכוב נכון באפקט האדוות כשנעשה שימוש ב-Clickables בתוך Scrollable ViewGroup.
  • עדכנו את מגירות האפליקציות ואת Sheets כדי לעכב לחיצות בצורה נכונה במקרים שבהם תנועות יכולות להפוך לאירועי גלילה.

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

  • ‫Compose UI ו-Compose Material תלויים עכשיו ב-Lifecycle 2.5.1. (I05ab0, b/258038814)

גרסה 1.1.0-alpha02

9 בנובמבר 2022

הגרסאות androidx.compose.material3:material3:1.1.0-alpha02 ו-androidx.compose.material3:material3-window-size-class:1.1.0-alpha02 יוצאות לאור. גרסה 1.1.0-alpha02 מכילה את הקומיטים האלה.

שינויים ב-API

  • ‫awaitFirstDown ו-waitForUpOrCancellation תומכים עכשיו ב-PointerEventPass כדי לאפשר גמישות רבה יותר (גם מתקן את ExposedDropdownMenuBox שמציג תפריט בזמן גלילה).(I7579a, b/212091796)
  • נוסף הפרמטר minLines לרכיבי Text של Material ו-Material3, ‏ TextField ו-OutlinedTextField שמאפשר להגדיר את הגובה המינימלי של הרכיב במונחים של מספר שורות (I4af1d)
  • הוצאנו משימוש את הפונקציה TopAppBarDefaults smallTopAppBarColors לטובת פונקציה חדשה topAppBarColors שבה צריך להשתמש כשיוצרים TopAppBar. (Ie6cb9)
  • נוסף הפרמטר minLines ל-BasicText ול-BasicTextField. הוא מאפשר להגדיר את הגובה המינימלי של רכיבי ה-Composable האלה במונחים של מספר שורות (I24294, b/122476634)

תיקוני באגים

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

גרסה 1.1.0-alpha01

24 באוקטובר 2022

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

תיקוני באגים

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

גירסה 1.0

גרסה 1.0.1

9 בנובמבר 2022

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

תיקוני באגים

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

גרסה 1.0.0

24 באוקטובר 2022

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

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

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

עיצוב ערכות נושא ב-Material Design 3 וצבע דינמי ב-Material You

רכיבים של Material Design 3

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

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

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

גרסה 1.0.0-rc01

5 באוקטובר 2022

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

שינויים ב-API

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

גרסה 1.0.0-beta03

‫21 בספטמבר 2022

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

שינויים ב-API

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

תיקוני באגים

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

גרסה 1.0.0-beta02

‫7 בספטמבר 2022

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

שינויים ב-API

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

תיקוני באגים

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

גרסה 1.0.0-beta01

‫24 באוגוסט 2022

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

הפניית API

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

שינויים ב-API

  • עדכנו את סרגל האפליקציות העליון של Material 3 כך שניתן יהיה להקטין אותו למצב מכווץ לחלוטין או להגדיל אותו למצב מורחב לחלוטין. בנוסף, עודכנה פונקציית ההתנהגות TopAppBarDefaults כך שתהיה Composables ותספק ערכי ברירת מחדל למצב סרגל האפליקציות העליון ולמפרט האנימציה. (I642b3)
  • עדכון של חתימות רכיבי ה-FAB כך שיתאימו לממשק ה-API של המשטח (I3afaa)
  • הוספנו תמיכה מובנית ב-insets בסרגלי אפליקציות עליונים, במגירות, בסרגלי ניווט ובסרגלי צד. הרכיבים האלה, כשמשתמשים בהם בנפרד או עם Scaffold, מטפלים באופן אוטומטי ב-insets למפתחים. הערה: השינוי הזה לא מוסיף טיפול אוטומטי בסמלים של סרגל הסטטוס ובשקיפות של סרגל הסטטוס וסרגל הניווט. כדי ליהנות מהחוויה הטובה ביותר מקצה לקצה, צריך להמשיך לעשות את זה באופן ידני. (I7e4e6, b/183161866)
  • עדכנו את ברירות המחדל של הרכיבים כדי לצמצם את שטח ה-API, וכך לאפשר גמישות בעתיד ולשפר את הביצועים. (I31820)
  • שינוי הסדר של הפרמטרים של הצ'יפ ושל דף המגירה של הניווט כדי לשמור על עקביות ב-API (I45d0b)
  • הוסר startIndent מהרכיב Divider והצבע הועבר להיות הפרמטר האחרון.(If7be2)

גרסה 1.0.0-alpha16

‫10 באוגוסט 2022

הגרסאות androidx.compose.material3:material3:1.0.0-alpha16 ו-androidx.compose.material3:material3-window-size-class:1.0.0-alpha16 יוצאות לאור. גרסה 1.0.0-alpha16 מכילה את הקומיטים האלה.

תכונות חדשות

  • תמיכה בהגדרת רוחב מותאם אישית בחלונית ההזזה לניווט. (Ia7f10)

שינויים ב-API

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

גרסה 1.0.0-alpha15

‫27 ביולי 2022

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

תכונות חדשות

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

שינויים ב-API

  • עדכונים בממשקי ה-API‏ FilterChip ו-ElevatedFilterChip כדי להסיר את משבצת selectedIcon ולעודד שימוש חוזר ב-leadingIcon להצגת מצב נבחר. (Ie5dc2)
  • הוספת תפקידי צבע שונים של שכבת scrim ושל קווי מתאר. (Id6d54)
  • תיקון מוסכמות מתן שמות לברירות מחדל שניתנות להרכבה. (I62b27)
  • סימון של ListItemDefaults ושל ListItemColors כמוצרים ניסיוניים. (I1f3ec)
  • שינויים ב-API של סרגל האפליקציה העליון כדי לשקף טוב יותר את המשמעות של מאפייני המצב שלו. בנוסף, צריך לסמן את ה-API של סרגל האפליקציות העליון כניסיוני. (Ic0ad8)
  • הוספנו ל-TextFieldColors צבעים לבחירת טקסט, כדי שיהיה קל יותר למצוא אותם. (Iba1b8)
  • הוספת ButtonDefault.ButtonWithIconContentPadding לשימוש בלחצנים שמכילים סמל. (I2bf9c)
  • שדות הטקסט סומנו כניסיוניים כדי לאפשר גמישות רבה יותר בשינויים עתידיים בממשק ה-API. (I127b5)
  • ההערה @ExperimentalMaterial3Api הוסרה מהפונקציה Checkbox. (I5eefc)
  • ההערה @ExperimentalMaterial3Api הוסרה מהפונקציה RadioButton. (I17e2a)
  • הוסרה ההערה @ExperimentalMaterial3Api מהכרטיסים הלא אינטראקטיביים. (I9bd49)
  • עדכונים של אובייקטים שונים של ברירות מחדל של רכיבים, כך שיכללו צבעים, צורות וכו'. (I96e11)

תיקוני באגים

  • הוסרו סמלים לא פעילים של קלט שבבים לדוגמאות כדי למנוע בלבול בקרב המשתמשים באפליקציית הקטלוג. (I9846a)

גרסה 1.0.0-alpha14

29 ביוני 2022

הגרסאות androidx.compose.material3:material3:1.0.0-alpha14 ו-androidx.compose.material3:material3-window-size-class:1.0.0-alpha14 יוצאות לאור. גרסה 1.0.0-alpha14 מכילה את הקומיטים האלה.

תכונות חדשות

  • נוספה הטמעה של רשימת M3. דוגמאות לשימוש מופיעות במסמכי התיעוד (Id7a20)

שינויים ב-API

  • שינוי שם הפרמטר מ-values ל-value ב-RangeSlider (I3b79a)
  • שינויים ב-API בהטמעה של InputChip כדי לתמוך במצב שניתן לבחירה בהתאם למפרט של Material Design. תמיכה נוספת בצבעים של FilterChip למצב מושבת שנבחר. (I55244, b/235792432)
  • הוספת לחצן פעולה צף (FAB) שמוגדר כברירת מחדל BottomAppBar (Ida4c8)
  • הכרטיס ColorScheme.surfaceColorAtElevation נוסף (Id41af)
  • ממשקים בספריות של Compose נוצרים עכשיו באמצעות שיטות ממשק שמוגדרות כברירת מחדל ב-jdk8 (I5bcf1)
  • המחלקות WindowWidthSizeClass ו-WindowHeightSizeClass מיישמות עכשיו את הממשק Comparable, כך שאפשר להשוות ביניהן באמצעות אופרטורים (<, <=, >=, >) וממשקי API אחרים. (I747d0)

תיקוני באגים

  • עדכון דוגמת התג כדי לספק תיאור משמעותי יותר של התוכן. (I10b9d)
  • נוספה אפשרות להשתמש בגודל הגופן של המערכת בכלי לבחירת העיצוב של קטלוג Material 3. (I10605)
  • הוספת קוד לדוגמה לתג ולאינדיקטורים של התקדמות לא מוגדרת. (I8fbe0)

גרסה 1.0.0-alpha13

‫1 ביוני 2022

הגרסאות androidx.compose.material3:material3:1.0.0-alpha13 ו-androidx.compose.material3:material3-window-size-class:1.0.0-alpha13 יוצאות לאור. גרסה 1.0.0-alpha13 מכילה את הקומיטים האלה.

שינויים ב-API

  • יש תמיכה בשמירה על המיקום של סרגל האפליקציות העליון כשמשנים את ההגדרה. (I10459, ‏ b/216160958)

גרסה 1.0.0-alpha12

18 במאי 2022

הגרסאות androidx.compose.material3:material3:1.0.0-alpha12 ו-androidx.compose.material3:material3-window-size-class:1.0.0-alpha12 יוצאות לאור. גרסה 1.0.0-alpha12 מכילה את הקומיטים האלה.

תיקוני באגים

  • עכשיו אפשר להגדיר רוחב 0 לרכיב slider parent. (b/231707291)

גרסה 1.0.0-alpha11

11 במאי 2022

הגרסאות androidx.compose.material3:material3:1.0.0-alpha11 ו-androidx.compose.material3:material3-window-size-class:1.0.0-alpha11 יוצאות לאור. גרסה 1.0.0-alpha11 מכילה את הקומיטים האלה.

תכונות חדשות

  • נוספה RangeSlider ל-Material 3‏ (I18e38)
  • הוספת תמיכה ב-Material3‏ AssistChip וInputChip (I0d25a)
  • הוספת תמיכה ב-Material3‏ FilterChip וSuggestionChip (I9fdf3)

שינויים ב-API

  • השם של רכיב ה-Composable‏ TextFieldDefaults.BorderStroke שיוצר קו גבול ב-OutlinedTextField שונה ל-TextFieldDefaults.BorderBox. (I5f295)
  • שינויים חזותיים ב-m3‏ (Iab30e)
  • הגדרה שמאפשרת להעביר צבעים ללחצני סמלים רגילים. (Ia2445)

תיקוני באגים

  • הוספת בדיקת lint ל-material3/Scaffold כדי לוודא שהריווח הפנימי נמצא בשימוש (I72293, ‏ b/226951418)

גרסה 1.0.0-alpha10

‫20 באפריל 2022

הגרסאות androidx.compose.material3:material3:1.0.0-alpha10 ו-androidx.compose.material3:material3-window-size-class:1.0.0-alpha10 יוצאות לאור. גרסה 1.0.0-alpha10 מכילה את הקומיטים האלה.

תכונות חדשות

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

שינויים ב-API

  • נוספה הגבהה של כפתור פעולה צף כברירת מחדל ל-BottomAppBar, הוסרה lambda מסוג trailing מ-BottomAppBar עם כפתור פעולה צף. (I92c47)
  • נוספו Material3 FilledIconButton,‏ FilledTonalIconButton ו-OutlinedIconButton. (Ib2bda)
  • בוצעו עדכונים ב-Snackbar API של Material 3 כדי לאפשר קבלת ערכי צבע לפעולה האופציונלית ולפעולת ההסרה. (Ibe4b4)
  • השימוש החלקי (הורדה או מיקום) הוצא משימוש ב-PointerInputChange. אפשר להשתמש ב-consume() כדי להחיל את השינוי באופן מלא. אפשר להשתמש ב-isConsumed כדי לקבוע אם מישהו אחר כבר השתמש בשינוי.
  • הפונקציה PointerInputChange::copy() יוצרת עכשיו תמיד עותק שטחי. המשמעות היא שעותקים של PointerInputChange ינוצלו ברגע שאחד מהעותקים ינוצל. אם רוצים ליצור PointerInputChange לא מאוגד, צריך להשתמש בבונה במקום זאת. ‫(Ie6be4, b/225669674)
  • בוצעו שינויים ב-Cards API כדי לקבל את הצבעים של הרכיב והתוכן דרך ממשק CardColors, וכדי לתמוך במצב מושבת של כרטיסים שאפשר ללחוץ עליהם. (I927df)
  • הפרמטר backgroundColor קיבל את השם containerColor בשדות טקסט של Material 3 כדי לשפר את העקביות עם רכיבים אחרים. (I6fbd9)

תיקוני באגים

  • עדכנו את התקן IconButton כדי שיתאים למפרט Material3. ‏(I09eab)
  • העברת הגובה של הסרגל העליון של material3 Scaffold אל הריווח הפנימי שמועבר לתוכן, כדי שהתוכן יוצג מתחת לסרגל האפליקציה העליון. אם מתעלמים מהערכים PaddingValues, יכול להיות שהתוכן יוסתר על ידי הסרגל העליון. (I83cbc, b/217776202)

גרסה 1.0.0-alpha09

‫6 באפריל 2022

androidx.compose.material3:material3:1.0.0-alpha09 משוחרר. גרסה 1.0.0-alpha09 מכילה את הקומיטים האלה.

תכונות חדשות

  • נוסף Material 3 Switch API ‏ (I2c3ad)

שינויים ב-API

  • נוספה תמיכה בתפריטים נפתחים עם שדות טקסט (שנקראים גם 'תפריטים נפתחים חשופים' או 'תיבות משולבות'). (I1b832)
  • נוסף פרמטר צורה למערכת המשנה MaterialTheme ו-Shape. (I37426)
  • נוסף פרמטר מורחב ל-ExtendedFloatingActionButton כדי לקבוע אם לחצן ה-FAB יורחב או יכווץ, עם אנימציות בין כל מצב. נוספה עומס יתר של לחצן פעולה צף מורחב ללחצני פעולה צפים מורחבים עם טקסט נגרר ללחצני פעולה צפים מורחבים ללא סמל. (Iba7f1)

גרסה 1.0.0-alpha08

23 במרץ 2022

androidx.compose.material3:material3:1.0.0-alpha08 משוחרר. גרסה 1.0.0-alpha08 מכילה את הקומיטים האלה.

תכונות חדשות

  • הוספנו תמיכה בשדות טקסט של Material 3. (I795cc, ‏ b/199377790)

שינויים ב-API

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

תיקוני באגים

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

גרסה 1.0.0-alpha04

‫26 בינואר 2022

androidx.compose.material3:material3:1.0.0-alpha04 משוחרר. גרסה 1.0.0-alpha04 מכילה את הקומיטים האלה.

שינויים ב-API

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

תיקוני באגים

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

גרסה 1.0.0-alpha03

12 בינואר 2022

androidx.compose.material3:material3:1.0.0-alpha03 משוחרר. גרסה 1.0.0-alpha03 מכילה את הקומיטים האלה.

תיקוני באגים

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

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

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

גרסה 1.0.0-alpha02

1 בדצמבר 2021

androidx.compose.material3:material3:1.0.0-alpha02 משוחרר. גרסה 1.0.0-alpha02 מכילה את הקומיטים האלה.

תכונות חדשות

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

שינויים ב-API

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

תיקוני באגים

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

גרסה 1.0.0-alpha01

‫27 באוקטובר 2021

androidx.compose.material3:material3:1.0.0-alpha01 משוחרר. גרסה 1.0.0-alpha01 מכילה את הקומיטים האלה.

תכונות חדשות

עיצוב ערכות נושא ב-Material Design 3 וצבע דינמי ב-Material You

רכיבים של Material Design 3

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