หน้านี้ได้รับการแปลโดย Cloud Translation API

Compose Material 3

เอกสารอ้างอิง API
androidx.compose.material3
(ดูเอกสารอ้างอิง API สำหรับแพ็กเกจ Compose ทั้งหมด)

สร้าง UI ของ Jetpack Compose ด้วยคอมโพเนนต์ Material Design 3 ซึ่งเป็นวิวัฒนาการขั้นถัดไปของ Material Design Material 3 มีการอัปเดตธีมและคอมโพเนนต์ รวมถึงฟีเจอร์การปรับเปลี่ยนในแบบของคุณของ Material You เช่น สีแบบเปลี่ยนอัตโนมัติ และออกแบบมาให้สอดคล้องกับสไตล์ภาพและ UI ของระบบ Android 12 ใหม่

อัปเดตล่าสุด	รุ่นที่เสถียร	รุ่นที่อาจได้รับการเผยแพร่	รุ่นเบต้า	รุ่นอัลฟ่า
22 ตุลาคม 2025	1.4.0	-	-	1.5.0-alpha07

โครงสร้าง

Compose คือการรวมรหัสกลุ่ม Maven 7 รายการภายใน androidx แต่ละกลุ่ม มีฟังก์ชันการทำงานย่อยที่กำหนดเป้าหมาย ซึ่งแต่ละกลุ่มมีชุดหมายเหตุประจำรุ่นของตัวเอง

ตารางนี้อธิบายกลุ่มและลิงก์ไปยังชุดหมายเหตุประจำรุ่นแต่ละชุด

กลุ่ม	คำอธิบาย
compose.animation	สร้างภาพเคลื่อนไหวในแอปพลิเคชัน Jetpack Compose เพื่อยกระดับประสบการณ์ของผู้ใช้
compose.compiler	แปลงฟังก์ชัน @Composable และเปิดใช้การเพิ่มประสิทธิภาพด้วยปลั๊กอินคอมไพเลอร์ Kotlin
compose.foundation	เขียนแอปพลิเคชัน Jetpack Compose ด้วยองค์ประกอบพื้นฐานที่พร้อมใช้งาน และขยายรากฐานเพื่อสร้างชิ้นส่วนระบบการออกแบบของคุณเอง
compose.material	สร้าง UI ของ Jetpack Compose ด้วยคอมโพเนนต์ Material Design ที่พร้อมใช้งาน ซึ่งเป็นจุดแรกเข้าของ Compose ในระดับที่สูงขึ้น ออกแบบมาเพื่อจัดหาคอมโพเนนต์ที่ตรงกับคอมโพเนนต์ที่อธิบายไว้ที่ www.material.io
compose.material3	สร้าง UI ของ Jetpack Compose ด้วยคอมโพเนนต์ Material Design 3 ซึ่งเป็นวิวัฒนาการขั้นถัดไปของ Material Design Material 3 มีการอัปเดตธีมและคอมโพเนนต์ รวมถึงฟีเจอร์การปรับเปลี่ยนในแบบของคุณของ Material You เช่น สีแบบเปลี่ยนอัตโนมัติ และออกแบบมาให้สอดคล้องกับสไตล์ภาพและ UI ของระบบ Android 12 ใหม่
compose.runtime	องค์ประกอบพื้นฐานของรูปแบบการเขียนโปรแกรมและการจัดการสถานะของ Compose รวมถึงรันไทม์หลักสำหรับปลั๊กอินคอมไพเลอร์ Compose เพื่อกำหนดเป้าหมาย
compose.ui	องค์ประกอบพื้นฐานของ Compose UI ที่จำเป็นต่อการโต้ตอบกับอุปกรณ์ ซึ่งรวมถึงเลย์เอาต์ การวาด และอินพุต

การประกาศทรัพยากร Dependency

หากต้องการเพิ่มการอ้างอิงใน Compose คุณต้องเพิ่มที่เก็บ Maven ของ Google ลงในโปรเจ็กต์ อ่านข้อมูลเพิ่มเติมได้ที่ที่เก็บ Maven ของ Google

เพิ่มทรัพยากร Dependency สำหรับอาร์ติแฟกต์ที่ต้องการในไฟล์ build.gradle สำหรับ แอปหรือโมดูล

Groovy

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

android {
    buildFeatures {
        compose true
    }

    composeOptions {
        kotlinCompilerExtensionVersion = "1.1.1"
    }

    kotlinOptions {
        jvmTarget = "1.8"
    }
}

Kotlin

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

android {
    buildFeatures {
        compose = true
    }

    composeOptions {
        kotlinCompilerExtensionVersion = "1.1.1"
    }

    kotlinOptions {
        jvmTarget = "1.8"
    }
}

ดูข้อมูลเพิ่มเติมเกี่ยวกับการพึ่งพาได้ที่เพิ่มการพึ่งพาบิลด์

ความคิดเห็น

ความคิดเห็นของคุณช่วยเราปรับปรุง Jetpack ให้ดียิ่งขึ้น โปรดแจ้งให้เราทราบหากพบปัญหาใหม่หรือมี ไอเดียในการปรับปรุงไลบรารีนี้ โปรดดูปัญหาที่มีอยู่ ในไลบรารีนี้ก่อนสร้างปัญหาใหม่ คุณสามารถโหวตปัญหาที่มีอยู่ได้โดย คลิกปุ่มดาว

สร้างปัญหาใหม่

ดูข้อมูลเพิ่มเติมได้ในเอกสารประกอบของเครื่องมือติดตามปัญหา

Compose Material3 Common เวอร์ชัน 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 ได้

ชุดสีโทนเดียว
- TonalPalette
ไอคอน
- Icon
ขนาดเป้าหมายการสัมผัส
- LocalMinimumInteractiveComponentSize

Compose Material3 Adaptive Navigation Suite เวอร์ชัน 1.0

หมายเหตุ: ตั้งแต่เวอร์ชัน 1.0.0-alpha07 เป็นต้นไป ระบบจะเผยแพร่แพ็กเกจ androidx.compose.material3:material3-adaptive-navigation-suite เป็นส่วนหนึ่งของแพ็กเกจ Compose Material3 (Material3 เวอร์ชัน 1.3.0-*) ด้วยเหตุนี้ การกำหนดเวอร์ชันชุดการนำทางแบบปรับได้ของ Compose Material3 จึงเปลี่ยนจาก 1.0.0-xxxx เป็น 1.3.0-xxxx หากต้องการดูบันทึกประจำรุ่นและการคอมมิตของชุดการนำทางปัจจุบันและในอนาคต โปรดดู Compose Material3 เวอร์ชัน 1.3.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)

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)

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

ทำให้NavigationSuiteItemColorsตัวสร้างเป็นแบบสาธารณะ (Ica83a, b/324886877)

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 มีคอมมิตเหล่านี้

การอัปเดตการขึ้นต่อกัน

อัปเดตทรัพยากร Dependency แบบปรับได้ของ Material3 เป็นเส้นทางโมดูลใหม่ (Ibc421)
ย้ายข้อมูลไปใช้คลาสขนาดหน้าต่างเวอร์ชัน Window Manager (I3794d)

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 ขึ้น และระบบจะสร้าง MutableInteractionSource ภายในคอมโพเนนต์หากจำเป็น การเปลี่ยนเป็น null จะทำให้คอมโพเนนต์บางอย่างไม่จัดสรร MutableInteractionSource และทำให้คอมโพเนนต์อื่นๆ สร้างอินสแตนซ์เมื่อจำเป็นเท่านั้น ซึ่งจะช่วยปรับปรุงประสิทธิภาพในคอมโพเนนต์เหล่านี้ หากไม่ได้ใช้ MutableInteractionSource ที่ส่งไปยังคอมโพเนนต์เหล่านี้ เราขอแนะนำให้ส่งค่าเป็น null แทน นอกจากนี้ เราขอแนะนำให้คุณทำการเปลี่ยนแปลงที่คล้ายกันในคอมโพเนนต์ของคุณเองด้วย (I41abb, b/298048146)

13 ธันวาคม 2023

androidx.compose.material3:material3-adaptive-navigation-suite:1.0.0-alpha02 androidx.compose.material3:material3-adaptive-navigation-suite-android:1.0.0-alpha02 และ androidx.compose.material3:material3-adaptive-navigation-suite-desktop:1.0.0-alpha02 ออกอากาศแล้ว เวอร์ชัน 1.0.0-alpha02 มีคอมมิตเหล่านี้

ฟีเจอร์ใหม่

เพิ่ม "ไม่มี" NavigationSuiteType (If8cb1, b/313688598)

การแก้ไขข้อบกพร่อง

แก้ไขคอมโพเนนต์การนำทางที่เติมทั้งหน้าจอเมื่อพื้นผิวรูทมี modifier.fillMaxSize (c9cf250, b/312664933)

15 พฤศจิกายน 2023

androidx.compose.material3:material3-adaptive-navigation-suite:1.0.0-alpha01 ได้รับการเผยแพร่แล้ว เวอร์ชัน 1.0.0-alpha01 มีคอมมิตต่อไปนี้

ฟีเจอร์ใหม่

NavigationSuiteScaffold
- NavigationSuiteScaffoldLayout
- NavigationSuite

Compose Material3 Adaptive เวอร์ชัน 1.0

เวอร์ชัน 1.0.0-alpha06

7 กุมภาพันธ์ 2024

androidx.compose.material3:material3-adaptive:1.0.0-alpha06 androidx.compose.material3:material3-adaptive-android:1.0.0-alpha06 และ androidx.compose.material3:material3-adaptive-desktop:1.0.0-alpha06 ออกอากาศแล้ว เวอร์ชัน 1.0.0-alpha06 มีคอมมิตเหล่านี้

ฟีเจอร์ใหม่

เพิ่มตัวเลือกลักษณะการทำงานเพิ่มเติมสำหรับการThreePaneScaffoldNavigatorนำทางย้อนกลับ (I858aa)
เพิ่มเนื้อหาปลายทางที่ไม่บังคับลงในประวัติการนำทาง (Ibd7e6)

เวอร์ชัน 1.0.0-alpha05

24 มกราคม 2024

androidx.compose.material3:material3-adaptive:1.0.0-alpha05 androidx.compose.material3:material3-adaptive-android:1.0.0-alpha05 และ androidx.compose.material3:material3-adaptive-desktop:1.0.0-alpha05 ออกอากาศแล้ว เวอร์ชัน 1.0.0-alpha05 มีคอมมิตต่อไปนี้

ฟีเจอร์ใหม่

รองรับการรับรู้ประวัติในการนำทางโครงร่างและการคำนวณมูลค่า (I71d46)

เวอร์ชัน 1.0.0-alpha04

10 มกราคม 2024

androidx.compose.material3:material3-adaptive:1.0.0-alpha04 androidx.compose.material3:material3-adaptive-android:1.0.0-alpha04 และ androidx.compose.material3:material3-adaptive-desktop:1.0.0-alpha04 ออกอากาศแล้ว เวอร์ชัน 1.0.0-alpha04 มีคอมมิตเหล่านี้

ฟีเจอร์ใหม่

เพิ่มการรองรับแบบขอบถึงขอบในโครงร่างของบานหน้าต่าง (I1b462)

การเปลี่ยนแปลง API

