הרכבת חומר 3

בניית ממשקי משתמש ב-Jetpack פיתוח נייטיב עם רכיבי Material Design 3, הפיתוח הבא של עיצוב Material Design. Material 3 כולל עיצוב ורכיבים מעודכנים ותכונות התאמה אישית של Material You, כמו צבעים דינמיים, ונועד להיות אחיד עם הסגנון החזותי החדש של Android 12 וממשק המשתמש של המערכת.
העדכון האחרון גרסה יציבה מועמד לפרסום גרסת בטא גרסת אלפא
4 בספטמבר 2024 1.3.0 - - -

מבנה

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

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

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

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

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

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

מגניב

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

android {
    buildFeatures {
        compose true
    }

    composeOptions {
        kotlinCompilerExtensionVersion = "1.1.1"
    }

    kotlinOptions {
        jvmTarget = "1.8"
    }
}

Kotlin

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

android {
    buildFeatures {
        compose = true
    }

    composeOptions {
        kotlinCompilerExtensionVersion = "1.1.1"
    }

    kotlinOptions {
        jvmTarget = "1.8"
    }
}

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

משוב

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

דיווח על בעיה חדשה

מקורות מידע בנושא מעקב אחר בעיות אפשר לקבל מידע נוסף.

הרכבת Material3 גרסה 1.0 נפוצה

גרסה 1.0.0-alpha01

17 באפריל 2024

androidx.compose.material3:material3-common:1.0.0-alpha01, androidx.compose.material3:material3-common-android:1.0.0-alpha01 ו-androidx.compose.material3:material3-common-desktop:1.0.0-alpha01 שוחררו. גרסה 1.0.0-alpha01 מכילה את התחייבויות אלה.

תכונות חדשות

רכיבים ללא עיצוב שבהם אפשר להשתמש כדי לבנות רכיבים בעיצוב חדשני תלת-ממדי:

כתיבת גרסה 1.0 של חבילת הניווט הדינמית של Material3

גרסה 1.0.0-alpha07

1 במאי 2024

androidx.compose.material3:material3-adaptive-navigation-suite:1.0.0-alpha07, androidx.compose.material3:material3-adaptive-navigation-suite-android:1.0.0-alpha07 ו-androidx.compose.material3:material3-adaptive-navigation-suite-desktop:1.0.0-alpha07 שוחררו. גרסה 1.0.0-alpha07 מכילה את התחייבויות אלה.

שינויים ב-API

  • הגדרת ממשקי ה-API של חבילת הניווט ללא ניסיוניים (If62af)

תיקוני באגים

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

גרסה 1.0.0-alpha06

17 באפריל 2024

androidx.compose.material3:material3-adaptive-navigation-suite:1.0.0-alpha06, androidx.compose.material3:material3-adaptive-navigation-suite-android:1.0.0-alpha06 ו-androidx.compose.material3:material3-adaptive-navigation-suite-desktop:1.0.0-alpha06 שוחררו. גרסה 1.0.0-alpha06 מכילה את התחייבויות אלה.

שינויים ב-API

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

גרסה 1.0.0-alpha05

6 במרץ 2024

androidx.compose.material3:material3-adaptive-navigation-suite:1.0.0-alpha05, androidx.compose.material3:material3-adaptive-navigation-suite-android:1.0.0-alpha05 ו-androidx.compose.material3:material3-adaptive-navigation-suite-desktop:1.0.0-alpha05 שוחררו. גרסה 1.0.0-alpha05 מכילה את התחייבויות אלה.

שינויים ב-API

  • הגדרת ה-constructor של NavigationSuiteItemColors כציבורי. (Ica83a, b/324886877)

גרסה 1.0.0-alpha04

21 בפברואר 2024

androidx.compose.material3:material3-adaptive-navigation-suite:1.0.0-alpha04, androidx.compose.material3:material3-adaptive-navigation-suite-android:1.0.0-alpha04 ו-androidx.compose.material3:material3-adaptive-navigation-suite-desktop:1.0.0-alpha04 שוחררו. גרסה 1.0.0-alpha04 מכילה את התחייבויות אלה.

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

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

גרסה 1.0.0-alpha03

7 בפברואר 2024

androidx.compose.material3:material3-adaptive-navigation-suite:1.0.0-alpha03, androidx.compose.material3:material3-adaptive-navigation-suite-android:1.0.0-alpha03 ו-androidx.compose.material3:material3-adaptive-navigation-suite-desktop:1.0.0-alpha03 שוחררו. גרסה 1.0.0-alpha03 מכילה את התחייבויות אלה.

שינויים ב-API

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

גרסה 1.0.0-alpha02

13 בדצמבר 2023

androidx.compose.material3:material3-adaptive-navigation-suite:1.0.0-alpha02, androidx.compose.material3:material3-adaptive-navigation-suite-android:1.0.0-alpha02 ו-androidx.compose.material3:material3-adaptive-navigation-suite-desktop:1.0.0-alpha02 שוחררו. גרסה 1.0.0-alpha02 מכילה את התחייבויות אלה.

תכונות חדשות

תיקוני באגים

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

גרסה 1.0.0-alpha01

15 בנובמבר 2023

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

תכונות חדשות

כתיבת גרסה 1.0 מותאמת של Material3

גרסה 1.0.0-alpha06

7 בפברואר 2024

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

תכונות חדשות

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

גרסה 1.0.0-alpha05

24 בינואר 2024

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

תכונות חדשות

  • תמיכה במוּדעוּת להיסטוריה בניווט פיגומים ובחישוב ערך (I71d46)

גרסה 1.0.0-alpha04

10 בינואר 2024

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

תכונות חדשות

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

שינויים ב-API

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

תיקוני באגים

  • תיקון AnimatedPane לא נוצר מחדש (c3f573d)

גרסה 1.0.0-alpha03

13 בדצמבר 2023

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

שינויים ב-API

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

גרסה 1.0.0-alpha02

29 בנובמבר 2023

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

שינויים ב-API

  • פיצול ממשקי API לניווט מממשקי API גמישים. (Ic4045)
  • הסרת כיתה אחת (GutterSize). (I785b3)

תיקוני באגים

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

גרסה 1.0.0-alpha01

15 בנובמבר 2023

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

תכונות חדשות

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

ממשקי API של Material3 להתאמה ל-scaffold של הנחיית חלוניות:

ממשקי API של פירמוט חלוניות בגודל Material3:

כתיבת Material3 גרסה 1.3

גרסה 1.3.0

4 בספטמבר 2024

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

שינויים חשובים מאז 1.2.0

התכונות העיקריות של 1.3.0

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

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

גרסה 1.3.0-rc01

21 באוגוסט 2024

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

תיקוני באגים

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

גרסה 1.3.0-beta05

24 ביולי 2024

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

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

גרסה 1.3.0-beta04

26 ביוני 2024

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

גרסה 1.3.0-beta03

12 ביוני 2024

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

תרומה חיצונית

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

גרסה 1.3.0-beta02

29 במאי 2024

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

שינויים ב-API

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

תיקוני באגים

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

תרומה חיצונית

  • הגדרת androidx.compose.material3.AlertDialog כזמין מקבוצת מקור משותפת (Ia33f5)
  • הגדרת ModalBottomSheet כזמין מקבוצת מקור משותפת (Id7cc7)

גרסה 1.3.0-beta01

14 במאי 2024

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

שינויים ב-API

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

גרסה 1.3.0-alpha06

1 במאי 2024

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

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

  • ממשקי API חדשים מסוג pull-to-refresh:

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

שינויים ב-API

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

תיקוני באגים

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

גרסה 1.3.0-alpha05

17 באפריל 2024

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

תכונות חדשות

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

שינויים ב-API

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

תיקוני באגים

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

גרסה 1.3.0-alpha04

3 באפריל 2024

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

תכונות חדשות

  • נוספו שתי גרסאות ניסיוניות של קרוסלה Material3HorizontalMultiBrowseCarousel ו-HorizontalUncontainedCarousel (I88d64)
  • עודכנה חלונית ההזזה של הניווט M3 (ModalDrawerSheet ו-DismissibleDrawerSheet) כדי לתמוך בהצגה חזויה ב-U+ כהצטרפות (Ie5b0b)
  • הוספנו ממשק API חדש ב-icon כדי לאפשר העברת גוון צבע כמו lambda כדי למנוע יצירה מחדש. (I5b5a2)
  • ממשקי API של סרגל האפליקציה העליון תומכים עכשיו בגבהים מותאמים אישית בקטעים קבועים ובקטעים שניתנים לכיווץ. (Ib8b0c, b/323403446)