ย้ายพร็อพเพอร์ตี้ขอบเขตบานพับในท่าทางไปยังรายการข้อมูลบานพับ (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

PaneScaffoldDirective

API โครงสร้างบานหน้าต่างแบบปรับได้ Material3

API พื้นฐานของโครงสร้างบานหน้าต่าง

Compose Material3 เวอร์ชัน 1.5

เวอร์ชัน 1.5.0-alpha07

22 ตุลาคม 2025

androidx.compose.material3:material3-*:1.5.0-alpha07 ได้รับการเผยแพร่แล้ว เวอร์ชัน 1.5.0-alpha07 มีการเปลี่ยนแปลงเหล่านี้

การเปลี่ยนแปลง API

ปรับปรุง SearchBar.InputField ด้วยพารามิเตอร์ keyboardOptions ซึ่งช่วยให้ป้อนข้อความได้อย่างมีประสิทธิภาพโดยการระบุตัวเลือกแป้นพิมพ์และพารามิเตอร์ lineLimits ที่ช่วยให้ระบุการเลื่อนการตัดข้อความได้ (Id08a4, b/416991049)

การแก้ไขข้อบกพร่อง

แก้ไขข้อบกพร่องในแถบเลื่อนที่การโต้ตอบด้วยการกดไม่เกิดขึ้นเมื่อแตะลง การเปลี่ยนแปลงนี้ช่วยให้มั่นใจได้ว่าระบบจะปล่อย PressInteraction.Press ทันทีใน awaitFirstDown ซึ่งจะให้ความคิดเห็นแบบภาพทันที (If9e25, b/308501482)
แก้ไขปัญหาเกี่ยวกับเครื่องหมายแคร์ต Tooltip ไม่เปลี่ยนทิศทางเมื่อเลื่อน ตอนนี้ TooltipBox จะทริกเกอร์การจัดองค์ประกอบใหม่ทุกครั้งที่ป๊อปอัปเคล็ดลับเครื่องมือสลับด้าน เพื่อให้มั่นใจว่าทิศทางของแคร์เร็ตจะอัปเดตอย่างถูกต้อง (I5ad1e, b/438875827)

เวอร์ชัน 1.5.0-alpha06

8 ตุลาคม 2025

androidx.compose.material3:material3-*:1.5.0-alpha06 ได้รับการเผยแพร่แล้ว เวอร์ชัน 1.5.0-alpha06 มีการเปลี่ยนแปลงเหล่านี้

การเปลี่ยนแปลง API

เพิ่มสีที่เลื่อนสำหรับ AppBarWithSearch แล้ว นอกจากนี้ ตอนนี้สีคอนเทนเนอร์ของช่องป้อนข้อมูลแถบค้นหาจะโปร่งใสโดยค่าเริ่มต้น สีคอนเทนเนอร์เริ่มต้นของแถบค้นหาจะไม่เปลี่ยนแปลง (I4fe32)
เพิ่ม Composable ตัวบ่งชี้การล้นเริ่มต้นไปยัง FloatingToolbar (I6a6f8, b/415833723)
อัปเดต isExpanded เป็น isShowing สำหรับ API เมนูในกลุ่มปุ่ม (I86309, b/412419514)
อัปเดต initialIsExpanded เป็น initialIsShowing และเพิ่มตัวบ่งชี้การล้นเริ่มต้นที่ใช้ร่วมกันได้ใน ButtonGroupDefaults (I6e67c, b/412419514)
นำฟีเจอร์ลากเพื่อปรับขนาดออกจาก API สาธารณะ (Ic85ba, b/437953743, b/442636084)

การแก้ไขข้อบกพร่อง

แก้ไขลำดับโฟกัสของการไปยังส่วนต่างๆ ในแป้นพิมพ์ด้วยปุ่ม และแก้ไขสำหรับ RTL ด้วย (Ibba27, b/422220597)
แก้ไขการนำทางด้วยคีย์บอร์ดในตารางการเลือกปีของเครื่องมือเลือกวันที่ (I02363, b/422425720, b/446814683)
แก้ไขการไปยังส่วนต่างๆ ด้วยแป้นพิมพ์สำหรับตารางการเลือกวันที่ในเครื่องมือเลือกวันที่ (I594ef, b/422220597, b/422223115)
แก้ไขแถบเครื่องมือที่อยู่นอกหน้าจอซึ่งรับโฟกัสแป้นพิมพ์ (I01a73, b/422786812)
แก้ไขการนำทางด้วยแป้นพิมพ์สำหรับ RangeSlider และแถบเลื่อน (Ib6bcf, b/424845268, b/422942624)

เวอร์ชัน 1.5.0-alpha04

10 กันยายน 2025

androidx.compose.material3:material3-*:1.5.0-alpha04 ได้รับการเผยแพร่แล้ว เวอร์ชัน 1.5.0-alpha04 มีการเปลี่ยนแปลงเหล่านี้

ฟีเจอร์ใหม่

เพิ่มโอเวอร์โหลดที่Textสามารถคอมโพสได้ซึ่งยอมรับColorProducerแลมบ์ดาที่ช่วยให้เปลี่ยนสีได้อย่างมีประสิทธิภาพโดยไม่ต้องทริกเกอร์การคอมโพสใหม่ทั้งหมด (I9ff25, b/407055128)

การเปลี่ยนแปลง API

เปลี่ยนชื่อ Scrim() เป็น LevitatedPaneScrim() และซ่อนพร็อพเพอร์ตี้ของคลาส Levitated และ Reflowed (I090e1, b/427953101)
ซ่อน calculatePosture() API เป็นภายใน (Ie7227, b/424442112)
เปิดเผย PaneScaffoldHorizontalOrder เป็น API สาธารณะที่ปิดผนึก (Ia4ebe)
ทําเครื่องหมาย API ที่เกี่ยวข้องกับขนาดหน้าต่างและท่าทางเป็นแบบทดลอง (I4ee96)

การแก้ไขข้อบกพร่อง

แก้ไขลำดับการไปยังส่วนต่างๆ ด้วยแป้นพิมพ์เพื่อให้โฟกัสย้ายจากปุ่ม FAB ไปยังรายการแรกที่ด้านบน (Icaaa1, b/422762939)
ปรับปรุงแป้นพิมพ์ของลิ้นชักการนำทางให้เข้าถึงได้ง่าย: ลิ้นชักจะโฟกัสไม่ได้อีกต่อไปเมื่อปิดแล้ว สามารถปิดผ่านแป้น Esc และเนื้อหาของลิ้นชักจะได้รับโฟกัสเมื่อเปิด (Idb995, b/422793544, b/422793651, b/422797424)
ตอนนี้หน้าปัดนาฬิกาของตัวเลือกเวลาจะตอบสนองต่อการไปยังส่วนต่างๆ/การป้อนข้อมูลด้วยแป้นพิมพ์แล้ว (I9d5d9, b/425710631)
ใช้ Anchor เริ่มต้นใหม่เมื่อรายการ Anchor การขยายแผงมีการเปลี่ยนแปลง (I91cd1, b/438829477)

เวอร์ชัน 1.5.0-alpha03

27 สิงหาคม 2025

androidx.compose.material3:material3-*:1.5.0-alpha03 ได้รับการเผยแพร่แล้ว เวอร์ชัน 1.5.0-alpha03 มีการเปลี่ยนแปลงเหล่านี้

การเปลี่ยนแปลงพฤติกรรม

เราได้ปรับขนาดช่องทำเครื่องหมายและสีของตัวบ่งชี้ให้สอดคล้องกับข้อกำหนดแล้ว เราได้เพิ่มฟีเจอร์ isCheckboxStylingFixEnabled เพื่อช่วยในการย้ายข้อมูลเพื่อลดการหยุดชะงักของ UI โปรดเปิดใช้ด้วยตนเองในแอป เราจะนำฟีเจอร์นี้ออกในเวอร์ชันอนาคต (I5bcd3, b/304300693)

การเปลี่ยนแปลง API

เพิ่มพารามิเตอร์ contentPadding สำหรับ TopAppBar (Ia5fea)
เพิ่มการลบล้างคอมโพเนนต์สำหรับโครงร่างชุดการนำทาง (I85312)

การแก้ไขข้อบกพร่อง

ตอนนี้ระบบได้ใช้พารามิเตอร์ containerColor ใน TimePickerDialog อย่างถูกต้องแล้ว ซึ่งช่วยให้ปรับแต่งสีพื้นหลังของกล่องโต้ตอบได้ (I47f89, b/403183883)
แถบนำทางแบบโมดัลจะไม่สูญเสียโฟกัสเมื่อยุบ และจะปิดเมื่อกดแป้น ESC (4255257)
Snackbar มีลำดับการโฟกัสแป้นพิมพ์ที่ถูกต้องสำหรับปุ่มการดำเนินการและปุ่มปิดแล้ว และปุ่มปิดยังรองรับการแสดงเคล็ดลับเครื่องมือด้วย (11fa13d)

เวอร์ชัน 1.5.0-alpha02

13 สิงหาคม 2025

androidx.compose.material3:material3-*:1.5.0-alpha02 ได้รับการเผยแพร่แล้ว เวอร์ชัน 1.5.0-alpha02 มีการเปลี่ยนแปลงเหล่านี้

การเปลี่ยนแปลง API

ใน PullToRefreshDefaults เราได้เปลี่ยนชื่อ shape เป็น indicatorShape และ containerColor เป็น indicatorContainerColor รวมถึงเพิ่ม indicatorMaxDistance สำหรับใช้เป็นตัวบ่งชี้ (Ib6cbe)
นำแท็กการเลิกใช้งานออกจาก PullToRefreshDefaults.indicatorColor (Iaaee2)
เพิ่ม AppBarWithSearch แทนที่ TopSearchBar และรองรับไอคอนการนำทาง/การดำเนินการ (I213a5)

การแก้ไขข้อบกพร่อง

แก้ไขข้อบกพร่องที่การกดกลับอัปเดตออฟเซ็ตลิ้นชักไม่ถูกต้อง (I85624, b/427778135)
SwipeToDismissBox จะกลับไปใช้ targetValue ที่แก้ไขแล้วหากไม่มีจุดยึดอื่นๆ BottomSheetScaffold จะกลับไปใช้ targetValue แบบขยายหากไม่มี Anchor อื่น (I73d5e, b/428856426)
แก้ไขระยะห่างจากขอบของปุ่มใน AlertDialog เมื่อซ้อนกันในแนวตั้ง (Ia2118)
[FAB] แก้ไขข้อบกพร่องที่ FAB ยังคงคลิกได้หลังจากที่ Modifier.animateFloatingActionButton ซ่อน (I8ea6c, b/430336834)
[แถบเลื่อน] แก้ไขการนำทางด้วยแป้นพิมพ์สำหรับแถบเลื่อน (I3a405)

เวอร์ชัน 1.5.0-alpha01

30 กรกฎาคม 2025

androidx.compose.material3:material3-*:1.5.0-alpha01 ได้รับการเผยแพร่แล้ว เวอร์ชัน 1.5.0-alpha01 มีการเปลี่ยนแปลงเหล่านี้

ฟีเจอร์ใหม่

เพิ่มผู้ให้บริการตำแหน่งสำหรับเคล็ดลับเครื่องมือ เพื่อให้นักพัฒนาแอปควบคุมได้ว่าเคล็ดลับเครื่องมือจะอยู่เหนือ ใต้ ซ้าย หรือขวาของจุดยึด เพิ่ม API ที่รับ Shape สำหรับแคร์เร็ต เพื่อให้ระบุรูปร่างที่กำหนดเองได้มากขึ้น (Ie513c)

การเปลี่ยนแปลง API

TextFieldColors ตอนนี้เมธอดในการคำนวณสีของคอมโพเนนต์ตามสถานะเป็นแบบสาธารณะแล้ว (I03165)
นำการระงับคำอธิบายประกอบออกจากแฮนเดิลการเรียกกลับของ onDismiss แล้ว (Ie3166)
DatePickerState.getDisplayedMonth(): YearMonth? และ DateRangePickerState.getDisplayedMonth(): YearMonth? ได้รับการอัปเดตให้แสดงผลค่าที่กำหนดให้เป็น Null ไม่ได้ (Ice09c, b/427952972)
นำ ModalWideNavigationRailDefaults ออก ย้ายเนื้อหาไปยัง WideNavigationRailDefaults และเปลี่ยนชื่อที่เกี่ยวข้องกับรูปร่าง (Ic5e61)
WideNavigationRailItemสีและข้อความของฟังก์ชันที่เลิกใช้งานแล้วควรมีระดับเป็น "ซ่อน" (Id7e82)
เปลี่ยนระดับของ WideNavigationRail API ที่เลิกใช้งานแล้วเป็นคำเตือนและทำให้เป็นแบบทดลอง (I89085)

การแก้ไขข้อบกพร่อง

ช่วยให้ DatePicker จัดรูปแบบตัวเลขตามภาษาของตัวเอง ก่อนหน้านี้ หากมีการกำหนดค่า DatePicker สำหรับภาษาอาหรับ ระบบอาจแสดงตัวเลขละตินอย่างไม่ถูกต้องหากภาษาของระบบในอุปกรณ์ใช้ระบบตัวเลขอื่น (Iccf76, b/432616196)
แก้ไขปัญหา LinearProgressIndicator ที่ไม่ได้แสดงตัวบ่งชี้การหยุดอย่างถูกต้องในเลย์เอาต์ RTL (I0734c)
PrimaryScrollableTabRowและSecondaryScrollableTabRow ตอนนี้ขยายไปจนถึงขนาดเต็มหน้าจอแล้ว แม้ว่าเนื้อหาแท็บจะไม่ได้ขยายไปจนสุดหน้าจอก็ตาม (Ic1e9c, b/261741384)

Compose Material3 เวอร์ชัน 1.4

เวอร์ชัน 1.4.0

24 กันยายน 2025

androidx.compose.material3:material3-*:1.4.0 ได้รับการเผยแพร่แล้ว เวอร์ชัน 1.4.0 มีการคอมมิตเหล่านี้

การเปลี่ยนแปลงที่สำคัญตั้งแต่เวอร์ชัน 1.3.0:

ประกาศการเปลี่ยนแปลงคลัง

androidx.compose.material.iconsไม่แนะนําให้ใช้ไลบรารีในการแสดงไอคอน Material ใน Compose อีกต่อไป เนื่องจาก Material Symbols เป็นวิธีใหม่ในการใช้งาน เราได้หยุดเผยแพร่การอัปเดตไลบรารีนี้แล้ว และได้นำไลบรารีนี้ออกจากการเผยแพร่ไลบรารี Material 3 ล่าสุดแล้ว คุณยังคงอ้างอิงไลบรารีนี้ด้วยตนเองได้หากยังย้ายข้อมูลไม่ได้

เราขอแนะนำให้ดาวน์โหลดไฟล์ XML ของ Vector Drawable จากแท็บ Android ของ https://fonts.google.com/icons แทน เพื่อเข้าถึงไอคอนที่มีสไตล์ล่าสุดอย่าง Material Symbols

ทำไมเราจึงไม่แนะนำไลบรารีอีกต่อไป ไลบรารีไอคอน ("ไอคอน Material") ได้รับการแทนที่ด้วยรูปลักษณ์ใหม่ของสัญลักษณ์ Material แล้ว และเราพบว่าไลบรารีนี้อาจเพิ่มเวลาในการสร้างแอปของคุณอย่างมาก เนื่องจากมีไอคอนต่างๆ ทั้งหมดซึ่งอาจไม่จำเป็น

ดูข้อมูลเพิ่มเติมได้ที่ https://developer.android.com/develop/ui/compose/graphics/images/material

การเปลี่ยนแปลงลักษณะการทำงาน

ไลบรารีนี้จะไม่เพิ่มทรัพยากร Dependency ไปยัง material-icons-core อีกต่อไป ดังนั้นหากโปรเจ็กต์ของคุณใช้ทรัพยากร Dependency นั้น คุณจะต้องเพิ่มทรัพยากร Dependency นั้นอย่างชัดเจนในไฟล์ build.gradle[.kts] (I735ff, b/349894318)
NavigationBarItem และ NavigationRailItem จะเปลี่ยนสีป้ายกำกับที่ใช้งานอยู่จาก onSurface เป็นสีรองเพื่อปรับปรุงความสามารถในการใช้งาน คอนทราสต์ของสี และปรับปรุงความสอดคล้องกันภายในระบบ (Ibc297) หากต้องการเปลี่ยนกลับไปใช้ลักษณะการทำงานก่อนหน้า ให้คัดลอกสีเริ่มต้นและเปลี่ยน selectedTextColor เป็น MaterialTheme.colorScheme.onSurface
ตอนนี้คอมโพเนนต์ Material 3 ใช้ MotionScheme ใหม่เพื่อกำหนดการเคลื่อนไหวแล้ว (Ie0f93)
การเปลี่ยนแปลงการเคลื่อนไหวของตัวบ่งชี้ความคืบหน้าแบบวงกลมที่ไม่แน่นอน (I3c07e)

คอมโพเนนต์ Material Design 3 ใหม่

HorizontalCenteredHeroCarousel
VerticalDragHandle
ช่องข้อความที่ปลอดภัยสำหรับช่องป้อนรหัสผ่าน
- SecureTextField
- OutlinedSecureTextField

การปรับปรุงคอมโพเนนต์ Material Design 3 ที่มีอยู่

ตอนนี้ข้อความรองรับ autoSize
- ข้อความที่มี string
- ข้อความที่มี annotatedString
เพิ่มตัวตกแต่ง Material 3 สำหรับ BasicTextField2
- Textfield
- OutlineTextfield
เพิ่ม TimePickerDialog API ที่ใช้กับ TimePicker, TimeInput หรือมีเวอร์ชันที่สลับได้
API แถบค้นหาใหม่
- ตอนนี้แถบค้นหาที่ยุบและ "มุมมอง" การค้นหาที่ขยายจะแยกเป็น Composable ต่างหาก
- SearchBar แสดงแถบค้นหาในสถานะที่ยุบอยู่
- ExpandedFullScreenSearchBar และ ExpandedDockedSearchBar แสดงถึงแถบค้นหาในสถานะขยาย ซึ่งจะเปิดในหน้าต่างใหม่
- SearchBarState เพื่อควบคุมสถานะของแถบค้นหา
เลื่อนระดับ API ทดลองเป็น API ที่เสถียรแล้ว
ปรับปรุงประสิทธิภาพ

เวอร์ชัน 1.4.0-rc01

10 กันยายน 2025

androidx.compose.material3:material3-*:1.4.0-rc01 ได้รับการเผยแพร่แล้ว เวอร์ชัน 1.4.0-rc01 มีการเปลี่ยนแปลงเหล่านี้

เวอร์ชัน 1.4.0-beta03

27 สิงหาคม 2025

androidx.compose.material3:material3-*:1.4.0-beta03 ได้รับการเผยแพร่แล้ว เวอร์ชัน 1.4.0-beta03 มีการเปลี่ยนแปลงเหล่านี้

เวอร์ชัน 1.4.0-beta02

13 สิงหาคม 2025

androidx.compose.material3:material3-*:1.4.0-beta02 ได้รับการเผยแพร่แล้ว เวอร์ชัน 1.4.0-beta02 มีการเปลี่ยนแปลงเหล่านี้

การเปลี่ยนแปลงการขึ้นต่อกัน

นำการขึ้นต่อกันของ graphics-shapes ออก (I219e0, b/436230765)

การเปลี่ยนแปลง API

ใน PullToRefreshDefaults เราได้เปลี่ยนชื่อ shape เป็น indicatorShape และ containerColor เป็น indicatorContainerColor รวมถึงเพิ่ม indicatorMaxDistance สำหรับใช้เป็นตัวบ่งชี้ (Ib6cbe)
นำแท็กการเลิกใช้งานออกจาก PullToRefreshDefaults.indicatorColor (Iaaee2)
BasicAlertDialogOverrideScope ได้รับการเลื่อนขั้นเป็นเวอร์ชันเสถียรโดยไม่ตั้งใจ และมีการนำคำอธิบายประกอบเวอร์ชันทดลองออกใน aosp/3701846 ทำเครื่องหมายว่าเป็นการเข้าชมภายใน โดยจะยังคงเป็นเวอร์ชันทดลองแบบสาธารณะใน 1.5.0-alpha (I9182a)

การแก้ไขข้อบกพร่อง

แก้ไขข้อบกพร่องที่การกดกลับอัปเดตออฟเซ็ตลิ้นชักไม่ถูกต้อง (I85624, b/427778135)

เวอร์ชัน 1.4.0-beta01

30 กรกฎาคม 2025

androidx.compose.material3:material3-*:1.4.0-beta01 ได้รับการเผยแพร่แล้ว เวอร์ชัน 1.4.0-beta01 มีการเปลี่ยนแปลงเหล่านี้

การเปลี่ยนแปลงที่ส่งผลกับส่วนอื่นในระบบ

เราได้นำ API สาธารณะทั้งหมดที่ติดแท็ก ExperimentalMaterial3ExpressiveApi หรือ ExperimentalMaterial3ComponentOverrideApi ออกแล้ว โปรดเปลี่ยนไปใช้ 1.5.0-alpha เพื่อใช้ฟีเจอร์เหล่านี้ต่อไป (Ie4ae0)
โปรดทราบว่าเราจะเปลี่ยนชื่อ pullToRefresh API ที่เสถียรต่อไปนี้ในรุ่นถัดไป (Ib6cbe)

ฟีเจอร์ใหม่

Tooltip ตอนนี้รองรับรูปร่างเคอร์เซอร์ที่กำหนดเองและตำแหน่งเคอร์เซอร์ที่กำหนดเอง (เหนือ ใต้ ซ้าย หรือขวาของจุดยึด) แล้ว (Ie513c)

การเปลี่ยนแปลง API

นำการระงับคำอธิบายประกอบออกจากแฮนเดิลการเรียกกลับของ onDismiss แล้ว (Ie3166)
DatePickerState.getDisplayedMonth(): YearMonth? และ DateRangePickerState.getDisplayedMonth(): YearMonth? ได้รับการอัปเดตให้แสดงผลค่าที่กำหนดให้เป็น Null ไม่ได้ (Ice09c, b/427952972)
นำ ModalWideNavigationRailDefaults ออก ย้ายเนื้อหาไปยัง WideNavigationRailDefaults และเปลี่ยนชื่อที่เกี่ยวข้องกับรูปร่าง (Ic5e61)

การแก้ไขข้อบกพร่อง

ช่วยให้ DatePicker จัดรูปแบบตัวเลขตามภาษาของตัวเอง ก่อนหน้านี้ หากมีการกำหนดค่า DatePicker สำหรับภาษาอาหรับ ระบบอาจแสดงตัวเลขละตินอย่างไม่ถูกต้องหากภาษาของระบบในอุปกรณ์ใช้ระบบตัวเลขอื่น (Iccf76, b/432616196)
แก้ไขปัญหา LinearProgressIndicator ที่ไม่ได้แสดงตัวบ่งชี้การหยุดอย่างถูกต้องในเลย์เอาต์ RTL (I0734c)
PrimaryScrollableTabRowและSecondaryScrollableTabRow ตอนนี้ขยายไปจนถึงขนาดเต็มหน้าจอแล้ว แม้ว่าเนื้อหาแท็บจะไม่ได้ขยายไปจนสุดหน้าจอก็ตาม (Ic1e9c, b/261741384)

เวอร์ชัน 1.4.0-alpha18

16 กรกฎาคม 2025

androidx.compose.material3:material3-*:1.4.0-alpha18 ได้รับการเผยแพร่แล้ว เวอร์ชัน 1.4.0-alpha18 มีการเปลี่ยนแปลงเหล่านี้

ฟีเจอร์ใหม่

ModalBottomSheetProperties ตอนนี้มีตัวเลือกในการปิดใช้ dismissRequest จากการคลิกขอบดำแล้ว (I8e715)
เพิ่มการรองรับ trackCornerSize ลงในแทร็กของ RangeSlider (Iec529)

การเปลี่ยนแปลง API

กำหนดให้ railExpanded เป็นพารามิเตอร์ที่จำเป็นสำหรับ WideNavigationRailItem เพิ่ม modalContentColor สำหรับ WideNavigationRailColors และย้าย WideNavigationRailDefaults.modalContainerShape ไปยัง ModalWideNavigationRailDefaults.containerShape (Id60c5)
ย้ายพารามิเตอร์ฟังก์ชันสีใหม่ของ WideNavigationRail ไปไว้สุดท้ายและเลิกใช้งานฟังก์ชันเก่า (Iac7f7)
PullToRefresh ตอนนี้เป็น API ที่เสถียรแล้ว (I18537)
การอัปเดต DatePickers API เราได้นำวันที่สิ้นสุดเริ่มต้นที่เป็นค่าว่างสำหรับ DateRangePicker ออกแล้ว และกำหนดให้ต้องส่งวันที่สิ้นสุด นอกจากนี้ เรายังได้ชี้แจงการใช้งานการแสดงวันที่ในเอกสารประกอบ API ในเวลาเที่ยงคืน UTC และทำเครื่องหมายตัวรับและตัวตั้งค่าล่าสุดที่ใช้ java.time API เป็นเวอร์ชันทดลองในตอนนี้ (I121b3, b/427952972)
เลื่อนระดับ API พารามิเตอร์ไอคอน tint: ColorProducer จากเวอร์ชันทดลองเป็นเวอร์ชันที่ไม่ใช่เวอร์ชันทดลอง (Ia0133)
นำคำอธิบายประกอบเวอร์ชันทดลองออกจาก DatePicker, DateRangePicker รวมถึงสถานะ คลาส และประเภทที่รองรับ (I0e4e0, b/391848485)
เปลี่ยนค่าที่โฟกัสได้เริ่มต้นเป็น 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 เพื่อสังเกตสถานะที่ชำระแล้วแทนสถานะปัจจุบัน คืนค่าลักษณะการทำงานที่มีอยู่ซึ่งจะปิดใช้ลักษณะการทำงานของ Anchor เมื่อคอมโพเนนต์อยู่ในสถานะที่ถูกปิดเท่านั้น (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 ลงใน Composable ของ Carousel (I1d4d2)
ตอนนี้คุณดู currentItem ของภาพสไลด์ได้จาก CarouselState แล้ว (Ie87e9)

การแก้ไขข้อบกพร่อง

แก้ไขปัญหาที่รูปร่างที่กำหนดเองใน FAB ซึ่งส่งไปยัง FloatingToolbar ไม่ได้ใช้เงาอย่างถูกต้อง (Icdcc9, b/423336922)
ตอนนี้แคร์รอสเซลทั้งหมดใช้บทบาทเชิงความหมายของแคร์รอสเซลโดยค่าเริ่มต้น (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 ซึ่งจำเป็นต่อการใช้ข้อกำหนดของ Material อย่างถูกต้องสำหรับแถบแอปด้านบน (I92ce4)
เพิ่มเมธอดใน TooltipScope เพื่อรับ layoutCoordinates ของ Anchor เลิกใช้งานเมธอด drawCaret เนื่องจากนักพัฒนาแอปสามารถใช้วิธีใหม่นี้เพื่อรับขอบเขตของจุดยึด layoutCoordinates และสร้างรูปร่างที่เหมาะสมซึ่งมีเครื่องหมายแคร์เร็ตได้ (Ia2e12, b/329470609)
เพิ่มการรองรับ java.time สำหรับเครื่องมือเลือกวันที่: เปิดตัวการโอเวอร์โหลด rememberDatePickerState/rememberDateRangePickerState ที่ยอมรับออบเจ็กต์ java.time (เช่น LocalDate เริ่มต้น YearMonth) นอกจากนี้ยังเพิ่มฟังก์ชันส่วนขยายในออบเจ็กต์สถานะเพื่อรับ/ตั้งค่าโดยใช้ประเภทต่างๆ เช่น LocalDate และ YearMonth ต้องใช้ API 26 ขึ้นไปหรือ Desugaring (I70f29, b/266202516, b/281859606)
เพิ่ม CenteredTrack ที่ประกอบได้เพื่อให้ใช้แถบเลื่อนกับแทร็กที่เริ่มจากตรงกลาง (I5b1d6)

การแก้ไขข้อบกพร่อง

ปรับปรุงประสิทธิภาพของตัวบ่งชี้ความคืบหน้าแบบหยัก: ตอนนี้ประเภทเชิงเส้นโหลดเร็วขึ้นประมาณ 8.5% โดยมีการจัดสรรน้อยลงประมาณ 11% ในขณะที่ประเภทวงกลมมีความเร็วเพิ่มขึ้นอย่างมากประมาณ 47% และมีการจัดสรรลดลงประมาณ 39% (I595d8)

เวอร์ชัน 1.4.0-alpha13

23 เมษายน 2025

androidx.compose.material3:material3-*:1.4.0-alpha13 ได้รับการเผยแพร่แล้ว เวอร์ชัน 1.4.0-alpha13 มีการเปลี่ยนแปลงเหล่านี้

การเปลี่ยนแปลง API

isAppearanceLightStatusBars และ isAppearanceLightNavigationBars ได้รับการนำกลับมาใช้ใน ModalBottomSheetProperties อีกครั้งในฐานะพารามิเตอร์สำหรับ Android เท่านั้น (Id4bc0)
เพิ่ม AppBarRow ที่ประกอบได้ซึ่งจัดการรายการที่ล้นออกมานอกขอบเขต (I742bd)
อัปเดต API DatePicker และ DateRangePicker เพื่อขอโฟกัสเมื่อเปลี่ยนเป็นโหมดป้อนวันที่ เราได้แทนที่requestFocusพารามิเตอร์บูลีนด้วยfocusRequesterพารามิเตอร์ที่ไม่บังคับซึ่งใช้FocusRequester (I14b69)
นำแหล่งที่มาของตัวแก้ไขและการโต้ตอบออกจากรายการที่คลิกได้และสลับได้เริ่มต้น ให้ใช้เป็นรายละเอียดการใช้งานแทน (I95ed6)
อัปเดต ButtonGroup ให้แสดงเป็นเมนูแบบเลื่อนลงเมื่อมีปุ่มมากเกินกว่าจะแสดงบนหน้าจอ (I7b88b)

การแก้ไขข้อบกพร่อง

ตอนนี้ Bottomsheet จะใช้ Inset ด้านบนเมื่อมีขนาดเล็กกว่าออฟเซ็ตปัจจุบัน ซึ่งจะช่วยให้ผู้ใช้ระบุระยะขอบด้านบนสำหรับการทำงานที่ขยายได้ ตอนนี้ BottomSheetDefaults.windowInsets มี WindowInsets.safeDrawing.Top แล้ว (I0ab67, b/321877275, b/336962418, b/342093067)
เปิดใช้ภาพเคลื่อนไหวเข้า/ออก (จาง/เลื่อน) สำหรับไอคอน/อวาตาร์นำหน้าของชิปและไอคอนต่อท้ายเมื่อมีการเพิ่มหรือนำออก ซึ่งส่วนใหญ่จะมีประโยชน์ต่อชิปที่เลือกได้ (ตัวกรอง อินพุต) แต่ก็ใช้ได้โดยทั่วไป (I9af21)
แก้ไขลักษณะการทำงานของแถบเลื่อน RTL ที่ใช้งานไม่ได้ซึ่งเกิดจาก LookaheadScope (Ieb152, b/408118041)
แก้ไขข้อขัดข้องที่ด้านล่าง AppBar ซึ่งเกี่ยวข้องกับการเลื่อนด้วย UI ของระบบที่ซ่อนอยู่ (Ic6140, b/405996228)

เวอร์ชัน 1.4.0-alpha12

9 เมษายน 2025

androidx.compose.material3:material3-*:1.4.0-alpha12 ได้รับการเผยแพร่แล้ว เวอร์ชัน 1.4.0-alpha12 มีการเปลี่ยนแปลงเหล่านี้

การเปลี่ยนแปลง API

นำพารามิเตอร์เฉพาะของ Android ออกจาก ModalBottomSheetProperties (Iab97f, b/362539765)
เปิดตัวฟังก์ชันการโอเวอร์โหลดสำหรับค่าเริ่มต้นของขนาดแฮนเดิลการลาก (I0ed0d)
เพิ่มฟังก์ชัน NavigationSuiteScaffold และ NavigationSuiteScaffoldLayout ใหม่เพื่อรองรับเลย์เอาต์ประเภทใหม่ และเพิ่มการรองรับเนื้อหาการกระทำหลักที่ไม่บังคับ (Ib262a, b/353144478)
เลิกใช้งาน Modifier.weight โดยมีพารามิเตอร์การแสดงโฆษณาที่เรียกใช้ใน ButtonGroup การเพิ่มเวอร์ชันที่ไม่มีการแสดงโฆษณา (Id32bb)
เปลี่ยนชื่อค่าเริ่มต้นของคอมโพเนนต์ xSmall- และ xLarge- IconButton เป็น extra (Ib6e0f)
เพิ่มฟังก์ชัน NavigationSuite, NavigationSuiteItem และ NavigationSuiteColors ใหม่เพื่อรองรับเลย์เอาต์ประเภทใหม่ (I203d6)
เพิ่มฟังก์ชันใหม่ NavigationSuiteTypes และเพิ่มฟังก์ชันใหม่ navigationSuiteType ที่มีตัวเลือกเลย์เอาต์เหล่านั้น (If68f9)

การแก้ไขข้อบกพร่อง

ColorScheme.contentColorFor ตอนนี้จะแมป surfaceDim กับ onSurface (I8891a)
อัปเดตการติดตั้งใช้งาน DateInputTextField เพื่อแก้ไขปัญหาที่ช่องป้อนข้อมูลไม่แสดงวันที่ที่ตั้งค่าแบบเป็นโปรแกรม (I6c8d1, b/401143451)
แก้ไขลำดับโฟกัสของ TalkBack สำหรับแถบนำทางและแถบนำทางแบบกว้าง (I6cf6f, b/407048224)

เวอร์ชัน 1.4.0-alpha11

26 มีนาคม 2025

androidx.compose.material3:material3-*:1.4.0-alpha11 ได้รับการเผยแพร่แล้ว เวอร์ชัน 1.4.0-alpha11 มีการเปลี่ยนแปลงเหล่านี้

การเปลี่ยนแปลง API

อัปเดตการใช้อักษรตัวพิมพ์สำหรับพร็อพเพอร์ตี้ที่ประกอบได้ในออบเจ็กต์เริ่มต้นสำหรับปุ่มและปุ่มเปิด/ปิด เพิ่มวิธีการใน ToggleButtonDefaults และ ButtonDefaults สำหรับระยะห่างภายใน รูปร่าง ขนาดไอคอน ระยะห่างไอคอน และรูปแบบข้อความของเนื้อหาแนะนำ ทั้งนี้ขึ้นอยู่กับความสูงของคอนเทนเนอร์ (Iea69e)
นำฟังก์ชันและค่าคงที่ทดลองที่เลิกใช้งานแล้วออกจาก FloatingToolbar (I8f339)
ตอนนี้คอมโพเนนต์การยกระดับใช้ส่วนติดต่อร่วมกันแล้ว และมีตัวสร้างและพร็อพเพอร์ตี้สาธารณะ (Ibb172)
การเพิ่มตัวแก้ไข animateWidth ใน ButtonGroupScope ซึ่งจะต้องใช้กับองค์ประกอบย่อยของกลุ่มปุ่มเพื่อเคลื่อนไหวองค์ประกอบย่อยอย่างถูกต้อง (Ia3bb6)

การแก้ไขข้อบกพร่อง

แก้ไขการเว้นวรรคของแถบเครื่องมือลอยเพื่อให้มั่นใจถึงความสมดุลของภาพระหว่างการยุบ และปรับปรุงความยืดหยุ่นสำหรับเนื้อหาขนาดใหญ่ (I06c00)

เวอร์ชัน 1.4.0-alpha10

12 มีนาคม 2025

androidx.compose.material3:material3-*:1.4.0-alpha10 ได้รับการเผยแพร่แล้ว เวอร์ชัน 1.4.0-alpha10 มีการเปลี่ยนแปลงเหล่านี้

การเปลี่ยนแปลง API

TabRowDefaults.tabIndicatorOffset เลิกใช้งานแล้วเพื่อใช้ TabIndicatorScope.tabIndicatorOffset แทน (Ib36b3)
แก้ไขการสะกดคำผิดสำหรับการเว้นวรรคเนื้อหาขนาดเล็กในค่าเริ่มต้นของปุ่ม (I19bfe)
เราเลิกใช้งาน TabRow และ ScrollableTabRow แล้วเพื่อเปลี่ยนไปใช้ตัวแปรหลักและรองของแต่ละรายการแทน แถวแท็บหลักและแท็บรองมีประสิทธิภาพมากขึ้นและเป็นไปตามข้อกำหนดอย่างแม่นยำ (I918e2)
เพิ่ม rememberSliderState และ rememberRangeSliderState แล้ว (I8e384)
เพิ่ม shouldAutoSnap ใน SliderState เพื่อควบคุมกลไกการสแนปอัตโนมัติ การปิดใช้กลไกนี้อาจมีประโยชน์สำหรับการเคลื่อนไหวที่กำหนดเอง (I07745)
ตอนนี้ความกว้างขั้นต่ำของแท็บในแถบแท็บที่เลื่อนได้เป็นพารามิเตอร์แล้ว ตัวแปรแถวแท็บหลักและแท็บรองไม่ใช่เวอร์ชันทดลองอีกต่อไป (If6f15, b/226665301)
ทำให้ชั้นเรียนเป็นExitAlwaysFloatingToolbarScrollBehaviorแบบสาธารณะเพื่อให้สร้างได้โดยไม่ต้องเรียบเรียง (Ibf31c)

เวอร์ชัน 1.4.0-alpha09

26 กุมภาพันธ์ 2025

androidx.compose.material3:material3-*:1.4.0-alpha09 ได้รับการเผยแพร่แล้ว เวอร์ชัน 1.4.0-alpha09 มีการคอมมิตเหล่านี้

การเปลี่ยนแปลง API

เปลี่ยนชื่อช่องการตั้งค่าของ DragHandle ในสถานะเริ่มต้น แยกสถานะที่กดและลาก และทำให้ขนาดเริ่มต้นเป็นแบบสาธารณะ (I787b9)
การอัปเดต TowRowsTopAppBar API นำexpandedพารามิเตอร์ Lambda ออกและเพิ่มพารามิเตอร์แยกต่างหากสำหรับความสูงที่ขยายและยุบ (Idd677, b/306697446, b/229134133, b/268068946)

การแก้ไขข้อบกพร่อง

ตอนนี้แถบแอปด้านล่างจะสังเกตบริการการสำรวจด้วยการสัมผัส (เช่น TalkBack) และแสดงให้เห็นทุกครั้งที่เปิดใช้บริการ (I4b34d)

เวอร์ชัน 1.4.0-alpha08

12 กุมภาพันธ์ 2025

androidx.compose.material3:material3-*:1.4.0-alpha08 ได้รับการเผยแพร่แล้ว เวอร์ชัน 1.4.0-alpha08 มีการคอมมิตเหล่านี้

ฟีเจอร์ใหม่

เพิ่ม TimePickerDialog API ที่ใช้กับ TimePicker, TimeInput หรือมีเวอร์ชันที่สลับได้ (Id2d83)
API แถบค้นหาใหม่
- ตอนนี้แถบค้นหาที่ยุบและ "มุมมอง" การค้นหาที่ขยายจะแยกออกจากกันได้แล้ว
- SearchBar แสดงแถบค้นหาในสถานะที่ยุบอยู่
- ExpandedFullScreenSearchBar และ ExpandedDockedSearchBar แสดงถึงแถบค้นหาในสถานะขยาย ซึ่งจะเปิดในหน้าต่างใหม่
- SearchBarState เพื่อควบคุมสถานะของแถบค้นหา
- TopSearchBar เพื่อเพิ่มการจัดการระยะขอบและลักษณะการเลื่อน
- การโอเวอร์โหลดใหม่ของ InputField ซึ่งใช้ SearchBarState (Ie0723, b/261496232, b/283311462, b/350916229, b/352872248)

การเปลี่ยนแปลง API

รองรับการเปลี่ยนรูปร่างมุมของปุ่มไอคอนเมื่อกด (I21843)
API ของตัวตกแต่งช่องข้อความ/กล่องตกแต่งไม่ใช่เวอร์ชันทดลองอีกต่อไป (I31d95)
เพิ่มตัวอย่างและค่าเริ่มต้นสำหรับผลิตภัณฑ์ย่อยที่เชื่อมต่อสำหรับ ButtonGroup (I5c8ce)
ทำให้พารามิเตอร์สถานะเป็นพารามิเตอร์สุดท้ายใน NavigationSuiteScaffold และ NavigationSuiteScaffoldLayout (I9cc7b)

การแก้ไขข้อบกพร่อง

เพิ่มการดำเนินการเพื่อการช่วยเหลือพิเศษที่กำหนดเองลงใน FloatingToolbars เพื่อให้บริการเพื่อการช่วยเหลือพิเศษสามารถขยายหรือยุบรูปแบบ FloatingToolbar ทั้งหมดได้แล้ว เวอร์ชันที่มี 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 นี้มีพารามิเตอร์ Stroke ที่ช่วยให้ควบคุมวิธีแสดงผลเครื่องหมายถูกและเส้นขอบช่องทําเครื่องหมายได้มากขึ้น (I65a88)
เพิ่ม TwoRowsTopAppBar API ซึ่งเป็นทางเลือกที่ปรับแต่งได้มากกว่าสำหรับแถบแอปขนาดกลางและขนาดใหญ่เพื่อสร้างแถบแอปด้านบนแบบ 2 แถว ตอนนี้ นักพัฒนาแอปสามารถควบคุมเนื้อหาของชื่อและคำบรรยายแทนเสียงได้ทั้งในสถานะยุบและขยาย โดยมีความสูงที่ปรับแต่งได้สำหรับแต่ละสถานะ (I0be3c, b/306697446, b/229134133, b/268068946)

การเปลี่ยนแปลง API

เปลี่ยนชื่อBottomAppBarรูปแบบการทดสอบเป็น FlexibleBottomAppBar เพื่อให้ควบคุมการจัดเรียงและความสูงของเนื้อหาได้มากขึ้น (Iaa448)
อัปเดตการตั้งชื่อพร็อพเพอร์ตี้ในออบเจ็กต์เริ่มต้นของกลุ่มปุ่มเป็น CapitalCase อัปเดตชื่อของ animateFraction ให้แม่นยำยิ่งขึ้นตามลักษณะการทำงานที่แสดง (I545cd)
เพิ่มโอเวอร์โหลดสำหรับปุ่มทั่วไปที่อนุญาตให้ใช้รูปร่างเคลื่อนไหวเมื่อมีการโต้ตอบด้วยการกด เพิ่มรูปร่างปุ่มที่แคชไว้แล้ว (I5ec20)
ตอนนี้คุณควบคุมวิธีที่ FloatingToolbar ที่มี FAB ตอบสนองต่อการเลื่อนได้โดยระบุ FloatingToolbarScrollBehavior สำหรับแถบเครื่องมือที่วางไว้ตามขอบตรงกลาง (เช่น ตรงกลางด้านบนหรือด้านล่าง) เราขอแนะนำให้ใช้ลักษณะการเลื่อนเพื่อซ่อนทั้งคอมโพเนนต์เมื่อเลื่อนเพื่อให้ดูสะอาดตามากขึ้น นอกจากนี้ ยังช่วยป้องกันไม่ให้ FAB ไม่อยู่ตรงกลาง ซึ่งอาจเกิดขึ้นเมื่อใช้ Flag expanded สำหรับการยุบ (I33f67)
อัปเดต TopAppBar API เวอร์ชันทดลองให้ใช้ Alignment.Horizontal แทน TopAppBarTitleAlignment ที่กำหนดเองเมื่อตั้งค่าการจัดแนวของชื่อและคำบรรยาย (I70ca2)
SliderState#onValueChange ตอนนี้เป็นแบบสาธารณะแล้วเพื่อให้ผู้ใช้ควบคุมได้มากขึ้น (I104eb)
เปิดตัว NavigationSuiteScaffoldState เพื่ออนุญาตให้ใช้ภาพเคลื่อนไหวของคอมโพเนนต์การนำทาง นอกจากนี้ ให้เพิ่มโอเวอร์โหลดของ NavigationSuiteScaffold และ NavigationSuiteScaffoldLayout ที่มีพารามิเตอร์สถานะ (I6a8c9, b/328674235)

การแก้ไขข้อบกพร่อง

ย้ายชั้นเรียน IconButtonColors และ IconToggleButtonColors จาก IconButtonDefaults.kt กลับไปที่ IconButton.kt (I3c233)

การมีส่วนร่วมภายนอก

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 ที่รองรับการแทรก และค่า WindowInsets ที่ระบุในออบเจ็กต์ค่าเริ่มต้นของคอมโพเนนต์สำหรับทั้ง Material 2 และ Material 3 หากการเปลี่ยนแปลงนี้ทำให้เกิดลักษณะการทำงานที่ไม่พึงประสงค์ ให้ระบุพารามิเตอร์ WindowInsets ด้วยตนเองในระดับคอมโพเนนต์ (I43ee9, b/362508045)

การเปลี่ยนแปลง API

การอัปเดต TopAppBar API เปลี่ยนชื่อแถบแอปด้านบนขนาดกลางและขนาดใหญ่พร้อมคำบรรยายเป็น *FlexibleTopAppBar รวมรูปแบบสีต่างๆ ไว้ในTopAppBarDefault.topAppBarColors() ฟังก์ชันเดียว และเพิ่มsubtitle พารามิเตอร์สีที่จะใช้กับ Composable ของคำบรรยายแทนเสียงที่ระบุ (I41b65)
นำ WideNavigationRailArrangement API ออกเพื่อใช้ Arrangement.Vertical (Id0341)
เพิ่ม VerticalSlider @Composable ใหม่ (I2bfba)
เพิ่มแทร็กใหม่ @Composable ที่ช่วยให้ระบุมุมแทร็กภายนอกและไอคอนแทร็กที่กำหนดเองได้ (I436a4)
อัปเดต API แถบเครื่องมือลอยเพื่อใช้ออบเจ็กต์ FloatingToolbarColors แทนสีคอนเทนเนอร์เดียว (I9a054)
เพิ่มและใช้คำอธิบายประกอบเวอร์ชันทดลองใหม่ ExperimentalMaterial3ComponentOverrideApi (Ia1eaf)
Modifier.indicatorLine จะมีรูปร่างสำหรับช่องข้อความเพื่อจัดการการตัด (I8c5f3, b/380704151)
เปลี่ยนชื่อฟังก์ชัน FloatingAppBar เวอร์ชันทดลองเป็น FloatingToolbar (I1dbf8)
เพิ่ม floatingToolbarVerticalNestedScroll ใหม่ที่แนบกับคอนเทนเนอร์ที่เลื่อนได้เพื่ออัปเดตสถานะการขยายแถบเครื่องมือลอยตามการเลื่อนที่ข้ามเกณฑ์ (I6d65f)
ขอแนะนำ API ใหม่สำหรับการสร้างแถบเครื่องมือลอยที่มีปุ่มการทำงานแบบลอย (FAB) แนบอยู่ API มีตัวเลือกการปรับแต่งที่ยืดหยุ่น ซึ่งช่วยให้คุณจัดเรียงแถบเครื่องมือในแนวนอนหรือแนวตั้ง และวาง FAB ที่จุดเริ่มต้นหรือจุดสิ้นสุดของแถบเครื่องมือได้ (I9e350)

การแก้ไขข้อบกพร่อง

แก้ไขปัญหาการช่วยเหลือพิเศษของ Snackbar ที่ทำให้ประกาศตัวเองเมื่อปิดเมื่อ TalkBack เปิดอยู่ (/I9db53)

การมีส่วนร่วมภายนอก

BasicTooltip ที่ใช้กันทั่วไปใน Foundation และ BasicTooltip/Tooltip ใน Material3 (Ifc2e6)

เวอร์ชัน 1.4.0-alpha05

12 ธันวาคม 2024

androidx.compose.material3:material3-*:1.4.0-alpha05 ได้รับการเผยแพร่แล้ว เวอร์ชัน 1.4.0-alpha05 มีการเปลี่ยนแปลงเหล่านี้

การเปลี่ยนแปลง API

แทนที่ประเภทในWideNavigationRailState.current/targetค่าสำหรับ enum เพื่อให้อ่านง่ายขึ้น (I2d6ab)
SplitButton เปลี่ยน Shape API จากคลาสข้อมูลเป็นคลาสเพื่อความเข้ากันได้แบบไบนารี (I53812)
เพิ่ม API เคล็ดลับเครื่องมือที่มีพารามิเตอร์ onDismissRequest เพื่อให้ผู้สร้างตัดสินใจได้ว่าจะเกิดอะไรขึ้นเมื่อผู้ใช้คลิกภายนอกเคล็ดลับเครื่องมือ เลิกใช้งาน API เก่าที่ไม่มีพารามิเตอร์ใหม่นี้ (I99aef)
เปลี่ยนการตั้งชื่อของ opticalCentering เป็น horizontalCenterOptically การทำให้ตัวแก้ไขเป็นภายใน แทนที่พารามิเตอร์การเพิ่มพื้นที่ด้วยออฟเซ็ตเริ่มต้นและสิ้นสุดสูงสุด (I0b904)
เปลี่ยน WideNavigationRailState ให้มีค่าปัจจุบัน/เป้าหมาย นำ Enum ออกเพื่อใช้บูลีน (Idfa29, b/356039090)
เพิ่ม NavigationBarItemComponentOverride (I3a06a)

การแก้ไขข้อบกพร่อง

แก้ไขลักษณะการทำงานของแถบแอปด้านบนและด้านล่างเพื่อให้เปลี่ยนสีได้อย่างน่าเชื่อถือเมื่อเลื่อนเนื้อหาจนสุด (Idc4e8, b/293665988)
ฟังก์ชันลักษณะการเลื่อนสำหรับแถบแอปด้านบนและด้านล่างจะแสดงลักษณะที่จดจำไว้เพื่อให้ทำงานได้ดีขึ้นในการเขียนคอมโพสซ้ำ (I0fdbe, b/207957336)
ตอนนี้พารามิเตอร์ตัวแก้ไขจะมีผลหลังจากตัวแก้ไขภายใน เช่น ลักษณะการลากและความหมาย แทนที่จะเป็นก่อน ซึ่งจะส่งผลต่อลำดับการใช้ตัวแก้ไข (I8d83f)
Bottom Sheet ที่ขยายแล้วจะยังคงขยายอยู่เมื่อมีการเปลี่ยนขนาด (I2870b, b/324934884)
กำหนดเส้นทางแฟล็กแถบสถานะและแถบนำทางอย่างถูกต้องสำหรับพร็อพเพอร์ตี้หน้าต่าง (Ie674d, b/362539765)
ย้ายพารามิเตอร์ตัวแก้ไขไปยังรูทของ Scaffold ตามที่ระบุไว้ในเอกสาร ซึ่งจะช่วยให้การติดตั้งใช้งานสอดคล้องกับ M2 (I0235e, b/372311595)

การมีส่วนร่วมภายนอก

ฟังก์ชัน DatePickerDialog ที่ใช้ร่วมกัน (I7dced)

เวอร์ชัน 1.4.0-alpha04

13 พฤศจิกายน 2024

androidx.compose.material3:material3-*:1.4.0-alpha04 ได้รับการเผยแพร่แล้ว เวอร์ชัน 1.4.0-alpha04 มีการคอมมิตเหล่านี้

การเปลี่ยนแปลงลักษณะการทำงาน

เปลี่ยนกลับการเปลี่ยนแปลงสีที่เปิดตัวใน aosp/3212478 เป็น iconButtonColors, iconToggleButtonColors, outlinedIconButtonColors, outlinedIconToggleButtonColors และ outlinedIconToggleButtonBorder ย้ายลักษณะการทำงานที่กลับมาแล้วไปไว้ในชุดฟังก์ชันใหม่ที่ชื่อ iconButtonVibrantColors และอื่นๆ เพื่อเน้นสีคอนทราสต์สูงที่แสดงผล (Iffd8d)

ฟีเจอร์ใหม่

ขอแนะนำคอมโพเนนต์ VerticalDragHandle (I6c770)

การเปลี่ยนแปลง API

เปลี่ยนชื่อ DismissibleModalWideNavigationRailDefaults เป็น ModalWideNavigationRailDefaults (I8e877)
เพิ่ม NavigationBarComponentOverrides (I8a3f3)
เพิ่ม NavigationRailComponentOverride (I83e13)
แนะนำ WideNavigationRailState เพื่อจัดการการยุบ/ขยายแถบ ให้ ModalWideNavigationRail ปิดได้ และลบ DismissibleModalWideNavigationRail (I88568)
เพิ่มค่าเริ่มต้นของขนาด xSmall, ปานกลาง, ใหญ่ และ xLarge ลงในค่าเริ่มต้นของปุ่มสลับ (Ie95d1)
เพิ่มค่าเริ่มต้นของขนาด xSmall, ปานกลาง, ใหญ่ และ xLarge ลงในค่าเริ่มต้นของปุ่ม (If8b6d)

การแก้ไขข้อบกพร่อง

อัปเดตสีไอคอนต่อท้ายของชิปตัวกรองจากสีหลักเป็น OnSurfaceContainer ตามข้อกำหนด และอัปเดตสีเส้นขอบของชิปทั้งหมดจากสีเส้นขอบเป็นสีเส้นขอบตัวแปรตามข้อกำหนด (I68bd4)

เวอร์ชัน 1.4.0-alpha03

30 ตุลาคม 2024

androidx.compose.material3:material3-*:1.4.0-alpha03 ได้รับการเผยแพร่แล้ว เวอร์ชัน 1.4.0-alpha03 มีคอมมิตเหล่านี้

การเปลี่ยนแปลง API

SheetState เลิกใช้งานตัวสร้างที่มีความหนาแน่นแล้วเพื่อใช้เกณฑ์ตำแหน่งและความเร็วแทน (Ifd16e)
เพิ่ม rememberTooltipPositionProvider ที่มีตรรกะการจัดตำแหน่งที่อัปเดตแล้ว เลิกใช้งาน rememberPlainTooltipPositionProvider และ rememberRichTooltipPositionProvider แล้ว (Ie66e2)
ModalBottomSheetProperties เพิ่มเติมช่วยให้ปรับแต่งสีของแถบสถานะและแถบนำทางได้ โดยค่าเริ่มต้นแล้ว องค์ประกอบเหล่านี้จะอัปเดตตามสีของเนื้อหาแทนที่จะเป็นสถานะธีมมืดของระบบ (Ib874e, b/362539765)
ปรับปรุงประสบการณ์การป้อนข้อมูลสำหรับเครื่องมือเลือกวันที่: เมื่ออยู่ในโหมดป้อนข้อมูล ระบบจะโฟกัสช่องข้อความวันที่เพื่อให้ป้อนข้อความได้ทันที การเปลี่ยนแปลงนี้จะเพิ่มพารามิเตอร์ requestFocus ลงใน DatePicker และ DateRangePicker คุณอาจป้องกันโฟกัสได้โดยส่ง false (I12d09, b/286399710, b/340102743)
แคชค่าเริ่มต้นของรูปร่างลงในออบเจ็กต์รูปร่าง การตั้งค่าเริ่มต้นของรูปร่าง @Composable สำหรับปุ่มเปิด/ปิด ยุบรูปร่างเป็นรูปร่างเดียวโดยค่าเริ่มต้นเนื่องจากตัวแปรชี้ไปยังไฟล์โทเค็นเดียวกัน (Iaa014)

การแก้ไขข้อบกพร่อง

เพิ่มประสิทธิภาพลักษณะการทำงานของ Scaffold contentPadding เพื่อหลีกเลี่ยงการจัดองค์ประกอบเนื้อหาของ Body ใหม่ทุกครั้งเมื่อ contentPadding มีการเปลี่ยนแปลง (I8c8e2, b/373904168)
เปลี่ยนชื่อ TextFieldLabelScope progress เป็น labelMinimizedProgress แล้ว
เปลี่ยนชื่อ TextFieldLabelPosition Default เป็น Attached แล้ว นำสมาชิกของอินเทอร์เฟซออกแล้ว (If75c6)
แก้ไขปัญหาเกี่ยวกับ DatePicker ในโหมดป้อนข้อมูลที่ข้อผิดพลาดในการตรวจสอบอาจทำให้ความสูงของคอมโพเนนต์เปลี่ยนแปลง (I2e229, b/280462363)
ทำให้แถบเลื่อนของวัสดุเปลี่ยนค่าเมื่อกดปุ่มควบคุม (I1c442)

เวอร์ชัน 1.4.0-alpha02

16 ตุลาคม 2024

androidx.compose.material3:material3-*:1.4.0-alpha02 ได้รับการเผยแพร่แล้ว เวอร์ชัน 1.4.0-alpha02 มีคอมมิตเหล่านี้

การเปลี่ยนแปลง API

อัปเดตเครื่องมือเลือกวันที่เพื่อให้แน่ใจว่ามีการใช้ภาษาอย่างสอดคล้องกันตลอดทั้ง DatePicker และ DateRangePicker เมื่อตั้งค่าภาษาโดยตรงผ่าน DatePickerState หรือ DateRangePickerState โปรดทราบว่าเมื่อตั้งค่าภาษาโดยตรงเป็นสถานะ คุณจะต้องตรวจสอบว่าข้อความชื่อและข้อความบรรทัดแรกได้รับการแปลตามนั้น เนื่องจากระบบจะยังคงใช้ข้อความเริ่มต้นตามภาษาเริ่มต้นของแพลตฟอร์ม (I37073, b/326490763, b/321657276)
SheetState.isAnimationRunning แสดงแล้ว (I9a3d7)
DatePickerColors จะมีลำดับความสำคัญเหนือกว่าสีที่ขัดแย้งกันซึ่งกำหนดไว้ในรูปแบบข้อความของ Typography ของธีมอย่างถูกต้อง นอกจากนี้ โปรดทราบว่าการอัปเดตนี้จะปรับตำแหน่งของพารามิเตอร์ color ในฟังก์ชันเครื่องมือเลือกวันที่ และเพิ่มพารามิเตอร์ contentColor สำหรับการปรับแต่งสีข้อความส่วนหัวและชื่อ (I30d03, b/347031394)
เปลี่ยนชื่อ SplitButton เป็น SplitButtonLayout และนำ API ของผลิตภัณฑ์ย่อยตามสี SplitButton ออก โดยจะใช้ผลิตภัณฑ์ย่อยโดยการนำผลิตภัณฑ์ย่อยของปุ่มที่ SplitButtonDefaults ให้มาใช้ซ้ำ (I44c36)
ModalBottomSheet ตอนนี้มีพารามิเตอร์ sheetGestureEnabled (I856cb, b/288211587)
เปลี่ยนชื่อstandardMotionSchemeและexpressiveMotionSchemeเป็น "มาตรฐาน" และ "สื่ออารมณ์" ตอนนี้คุณเข้าถึงฟังก์ชันทั้ง 2 ได้ผ่านออบเจ็กต์MotionSchemeคู่โดยการเรียกใช้ MotionScheme.standard() และ MotionScheme.expressive() (Iceccf)
เพิ่มพารามิเตอร์ maxWidth ลงในเคล็ดลับเครื่องมือแบบธรรมดาและแบบริช ค่าเริ่มต้นคือข้อกำหนดการออกแบบที่ 200 dp สำหรับเคล็ดลับเครื่องมือธรรมดา และ 320 dp สำหรับเคล็ดลับเครื่องมือที่สมบูรณ์ (I30ce9)

การแก้ไขข้อบกพร่อง

ตอนนี้ DatePicker และ DateRangePicker จะอัปเดตเดือนที่แสดงอย่างถูกต้องเมื่อตั้งค่าผ่าน displayedMonthMillis ของสถานะ (If9e47, b/333414302)
ModalBottomSheet ตอนนี้จะย้ายเนื้อหาออกจากแถบสถานะ (I5114c, b/321877275, b/336962418, b/342093067)
[Bottom Sheet] เปลี่ยนลำดับความสำคัญของแฮนเดิลการเรียกกลับเป็น PRIORITY_DEFAULT เพื่อให้แป้นพิมพ์ IME ปิดก่อน (I447fb)
แก้ไขข้อขัดข้องใน DatePicker และ DateRangePicker เมื่อตั้งค่าปีที่เลือกได้ขั้นต่ำเป็นปีในอนาคต (I78656, b/319395747)
แก้ไขปัญหาเครื่องมือเลือกวันที่เพื่ออัปเดต UI เมื่อใช้อินสแตนซ์ SelectableDates ที่อัปเดตแล้ว (Iad59a, b/290135807, b/339898760)

เวอร์ชัน 1.4.0-alpha01

2 ตุลาคม 2024

androidx.compose.material3:material3-*:1.4.0-alpha01 ได้รับการเผยแพร่แล้ว เวอร์ชัน 1.4.0-alpha01 มีการเปลี่ยนแปลงเหล่านี้

การเปลี่ยนแปลงลักษณะการทำงาน

ไลบรารีจะไม่เพิ่มทรัพยากร Dependency ไปยัง material-icons-core อีกต่อไป ดังนั้นหากโปรเจ็กต์ของคุณต้องพึ่งพาสิ่งนั้น คุณจะต้องเพิ่มทรัพยากร Dependency ดังกล่าวอย่างชัดเจนในไฟล์ 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 ที่ไม่บังคับลงในฟังก์ชัน enterAlwaysScrollBehavior ของ TopAppBar เพื่อรองรับเนื้อหาที่ตั้งค่าด้วย reverseLayout ได้ดียิ่งขึ้น (I4e0e5)
ตอนนี้ SegmentedButton รองรับอาร์กิวเมนต์ contentPadding แล้ว (I5ad91, b/358414376)
PullToRefreshState ไม่มีค่าเริ่มต้นสำหรับการติดตั้งใช้งาน isAnimating อีกต่อไป (I6a593)
เพิ่มการโอเวอร์โหลดใหม่ของ Material TextField และ OutlinedTextField ที่ใช้ TextFieldState เพิ่ม API กล่องตกแต่งที่เข้ากันได้กับ TextFieldDecorator (If13a1)
เพิ่มพารามิเตอร์เพื่อควบคุม labelPosition ของช่องข้อความ การใช้ alwaysMinimize จะช่วยให้รูปแบบ UI แสดงป้ายกำกับและตัวยึดตำแหน่งในช่องข้อความพร้อมกันได้แม้ว่าช่องจะไม่ได้โฟกัสอยู่ก็ตาม (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)

การแก้ไขข้อบกพร่อง

ใช้ดัชนีการย้ายโฟกัสที่ถูกต้องกับ ScaffoldComposables ย่อย ลำดับคือ topBar, bottomBar, fab, content, snackbar (I5936b)
แก้ไขปัญหาที่ DatePicker และ DateRangePicker ซึ่งในบางภาษาและรูปแบบโครงสร้าง องค์ประกอบวันที่บางอย่าง (เช่น ชื่อเดือน) ไม่ได้ขึ้นต้นด้วยตัวพิมพ์ใหญ่ (I1430f)
ผสานรวมโทเค็นคอมโพเนนต์ FAB และเมนู FAB (การอัปเดตภาพเล็กน้อยสำหรับระยะขอบและข้อความ) (Ib57f3)
ModalBottomSheet จะเป็นองค์ประกอบแรกในลำดับการไปยังแบบเชิงความหมาย ตามด้วยขอบมืด (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 ในโหมด RTL

เวอร์ชัน 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)
แก้ไขปัญหาเครื่องมือเลือกวันที่เพื่ออัปเดต UI เมื่อใช้อินสแตนซ์ SelectableDates ที่อัปเดตแล้ว (Iad59a, b/290135807, b/339898760)
เปลี่ยนลำดับความสำคัญของโปรแกรมเรียกกลับที่ใช้โดยชีตด้านล่างเป็น 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 ใหม่

ภาพหมุน
- HorizontalMultiBrowseCarousel และ HorizontalUncontainedCarousel การปรับปรุงคอมโพเนนต์ 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)
เพิ่มเครื่องหมายแทรกเริ่มต้นสำหรับเคล็ดลับเครื่องมือแบบริช รองรับการวาดเครื่องหมายแทรกที่กำหนดเองเมื่อระบุ Anchor 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 เล็กน้อยเพื่อให้มีสีอ่อนและสีเข้มมากขึ้นในธีมสว่างและธีมมืด (I677a5)
เลื่อนระดับ API ทดลองเป็น 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 การดึงเพื่อรีเฟรชให้เปิดใช้เป็นบูลีนแทนที่จะเป็นแลมบ์ดา รองรับการจัดแนวเนื้อหาใน PullToRefreshBox (I75679)
การทำให้ TooltipScope เป็นอินเทอร์เฟซที่ปิดผนึกและสร้างการใช้งานภายในเพื่อใช้ใน TooltipBox และ Label (I3833e)
เพิ่มตัวแก้ไขใหม่ 2 รายการลงใน CarouselItemScope - maskClip และ maskBorder - เพื่อให้เพิ่มรูปร่างและเส้นขอบไปยังรายการภาพสไลด์ได้อย่างง่ายดาย (Id67a1)
ตอนนี้ TimePickerState เป็นอินเทอร์เฟซและอนุญาตให้ตั้งเวลาได้ (I88546)
อัปเดต API สำหรับจัดรูปแบบลิงก์: ย้าย TextLinkStyles ไปยัง TextStyle และนำ TextDefaults ออกจาก Material (I5477b)

การแก้ไขข้อบกพร่อง

ModalBottomSheet ไอคอนแถบสถานะและแถบนำทางจะตอบสนองต่อสถานะธีมมืดแล้ว (Ie1fe7, b/338342149)
เพิ่มความหมายของชีตปิดลงใน ModalBottomSheetScrim (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 สำหรับรับลิงก์ที่มีธีม Material ในข้อความ โดยเฉพาะอย่างยิ่ง เราได้นำวิธีการต่างๆ ออกจาก TextDefaults สำหรับการสร้าง LinkAnnotations ที่มีธีมและแยกวิเคราะห์ HTML ด้วยลิงก์ที่มีธีม แต่ได้เพิ่มTextLinkStylesคลาสที่อนุญาตให้จัดรูปแบบลิงก์เป็นพารามิเตอร์ไปยัง Text ที่ใช้ร่วมกันได้แทน (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 เป็นค่าว่างได้ หากต้องการปิดใช้การกระเพื่อม ให้ระบุ null เป็น LocalRippleConfiguration แทนการระบุ RippleConfiguration เป็น isEnabled = false (I22725)
ModalBottomSheet วาดขอบมืดเหนือแถบสถานะได้แม่นยำยิ่งขึ้นเมื่อเปิดใช้การแสดงผลแบบขอบจรดขอบ ตอนนี้เนื้อหาของแผ่นชีตด้านล่างแบบโมดัลสามารถใช้ส่วนแทรกของหน้าต่างได้แล้ว ซึ่งจะช่วยให้เนื้อหาที่มองเห็นได้อยู่เหนือแถบนำทาง พารามิเตอร์ ModalBottomSheet windowInsets เปลี่ยนชื่อเป็น contentWindowInsets เพื่อระบุตำแหน่งที่จะใช้ Inset ซึ่งจะไม่เชื่อมโยงกับตรรกะของหน้าต่างอีกต่อไป contentWindowInsets ได้เปลี่ยนเป็นฟังก์ชันที่แสดงผล WindowInsets เพื่อให้สามารถแก้ไขได้ภายในหน้าต่างใหม่ (I39630, b/274872542, b/300280229, b/290893168)
ตอนนี้ PrimaryScrollableTabRow และ SecondaryScrollableTabRow ใช้เลย์เอาต์ที่กำหนดเองแทนการประกอบย่อย ซึ่งจะช่วยปรับปรุงประสิทธิภาพ (I991e0)
ลิงก์ข้อความมีตัวเลือกการจัดรูปแบบสถานะที่กดนอกเหนือจากการจัดรูปแบบปกติ การวางเมาส์ และการโฟกัส TextDefaults แต่ละเมธอดมีอาร์กิวเมนต์ pressedStyle เพื่อรองรับการดำเนินการดังกล่าว (Ic473f, b/139312671)

การแก้ไขข้อบกพร่อง

ตอนนี้จุดยึดการลากของลิ้นชักการนำทางจะตรงกับความกว้างของ drawerContent แล้ว (Ibc72f, b/245355396)
OutlinedTextField ตอนนี้การเว้นที่ว่างด้านบนสำหรับป้ายกำกับจะพิจารณาขนาดแบบอักษรของระบบแล้ว (Idc781)
ตำแหน่งแพ็กเกจคงที่ของ CalendarLocale (Ifa235)
[การย้อนกลับแบบคาดเดา] อัปเดตภาพเคลื่อนไหวการย้อนกลับแบบคาดเดาให้ใช้เส้นโค้งการประมาณค่าของ (0.1, 0.1, 0, 1) (I2591a)

เวอร์ชัน 1.3.0-alpha05

17 เมษายน 2024

androidx.compose.material3:material3-*:1.3.0-alpha05 ได้รับการเผยแพร่แล้ว เวอร์ชัน 1.3.0-alpha05 มีการเปลี่ยนแปลงเหล่านี้

ฟีเจอร์ใหม่

SearchBar และ DockedSearchBar มีการโอเวอร์โหลดใหม่ที่ใช้พารามิเตอร์ช่องข้อความ ซึ่งช่วยให้จัดรูปแบบช่องข้อความแยกจากส่วนอื่นๆ ของแถบค้นหา รวมถึงส่งช่องข้อความที่กำหนดเองได้ เราได้จัดเตรียมช่องข้อความของการติดตั้งใช้งานปัจจุบันเป็น SearchBarDefaults.InputField (I50c73, b/275074248, b/278773336, b/326627700)
เพิ่ม Lambda drawTick ลงใน API สาธารณะเพื่อปรับแต่งเครื่องหมายหากจำเป็น (I0c048)

การเปลี่ยนแปลง API

ลิงก์ข้อความมีตัวเลือกการจัดรูปแบบสถานะที่กดนอกเหนือจากการจัดรูปแบบปกติ การวางเมาส์ และการโฟกัส (I5f864, b/139312671)
อัปเดต CarouselItemInfo เพื่อแสดง Rect ของมาสก์ที่ใช้ตัดรายการ (I785d8)
นำ BasicTooltipState ออกจาก API สาธารณะของ Material 3 โดยจะรวมฟังก์ชันการทำงานของ TooltipState เข้ากับ BasicTooltip ของ Foundation จนกว่าจะเสถียร (Icda29)
เพิ่มออบเจ็กต์ TextDefaults ที่มีเมธอดในการสร้าง LinkAnnotation และแยกวิเคราะห์สตริงที่ติดแท็ก HTML ซึ่งใช้ MaterialTheme กับลิงก์ (I98532, b/139312671)
ExposedDropdownMenuBoxScope ไม่อนุญาตให้ใช้คลาสย่อยอีกต่อไป ตอนนี้เมนูแบบเลื่อนลงที่เปิดเผยมี MenuAnchorType ซึ่งควรส่งไปยัง menuAnchor เพื่อรองรับ a11y ได้ดียิ่งขึ้น ควรใช้พารามิเตอร์นี้แทนการส่ง focusable ไปยัง ExposedDropdownMenu ซึ่งตอนนี้เลิกใช้งานแล้ว menuAnchor มีพารามิเตอร์ใหม่เพื่อควบคุมสถานะ enabled (I55ee6, b/257209915, b/308840226)
แก้ไขสีเส้นขอบของ OutlinedButton เมื่อปิดใช้ เพิ่มButtonDefaults.outlinedButtonBorder("enabled")โอเวอร์โหลดที่ใช้สถานะที่เปิดใช้ (Ie650b, b/318461363)
เพิ่มคลาส CarouselItemInfo ใหม่เพื่อช่วยให้ลูกค้าได้รับข้อมูลเกี่ยวกับขนาดของสินค้า (I9070c)
ตอนนี้เราเลิกใช้งานตัวสร้าง ColorScheme ที่ไม่มีคอนเทนเนอร์พื้นผิวแล้ว โปรดย้ายข้อมูลไปยังตัวสร้างที่มีคอนเทนเนอร์พื้นผิว (I35c11)
[เติมขอบ]TextFieldDefaults เปลี่ยนชื่อ ContainerBox เป็น Container แล้ว (Ie8d3b)

การแก้ไขข้อบกพร่อง

BottomSheetScaffold จะไม่เลื่อนจากเลื่อนที่ซ้อนกันอีกต่อไปหาก sheetSwipeEnabled เป็นเท็จ (I5e1c1, b/306464779)
นำคำอธิบายประกอบการเลือกใช้ExperimentalMaterial3ApiบางรายการในIconButtonSamples.ktออกแล้ว (I111d1)

เวอร์ชัน 1.3.0-alpha04

3 เมษายน 2024

androidx.compose.material3:material3-*:1.3.0-alpha04 ได้รับการเผยแพร่แล้ว เวอร์ชัน 1.3.0-alpha04 มีการเปลี่ยนแปลงเหล่านี้

ฟีเจอร์ใหม่

เพิ่ม Material3 Carousel เวอร์ชันทดลอง 2 รายการ ได้แก่ HorizontalMultiBrowseCarousel และ HorizontalUncontainedCarousel (I88d64)
อัปเดตแถบนำทาง Compose M3 (ModalDrawerSheet และ DismissibleDrawerSheet) เพื่อรองรับการย้อนกลับแบบคาดการณ์ใน U+ เป็นการเลือกใช้ (Ie5b0b)
เพิ่ม API ใหม่ในไอคอนเพื่อให้ส่งการปรับสีเป็น 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)
นำ DismissDirection และ DismissValue enum และ API ที่เลิกใช้งานแล้วออก (I89ccd)
เพิ่มแท็กเวอร์ชันทดลองลงในCarouselStateออบเจ็กต์เสริมของภาพหมุน (I94154)
เลิกใช้งาน LocalMinimumInteractiveComponentEnforcement และเปิดตัว LocalMinimumInteractiveComponentSize เพื่อแทนที่ (I7a7ac)
ตอนนี้เครื่องมือสร้าง 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 composable (I9f315)
ตอนนี้เราใช้ Popup เพื่อติดตั้งใช้งาน ExposedDropdownMenu แล้ว ลักษณะการทำงานควรเหมือนกัน ยกเว้นเมนูที่โฟกัสได้ซึ่งมีช่องข้อความที่แก้ไขได้อาจปิดเมื่อพิมพ์บนแป้นพิมพ์

การแก้ไขข้อบกพร่อง

เราได้ปรับบทบาทพื้นฐานของ Surface และคอนเทนเนอร์ Surface เล็กน้อยเพื่อให้มีสีอ่อนและสีเข้มมากขึ้นในธีมสว่างและธีมมืด (I677a5)
อัปเดตสีของแถบเลื่อนและ ProgressIndicator ให้เป็นไปตามข้อกำหนดใหม่ของคอนทราสต์ที่ไม่ใช่ข้อความ (I26807)
อัปเดตการวางซ้อนสถานะโฟกัสเป็น 0.1f เพื่อให้มั่นใจว่าสีมีคอนทราสต์เพียงพอ (I7ea77)
การปรับค่าเริ่มต้นของสีพื้นผิวและสีพื้นหลังเล็กน้อยใน lightColorScheme และ darkColorScheme (I9db52)

เวอร์ชัน 1.3.0-alpha02

6 มีนาคม 2024

androidx.compose.material3:material3-*:1.3.0-alpha02 ได้รับการเผยแพร่แล้ว เวอร์ชัน 1.3.0-alpha02 มีการเปลี่ยนแปลงเหล่านี้

การเปลี่ยนแปลง API

ทำให้สถานะแถบเลื่อนเสถียรอีกครั้ง การทำให้ State.onValueChangeFinished เป็น Val อีกครั้ง การห่อ onValueChangeFinished ใน rememberUpdatedState (I82ab2, b/322269951)
ตอนนี้คอมโพเนนต์การนำทางใช้บทบาท SurfaceContainer ใหม่แล้ว ตอนนี้ DrawerDefaults มีแอตทริบิวต์ standardContainerColor และ modalContainerColor ที่แตกต่างกันแล้ว DrawerDefaults.ModalDrawerElevation เปลี่ยนชื่อเป็น 0.dp แล้ว (I7fbac)
นำ @Stable ออกจากสถานะของ Slider เนื่องจากเราจะเปลี่ยน state.onValueChangeFinished เป็น var (Ied34a, b/322269951)
ตอนนี้ModalBottomSheetและStandardBottomSheetเป็นTweenSpecแล้ว ซึ่งอัปเดตมาจากภาพเคลื่อนไหวแบบสปริง ซึ่งจะช่วยแก้ปัญหาการโอเวอร์ชูตที่มองเห็นได้ ตอนนี้เราได้นำตัวสร้างSheetStateที่เลิกใช้งานแล้วซึ่งไม่มีความหนาแน่นออกแล้ว (I7babc, b/285847707)

การแก้ไขข้อบกพร่อง

ตอนนี้คอมโพเนนต์ใช้ตัวแปร SurfaceContainer แล้ว คอมโพเนนต์ที่คำนวณสีด้วย Surface และ TonalElevation อย่างเป็นทางการจะใช้บทบาท SurfaceContainer โดยค่าเริ่มต้น ซึ่งไม่ได้รับผลกระทบจากการยกระดับโทนสี (b/304584161)
แก้ไขข้อบกพร่องที่ทำให้สีของคอนเทนเนอร์ที่ไม่ได้เลือกและปิดใช้เป็นสีดำElevatedFilterChip (I400e6, b/322407043)
แก้ไขตัวบ่งชี้ความคืบหน้าแบบไม่ระบุเวลาเมื่อความคืบหน้าเป็น 0 (Id6582)
แก้ไขปัญหาเกี่ยวกับ Slider และ RangeSlider ในเลย์เอาต์ RTL (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 มีคอมมิตเหล่านี้

ฟีเจอร์ใหม่

อัปเดต Compose M3 ModalBottomSheet เพื่อรองรับการคาดการณ์การย้อนกลับใน U+ (Iccf32, b/281967264, b/304850357)
อัปเดต Compose M3 SearchBar เพื่อรองรับการย้อนกลับที่คาดการณ์ได้ใน U+ (I657f8)
อัปเดตแถบเลื่อนเพื่อปรับปรุงการช่วยเหลือพิเศษโดยเพิ่มช่องว่างและตัวบ่งชี้การหยุด (I3058e)
อัปเดต ProgressIndicator เพื่อปรับปรุงการช่วยเหลือพิเศษโดยการเพิ่มตัวบ่งชี้ช่องว่างและตัวบ่งชี้หยุด (I21451)
การเพิ่มเครื่องหมายแคร์เร็ตเริ่มต้นสำหรับริชทูลทิป ตอนนี้ API ริชทูลทิปใหม่ช่วยให้วาดแคร์เร็ตที่กำหนดเองได้เมื่อระบุจุดยึด LayoutCoordinates (Ifd42c)

การเปลี่ยนแปลงลักษณะการทำงาน

เราได้ย้ายข้อมูลคอมโพเนนต์ Material ไปใช้ API Ripple ใหม่แล้ว และจะไม่ค้นหา RippleTheme อีกต่อไป

การเปลี่ยนแปลง API

ตอนนี้ฟีเจอร์สนุกๆ drawStopIndicator พร้อมให้ใช้งานแล้ว (I3f59f)
ทําเครื่องหมายฟังก์ชัน formatWithSkeleton ของ DatePicker เป็นภายใน (Ic65dc)
DropdownMenu ตอนนี้รองรับสี รูปร่าง ระดับความสูง และเส้นขอบที่กำหนดเองแล้ว (I8e981, b/289554448, b/301887035, b/283654243)
คอมโพเนนต์ Material3 ที่แสดง MutableInteractionSource ใน API ได้รับการอัปเดตให้แสดง MutableInteractionSource ที่อนุญาตให้เป็นค่าว่างได้ ซึ่งมีค่าเริ่มต้นเป็น null ไม่มีการเปลี่ยนแปลงเชิงความหมายที่นี่ การส่งค่า null หมายความว่าคุณไม่ต้องการยก MutableInteractionSource ขึ้น และระบบจะสร้าง MutableInteractionSource ภายในคอมโพเนนต์หากจำเป็น การเปลี่ยนเป็น null จะทำให้คอมโพเนนต์บางอย่างไม่จัดสรร MutableInteractionSource และทำให้คอมโพเนนต์อื่นๆ สร้างอินสแตนซ์เมื่อจำเป็นเท่านั้น ซึ่งจะช่วยปรับปรุงประสิทธิภาพในคอมโพเนนต์เหล่านี้ หากไม่ได้ใช้ MutableInteractionSource ที่ส่งไปยังคอมโพเนนต์เหล่านี้ เราขอแนะนำให้ส่งค่าเป็น null แทน นอกจากนี้ เราขอแนะนำให้คุณทำการเปลี่ยนแปลงที่คล้ายกันในคอมโพเนนต์ของคุณเองด้วย (I41abb, b/298048146)
เพิ่ม RippleConfiguration และ LocalRippleConfiguration เพื่ออนุญาตการปรับแต่งการกระเพื่อมต่อคอมโพเนนต์ / ทรีย่อยโดยใช้ค่าคงที่ เช่น หากต้องการเปลี่ยนสีของคอมโพเนนต์ที่คุณควบคุมไม่ได้ หรือปิดใช้เอฟเฟกต์ระลอกน้ำสำหรับคอมโพเนนต์ ในกรณีส่วนใหญ่ คุณควรใช้ค่าเริ่มต้น เนื่องจาก API เหล่านี้เป็นทางออกสำหรับการปรับแต่งคอมโพเนนต์แต่ละรายการ / ซับทรีที่จำกัด สำหรับการเปลี่ยนแปลงที่กว้างขึ้นและระบบการออกแบบที่กำหนดเอง คุณควรสร้างเอฟเฟกต์ระลอกของคุณเองโดยใช้ createRippleModifierNode แทน (I7b5d6, b/298048146)
เพิ่ม API การกระเพื่อมใหม่ใน Material3 ซึ่งมาแทนที่ rememberRipple ที่เลิกใช้งานไปแล้ว นอกจากนี้ ยังเพิ่ม CompositionLocal, LocalUseFallbackRippleImplementation ชั่วคราวเพื่อเปลี่ยนคอมโพเนนต์ Material3 กลับไปใช้ 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 เป็น Val อีกครั้ง การห่อ onValueChangeFinished ใน rememberUpdatedState (Ie8fd0, b/322269951)
นำ @Stable ออกจากสถานะของ Slider เนื่องจากเราจะเปลี่ยน state.onValueChangeFinished เป็น var (I82ba1, b/322269951)
แก้ไขสีที่กำหนดเอง NavigationBar เพื่อคัดลอกจากค่าเริ่มต้น (80a779, b/326894020)
แก้ไขการถดถอยใน ExposedDropdownMenu เพื่อให้โฟกัสได้อีกครั้ง (3fcec1, b/323694447)
แก้ไขปัญหาการแคชสีปุ่ม (3e5bbc b/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 ใหม่

ดึงเพื่อรีเฟรช
- PullToRefreshContainer
- PullToRefreshState
ปุ่มแบ่งกลุ่ม

การปรับปรุงคอมโพเนนต์ Material Design 3 ที่มีอยู่

แถบแอปด้านล่าง (การจัดแนว RTL, ซ่อนอัตโนมัติเมื่อเลื่อน)
- BottomAppBarScrollBehavior
การอัปเดตภาพของแท็บ
- PrimaryIndicator
- SecondaryIndicator
ป้าย (การอัปเดตการจัดแนว)

เลื่อนระดับ API ทดลองเป็น 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 ที่เลิกใช้งานแล้วออก SwipeToDismiss component, state และ defaults object ได้รับการทำเครื่องหมายว่าอยู่ระหว่างการทดสอบ (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 เป็น Lambda content ต่อท้าย (I7f4d3)
ทำให้ตัวสร้างสำหรับ ChipElevation และ SelectableChipElevation เป็นแบบสาธารณะ (Ie0c48, b/308432421)
กำลังเพิ่ม ModalBottomSheetProperties กำลังย้าย securePolicy ไปยัง ModalBottomSheetProperties กำลังเพิ่มisFocusableและshouldDismissOnBackPressไปยัง ModalBottomSheetProperties บูลีนใหม่เหล่านี้ช่วยกำหนดวิธีที่แผ่นด้านล่างแบบโมดัลควรจัดการเหตุการณ์ IME (Iea56f, b/278216859)
อัปเดตสถานะ RangeSlider และ Slider เพื่อนำ initialOnValueChange, คำนำหน้าเริ่มต้น และ kdoc ที่เหมาะสมออก (I57d30)
เลิกใช้งานคลาส ChipBorder และการเรียกใช้ฟังก์ชันที่เกี่ยวข้อง ขอแนะนำให้ใช้ BorderStroke โดยตรงแทน (I89cc2)
ตอนนี้ Foundation Tooltip API พร้อมใช้งานแล้ว@ExperimentalFoundationApi (I30b0b)
TabRow และ ScrollableTabRow ไม่ได้เลิกใช้งานแล้ว ระบบจะทําเครื่องหมายรูปแบบหลักและรูปแบบรองใหม่เป็นรูปแบบทดลอง (I0def6)
ตอนนี้ชิปตัวกรองและชิปอินพุตใช้ BorderStroke โดยตรงแล้ว (I07a8d)
ตอนนี้ SegmentedButton ใช้ BorderStroke โดยตรงแล้ว (I89b9b)
เปลี่ยนชื่อฟังก์ชัน AlertDialog ทั่วไปเป็น BasicAlertDialog และเลิกใช้งานฟังก์ชันก่อนหน้า (Idbe52)
เปลี่ยนชื่อ SwipeToDismiss API เป็น SwipeDismiss และเลื่อนระดับ SwipeDismiss API ใหม่เป็นเวอร์ชันที่เสถียร (I14cbe)
เพิ่ม tonalElevation และ shadowElevation ลงใน API ของเคล็ดลับเครื่องมือ นอกจากนี้ เรายังย้าย API TooltipBox, PlainTooltip และ RichTooltip กลับไปเป็นเวอร์ชันทดลองเนื่องจากมีการเผยแพร่เป็นเวอร์ชันเสถียรโดยไม่ตั้งใจ (If0f66, b/293939035)
เลื่อนระดับ API ของชิปทดลองเป็นแบบเสถียร (Iea2c3)
นำคำอธิบายประกอบ @ExperimentalMaterial3Api ออกจากการ์ดที่คลิกได้ของ Material3 (I88dbf)

การแก้ไขข้อบกพร่อง

แก้ไขปัญหาที่ SwipeToDismiss จะขัดข้องในบางสถานการณ์ที่มีเลย์เอาต์ Lookahead และ Lazy ที่ซ้อนกัน (Ica8d1, b/297226562)

เวอร์ชัน 1.2.0-alpha10

18 ตุลาคม 2023

androidx.compose.material3:material3-*:1.2.0-alpha10 ได้รับการเผยแพร่แล้ว เวอร์ชัน 1.2.0-alpha10 มีคอมมิตต่อไปนี้

การเปลี่ยนแปลง API

การเลื่อนเวอร์ชัน Badge และ BadgedBox เป็นเวอร์ชันเสถียร (I67f16, b/261565132)
เพิ่ม securePolicy เป็นพารามิเตอร์ใน ModalBottomSheet เพื่อให้ผู้ใช้กําหนดลักษณะการทํางานสําหรับ WindowManager.LayoutParams.FLAG_SECURE ได้ (Icdac8, b/296250262)
เพิ่มโอเวอร์โหลดใหม่ของ LinearProgressIndicator และ CircularProgressIndicator ที่ใช้ progress เป็น 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 ไปใช้ AnchoredDraggable API ใหม่ DrawerStateanimateTo ถูกแทนที่ด้วยเมธอดเปิดและปิดแล้ว และตอนนี้ออฟเซ็ตจะแสดงเป็นค่าลอยแทนออบเจ็กต์สถานะ คุณเข้าถึงการชดเชยได้โดยตรงผ่าน 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 เปลี่ยนเป็น Immutable แล้ว ซึ่งทำให้การอัปเดตสีแต่ละรายการมีประสิทธิภาพน้อยลง แต่ทำให้การใช้สีที่พบบ่อยมีประสิทธิภาพมากขึ้น เหตุผลที่อยู่เบื้องหลังการเปลี่ยนแปลงนี้คือแอปส่วนใหญ่ไม่ได้มี Use Case หลักเป็นการอัปเดตสีแต่ละสี ซึ่งยังคงทำได้ แต่จะมีการจัดองค์ประกอบใหม่มากกว่าเดิม ซึ่งจะช่วยลดจำนวนการสมัครใช้บริการสถานะผ่านโค้ดทั้งหมดของ Material ลงอย่างมาก และจะส่งผลต่อต้นทุนการเริ่มต้นและการรันไทม์ของ Use Case มาตรฐานมากขึ้น (Ic447d, b/297212873)
การยกระดับโทนสีจะไม่เคลื่อนไหวในสถานะการโต้ตอบต่างๆ อีกต่อไปเพื่อให้ตรงกับข้อกำหนด (Icdd12)

การเปลี่ยนแปลง API

เพิ่ม BottomAppBar ใหม่ที่ใช้ BottomAppBarScrollBehavior เป็นพารามิเตอร์เพื่อซ่อนโดยอัตโนมัติเมื่อเลื่อนเนื้อหา นอกจากนี้ยังเพิ่ม FabPosition.EndOverlay เพื่อให้ FAB ซ้อนทับแถบแอปด้านล่างใน Scaffold แทนที่จะยึดไว้เหนือแถบแอป (Iecb47)
เพิ่มคอมโพเนนต์ป้ายกำกับแบบง่ายที่สร้างขึ้นบน BasicTooltipBox ซึ่งจะไม่ปิดเมื่อแตะนอกขอบเขตของป้ายกำกับ (I821f9)

การแก้ไขข้อบกพร่อง

นำการใช้ rememberSaveable สำหรับเคล็ดลับเครื่องมือออก (Icc131, b/299500338)
เปิดตัว Flag ชั่วคราวเพื่อควบคุมว่า 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 กับ Composable ใหม่ PlainTooltip และ RichTooltip (I79e1d)

การแก้ไขข้อบกพร่อง

ตอนนี้ dynamicLightColorScheme และ dynamicDarkColorScheme จะแสดงสีที่มีโครมาสูงขึ้นสำหรับบทบาทของพื้นผิวและ surfaceContainer (I5e901)
แก้ไขปัญหาที่คอมโพเนนต์บางรายการที่ใช้ Subcomposition (เช่น BottomSheetScaffold) ภายใน Scaffold ภายใน LookaheadScope พยายามอ่านขนาดเร็วเกินไป (I297b4, I871f1, b/295536718)

เวอร์ชัน 1.2.0-alpha06

23 สิงหาคม 2023

androidx.compose.material3:material3-*:1.2.0-alpha06 ได้รับการเผยแพร่แล้ว เวอร์ชัน 1.2.0-alpha06 มีคอมมิตเหล่านี้

การแก้ไขข้อบกพร่อง

แก้ไขการคำนวณ DropdownMenu ของ offset เพื่อให้ค่าออฟเซ็ต x ขึ้นอยู่กับทิศทางการจัดวางในเครื่องเท่านั้น และค่าออฟเซ็ต y จะไม่กลับด้านอีกต่อไปเมื่อเมนูอยู่ใกล้ด้านล่างของหน้าจอ (Iccc74, b/294103942)
แก้ไขการคำนวณ DropdownMenu ของ offset เพื่อให้ค่าออฟเซ็ต 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)
คำอธิบายประกอบเพิ่มเติมเพื่อระบุอินพุตที่อนุญาตไปยัง Composable (Ief234)
เพิ่มพารามิเตอร์ไอคอนลงในปุ่มที่แบ่งกลุ่ม แยกความหมายเพื่อให้เลือกปุ่มที่แบ่งกลุ่มเพื่อใช้การเลือกรายการเดียว และสลับเพื่อใช้การเลือกหลายรายการได้ โดยใช้ SelectableSegmentedButtonRow และ ToggelableSegmentedButtonRow ตามลำดับ (I38740)
เปลี่ยนชื่อตัวคั่นเป็น HorizontalDivider แล้ว เพิ่มฟังก์ชัน VerticalDivider (I5975c)
เปลี่ยนการใช้ ClosedFloatingPointRange เป็น FloatRange ที่มีน้ำหนักเบากว่าใน Material3 API เวอร์ชันทดลองเพื่อลดการแปลงอัตโนมัติ (I4aab5)
เพิ่มการจัดแนวเริ่มต้นใหม่สำหรับ FabPosition (Ib7aea, b/170592777)

การแก้ไขข้อบกพร่อง

ModalBottomSheet เคารพทิศทางการจัดวางในพื้นที่ (Ib4f44, b/285628622)

เวอร์ชัน 1.2.0-alpha03

21 มิถุนายน 2023

androidx.compose.material3:material3-*:1.2.0-alpha03 ได้รับการเผยแพร่แล้ว เวอร์ชัน 1.2.0-alpha03 มีคอมมิตต่อไปนี้

การเปลี่ยนแปลงลักษณะการทำงาน

ตอนนี้ includeFontPadding เป็น false โดยค่าเริ่มต้นในการพิมพ์แบบ Material 3 นอกจากนี้ เรายังได้เปลี่ยนรูปแบบความสูงของบรรทัดเริ่มต้นเป็น Trim.None และ Alignment.Center รวมถึงเพิ่ม lineHeight ที่ชัดเจน (ใน sp) ลงใน TextStyle ของ Typography โปรดดูเอกสาร API หากต้องการปรับแต่งค่าเหล่านี้ และดูบล็อกโพสต์เพื่อดูคำอธิบายโดยละเอียดเกี่ยวกับการเปลี่ยนแปลงเหล่านี้ (I6266f, Icabc3)

ฟีเจอร์ใหม่

เพิ่มการโอเวอร์โหลดสำหรับ RangeSlider ซึ่งเป็นเวอร์ชันที่มีสถานะของคอมโพเนนต์ สร้าง RangeSliderState ที่มีข้อมูลทั้งหมดสำหรับแทร็กที่ใช้งานอยู่ในปัจจุบัน การวัดค่าของคอมโพเนนต์ของ RangeSlider รวมถึงตรรกะการลากและท่าทางสัมผัส (I8c270)
ตอนนี้แถบค้นหารองรับเงาผ่านพารามิเตอร์ shadowElevation ที่เพิ่มเข้ามาใหม่แล้ว (Ia5369, b/271040353)
ColorScheme รองรับSurfaceContainerบทบาทใหม่แล้ว
ตอนนี้คุณปิดใช้การซ้อนทับระดับความสูงของพื้นผิวได้แล้วด้วยการจัดองค์ประกอบ LocalTonalElevationEnabled (Ic203c, b/277774590)

การเปลี่ยนแปลง API

เปิดตัวสร้างสีของคอมโพเนนต์ (I8c4a6)
เพิ่มพารามิเตอร์ที่โฟกัสได้ลงในทั้ง 2 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

เพิ่มพารามิเตอร์ระยะขอบหน้าต่างใน ModalBottomSheet
- ตอนนี้สามารถวาดขอบมืดสำหรับ ModalBottomSheet ไว้ด้านหลังแถบสถานะได้แล้วโดยตั้งค่า windowInsets เป็น 0
- อัปเดตฟังก์ชันการทำงานเริ่มต้นของ 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)
เปลี่ยนชื่อพร็อพเพอร์ตี้ Semantics 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 ที่ตั้งค่าในสถานะเพื่อควบคุมวันที่หรือปีที่เลือกได้ใน UI (Ic2fc6)
TimePicker นำออกจาก API ที่เสถียรแล้ว คาดว่าจะมีการเปลี่ยนแปลงเพิ่มเติมใน State API (I3f39a)
ModalBottomSheet ย้ายไปใช้ Android เท่านั้น ไม่แนะนำให้ใช้ ModalBottomSheet บนเดสก์ท็อป และฟังก์ชันนี้จะไม่ได้รับการบำรุงรักษาอย่างต่อเนื่อง (Ib3778)

การแก้ไขข้อบกพร่อง

แก้ไขAlertDialogการดำเนินการปิดให้ปรากฏใต้การดำเนินการยืนยันเมื่อการดำเนินการซ้อนทับกันเพื่อให้พอดีกับความกว้างของกล่องโต้ตอบ การแก้ไขนี้จะปรับการใช้งานให้สอดคล้องกับข้อกำหนดของ Material Design (I029de, b/235454277)
แก้ไขข้อบกพร่องใน ListItem ที่ใช้ระยะห่างที่ไม่ถูกต้องสำหรับรายการโฆษณา 3 บรรทัด (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 มีคอมมิตเหล่านี้

การแก้ไขข้อบกพร่อง

แก้ไขการส่งตัวแก้ไขไปยัง Composable 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)
เพิ่มพารามิเตอร์ระยะขอบหน้าต่างใน ModalBottomSheet
- ตอนนี้สามารถวาดขอบมืดสำหรับ ModalBottomSheet ไว้ด้านหลังแถบสถานะได้แล้วโดยตั้งค่า windowInsets เป็น 0
- อัปเดตฟังก์ชันการทำงานเริ่มต้นของ 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 ทดลองเป็น 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 เป็นค่า Null เพื่อแสดงเครื่องมือเลือกแบบไม่มีส่วนหัวได้แล้ว (Id3f3a, b/266132421, b/267194809)

การแก้ไขข้อบกพร่อง

ตอนนี้แถบค้นหาจะล้างโฟกัสโดยอัตโนมัติเมื่อไม่ได้ใช้งาน (I22a7c, b/261444487)
อัปเดตDateRangePickerเพื่อให้เลือกช่วงที่มีวันที่เดียวกันสำหรับวันที่เริ่มต้นและวันที่สิ้นสุดได้ (I16529, b/272882497)
ตอนนี้ช่องข้อความจะจัดตำแหน่งองค์ประกอบข้อความอย่างถูกต้องเมื่อขนาดแบบอักษรเล็กกว่าที่คาดไว้ ซึ่งอาจส่งผลให้แอปมีการเปลี่ยนแปลงเล็กน้อยในระดับพิกเซลตามการตั้งค่าแบบอักษรและสคริปต์ (I8b8d0)
ตอนนี้การดำเนินการเชิงความหมายของ Bottom Sheet มีป้ายกำกับแล้ว (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 มีคอมมิตเหล่านี้

ฟีเจอร์ใหม่

เพิ่ม Composable ของอินพุตเวลาที่ใช้ได้กับ rememberTimePickerState() โดยเป็นไปตามข้อกำหนด M3 สำหรับอินพุตเวลา (Ia4fab)
เพิ่ม DateRangePicker API ของ Material 3 สำหรับการเลือกช่วงวันที่ (I7a6c3, b/267194809)
เพิ่มการรองรับโหมดป้อนข้อมูล Material 3 สำหรับการเลือกช่วงวันที่ผ่าน DateRangePicker API (Ifdbc4)
ตอนนี้สีของช่องข้อความอนุญาตให้ปรับแต่งได้แล้ว ดังนี้
- สีของช่องป้อนข้อมูลและข้อความตัวยึดตำแหน่งตามสถานะโฟกัสและข้อผิดพลาด เปลี่ยนชื่อพารามิเตอร์ textColor เป็น unfocusedTextColor และเปลี่ยนชื่อ placeholderColor เป็น unfocusedPlaceholderColor
- สีคอนเทนเนอร์สำหรับช่องข้อความที่กรอกแล้วตามสถานะข้อผิดพลาดด้วยพารามิเตอร์ errorContainerColor ใหม่
สีของช่องข้อความเมนูแบบเลื่อนลงที่เปิดเผยได้รับการอัปเดตด้วยพารามิเตอร์เพื่อรองรับ API คำนำหน้าและคำต่อท้ายใหม่ (I9c8b4, b/254284181, b/264766350)

การเปลี่ยนแปลง API

เปลี่ยนกลับ API แถบเลื่อนบางเวอร์ชันและนำการโอเวอร์โหลดแถบเลื่อนที่ซ้ำซ้อนออก ซึ่งครอบคลุมโดยแถบเลื่อนเวอร์ชันทดลองใหม่ที่มีภาพขนาดย่อและแทร็กที่กำหนดเอง กำลังโปรโมต 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)
นำบทบาทเชิงความหมายออกจากพื้นผิวที่คลิกได้และเลือกได้ อัปเดตคอมโพเนนต์ที่ใช้บทบาทเหล่านั้นเพื่อตั้งค่าบทบาทโดยใช้ตัวแก้ไข 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)
การใช้งาน Modal Bottom Sheet สำหรับ 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)
เลื่อนระดับ SliderPositions, SliderDefaults.Thumb และ SliderDefaults.Track เป็นเวอร์ชันเสถียร และเพิ่ม API Slider และ RangeSlider ที่ไม่ใช่เวอร์ชันทดลองซึ่งมีภาพขนาดย่อและแทร็กที่กำหนดเอง นอกจากนี้ เรายังจะเลิกใช้งาน API Slider และ RangeSlider ก่อนหน้าด้วย (Ie5ea6, b/261566890)
ตั้งค่าเป็นสาธารณะ Modifier.tooltipAnchor() เพื่อให้นักพัฒนาแอปส่งไปยัง Anchor เพื่อระบุว่าควรแสดงเคล็ดลับเครื่องมือเมื่อกดค้าง อัปเดต PlainTooltipBox API เพื่อไม่ให้ TooltipState เป็นค่าที่กำหนดให้เป็น Null ได้อีกต่อไป และตอนนี้มีค่าเริ่มต้นแล้ว (Ie2fb7)
มีการทำเครื่องหมาย ProgressIndicatorDefaults.circularTrackColor เป็น @Composable เพื่อให้สอดคล้องกัน (Id29cc)
คืนค่าเครื่องมือรับพร็อพเพอร์ตี้ LocalMinimuTouchTargetEnforcement และทําเครื่องหมายว่าเลิกใช้งานแล้ว พร้อมเปลี่ยนเส้นทางไปยัง LocalMinimumInteractiveComponentEnforcement (I60dd5)

เวอร์ชัน 1.1.0-alpha05

26 มกราคม 2023

androidx.compose.material3:material3:1.1.0-alpha05 และ androidx.compose.material3:material3-window-size-class:1.1.0-alpha05 เปิดตัวแล้ว เวอร์ชัน 1.1.0-alpha05 มีคอมมิตเหล่านี้

ฟีเจอร์ใหม่

DatePickerDialog และการสนับสนุนการช่วยเหลือพิเศษ
เพิ่มภาพปกและแทร็กที่กำหนดเองลงใน RangeSlider แล้ว

การอัปเดตการขึ้นต่อกัน

ตอนนี้ Compose UI และ Compose Material ต้องใช้ Lifecycle 2.6.0

เวอร์ชัน 1.1.0-alpha04

11 มกราคม 2023

androidx.compose.material3:material3:1.1.0-alpha04 และ androidx.compose.material3:material3-window-size-class:1.1.0-alpha04 เปิดตัวแล้ว เวอร์ชัน 1.1.0-alpha04 มีคอมมิตเหล่านี้

ฟีเจอร์ใหม่

DatePicker API เริ่มต้นสำหรับการเลือกวันที่เดียวผ่าน UI ปฏิทิน API นี้ยังอยู่ระหว่างการเปลี่ยนแปลง (I722b9)
เพิ่มการรองรับเคล็ดลับเครื่องมือแบบข้อความธรรมดาผ่าน PlainTooltipBox (I0cdfb)
แถบค้นหา (Iad128)
SwipeToDismiss (I458a8, b/242889540)

การเปลี่ยนแปลง API

เพิ่มพร็อพเพอร์ตี้ความหมาย IsContainer ใน Surface ระบบจะใช้พร็อพเพอร์ตี้นี้ในการเปลี่ยนแปลงในภายหลังซึ่งจะกำหนดลำดับการข้ามตามความหมายเชิงความหมายขององค์ประกอบต่างๆ เช่น พื้นผิว (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 ที่นี่คือจุดที่รายงานปัญหาครั้งแรก เราได้ส่งการแก้ไขแล้ว และการแก้ไขนี้จะพร้อมใช้งานในการอัปเดต Compose ครั้งถัดไป วิธีแก้ปัญหาชั่วคราวคืออัปเดตไลบรารี androidx.compose.material และ androidx.compose.material3 เป็นเวอร์ชันล่าสุด(1.1.0-alpha04) หรือดาวน์เกรด androidx.compose.foundation เป็น 1.4.0-alpha03

เวอร์ชัน 1.1.0-alpha03

7 ธันวาคม 2022

androidx.compose.material3:material3:1.1.0-alpha03 และ androidx.compose.material3:material3-window-size-class:1.1.0-alpha03 เปิดตัวแล้ว เวอร์ชัน 1.1.0-alpha03 มีคอมมิตเหล่านี้

การเปลี่ยนแปลง API

เปลี่ยนชื่อ consumedWindowInsets() เป็น consumeWindowInsets() และ withConsumedWindowInsets() เป็น onConsumedWindowInsetsChanged() รวมถึงเปิดตัวตัวแก้ไขต่อสาธารณะ (Ie44e1)
เพิ่มการเว้นวรรคเนื้อหาเริ่มต้นใหม่สำหรับปุ่มข้อความที่มีไอคอนที่จะใช้ (I8f662)
เพิ่มสีที่ปิดใช้สำหรับแถบนำทางและแถบด้านข้าง (Ia7892, b/258867034)
เพิ่ม Modifier API เพื่อค้นหาข้อมูลการเลื่อนขององค์ประกอบระดับบน (I2ba9d, b/203141462)
ใช้ใน Clickable เพื่อหน่วงเวลาการโต้ตอบการกดอย่างถูกต้อง เมื่อท่าทางสัมผัสอาจกลายเป็นเหตุการณ์การเลื่อน
แก้ไขปัญหาที่ Clickables ไม่หน่วงการกระเพื่อมอย่างถูกต้องเมื่อใช้ภายใน Scrollable ViewGroup
อัปเดตลิ้นชักและชีตเพื่อหน่วงเวลาการกดอย่างถูกต้องในกรณีที่ท่าทางสัมผัสอาจกลายเป็นเหตุการณ์การเลื่อน

การอัปเดตการขึ้นต่อกัน

ตอนนี้ Compose UI และ Compose Material ต้องใช้ Lifecycle 2.5.1 (I05ab0, b/258038814)

เวอร์ชัน 1.1.0-alpha02

9 พฤศจิกายน 2022

androidx.compose.material3:material3:1.1.0-alpha02 และ androidx.compose.material3:material3-window-size-class:1.1.0-alpha02 เปิดตัวแล้ว เวอร์ชัน 1.1.0-alpha02 มีคอมมิตเหล่านี้

การเปลี่ยนแปลง API

awaitFirstDown และ waitForUpOrCancellation ตอนนี้ยอมรับ PointerEventPass เพื่อความยืดหยุ่นที่มากขึ้น (ยังแก้ไข ExposedDropdownMenuBox ที่แสดงเมนูขณะเลื่อนด้วย)(I7579a, b/212091796)
เพิ่มพารามิเตอร์ minLines ลงในข้อความ Material และ Material3 TextField และ OutlinedTextField ซึ่งช่วยให้ตั้งค่าความสูงขั้นต่ำของคอมโพเนนต์ในแง่ของจำนวนบรรทัดได้ (I4af1d)
เลิกใช้งานฟังก์ชัน TopAppBarDefaults smallTopAppBarColors เพื่อให้ใช้ฟังก์ชัน topAppBarColors ใหม่แทน ซึ่งควรใช้เมื่อสร้าง TopAppBar (Ie6cb9)
เพิ่มพารามิเตอร์ minLines ลงใน BasicText และ BasicTextField ซึ่งช่วยให้ตั้งค่าความสูงขั้นต่ำของ Composable เหล่านี้ในแง่ของ จำนวนบรรทัด (I24294, b/122476634)

การแก้ไขข้อบกพร่อง

ตัดเนื้อหาของ IconButton Material3 และ IconToggleBotton ให้เป็นรูปร่างเลเยอร์สถานะของคอมโพเนนต์ (เช่น รูปร่างวงกลม) (I9da8f)
อัปเดตแถบแอปด้านบนขนาดกลางและขนาดใหญ่ของ Material3 เพื่อใช้สีพื้นหลังเดียวกันทั่วทั้งพื้นผิว และอนุญาตให้ตั้งค่าการลบล้างสีเริ่มต้นด้วยค่าสีโปร่งใส (I67659, b/249688556, b/250838918)

เวอร์ชัน 1.1.0-alpha01

24 ตุลาคม 2022

androidx.compose.material3:material3:1.1.0-alpha01 และ androidx.compose.material3:material3-window-size-class:1.1.0-alpha01 เปิดตัวแล้ว เวอร์ชัน 1.1.0-alpha01 มีคอมมิตเหล่านี้

การแก้ไขข้อบกพร่อง

แก้ไขแถบแอปด้านบนเมื่อใช้ชื่อกับ TextStyle และ Brush (If667e)

รุ่น 1.0

เวอร์ชัน 1.0.1

9 พฤศจิกายน 2022

androidx.compose.material3:material3:1.0.1 และ androidx.compose.material3:material3-window-size-class:1.0.1 เปิดตัวแล้ว เวอร์ชัน 1.0.1 มีคอมมิตเหล่านี้

การแก้ไขข้อบกพร่อง

อัปเดตแถบแอปด้านบนขนาดกลางและขนาดใหญ่ของ Material3 เพื่อใช้สีพื้นหลังเดียวกันทั่วทั้งพื้นผิว และอนุญาตให้ตั้งค่าการลบล้างสีเริ่มต้นด้วยค่าสีโปร่งใส (I67659, b/249688556, b/250838918)

เวอร์ชัน 1.0.0

24 ตุลาคม 2022

androidx.compose.material3:material3:1.0.0 และ androidx.compose.material3:material3-window-size-class:1.0.0 เปิดตัวแล้ว เวอร์ชัน 1.0.0 มีคอมมิตเหล่านี้

ฟีเจอร์หลักของเวอร์ชัน 1.0.0

นี่คือ Compose Material 3 เวอร์ชันเสถียรเวอร์ชันแรก

การกำหนดธีม Material Design 3 และสีแบบไดนามิกของ Material You

คอมโพเนนต์ Material Design 3

ป้าย
- Badge, BadgedBox
แถบแอปด้านล่าง
- BottomAppBar
ปุ่ม
- ปุ่ม, ElevatedButton, FilledTonalButton, OutlinedButton, TextButton
FAB และ FAB แบบขยาย
- SmallFloatingActionButton, FloatingActionButton, LargeFloatingActionButton, ExtendedFloatingActionButton
การ์ด
- Card, OutlinedCard, ElevatedCard
ช่องทำเครื่องหมาย
- ช่องทำเครื่องหมาย
ชิป
- AssistChip, ElevatedAssistChip, FilterChip, ElevatedFilterChip, InputChip, SuggestionChip, ElevatedSuggestionChip
กล่องโต้ตอบ
- AlertDialog
ตัวคั่น
- ตัวคั่น
เมนูแบบเลื่อนลง
- DropdownMenu, DropdownMenuItem, ExposedDropdownMenuBox
List
- ListItem
แถบนำทาง
- แถบนำทาง
ลิ้นชักการนำทาง
- ModalNavigationDrawer, ModalDrawerSheet, DismissibleNavigationDrawer, DismissibleDrawerSheet, PermanentNavigationDrawer, PermanentDrawerSheet
แถบนำทาง
- NavigationRail
ตัวบ่งชี้ความคืบหน้า
- CircularProgressIndicator, LinearProgressIndicator
ปุ่มตัวเลือก
- RadioButton
แถบเลื่อน
- แถบเลื่อน, RangeSlider
เปลี่ยน
- เปลี่ยน
แท็บ
- Tab, LeadingIconTab, TabRow, ScrollableTabRow
ช่องข้อความ
- TextField, OutlinedTextField
แถบแอปด้านบน
- TopAppBar, CenterAlignedTopAppBar, MediumTopAppBar, LargeTopAppBar
ไอคอน
- Icon, IconButton
ข้อความ
- ข้อความ
Surface
- Surface
เลย์เอาต์
- โครงร่าง
สีเนื้อหา
- LocalContentColor

คลาสขนาดหน้าต่าง

material3-window-size-class เป็นไลบรารีใหม่ที่รองรับคลาสขนาดหน้าต่าง ซึ่งเป็นชุดเบรกพอยต์วิวพอร์ตที่กำหนดไว้ล่วงหน้าเพื่อให้คุณออกแบบ พัฒนา และทดสอบเลย์เอาต์แอปพลิเคชันที่ปรับขนาดได้ คุณใช้ calculateWindowSizeClass เพื่อดึงข้อมูลอินสแตนซ์คลาสขนาดหน้าต่างได้ ซึ่งคุณสามารถใช้เพื่อกำหนดลักษณะที่ UI ควรปรากฏ เช่น การแสดงแถบนำทางแทนการนำทางด้านล่างสำหรับขนาดหน้าต่างที่ใหญ่ขึ้น ดูข้อมูลเพิ่มเติมและตัวอย่างการใช้งานได้ในเอกสารประกอบการอ้างอิง 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() ที่ควรส่งไปยังช่องข้อความเพื่อให้ลักษณะการทำงานของ a11y เป็นไปอย่างถูกต้อง (I27fa3)
เพิ่ม 2 เมธอดที่โอเวอร์โหลดสำหรับ Slider API ปัจจุบันเพื่อให้ผู้ใช้ส่งนิ้วโป้งหรือแทร็กเพื่อป้อนข้อมูลแถบเลื่อน (I21c00)

การแก้ไขข้อบกพร่อง

อัปเดตการแมปสีธีมมืดสำหรับคอนเทนเนอร์ "เมื่อเกิดข้อผิดพลาด" เป็นโทน 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 อีกต่อไป
ตอนนี้คอมโพเนนต์ Scaffold ของ Material3 มีพารามิเตอร์ contentWindowInsets แล้ว ซึ่งช่วยให้ระบุจำนวนการแทรกเพื่อจัดการช่องเนื้อหาได้ (Icf11a, b/243713323)
เลิกใช้งานฟังก์ชัน SmallTopAppBar ของ Material 3 เวอร์ชันทดลอง และเปิดตัวฟังก์ชัน TopAppBar ที่เทียบเท่า โปรดย้ายข้อมูลการใช้งาน ไปยังเวอร์ชันใหม่ (I74404, b/226918634)
เพิ่มการควบคุมลักษณะการทำงานของการปัดและการสแนปแถบแอปด้านบน (I15c81)
นำ startIndent ออกจาก Divider และย้ายสีไปยังพารามิเตอร์สุดท้าย (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

หากต้องการดูธีม คอมโพเนนต์ และ Composable อื่นๆ ล่าสุดที่มีให้ใช้งาน โปรดดูภาพรวมเอกสารอ้างอิง API ของ Compose Material 3

การเปลี่ยนแปลง API

อัปเดตแถบแอปด้านบนของ Material 3 ให้เปลี่ยนจากสถานะยุบอย่างสมบูรณ์เป็นสถานะขยายอย่างสมบูรณ์ นอกจากนี้ ยังได้อัปเดตTopAppBarDefaultsฟังก์ชันลักษณะการทำงานให้เป็น Composables และระบุค่าเริ่มต้นสำหรับสถานะแถบแอปด้านบนและข้อกำหนดภาพเคลื่อนไหว (I642b3)
อัปเดตลายเซ็นของคอมโพเนนต์ FAB ให้ตรงกับ Surface API (I3afaa)
เพิ่มการรองรับการแทรกในตัวสำหรับแถบแอปด้านบน ลิ้นชัก แถบนำทาง และแถบนำทางด้านข้าง เมื่อใช้แยกกันหรือใช้กับ Scaffold คอมโพเนนต์เหล่านี้จะจัดการ Inset ให้แก่นักพัฒนาแอปโดยอัตโนมัติ หมายเหตุ: การเปลี่ยนแปลงนี้ไม่ได้เพิ่มการจัดการไอคอนแถบสถานะและความโปร่งใสของแถบสถานะและแถบนำทางโดยอัตโนมัติ โปรดดำเนินการด้วยตนเองต่อไปเพื่อให้มั่นใจว่าจะได้รับประสบการณ์การใช้งานแบบขอบจรดขอบที่ดีที่สุด (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)
แยกเนื้อหาของลิ้นชักการนำทางไปยัง Composable ของตัวเองเพื่อรองรับการระบุความกว้างที่กำหนดเองในลิ้นชัก (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)
ตอนนี้อินเทอร์เฟซในไลบรารี Compose สร้างขึ้นโดยใช้เมธอดอินเทอร์เฟซเริ่มต้นของ jdk8 (I5bcf1)
WindowWidthSizeClass และ WindowHeightSizeClass ตอนนี้ใช้ Comparable แล้ว จึงสามารถเปรียบเทียบได้โดยใช้โอเปอเรเตอร์ (<, <=, >=, >) และ API อื่นๆ (I747d0)

การแก้ไขข้อบกพร่อง

อัปเดตตัวอย่างป้ายเพื่อระบุคำอธิบายเนื้อหาที่มีความหมายมากขึ้น (I10b9d)
เพิ่มตัวเลือกในการใช้ขนาดแบบอักษรของระบบกับเครื่องมือเลือกธีมของแคตตาล็อก Material 3 (I10605)
เพิ่มโค้ดตัวอย่างสำหรับป้ายและตัวบ่งชี้ความคืบหน้าที่ไม่แน่นอน (I8fbe0)

เวอร์ชัน 1.0.0-alpha13

1 มิถุนายน 2022

androidx.compose.material3:material3:1.0.0-alpha13 และ androidx.compose.material3:material3-window-size-class:1.0.0-alpha13 เปิดตัวแล้ว เวอร์ชัน 1.0.0-alpha13 มีคอมมิตต่อไปนี้

การเปลี่ยนแปลง API

รองรับการรักษําตำแหน่งแถบแอปด้านบนเมื่อมีการเปลี่ยนแปลงการกำหนดค่า (I10459, b/216160958)

เวอร์ชัน 1.0.0-alpha12

18 พฤษภาคม 2022

androidx.compose.material3:material3:1.0.0-alpha12 และ androidx.compose.material3:material3-window-size-class:1.0.0-alpha12 เปิดตัวแล้ว เวอร์ชัน 1.0.0-alpha12 มีคอมมิตต่อไปนี้

การแก้ไขข้อบกพร่อง

ตอนนี้องค์ประกอบหลักของแถบเลื่อนมีความกว้างเป็น 0 ได้แล้ว (b/231707291)

เวอร์ชัน 1.0.0-alpha11

11 พฤษภาคม 2022

androidx.compose.material3:material3:1.0.0-alpha11 และ androidx.compose.material3:material3-window-size-class:1.0.0-alpha11 เปิดตัวแล้ว เวอร์ชัน 1.0.0-alpha11 มีคอมมิตเหล่านี้

ฟีเจอร์ใหม่

เพิ่ม RangeSlider ไปยัง Material 3 (I18e38)
เพิ่มการรองรับ Material3 AssistChip และ InputChip (I0d25a)
เพิ่มการรองรับ Material3 FilterChip และ SuggestionChip (I9fdf3)

การเปลี่ยนแปลง API

เปลี่ยนชื่อฟังก์ชันที่ประกอบกันได้ TextFieldDefaults.BorderStroke ซึ่งวาดเส้นขอบใน OutlinedTextField เป็น TextFieldDefaults.BorderBox (I5f295)
การเปลี่ยนแปลงภาพของ Switch 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 เป็นไลบรารีใหม่ที่รองรับคลาสขนาดหน้าต่าง ซึ่งเป็นชุดเบรกพอยต์วิวพอร์ตที่กำหนดไว้ล่วงหน้าเพื่อให้คุณออกแบบ พัฒนา และทดสอบเลย์เอาต์แอปพลิเคชันที่ปรับขนาดได้ คุณใช้ calculateWindowSizeClass เพื่อดึงข้อมูลอินสแตนซ์คลาสขนาดหน้าต่างได้ ซึ่งคุณสามารถใช้เพื่อกำหนดลักษณะที่ UI ควรปรากฏ เช่น การแสดงแถบนำทางแทนการนำทางด้านล่างสำหรับขนาดหน้าต่างที่ใหญ่ขึ้น ดูข้อมูลเพิ่มเติมและตัวอย่างการใช้งานได้ในเอกสารประกอบข้อมูลอ้างอิงของ API สำหรับ WindowSizeClass ดูข้อมูลเพิ่มเติมเกี่ยวกับคำจำกัดความของคลาสขนาดหน้าต่างได้ที่คำแนะนำแบบสาธารณะเกี่ยวกับการรองรับหน้าจอขนาดต่างๆ

การเปลี่ยนแปลง API

เพิ่มระดับความสูงเริ่มต้นของ FAB สำหรับ BottomAppBar นำ Lambda ต่อท้ายออกจาก BottomAppBar ที่มี FAB (I92c47)
เพิ่ม Material3 FilledIconButton, FilledTonalIconButton และ OutlinedIconButton (Ib2bda)
อัปเดต Material 3 Snackbar API เพื่อยอมรับค่าสีสำหรับการดำเนินการที่ไม่บังคับและการดำเนินการยกเลิก (Ibe4b4)
การดูบางส่วน (ลงหรือตำแหน่ง) เลิกใช้งานแล้วใน PointerInputChange คุณใช้ consume() เพื่อใช้การเปลี่ยนแปลงทั้งหมดได้ คุณใช้ isConsumed เพื่อดูว่ามีบุคคลอื่นใช้การเปลี่ยนแปลงไปก่อนหน้านี้หรือไม่
PointerInputChange::copy() จะทำสำเนาแบบตื้นเสมอ ซึ่งหมายความว่าระบบจะใช้สำเนาของ PointerInputChange เมื่อมีการใช้สำเนาใดสำเนาหนึ่ง หากต้องการสร้าง PointerInputChange ที่ไม่มีขอบเขต ให้ใช้ตัวสร้างแทน (Ie6be4, b/225669674)
การเปลี่ยนแปลง Cards API เพื่อรับสีคอนเทนเนอร์และเนื้อหาผ่านอินเทอร์เฟซ CardColors และเพื่อรองรับสถานะที่ปิดใช้สำหรับ การ์ดที่คลิกได้ (I927df)
เราได้เปลี่ยนชื่อพารามิเตอร์ backgroundColor เป็น containerColor ในช่องข้อความ Material 3 เพื่อให้สอดคล้องกับคอมโพเนนต์อื่นๆ มากขึ้น (I6fbd9)

การแก้ไขข้อบกพร่อง

อัปเดตIconButtonมาตรฐานให้สอดคล้องกับข้อกำหนด Material3 (I09eab)
ย้ายความสูงของแถบด้านบนของ Scaffold ของ Material3 ไปยังระยะเว้นที่ส่งไปยังเนื้อหา เพื่อให้เนื้อหาแสดงผลใต้แถบแอปด้านบนได้ หากไม่สนใจ 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 และระบบย่อยของรูปร่าง (I37426)
เพิ่มพารามิเตอร์แบบขยายไปยัง ExtendedFloatingActionButton เพื่อควบคุมว่าจะขยายหรือยุบ FAB หรือไม่ โดยมีการเคลื่อนไหวระหว่างแต่ละสถานะ เพิ่มการโอเวอร์โหลด Extended FAB สำหรับ Extended FAB ที่มีข้อความต่อท้ายสำหรับ ExtendedFAB ที่ไม่มีไอคอน (Iba7f1)

เวอร์ชัน 1.0.0-alpha08

23 มีนาคม 2022

androidx.compose.material3:material3:1.0.0-alpha08 ได้รับการเผยแพร่แล้ว เวอร์ชัน 1.0.0-alpha08 มีคอมมิตต่อไปนี้

ฟีเจอร์ใหม่

เพิ่มการรองรับช่องข้อความ Material 3 (I795cc, b/199377790)

การเปลี่ยนแปลง API

เพิ่มตัวแบ่งเริ่มต้นสำหรับเมนู (I01374)
เพิ่มพารามิเตอร์สี surfaceTint ลงในคลาส ColorScheme (I2f558)

การแก้ไขข้อบกพร่อง

แก้ไขที่ปุ่ม Material3 เพื่ออ่านค่ารูปแบบข้อความเริ่มต้น จาก MaterialTheme (Ie62fc)

เวอร์ชัน 1.0.0-alpha07

9 มีนาคม 2022

androidx.compose.material3:material3:1.0.0-alpha07 ได้รับการเผยแพร่แล้ว เวอร์ชัน 1.0.0-alpha07 มีคอมมิตเหล่านี้

การเปลี่ยนแปลง API

อัปเดต Material 3 Surface API ที่นำฟังก์ชันที่โอเวอร์โหลดสำหรับ Surface ที่คลิกได้กลับมา รวมถึงเพิ่มฟังก์ชันเพื่อรองรับ Surface ที่เลือกได้และสลับได้ (I4bf18)
ตอนนี้ LazyVerticalGrid และ LazyHorizontalGrid เสถียรแล้ว (I307c0)
LazyVerticalGrid/LazyHorizontalGrid และ API ที่เกี่ยวข้องทั้งหมดถูกย้ายไปไว้ในแพ็กเกจย่อย .grid โปรดอัปเดตการนำเข้าจาก androidx.compose.foundation.lazy เป็น androidx.compose.foundation.lazy.grid (I2d446)
เปลี่ยนกลับการเปลี่ยนแปลงก่อนหน้านี้ที่อาศัย View เพียงอย่างเดียวสำหรับ WindowInsetsControllerCompat และกำหนดให้ต้องมี Window อีกครั้ง ซึ่งจำเป็นสำหรับการจัดการแฟล็กหน้าต่างบางรายการ เลิกใช้งาน ViewCompat.getWindowInsetsController เพื่อ WindowCompat.getInsetsController เพื่อให้แน่ใจว่าใช้ Window ที่ถูกต้อง (เช่น หาก View อยู่ในกล่องโต้ตอบ) (I660ae, b/219572936)
เพิ่ม LazyVerticalGrid API ใหม่เพื่อกำหนดขนาดแกนไขว้ (I17723)

การแก้ไขข้อบกพร่อง

อัปเดต Card API เพื่อให้เป็นไปตามการเปลี่ยนแปลงใน Surface API (I3c8b9)

เวอร์ชัน 1.0.0-alpha06

23 กุมภาพันธ์ 2022

androidx.compose.material3:material3:1.0.0-alpha06 ได้รับการเผยแพร่แล้ว เวอร์ชัน 1.0.0-alpha06 มีคอมมิตเหล่านี้

การเปลี่ยนแปลง API

เพิ่ม NavigationDrawerItem ที่แสดงถึงปลายทางเดียวภายในลิ้นชัก (Ic396f, b/218286829)
PermanentNavigationDrawer และ DismissibleNavigationDrawer ได้รับการเพิ่มเป็น API เวอร์ชันทดลองแล้ว ซึ่งเป็นลิ้นชักที่เหมาะสำหรับอุปกรณ์หน้าจอขนาดใหญ่ (I5f8ab, b/218286829)
เพิ่มการรองรับแถบแอปด้านล่างของ Material 3 (Ic432a)
NavigationDrawer เปลี่ยนชื่อเป็น ModalNavigationDrawer (I1807d, b/218286829) แล้ว
เพิ่มคลาสและโทเค็นของแถบเลื่อน Material 3 (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

เมนูแบบเลื่อนลง
- DropdownMenu, DropdownMenuItem
การ์ด
- Card, OutlinedCard, ElevatedCard

การเปลี่ยนแปลง API

ฟังก์ชัน Surface ที่เลิกใช้งานแล้วซึ่งใช้ onClick callback ควรสร้างพื้นผิวที่คลิกได้ด้วย InteractionSource และ Modifier.clickable() (I211c6)
เพิ่มการรองรับระดับความสูงเมื่อกดและโฟกัสสำหรับ FAB (Ibb584)
เปลี่ยน Surface API เพื่อรับ InteractionSource ซึ่งช่วยให้ ควบคุมลักษณะที่ปรากฏในสถานะต่างๆ ได้ (Iafbc8)

การแก้ไขข้อบกพร่อง

เพิ่มสีระดับที่ 3 ที่ขาดหายไปในรูปแบบสีแบบไดนามิก (I456c4, b/214588434)

เวอร์ชัน 1.0.0-alpha04

26 มกราคม 2022

androidx.compose.material3:material3:1.0.0-alpha04 ได้รับการเผยแพร่แล้ว เวอร์ชัน 1.0.0-alpha04 มีคอมมิตเหล่านี้

การเปลี่ยนแปลง API

เพิ่ม NonRestartableComposable ให้กับเมธอดที่โอเวอร์โหลด ของเมธอดที่มีอยู่โดยไม่มีตรรกะที่ซับซ้อน ซึ่งจะช่วยลดการตรวจสอบการจดจำ (เท่ากับ) ที่คอมไพเลอร์ สร้างขึ้นสําหรับพารามิเตอร์ทั้งหมดที่ ซ้ำกันในฟังก์ชันด้านในที่เรียกใช้ (I90490)
เพิ่มตัวแบ่ง Material 3 (Ica5fc)
ทำเครื่องหมายช่องทำเครื่องหมายและปุ่มตัวเลือกด้วยคำอธิบายประกอบ API เวอร์ชันทดลอง (Ie44bb)
เพิ่มการรองรับตัวบ่งชี้ความคืบหน้าของ Material 3 (Iff232, b/205023841)

การแก้ไขข้อบกพร่อง

อัปเดตสีคอนเทนเนอร์ TextButton's ที่ปิดใช้ให้โปร่งใส (I6b248, b/213339737)

เวอร์ชัน 1.0.0-alpha03

12 มกราคม 2022

androidx.compose.material3:material3:1.0.0-alpha03 ได้รับการเผยแพร่แล้ว เวอร์ชัน 1.0.0-alpha03 มีคอมมิตต่อไปนี้

การแก้ไขข้อบกพร่อง

เพิ่ม LocalIndication ลงใน MaterialTheme ของ Material 3 (I7ce4e)
แก้ไขรัศมีมุมที่ใช้กับช่องทำเครื่องหมาย (I38b03, b/175198975, b/202309440)

การอัปเดตการขึ้นต่อกัน

ตอนนี้ขึ้นอยู่กับ Kotlin 1.6.10

เวอร์ชัน 1.0.0-alpha02

1 ธันวาคม 2021

androidx.compose.material3:material3:1.0.0-alpha02 ได้รับการเผยแพร่แล้ว เวอร์ชัน 1.0.0-alpha02 มีคอมมิตเหล่านี้

ฟีเจอร์ใหม่

เพิ่มการรองรับช่องทําเครื่องหมายและปุ่มตัวเลือก
อัปเดตให้เข้ากันได้กับ Kotlin 1.6.0

การเปลี่ยนแปลง API

นำลิ้นชักออกจาก Scaffold ของ 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

ปุ่ม
- Button, ElevatedButton, FilledTonalButton, OutlinedButton, TextButton
FAB และ FAB แบบขยาย
- SmallFloatingActionButton, FloatingActionButton, LargeFloatingActionButton, ExtendedFloatingActionButton
กล่องโต้ตอบ
- AlertDialog
แถบนำทาง
- NavigationBar
ลิ้นชักการนำทาง
- NavigationDrawer
แถบนำทาง
- NavigationRail
แถบแอปด้านบน
- SmallTopAppBar, CenterAlignedTopAppBar, MediumTopAppBar, LargeTopAppBar
ป้าย
- Badge, BadgedBox
ไอคอน
- Icon, IconButton
ข้อความ
- Text
Surface
- Surface
เลย์เอาต์
- Scaffold
สีเนื้อหา
- LocalContentColor

ดูข้อมูลเพิ่มเติมได้ที่ส่วน Material Design 3 และ Material You ในคู่มือการใช้ธีม Material ใน Compose