שינויים ב-API

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

גרסה 1.3.0-alpha03

20 במרץ 2024

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

שינויים של תקלות ויזואליות

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

תכונות חדשות

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

שינויים ב-API

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

תיקוני באגים

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

גרסה 1.3.0-alpha02

6 במרץ 2024

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

שינויים ב-API

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

תיקוני באגים

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

גרסה 1.3.0-alpha01

21 בפברואר 2024

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

תכונות חדשות

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

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

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

שינויים ב-API

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

תיקוני באגים

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

גרסה 1.2

גרסה 1.2.1

6 במרץ 2024

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

תיקוני באגים

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

גרסה 1.2.0

7 בפברואר 2024

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

בעיה ידועה

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

שינויים חשובים מאז 1.1.0

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

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

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

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

גרסה 1.2.0-rc01

24 בינואר 2024

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

תיקוני באגים

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

גרסה 1.2.0-beta02

10 בינואר 2024

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

באג ידוע

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

שינויים ב-API

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

תיקוני באגים

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

גרסה 1.2.0-beta01

13 בדצמבר 2023

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

שינויים ב-API

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

תיקוני באגים

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

גרסה 1.2.0-alpha12

29 בנובמבר 2023

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

שינויים ב-API

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

גרסה 1.2.0-alpha11

15 בנובמבר 2023

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

תכונות חדשות

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

שינויים ב-API

  • מסמנים את SwipeToDismissBox DismissDirection ואת DismissValue כניסיוניים. (I517b0)
  • שינוי השם של SwipeToDismiss לשם SwipeToDismissBox. שנה את השם של background ל-backgroundContent ואת dismissContent ל-content lambda בסוף. (I7f4d3)
  • מגדירים את ה-constructor של ChipElevation ו-SelectableChipElevation כציבורי. (Ie0c48, b/308432421)
  • מתבצעת הוספה של ModalBottomSheetProperties. מתבצעת העברה של securePolicy אל ModalBottomSheetProperties. מתבצעת הוספה של isFocusable ושל shouldDismissOnBackPress אל ModalBottomSheetProperties. הבוליאני החדש האלה עוזר לקבוע כיצד גיליון תחתון של מודל צריך לטפל באירועי IME. (Iea56f, b/278216859)
  • המצבים RangeSlider ו-Slider עודכנו כדי להסיר את initialOnValueChange, את הקידומות הראשוניות ואת ה-kdocs המתאים. (I57d30)
  • צריך להוציא משימוש את המחלקה ChipBorder ואת הקריאות לפונקציות שמשויכות אליה. במקום זאת, מומלץ להשתמש ישירות ב-BorderStroke. (I89cc2)
  • ממשקי ה-API של הסבר קצר בסיסי הם עכשיו @ExperimentalFoundationApi. (I30b0b)
  • TabRow ו-ScrollableTabRow כבר לא הוצאו משימוש. הווריאנטים הראשיים והמשניים החדשים מסומנים כניסיוניים. (I0def6)
  • צ'יפים של סינון וסינון משתמשים עכשיו ישירות ב-BorderStroke. (I07a8d)
  • SegmentedButton משתמש עכשיו ישירות ב-BorderStroke. (I89b9b)
  • שינו את השם של הפונקציה AlertDialog הגנרית ל-BasicAlertDialog ומוציאים משימוש את הפונקציה הקודמת. (Idbe52)
  • שינוי השם של SwipeToDismiss ממשקי ה-API ל-SwipeDismiss וקידום ממשקי ה-API החדשים של SwipeDismiss ליציבות. (I14cbe)
  • הוספה של tonalElevation ו-shadowElevation להסבר קצר על ממשקי API. בנוסף, אנחנו מעבירים את ממשקי ה-API של TooltipBox, PlainTooltip ו-RichTooltip חזרה לגרסה ניסיונית כי הם שוחררו בטעות כיציבים. (If0f66, b/293939035)
  • קידום ממשקי API ניסיוניים של צ'יפים ניסיוניים ליציבות. (Iea2c3)
  • הוסרה ההערה @ExperimentalMaterial3Api מהכרטיסים שניתן ללחוץ עליהם ב-Material3. (I88dbf)

תיקוני באגים

  • תוקנה בעיה שבה SwipeToDismiss קרס בתרחישים מסוימים עם פריסות Lookahead ופריסות מוטמעות של Lookahead. (Ica8d1, b/297226562)

גרסה 1.2.0-alpha10

18 באוקטובר 2023

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

שינויים ב-API

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

תיקוני באגים

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

גרסה 1.2.0-alpha09

4 באוקטובר 2023

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

שינויים ב-API

  • הועברו ModalNavigationDrawer ו-DismissibleNavigationDrawer לשימוש בממשקי API חדשים של AnchoredDraggable. הפרמטר animateTo של DrawerState הוחלף בשיטות הפתיחה והסגירה, וההיסט חשוף עכשיו כצף במקום כאובייקט מצב. אפשר לגשת לקיזוז ישירות דרך currentOffset. (I0a72c)
  • נוספו פונקציות שאינן קומפוזביליות כדי ליצור ישירות DatePickerState ו-DateRangePickerState. אפשר להשתמש בפונקציות האלה כחלופה לפונקציות הקומפוזביליות rememberDatePickerState ו-rememberDateRangePickerState כשיש צורך. (I70326, b/291524052)
  • לגרסה TabRows הקבועה ולגלילה יש עכשיו וריאציות ראשיות ומשניות. הרכיבים האלה ממופים בצורה נכונה להתנהגות הצבע והאינדיקטור כפי שמוגדרים ב-Material3.
  • PrimaryScrollableTabRow ו-SecondaryScrollableTabRow חושפים עכשיו את מצב הגלילה. (Iec8f5, b/260572337)
  • הוספת פרמטר sheetMaxWidth חדש שהמפתחים יכולים להגדיר, כדי לציין רוחב מקסימלי שהגיליון יתפרש. אפשר להעביר את Dp.Unspecified עבור הפרמטר, אם רוצים לקבל גיליון שמתפרש על פני כל רוחב המסך. (Ifb7c9, b/266697696)
  • הוספת ממשקי ה-API PlainTooltipBox ו-RichTooltipBox כשיטות שהוצאו משימוש. (I246fa)

תיקוני באגים

  • תיקון קריסה כשה-DatePicker מופעל באמצעות DatePickerFormatter, שכולל שלדים מסוימים של תאריכים שנשארים ללא שינוי כשממירים לתבניות תאריך (כמו YY). (I01f29)

גרסה 1.2.0-alpha08

20 בספטמבר 2023

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

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

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

שינויים ב-API

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

תיקוני באגים

  • הסרת את השימוש בrememberSaveable כדי לקבל הסברים קצרים. (Icc131, b/299500338)
  • הוספנו סימון זמני כדי לקבוע אם צריך למדוד את הצאצאים של Scaffold במהלך המדידה או במהלך ההצבה. כברירת מחדל, המדד הזה יימדד במדידה. אם נתקלת בבעיות שקשורות להתנהגות החדשה, אפשר לדווח על בעיה. (I0b354)
  • בוצע תיקון אופקי מקצה לקצה ב-BottomSheet על ידי שימוש במדידה הנכונה של רוחב המסך במכשיר. (I1df0c, b/299058752)
  • תוקן באג שגרם לכך ש-ModalBottomSheet לא שלח קריאה אל onDismissedRequest בזמן סגירה על ידי החלקה למטה בגיליון. (Idfdd8)

גרסה 1.2.0-alpha07

6 בספטמבר 2023

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

תכונות חדשות

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

שינויים ב-API

  • SliderState מטמיעים את DraggableState (I9b116)
  • משנים את הצורה לפרמטר נדרש. שינוי השם של position ל-index בפונקציה ליצירת צורות. (I34941)
  • היא מעדכנת את DatePicker formatWithSkeleton כך שתכלול מפה שמשמשת כמטמון לשיפור הביצועים. (I3195f)
  • הוספנו את BasicTooltipBox אל compose.foundation, ועדכנו את PlainTooltipBox ואת RichTooltipBox לשימוש ב-TooltipBox עם תכנים קומפוזביליים חדשים של PlainTooltip ו-RichTooltip. (I79e1d)

תיקוני באגים

  • dynamicLightColorScheme ו-dynamicDarkColorScheme מחזירים עכשיו צבעי Chroma גבוהים יותר לתפקידים של פני השטח ו-surfaceContainer. (I5e901)
  • תוקנה בעיה שבה רכיבים מסוימים שמשתמשים בתת-רכיב (למשל BottomSheetScaffold) בתוך פיגם בתוך LookaheadScope ניסו לקרוא את הגודל שלהם מוקדם מדי. (I297b4, I871f1, b/295536718)

גרסה 1.2.0-alpha06

23 באוגוסט 2023

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

תיקוני באגים

  • בוצע תיקון של חישוב offset של DropdownMenu, כך שהקיזוזים של x תלויים אך ורק בכיוון הפריסה המקומי, והקיזוזים של y לא יבוטלו יותר כשהתפריט נמצא קרוב לתחתית המסך. (Iccc74, b/294103942)
  • בוצע תיקון של חישוב offset של DropdownMenu, כך שהקיזוזים של x תלויים אך ורק בכיוון הפריסה המקומי, והקיזוזים של y לא יבוטלו יותר כשהתפריט נמצא קרוב לתחתית המסך. (Ib87a2, b/294103942)

גרסה 1.2.0-alpha05

9 באוגוסט 2023

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

שינויים ב-API

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

גרסה 1.2.0-alpha04

26 ביולי 2023

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

תכונות חדשות

  • ממשק API ניסיוני של לחצן מפולח (Ifc8fb)
  • למפרידים יש עכשיו פרמטר שקובע את הכיוון ותומך בקווים מפרידים אנכיים. (I4c899, b/288438593)

שינויים ב-API

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

תיקוני באגים

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

גרסה 1.2.0-alpha03

21 ביוני 2023

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

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

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

תכונות חדשות

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

שינויים ב-API

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

תיקוני באגים

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

גרסה 1.2.0-alpha02

24 במאי 2023

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

שינויים ב-API

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

תיקוני באגים

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

גרסה 1.2.0-alpha01

10 במאי 2023

androidx.compose.material3:material3:1.2.0-alpha01 ו-androidx.compose.material3:material3-window-size-class:1.2.0-alpha01 שוחררו. גרסה 1.2.0-alpha01 מכילה את התחייבויות אלה.

גרסה 1.1

גרסה 1.1.2

20 בספטמבר 2023

androidx.compose.material3:material3:1.1.2 ו-androidx.compose.material3:material3-window-size-class:1.1.2 שוחררו. גרסה 1.1.2 כוללת את ההתחייבויות האלה.

תיקוני באגים

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

גרסה 1.1.1

21 ביוני 2023

androidx.compose.material3:material3:1.1.1 ו-androidx.compose.material3:material3-window-size-class:1.1.1 שוחררו. גרסה 1.1.1 כוללת את ההתחייבויות האלה.

תיקוני באגים

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

גרסה 1.1.0

10 במאי 2023

androidx.compose.material3:material3:1.1.0 ו-androidx.compose.material3:material3-window-size-class:1.1.0 שוחררו. גרסה 1.1.0 כוללת את ההתחייבויות האלה.

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

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

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

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

בפוסט הזה בבלוג אפשר לקרוא פרטים נוספים.

גרסה 1.1.0-rc01

19 באפריל 2023

androidx.compose.material3:material3:1.1.0-rc01 ו-androidx.compose.material3:material3-window-size-class:1.1.0-rc01 שוחררו. גרסה 1.1.0-rc01 מכילה את ההתחייבויות האלה.

שינויים ב-API

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

גרסה 1.1.0-beta02

5 באפריל 2023

androidx.compose.material3:material3:1.1.0-beta02 ו-androidx.compose.material3:material3-window-size-class:1.1.0-beta02 שוחררו. גרסה 1.1.0-beta02 מכילה את התחייבויות אלה.

שינויים ב-API

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

תיקוני באגים

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

גרסה 1.1.0-beta01

22 במרץ 2023

androidx.compose.material3:material3:1.1.0-beta01 ו-androidx.compose.material3:material3-window-size-class:1.1.0-beta01 שוחררו. גרסה 1.1.0-beta01 מכילה את התחייבויות אלה.

שינויים ב-API

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

תיקוני באגים

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

גרסה 1.1.0-alpha08

8 במרץ 2023

androidx.compose.material3:material3:1.1.0-alpha08 ו-androidx.compose.material3:material3-window-size-class:1.1.0-alpha08 שוחררו. גרסה 1.1.0-alpha08 מכילה את התחייבויות אלה.

תכונות חדשות

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

שינויים ב-API

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

תיקוני באגים

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

גרסה 1.1.0-alpha07

22 בפברואר 2023

androidx.compose.material3:material3:1.1.0-alpha07 ו-androidx.compose.material3:material3-window-size-class:1.1.0-alpha07 שוחררו. גרסה 1.1.0-alpha07 מכילה את התחייבויות אלה.

תכונות חדשות

  • צריך להוסיף תוכן קומפוזבילי עם קלט זמן שפועל עם rememberTimePickerState(), הוא תואם למפרט של M3 לקלט זמן (Ia4fab)
  • הוספנו Material 3 DateRangePicker API לבחירת טווח תאריכים. (I7a6c3, b/267194809)
  • נוספה תמיכה במצב קלט של Material 3 לבחירת טווחי תאריכים באמצעות ה-API של DateRangePicker. (Ifdbc4)
  • עכשיו אפשר להתאים אישית את הצבעים של שדות הטקסט:
    • הצבעים של השדה להזנת הקלט והטקסט של ה-placeholder, על סמך המיקוד ומצב השגיאה. השם של הפרמטר textColor השתנה ל-unfocusedTextColor, והשם של הפרמטר placeholderColor השתנה ל-unfocusedPlaceholderColor.
    • צבע המאגר של שדות טקסט שמולאו על סמך מצב שגיאה עם הפרמטר errorContainerColor החדש.
  • הצבעים של שדות הטקסט בתפריט הנפתח החשופים עודכנו בפרמטרים כדי לתמוך ב-API החדש של הקידומת והסיומת. (I9c8b4, b/254284181, b/264766350)

שינויים ב-API

  • ביטול של חלק מהגרסאות של Slider API והסרת עומסי יתר מיותרים של פס הזזה שמכוסה על ידי ה-Slider הניסיוני החדש, עם אגודל ונתיב מותאמים אישית. אנחנו מקדמים את RangeSlider כדי לשמור על יציבות. (Ie8fbd)
  • השם של defaultElevation השתנה בפונקציות הגובה של הצ'יפ ל-elevation. (I0f872)
  • ממשקי ה-API הבאים של שדות הטקסט ב-Material 3 כבר לא ניסיוניים: TextField, OutlinedTextField, textFieldWithLabelPadding, textFieldWithoutLabelPadding, outlinedTextFieldPadding. (Ieb5c0, b/261561819)
  • TimePickers is24Hour משתמש בהגדרת המערכת (I18856)
  • הערה ניסיונית הוסרה מ-Scaffold API. (Ibb51e, b/261565765, b/261436953)

תיקוני באגים

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

גרסה 1.1.0-alpha06

8 בפברואר 2023

androidx.compose.material3:material3:1.1.0-alpha06 ו-androidx.compose.material3:material3-window-size-class:1.1.0-alpha06 שוחררו. גרסה 1.1.0-alpha06 מכילה את התחייבויות אלה.

תכונות חדשות

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

שינויים ב-API

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

גרסה 1.1.0-alpha05

26 בינואר 2023

androidx.compose.material3:material3:1.1.0-alpha05 ו-androidx.compose.material3:material3-window-size-class:1.1.0-alpha05 שוחררו. גרסה 1.1.0-alpha05 מכילה את התחייבויות אלה.

תכונות חדשות

  • DatePickerDialog ותמיכה בנגישות
  • 'אהבתי' וטראק בהתאמה אישית נוספו אל RangeSlider.

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

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

גרסה 1.1.0-alpha04

11 בינואר 2023

androidx.compose.material3:material3:1.1.0-alpha04 ו-androidx.compose.material3:material3-window-size-class:1.1.0-alpha04 שוחררו. גרסה 1.1.0-alpha04 מכילה את התחייבויות אלה.

תכונות חדשות

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

שינויים ב-API

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

תיקוני באגים

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

בעיה ידועה

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

גרסה 1.1.0-alpha03

7 בדצמבר 2022

androidx.compose.material3:material3:1.1.0-alpha03 ו-androidx.compose.material3:material3-window-size-class:1.1.0-alpha03 שוחררו. גרסה 1.1.0-alpha03 מכילה את התחייבויות אלה.

שינויים ב-API

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

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

  • Compose UI ו-Compose Material תלויים עכשיו במחזור החיים 2.5.1. (I05ab0, b/258038814)

גרסה 1.1.0-alpha02

9 בנובמבר 2022

androidx.compose.material3:material3:1.1.0-alpha02 ו-androidx.compose.material3:material3-window-size-class:1.1.0-alpha02 שוחררו. גרסה 1.1.0-alpha02 מכילה את התחייבויות אלה.

שינויים ב-API

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

תיקוני באגים

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

גרסה 1.1.0-alpha01

24 באוקטובר 2022

androidx.compose.material3:material3:1.1.0-alpha01 ו-androidx.compose.material3:material3-window-size-class:1.1.0-alpha01 שוחררו. גרסה 1.1.0-alpha01 מכילה את התחייבויות אלה.

תיקוני באגים

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

גירסה 1.0

גרסה 1.0.1

9 בנובמבר 2022

androidx.compose.material3:material3:1.0.1 ו-androidx.compose.material3:material3-window-size-class:1.0.1 שוחררו. גרסה 1.0.1 כוללת את ההתחייבויות האלה.

תיקוני באגים

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

גרסה 1.0.0

24 באוקטובר 2022

androidx.compose.material3:material3:1.0.0 ו-androidx.compose.material3:material3-window-size-class:1.0.0 שוחררו. גרסה 1.0.0 מכילה את ההתחייבויות האלה.

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

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

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

רכיבים בעיצוב חדשני 3

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

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

  • בפוסט הזה בבלוג אפשר לקרוא פרטים נוספים.

גרסה 1.0.0-rc01

5 באוקטובר 2022

androidx.compose.material3:material3:1.0.0-rc01 ו-androidx.compose.material3:material3-window-size-class:1.0.0-rc01 שוחררו. גרסה 1.0.0-rc01 מכילה את ההתחייבויות האלה.

שינויים ב-API

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

גרסה 1.0.0-beta03

21 בספטמבר 2022

androidx.compose.material3:material3:1.0.0-beta03 ו-androidx.compose.material3:material3-window-size-class:1.0.0-beta03 שוחררו. גרסה 1.0.0-beta03 מכילה את התחייבויות אלה.

שינויים ב-API

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

תיקוני באגים

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

גרסה 1.0.0-beta02

7 בספטמבר 2022

androidx.compose.material3:material3:1.0.0-beta02 ו-androidx.compose.material3:material3-window-size-class:1.0.0-beta02 שוחררו. גרסה 1.0.0-beta02 מכילה את התחייבויות אלה.

שינויים ב-API

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

תיקוני באגים

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

גרסה 1.0.0-beta01

24 באוגוסט 2022

androidx.compose.material3:material3:1.0.0-beta01 ו-androidx.compose.material3:material3-window-size-class:1.0.0-beta01 שוחררו. גרסה 1.0.0-beta01 מכילה את התחייבויות אלה.

הפניית API

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

שינויים ב-API

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

גרסה 1.0.0-alpha16

10 באוגוסט 2022

androidx.compose.material3:material3:1.0.0-alpha16 ו-androidx.compose.material3:material3-window-size-class:1.0.0-alpha16 שוחררו. גרסה 1.0.0-alpha16 מכילה את התחייבויות אלה.

תכונות חדשות

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

שינויים ב-API

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

גרסה 1.0.0-alpha15

27 ביולי 2022

androidx.compose.material3:material3:1.0.0-alpha15 ו-androidx.compose.material3:material3-window-size-class:1.0.0-alpha15 שוחררו. גרסה 1.0.0-alpha15 מכילה את התחייבויות אלה.

תכונות חדשות

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

שינויים ב-API

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

תיקוני באגים

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

גרסה 1.0.0-alpha14

29 ביוני 2022

androidx.compose.material3:material3:1.0.0-alpha14 ו-androidx.compose.material3:material3-window-size-class:1.0.0-alpha14 שוחררו. גרסה 1.0.0-alpha14 מכילה את התחייבויות אלה.

תכונות חדשות

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

שינויים ב-API

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

תיקוני באגים

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

גרסה 1.0.0-alpha13

1 ביוני 2022

androidx.compose.material3:material3:1.0.0-alpha13 ו-androidx.compose.material3:material3-window-size-class:1.0.0-alpha13 שוחררו. גרסה 1.0.0-alpha13 מכילה את התחייבויות אלה.

שינויים ב-API

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

גרסה 1.0.0-alpha12

18 במאי 2022

androidx.compose.material3:material3:1.0.0-alpha12 ו-androidx.compose.material3:material3-window-size-class:1.0.0-alpha12 שוחררו. גרסה 1.0.0-alpha12 מכילה את התחייבויות אלה.

תיקוני באגים

  • לתבנית ההורה של פס ההזזה יכול להיות עכשיו רוחב של 0. (b/231707291)

גרסה 1.0.0-alpha11

11 במאי 2022

androidx.compose.material3:material3:1.0.0-alpha11 ו-androidx.compose.material3:material3-window-size-class:1.0.0-alpha11 שוחררו. גרסה 1.0.0-alpha11 מכילה את התחייבויות אלה.

תכונות חדשות

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

שינויים ב-API

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

תיקוני באגים

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

גרסה 1.0.0-alpha10

20 באפריל 2022

androidx.compose.material3:material3:1.0.0-alpha10 ו-androidx.compose.material3:material3-window-size-class:1.0.0-alpha10 שוחררו. גרסה 1.0.0-alpha10 מכילה את התחייבויות אלה.

תכונות חדשות

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

שינויים ב-API

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

תיקוני באגים

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

גרסה 1.0.0-alpha09

6 באפריל 2022

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

תכונות חדשות

  • נוסף ממשק API של Material 3 Switch (I2c3ad)

שינויים ב-API

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

גרסה 1.0.0-alpha08

23 במרץ, 2022

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

תכונות חדשות

שינויים ב-API

  • הוספה של מחיצת ברירת מחדל לתפריט (I01374)
  • פרמטר של צבע surfaceTint נוסף למחלקה ColorScheme. (I2f558)

תיקוני באגים

  • תיקון בלחצן Material3 כדי לקרוא את ערך ברירת המחדל של סגנון הטקסט מתוך MaterialTheme. (Ie62fc)

גרסה 1.0.0-alpha07

9 במרץ 2022

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

שינויים ב-API

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

תיקוני באגים

  • עדכונים ל-Card API בעקבות שינויים בפלטפורמת המסך API (I3c8b9)

גרסה 1.0.0-alpha06

23 בפברואר 2022

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

שינויים ב-API

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

תיקוני באגים

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

גרסה 1.0.0-alpha05

9 בפברואר 2022

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

תכונות חדשות

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

שינויים ב-API

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

תיקוני באגים

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

גרסה 1.0.0-alpha04

26 בינואר, 2022

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

שינויים ב-API

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

תיקוני באגים

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

גרסה 1.0.0-alpha03

12 בינואר, 2022

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

תיקוני באגים

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

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

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

גרסה 1.0.0-alpha02

1 בדצמבר 2021

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

תכונות חדשות

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

שינויים ב-API

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

תיקוני באגים

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

גרסה 1.0.0-alpha01

27 באוקטובר 2021

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

תכונות חדשות

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

רכיבים בעיצוב חדשני 3

לקבלת מידע נוסף, עיינו בקטע Material Design 3 ו-Material You במדריך Material Design בקטע 'כתיבה'.