Compose Material 3

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

โครงสร้าง

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คอมโพเนนต์พื้นฐานของ UI ของ Compose ที่จำเป็นต่อการโต้ตอบกับอุปกรณ์ ซึ่งรวมถึงเลย์เอาต์ การวาด และอินพุต

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

หากต้องการเพิ่มทรัพยากร 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-alpha19"
}

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

android {
    buildFeatures {
        compose = true
    }

    composeOptions {
        kotlinCompilerExtensionVersion = "1.1.1"
    }

    kotlinOptions {
        jvmTarget = "1.8"
    }
}

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

ความคิดเห็น

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

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

ดูข้อมูลเพิ่มเติมได้ในเอกสารประกอบของ Issue Tracker

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 ได้

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

เวอร์ชัน 1.0.0-alpha07

1 พฤษภาคม 2024

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

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

  • ทำให้ API ชุดการนำทางไม่ใช่เวอร์ชันทดลอง (If62af)

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

  • ใช้ Inset สำหรับเนื้อหาโดยค่าเริ่มต้น (50266df)

เวอร์ชัน 1.0.0-alpha06

17 เมษายน 2024

androidx.compose.material3:material3-adaptive-navigation-suite:1.0.0-alpha06 androidx.compose.material3:material3-adaptive-navigation-suite-android:1.0.0-alpha06 และ androidx.compose.material3:material3-adaptive-navigation-suite-desktop:1.0.0-alpha06 ออกอากาศแล้ว เวอร์ชัน 1.0.0-alpha06 มีการเปลี่ยนแปลงเหล่านี้

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

  • เพิ่ม containerColor และ contentColor ลงใน NavigationSuiteScaffoldDefaults (I64e3a, b/331993720)
  • เพิ่มฟังก์ชัน itemColors ลงใน NavigationSuiteDefaults (Idf719, b/328480012)
  • ทำให้ NavigationSuiteScope ปิดผนึก (Iefa57)

เวอร์ชัน 1.0.0-alpha05

6 มีนาคม 2024

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

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

  • ทำให้NavigationSuiteItemColorsเครื่องมือสร้างเป็นแบบสาธารณะ (Ica83a, b/324886877)

เวอร์ชัน 1.0.0-alpha04

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

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

การอัปเดตทรัพยากร Dependency

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

เวอร์ชัน 1.0.0-alpha03

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

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

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

  • อัปเดตชื่อแพ็กเกจเป็น navigationsuite จาก navigation-suite (I7eff7)
  • คอมโพเนนต์ Material3 ที่แสดง MutableInteractionSource ใน API ได้รับการอัปเดตให้แสดง MutableInteractionSource ที่อนุญาตให้เป็น Null ได้ ซึ่งมีค่าเริ่มต้นเป็น Null ไม่มีการเปลี่ยนแปลงเชิงความหมายที่นี่ การส่งค่า null หมายความว่าคุณไม่ต้องการยก MutableInteractionSource และระบบจะสร้าง MutableInteractionSource ภายในคอมโพเนนต์หากจำเป็น การเปลี่ยนเป็นค่าว่างจะทำให้คอมโพเนนต์บางอย่างไม่จัดสรร MutableInteractionSource และทำให้คอมโพเนนต์อื่นๆ สร้างอินสแตนซ์เมื่อจำเป็นเท่านั้น ซึ่งจะช่วยปรับปรุงประสิทธิภาพในคอมโพเนนต์เหล่านี้ หากไม่ได้ใช้ MutableInteractionSource ที่ส่งไปยังคอมโพเนนต์เหล่านี้ เราขอแนะนำให้ส่งค่าเป็น null แทน นอกจากนี้ เราขอแนะนำให้คุณทำการเปลี่ยนแปลงที่คล้ายกันในคอมโพเนนต์ของคุณเองด้วย (I41abb, b/298048146)

เวอร์ชัน 1.0.0-alpha02

13 ธันวาคม 2023

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

ฟีเจอร์ใหม่

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

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

เวอร์ชัน 1.0.0-alpha01

15 พฤศจิกายน 2023

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

ฟีเจอร์ใหม่

Compose Material3 Adaptive เวอร์ชัน 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

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

Compose Material3 เวอร์ชัน 1.5

เวอร์ชัน 1.5.0-alpha19

6 พฤษภาคม 2026

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

ฟีเจอร์ใหม่

  • ตอนนี้การจัดรูปแบบข้อความรองรับชุดแบบอักษรเริ่มต้นที่จะผสานกับรูปแบบข้อความที่ระบุ หากไม่ได้ตั้งค่าชุดแบบอักษรอย่างชัดเจน (I2e305, b/500356360)

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

  • นำ supportingText ออกจาก Lambda ต่อท้ายสำหรับ DropdownMenuItem แต่ให้ย้ายไปไว้หลัง trailingIcon แทน (I5694b, b/503047115)
  • เลื่อนเวอร์ชัน ToggleButtons เป็นเวอร์ชันเสถียร (I8a771, b/497876827)
  • โปรโมต API เมนูที่สื่อความหมาย นำ DropdownMenuItem ออกเนื่องจากเป็น API แบบทดลองที่เลิกใช้งานแล้วซึ่งเป็นส่วนหนึ่งของ 1.5.0-alpha (I1d556, b/497885285)
  • เลื่อนระดับ FAB และ FAB Menu API จากเวอร์ชันทดลอง (Ie509c, b/497892373)
  • โปรโมต API ปุ่มแบบด่วน นำ API การทดสอบที่เลิกใช้งานแล้วออก SmallButtonContentPaddingซึ่งเปิดตัวในเวอร์ชัน 1.5.0-alpha (Iee31e, b/497873833)
  • ย้าย API การสั่งซื้อโครงสร้างกลับไปเป็นเวอร์ชันทดลอง (I01492, b/489424245)
  • เพิ่มการโอเวอร์โหลดตัวสร้าง Typography อีกรายการ (I8b3b3, b/500356360)
  • เปลี่ยนกลับโปรโมชัน MaterialShapes และ LoadingIndicator เป็นเวอร์ชันเสถียร (I30e69, b/497876695, b/497877850)

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

  • แก้ไขข้อบกพร่องในการติดตั้งใช้งานแถบเลื่อนที่ทำให้ระบบใช้ระยะห่างจากวงแหวนโฟกัสแบบอินเซ็ตกับแทร็กและหัวแม่มือเมื่อคอมโพเนนต์ไม่ได้อยู่ในโฟกัส (I16315, b/506158497)
  • แก้ไขปัญหาใน ModalBottomSheet ที่มีการใช้ imePadding โดยไม่มีเงื่อนไข ทำให้ควบคุมลักษณะการทำงานของ IME ผ่าน contentWindowInsets ไม่ได้ (Ied801, b/289824811)
  • [FAB] แก้ไขข้อขัดข้องใน Modifier.animateFloatingActionButton ที่เกิดจากการปัดเศษ int กับ float ตามความหนาแน่น (I2d25f, b/489769219)
  • แก้ไขการโฟกัสที่ติดอยู่ภายในเครื่องมือเลือกช่วงวันที่ การกด Tab จะย้ายโฟกัสเข้าและออกจากวันที่ ส่วนปุ่มลูกศรจะย้ายโฟกัสผ่านวันที่ (I7f3ea, b/498332749)
  • เปลี่ยนกลับการเปลี่ยนแปลงปุ่มขนาดกลางและใหญ่สำหรับโหมดเคอร์เซอร์แบบแม่นยำ และขนาดไอคอนเริ่มต้นของกล่องโต้ตอบสำหรับโหมดเคอร์เซอร์แบบแม่นยำด้วย (I58d8c, b/496938250, b/500356640)
  • แก้ไขปัญหาการโฟกัสแป้นพิมพ์ที่ติดอยู่ในเครื่องมือเลือกวันที่ที่ไม่ใช่กล่องโต้ตอบ นอกจากนี้ ยังแก้ไขลำดับโฟกัสของปุ่มปิดและปุ่มยืนยันที่ไม่เป็นไปตามลำดับภาพด้วย (Ibbe2e, b/500454457)

เวอร์ชัน 1.5.0-alpha18

22 เมษายน 2026

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

ฟีเจอร์ใหม่

  • เพิ่มโอเวอร์โหลด FilterChip, ElevatedFilterChip และ InputChip ด้วยการเปลี่ยนรูปร่าง เพิ่มค่าเริ่มต้นของรูปร่าง ระยะห่าง และสีใหม่สำหรับการโอเวอร์โหลดเหล่านี้ (I84717, b/442678355)
  • เพิ่มการรองรับวงแหวนโฟกัสแบบอินเซ็ตผ่าน API แบบเลือกใช้ โดยใช้LocalRippleThemeConfigurationองค์ประกอบใหม่ (I0551a, b/282184440)

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

  • เปลี่ยนชื่อ rememberWithGapSearchBarState เป็น rememberSearchBarWithGapState แล้ว (I5f54b, b/498697243)
  • API RippleThemeConfiguration และ LocalRippleThemeConfiguration ได้รับการอัปเกรดเป็นเวอร์ชันเสถียรแล้ว โดยเพิ่มความสามารถในการกำหนดค่าการวาดระลอกคลื่นให้มีลักษณะวงแหวนโฟกัสแบบฝังแทนที่จะเป็นการระบุโฟกัสตามความทึบแสง API ที่ใช้ API การกำหนดค่า Material Ripple ถูกเลิกใช้งานแล้ว (Ide5d0, b/485893129)
  • โปรโมต WavyProgressIndicator API (Id72a3, b/497877853)
  • โปรโมต materialExpressTheme, expressiveLightColorScheme (I40eab, b/497876844)
  • BottomSheet composable ได้ย้ายไปที่ BottomSheet.kt แล้ว (If7e33, b/500091309)
  • เพิ่มMaterial3ExpressiveApiคำอธิบายประกอบที่ไม่ต้องใช้OptIn (Ib9f2e, b/499994043)
  • เพิ่ม DropdownMenuPopupPositionProviders เป็น DropdownMenuPopup เพื่อให้นักพัฒนาแอปกำหนดค่าตำแหน่งของเมนูที่วางไว้เทียบกับจุดยึดได้ ซึ่งจะช่วยให้รองรับเมนูย่อยภายในเมนูแบบเลื่อนลงได้ ตอนนี้คุณสร้างเมนูย่อยแบบเรียงซ้อนได้แล้วโดยใช้การวางตำแหน่งแบบสัมพัทธ์กับจุดยึดใหม่ ส่งตัวเลือกการวางตำแหน่งใหม่เหล่านี้ไปยัง rememberDropdownMenuPopupPositionProvider เพื่อกำหนดค่าเมนู ดูการติดตั้งใช้งานที่สมบูรณ์ได้ที่ตัวอย่างเมนูแคตตาล็อก (Ic1ace, b/476161294)

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

  • อัปเดตคอมโพเนนต์ Material3 เพื่อรองรับการระบุวงแหวนโฟกัสแบบแทรก (I88006, b/498610244, b/467984300, b/498281359)
  • แก้ไขปัญหาในตัวอย่าง TimePicker ที่โฟกัส TalkBack เคลื่อนที่ ทำให้ป้อนเวลาที่ไม่ถูกต้องได้ (I51690, b/498364606)

เวอร์ชัน 1.5.0-alpha17

8 เมษายน 2026

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

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

  • เลื่อนระดับ TopAppBarScrollBehavior และวิธีการที่เกี่ยวข้องเป็นเวอร์ชันเสถียร API เหล่านี้ไม่จำเป็นต้อง@ExperimentalMaterial3Apiเลือกใช้อีกต่อไป (Ieb2d1, b/496918628)

เวอร์ชัน 1.5.0-alpha16

25 มีนาคม 2026

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

ฟีเจอร์ใหม่

  • โปรโมตTypographyตัวสร้างและแอตทริบิวต์ เพิ่มTypographyตัวสร้างที่ยอมรับค่าเริ่มต้น FontFamily เพื่อใช้กับTextStylesทั้งหมดในสเกล (I3f6f1, b/236358112)
  • เลื่อนระดับ API ที่เป็นเวอร์ชันทดลองสำหรับแถบเลื่อนให้เป็นเวอร์ชันที่เสถียร (I5efb3, b/304811984)

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

  • isAnchoredDraggableComponentsAnchorRecoveryEnabled เปิดตัวแฟล็กฟีเจอร์สำหรับคอมโพเนนต์ที่ลากได้ซึ่งพบข้อผิดพลาดเป้าหมายที่ไม่ชัดเจน คอมโพเนนต์ประกอบด้วย ModalBottomSheet, BottomSheetScaffold, SwipeToDismissBox และ WideNavigationRail (I5b0e5, b/487941042, b/478210200, b/477038695)
  • เพิ่มDropdownMenuItemTrailingLabelฟังก์ชันเริ่มต้นและการเว้นวรรค UI ที่เพิ่มประสิทธิภาพของเคอร์เซอร์สำหรับเมนูที่แบ่งกลุ่ม (I28977, b/485937388)
  • เพิ่มระยะขอบสำหรับกล่องโต้ตอบเมื่อ ComposeMaterial3Flags.isPrecisionPointerComponentSizingEnabled เป็นจริง และเพิ่ม AlertDialogDefaults.IconSize สำหรับไอคอน (Ib9652, b/485932651)
  • เพิ่มประสิทธิภาพการคำนวณขนาดขั้นต่ำภายในของ BasicTextField ComposeFoundationFlags#isBasicTextFieldMinSizeOptimizationEnabled จะเป็นตัวควบคุมการตั้งค่าเหล่านี้ หากคุณต้องการปิดใช้ (I70ade)
  • อัปเดตลําดับพารามิเตอร์ใน SearchBarDefaults.InputField เพื่อรักษาความเข้ากันได้ของซอร์สโค้ด (I20e3b, b/486964336)
  • นำ API FilterChip และ AssistChip ที่เลิกใช้งานแล้วซึ่งมีพารามิเตอร์ horizontalSpacing ออก (Iec623, b/483762893)
  • พารามิเตอร์ isAtTop ใน TopAppBarDefaults.pinnedScrollBehavior และ TopAppBarDefaults.enterAlwaysScrollBehavior ได้รับการเปลี่ยนชื่อเป็น isAtStart (If7323, b/405129274)

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

  • ตอนนี้คอมโพเนนต์ BottomSheet จะใช้ MaterialTheme.motionScheme ในระหว่างการเลื่อนที่ซ้อนกันและท่าทางสัมผัสการลาก (I5fe22, b/452071842, b/384959324)
  • แก้ไขการใช้ระยะห่างภายในของป้ายกำกับไอคอนเมื่อรายการมี selectedLeadingIcon ที่ไม่ได้แสดงในขณะนี้ (Iba820)

เวอร์ชัน 1.5.0-alpha15

25 กุมภาพันธ์ 2026

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

ฟีเจอร์ใหม่

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

  • เราได้ปรับโครงสร้าง MaterialTheme ใหม่เพื่อใช้ CompositionLocal เดียวสำหรับข้อมูลธีม ตอนนี้คุณเข้าถึงสถานีวิทยุที่เปิดเพลงบรรเลงได้ผ่าน MaterialTheme.LocalMaterialTheme.current หรือ currentValueOf(MaterialTheme.LocalMaterialTheme) ใน CompositionLocalAccessorScope (Idee2e, b/483676974)
  • อัปเดตระยะห่างจากขอบของเนื้อหาเริ่มต้นของปุ่มข้อความสื่ออารมณ์ให้เป็นไปตามข้อกำหนดที่ถูกต้อง รวมถึงยกเลิกการเลิกใช้งาน TextButtonContentPadding และ TextButtonWithIconContentPadding ด้วย (I67283)
  • เพิ่มพารามิเตอร์เพื่อปิดใช้ตัวแฮนเดิลการกลับจาก BottomSheet (Iff81e, b/483763626)
  • เปลี่ยนรูปแบบการเคลื่อนไหวจากเวอร์ชันทดลอง (If822f, b/484003769)
  • เพิ่มพารามิเตอร์ "เปิดใช้" และ "เกณฑ์" ลงใน PullToRefreshBox ใน Material3 (I5610b, b/369044003)
  • แทนที่ horizontalSpacing ด้วย horizontalArrangement ใน FilterChip และ ElevatedFilterChip เพิ่มค่าเริ่มต้นของ horizontalArrangement ลงใน FilterChipDefaults (If3d6a, b/304853782)
  • ปรับปรุง KDoc สำหรับTopAppBarDefaultsลักษณะการทำงานของการเลื่อนเพื่ออธิบายการใช้งานเนื้อหาที่ย้อนกลับและเลื่อนไว้ล่วงหน้าได้ดียิ่งขึ้น (I247dd, b/405129274)
  • แทนที่พารามิเตอร์ horizontalSpacing ด้วยพารามิเตอร์ horizontalArrangmenet เพิ่มค่าเริ่มต้นของ horizontalArrangement ลงใน AssistChipDefaults (I15cec, b/304853782)
  • เพิ่ม Getter สำหรับ shouldUsePrecisionPointerComponentSizing (I234ce)
  • เพิ่มการโอเวอร์โหลดไปยัง TopAppBarDefaults.enterAlwaysScrollBehavior และ TopAppBarDefaults.pinnedScrollBehavior ที่ยอมรับพารามิเตอร์ isAtTopState ซึ่งจะช่วยให้ตรวจหา at top state ที่กำหนดเองได้เมื่อใช้ลักษณะการเลื่อน (I785b9, b/405129274)
  • เพิ่มพารามิเตอร์ contentPadding และ horizontalArrangement ลงใน InputChip และ ElevatedInputChip เพิ่มค่าเริ่มต้นของ horizontalArrangement และ contentPadding ลงใน InputChipDefaults (Iae39c, b/304853782)
  • เพิ่มการปรับขนาดตัวชี้ที่แม่นยำและการเว้นวรรคสำหรับปุ่ม และเลิกใช้งาน TextButtonContentPadding val ที่ล้าสมัย (I6d7b6, b/479879803)
  • เพิ่ม rememberWithGapSearchBarState เพื่อใช้กับ ExpandedDockedSearchBarWithGap (Ia3361)

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

  • แก้ไขปัญหาที่เงาไม่แสดงสำหรับบานหน้าต่างที่ลอยอยู่ (Ie6108, b/470517507)
  • อัปเดต TextButtons ให้มีข้อกำหนดการเว้นวรรคที่ถูกต้องของ Material3 หากต้องการเลือกไม่ใช้และเปลี่ยนกลับไปใช้ลักษณะการทำงานแบบเดิม คุณควรตั้งค่า isTextButtonContentPaddingFixEnabled เป็น false ในแอปพลิเคชัน (I66c8e)

เวอร์ชัน 1.5.0-alpha14

11 กุมภาพันธ์ 2026

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

วิธีแก้ปัญหาเฉพาะหน้า

  • เพิ่ม isAnchoredDraggableComponentsStrictOffsetCheckEnabled แล้ว แฟล็กนี้ควบคุมว่า BottomSheetScaffold, ModalBottomSheet, SwipeToDismissBox และ WideNavigation ต้องกำหนดค่าออฟเซ็ตภายในอย่างเคร่งครัดหรือไม่ เมื่อปิดใช้ คอมโพเนนต์จะไม่วางเนื้อหาจนกว่าจะเริ่มต้นออฟเซ็ต โดยค่าสถานะนี้จะช่วยแก้ปัญหาชั่วคราวในกรณีที่คอมโพเนนต์เหล่านี้แสดงข้อยกเว้นเนื่องจากไม่ได้เริ่มต้นออฟเซ็ต (I36870, b/477038695, b/478210200, b/471818801, b/475249572, b/475598146)

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

  • เพิ่ม isTextButtonContentPaddingFixEnabled ที่เมื่อเป็นจริงจะทำให้ TextButton มีข้อกำหนดการเว้นวรรคที่ถูกต้อง (Ib986e)
  • เพิ่มพารามิเตอร์ indicatorPadding สำหรับ WideNavigationRailItem แล้ว (I3d5dc)
  • เพิ่มพารามิเตอร์ contentPadding และ horizontalArrangement ลงใน SuggestionChip และ ElevatedSuggestionChip เพิ่มค่าเริ่มต้นของ horizontalArrangement และ ContentPadding ลงใน SuggestionChipDefaults สร้างChipArrangementชั้นเรียน (Ida874, b/304853782)
  • อัปเดตรายการในเมนูที่เลือกได้ให้มีพารามิเตอร์สำหรับข้อความสนับสนุน เลิกใช้งาน API ก่อนหน้าซึ่งไม่มีพารามิเตอร์ข้อความสนับสนุน นอกจากนี้ ให้เพิ่มขนาดไอคอนเริ่มต้นที่แนะนำสำหรับไอคอนนำหน้าและไอคอนต่อท้ายด้วย (I89e4b, b/417731599)
  • อัปเดตเลย์เอาต์ของแถบแสดงข้อความเพื่อปรับปรุงการจัดแนวข้อความหลายบรรทัด เราได้เปิดตัวฟีเจอร์ isSnackbarStylingFixEnabled เพื่อช่วยในการย้ายข้อมูลเพื่อลดการหยุดชะงักของ UI โปรดเปิดใช้ Flag นี้ด้วยตนเองในแอปพลิเคชันของคุณ เราจะนำออกในการเปิดตัวเวอร์ชันในอนาคต (I37d63, b/322866101)
  • แก้ไขข้อบกพร่องใน BottomSheetScaffold, ModalBottomSheet, SwipeToDismissBox และ WideNavigationRail ที่ระบบไม่คำนวณจุดยึดใหม่ในบางกรณี การแก้ไขนี้อยู่หลังแฟล็กฟีเจอร์ ComposeMaterial3Flags#isAnchoredDraggableComponentsInvalidationFixEnabled (I9acb1, b/478210200)
  • เพิ่มพารามิเตอร์ระยะห่างจากขอบของเนื้อหาไปยัง WideNavigationRail และ ModalWideNavigationRail เพื่อให้ปรับแต่งระยะห่างจากขอบเริ่มต้นได้ (I49106)

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

  • การตั้งค่า BottomSheetScaffold sheetPeekHeight เป็น 0 จะปิดใช้สมอ partiallyExpanded PartiallyExpanded จะยังคงอยู่ในเลย์เอาต์แรกเพื่อให้คำนวณเลย์เอาต์ได้ (Ia33a4, b/465158677)
  • SheetState#targetValue จะเลือกใช้จุดยึดปัจจุบันหากออฟเซ็ตปัจจุบันถูกต้อง ซึ่งจะป้องกันไม่ให้ initialValue อัปเดตทันที (Ied2c4, b/477279704)
  • แก้ไขไอคอนของ WideNavigationRailItem ที่ไม่ได้อยู่ตรงกลางแนวตั้งหากความสูงของรายการเปลี่ยนแปลง (Ib8c83)

เวอร์ชัน 1.5.0-alpha13

28 มกราคม 2026

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

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

  • เพิ่มการรองรับแถบค้นหา animationSpecForContentExpand และ animationSpecForContentCollapse (I033a5)

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

  • แก้ไขปัญหาที่เนื้อหาของ SearchBar ที่ขยายไม่ได้ใช้สีที่รับรู้ธีม (I878e0, b/379441904)
  • แก้ไขข้อบกพร่องที่ BottomSheetScaffold จะเรียกใช้การเรียกกลับ confirmValueChange ของ SheetState ด้วยค่าที่ไม่ถูกต้องเมื่อส่งแฮนเดิลการลากไปยัง BottomSheetScaffold โปรดทราบว่าควรใช้ confirmValueChange เพื่อคัดค้านการเปลี่ยนแปลงสถานะเท่านั้น ใช้ snapshotFlow เพื่อสังเกตการเปลี่ยนแปลงสถานะ (Ice9ee, b/465824174, b/477031833)

เวอร์ชัน 1.5.0-alpha12

14 มกราคม 2026

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

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

  • อัปเดต TopAppBarDefaults (enterAlways และลักษณะการทำงานที่ปักหมุด) เพื่อรองรับ lazyListState, scrollState และ reverseScrolling การแก้ไขนี้จะแก้ปัญหาทิศทางการจัดวางและจัดการเนื้อหาที่เลื่อนในตอนแรกได้อย่างถูกต้อง (I9d5c2, b/262234750)
  • เพิ่มพารามิเตอร์ contentPadding และ horizontalSpacing ลงใน AssistChip และ ElevatedAssistChip เพิ่มค่าเริ่มต้นของ HorizontalSpacing และ ContentPadding ลงใน AssistChipDefaults (I2ac90, b/304853782)
  • DatePicker API ที่ใช้คลาสเวลาของ Java จะไม่ได้รับการติดแท็กเป็นแบบทดลองอีกต่อไป (I5039c, b/457537971)

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

  • แก้ไขข้อขัดข้องในการจัดรูปแบบวันที่ใน API 23 (I67a94, b/452713222)DatePicker
  • แก้ไขข้อบกพร่องในการจัดแนวภาพในตัวอย่างตัวบ่งชี้ภาพเคลื่อนไหวแฟนซีเมื่อใช้กับแถวแท็บที่เลื่อนได้ (Iae0f3, b/466790304)
  • แก้ไขปัญหาที่ตัวเลือก AM/PM ของ TimePicker ไม่ได้ใช้รูปแบบข้อความที่กำหนดโดยข้อกำหนดของ Material Design (Ie908a, b/469788786)
  • แก้ไขข้อขัดข้องใน HorizontalFloatingToolbar ที่อาจเกิดขึ้นในโหมดแนวนอนเมื่อแสดงแป้นพิมพ์บนหน้าจอ (Ia13c1, b/466692323)
  • แก้ไขปัญหาที่TopAppBarชื่ออาจทับซ้อนกับactionsเมื่อไม่มีnavigationIcon ตอนนี้ชื่อจะถูกจำกัดให้พอดีกับพื้นที่ที่มีอยู่แล้ว (I2ba97, b/428697836)
  • รองรับ RTL ด้วยการขยายแผงยึด (I0770b, b/467775639)

เวอร์ชัน 1.5.0-alpha11

17 ธันวาคม 2025

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

ฟีเจอร์ใหม่

  • เพิ่ม ExpandedFullScreenContainedSearchBar แล้ว (Ie472d,b/454658635)
  • เพิ่มการรองรับการสร้าง Carousel แบบหลายสัดส่วนโดยใช้ Lazy Grid (I2b109, b/462137656)
  • ตอนนี้รายการที่สื่อความหมายของ Material พร้อมใช้งานแล้ว โดยรองรับการโต้ตอบและการจัดรูปแบบที่แบ่งกลุ่ม มีการเพิ่มฟิลด์สีเพิ่มเติมใน ListItemColors (I54057, b/441569230)
  • ตอนนี้ API ภาพสไลด์แบบเรียกดูหลายรายการและแบบไม่จำกัดมีเสถียรภาพแล้ว (I7a558, b/401537465)
  • เพิ่มพารามิเตอร์ contentPadding และ horizontalSpacing ลงใน FilterChip และ ElevatedFilterChip เพิ่มค่าเริ่มต้นของ HorizontalSpacing และ ContentPadding ลงใน FilterChipDefaults (Iec6e3, b/455596578)

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

  • การตั้งค่า BottomSheetScaffold sheetPeekHeight เป็น 0 จะปิดใช้สมอ partiallyExpanded (I52dc9, b/465158677)

เวอร์ชัน 1.5.0-alpha10

3 ธันวาคม 2025

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

ฟีเจอร์ใหม่

  • เพิ่มภาพหมุนแบบหลายสัดส่วน (I15247, b/411232854)

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

  • ตอนนี้เราได้จัดเตรียมแฟล็กฟีเจอร์ isCheckboxStylingFixEnabled ผ่านออบเจ็กต์ ComposeMaterial3Flags แล้ว (I97baf, b/457504316)
  • พารามิเตอร์ disabledCheckmarkColor ใน CheckboxColors ได้ย้ายไปไว้ที่ส่วนท้ายของรายการพารามิเตอร์เพื่อให้มั่นใจถึงความเข้ากันได้แบบไบนารี (I734d8, b/457504316)

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

  • เปลี่ยนแป้นลูกศรทั้งหมดที่เปลี่ยนค่าแถบเลื่อนเพื่อแก้ไขการโฟกัสที่ติดอยู่ในอุปกรณ์บางเครื่องที่ไม่มีแป้น Tab (I154dd, b/460912699)

เวอร์ชัน 1.5.0-alpha09

19 พฤศจิกายน 2025

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

ฟีเจอร์ใหม่

  • เพิ่มการอัปเดตเมนูที่สื่ออารมณ์ ซึ่งรวมถึงรายการในเมนูที่เปิด/ปิดได้ รายการในเมนูที่เลือกได้ กลุ่มเมนู และเมนูป๊อปอัป นอกจากนี้ ยังมีค่าเริ่มต้นของเมนูแบบใหม่ที่สื่อความหมายใน MenuDefaults ด้วย (I5cdd4, b/417731597, b/448646125, b/448646896, b/448646891)
  • ตอนนี้ Modifier.minimumInteractiveComponentSize มี AlignmentLines: MinimumInteractiveTopAlignmentLine และ MinimumInteractiveLeftAlignmentLine ใหม่ 2 รายการที่เผยแพร่ต่อสาธารณะ เส้นเหล่านี้จะทำเครื่องหมายขอบภาพของคอมโพเนนต์ก่อนที่จะเพิ่มพื้นที่ว่างเพื่อให้เป็นไปตามข้อกำหนดของพื้นที่เป้าหมายการสัมผัสขั้นต่ำ (I7f485, b/458124197)
  • เพิ่ม ExpandedDockedSearchBarWithGap แล้ว (Idb7f8)

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

  • เพิ่มการตรวจสอบเพื่อเปิดใช้การกำหนดขนาดคอมโพเนนต์ตัวชี้ที่แม่นยำ (I8108d)
  • เพิ่ม Modifier.align ใน ButtonGroupScope (I03890, b/416590906)
  • นำ ModalBottomSheet API ที่เลิกใช้งานแล้วซึ่งเป็นแบบทดลองที่อยู่ในรุ่นที่เสถียรอย่างน้อย 1 รุ่นออก (Ifbe1d, b/449757604)
  • ButtonGroup ใหม่ที่โอเวอร์โหลดด้วยพารามิเตอร์ verticalAlignment (I23a37, b/416590906)
  • นำ API ทดลองที่ซ่อนไว้ซึ่งเลิกใช้งานแล้วออก ซึ่ง API เหล่านี้อยู่ในรุ่นที่เสถียรอย่างน้อย 1 รุ่น (I4f68d, b/449754465, b/449749933, b/401311419, b/449749928, b/449756019)

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

  • เพิ่มเคล็ดลับเครื่องมือลงในปุ่มรายการเพิ่มเติมเริ่มต้นของแถบเครื่องมือแบบลอย (Ife952, b/422781172)
  • แก้ไขตัวบ่งชี้ของ WideNavigationRail ที่ถูกตัดหากตั้งค่าให้มีความกว้างมากขึ้นผ่านขนาดป้ายกำกับที่ใหญ่ขึ้น (I9d740, b/444728723)
  • อัปเดตปุ่มต่อท้ายของปุ่มแยกเพื่อให้ไอคอนอยู่ตรงกลางตามรูปร่างที่กำหนดแม้ใน RTL (Icab82)

เวอร์ชัน 1.5.0-alpha08

5 พฤศจิกายน 2025

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

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

  • เพิ่มพร็อพเพอร์ตี้ hourInput และ minuteInput ลงในอินเทอร์เฟซ TimePickerState แล้ว พร็อพเพอร์ตี้เหล่านี้มีไว้เพื่อเก็บข้อมูลดิบที่ยังไม่ได้ตรวจสอบจากผู้ใช้ พร็อพเพอร์ตี้ชั่วโมงและนาทีที่มีอยู่จะยังคงอยู่และแสดงถึงเวลาที่ถูกต้องล่าสุดที่ทราบ (I09d74, b/394612017)

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

  • แก้ไขข้อบกพร่องที่ทำให้ใช้ Switch กับ ReusableContent โดยไม่เคลื่อนไหวไม่ได้แล้ว (I61093, b/455909150)

เวอร์ชัน 1.5.0-alpha07

22 ตุลาคม 2025

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

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

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

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

  • แก้ไขข้อบกพร่องในแถบเลื่อนที่การโต้ตอบด้วยการกดไม่เกิดขึ้นเมื่อแตะลง การเปลี่ยนแปลงนี้ช่วยให้มั่นใจได้ว่าระบบจะปล่อย 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)
  • ซ่อน API ของ calculatePosture() เป็นภายใน (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 แบบขยายหากไม่มีจุดยึดอื่นๆ (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's active label color change from onSurface to secondary in order to improve usability, color contrast and improve coherence within the system (Ibc297), to revert to the previous behavior, copy the default colors and change the selectedTextColor to MaterialTheme.colorScheme.onSurface.

  • ตอนนี้คอมโพเนนต์ Material 3 ใช้ MotionScheme ใหม่เพื่อกำหนดการเคลื่อนไหวแล้ว (Ie0f93)

  • การเปลี่ยนแปลงการเคลื่อนไหวของตัวบ่งชี้ความคืบหน้าแบบวงกลมที่ไม่แน่นอน (I3c07e)

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

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

  • ตอนนี้ข้อความรองรับ autoSize
      แล้ว
    • ข้อความที่มี string
    • ข้อความที่มี annotatedString
  • เพิ่มตัวตกแต่ง Material 3 สำหรับ BasicTextField2
  • เพิ่ม 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 มีการเปลี่ยนแปลงเหล่านี้

การเปลี่ยนแปลงทรัพยากร Dependency

  • นำการขึ้นต่อกันของ 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 เราได้นำวันที่สิ้นสุดที่เป็นค่าเริ่มต้นซึ่งเป็นค่า Null สำหรับ DateRangePicker ออก และกำหนดให้ต้องส่งวันที่สิ้นสุด นอกจากนี้ เรายังได้ชี้แจงการใช้งานการแสดงวันที่ในเอกสารประกอบ API ในเวลาเที่ยงคืน UTC และทำเครื่องหมายตัวรับและตัวตั้งค่าล่าสุดที่ใช้ java.time API เป็นเวอร์ชันทดลองในตอนนี้ (I121b3, b/427952972)
  • เลื่อนระดับ API พารามิเตอร์ไอคอนที่มี tint: ColorProducer เป็น API ที่ไม่ใช่เวอร์ชันทดลอง (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 แถบค้นหาใหม่

    • ตอนนี้แถบค้นหาที่ยุบและ "มุมมอง" การค้นหาที่ขยายจะกลายเป็น Composable ที่แยกกัน
    • 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 ใหม่

  • ภาพหมุน
  • [ModalBottomSheet] รองรับการย้อนกลับแบบคาดการณ์ใน U+ แล้ว (Iccf32, b/281967264, b/304850357)
  • [SearchBar] รองรับการย้อนกลับที่คาดการณ์ได้ใน U+ (I657f8) แล้ว
  • ตอนนี้ Nav Drawer (ModalDrawerSheet และ DismissibleDrawerSheet) รองรับการย้อนกลับแบบคาดการณ์ใน U+ เป็นการเลือกใช้ (Ie5b0b)
  • DropdownMenu ตอนนี้รองรับสี รูปร่าง ระดับความสูง และเส้นขอบที่กำหนดเองแล้ว (I8e981,b/289554448, b/301887035, b/283654243)
  • อัปเดตแถบเลื่อนเพื่อปรับปรุงการช่วยเหลือพิเศษโดยการเพิ่มช่องว่างและตัวบ่งชี้การหยุด (I3058e)
  • อัปเดต ProgressIndicator เพื่อปรับปรุงการช่วยเหลือพิเศษโดยการเพิ่มตัวบ่งชี้ช่องว่างและตัวบ่งชี้หยุด (I21451)
  • เพิ่มเครื่องหมายแคร์เร็ตเริ่มต้นสำหรับริชทูลทิป รองรับการวาดเครื่องหมายแคร์เร็ตที่กำหนดเองเมื่อระบุแองเคอร์ LayoutCoordinates (Ifd42c) การเปลี่ยนแปลงที่ส่งผลกับส่วนอื่นในระบบ
  • API การดึงเพื่อรีเฟรชใหม่
    • PullToRefreshState ที่ง่ายขึ้นเพื่อใช้ค่าเศษส่วนแทนหน่วย Dp
    • ผู้ใช้จะเป็นผู้ควบคุมสถานะ isRefreshing แทน PullToRefreshState
    • แยกการเชื่อมต่อการเลื่อนที่ซ้อนกันออกจาก PullToRefreshState โดยจะจัดการผ่าน PullToRefreshBox หรือ Modifier.pullToRefresh ใหม่
    • การอัปเดตนี้เป็นการเปลี่ยนแปลงที่ทำให้ API ทดลองก่อนหน้านี้ใช้งานไม่ได้ (I0adeb, b/314496282, b/317177684, b/323787138, b/324573502, b/317177683) การเปลี่ยนแปลงที่ทำให้เกิดข้อขัดข้องด้านภาพ
  • อัปเดตการวางซ้อนสถานะโฟกัสเป็น 0.1f เพื่อให้มั่นใจว่าสีมีคอนทราสต์เพียงพอ (I7ea77)
  • การปรับค่าเริ่มต้นของสีพื้นผิวและสีพื้นหลังเล็กน้อยใน lightColorScheme และ darkColorScheme (I9db52)
  • อัปเดตสีของแถบเลื่อนและ ProgressIndicator ให้เป็นไปตามข้อกำหนดใหม่ของคอนทราสต์ที่ไม่ใช่ข้อความ (I26807)
  • ตอนนี้คอมโพเนนต์ใช้ตัวแปร SurfaceContainer แล้ว ตอนนี้คอมโพเนนต์ที่คำนวณสีด้วย Surface และ TonalElevation อย่างเป็นทางการจะใช้บทบาท SurfaceContainer โดยค่าเริ่มต้น ซึ่งไม่ได้รับผลกระทบจากการยกระดับโทนสี (b/304584161)
  • เราได้ปรับบทบาทพื้นฐานของ Surface และคอนเทนเนอร์ Surface เล็กน้อยเพื่อให้มีสีอ่อนและสีเข้มมากขึ้นในธีมสว่างและธีมมืด (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 วาดขอบมืดเหนือแถบสถานะได้แม่นยำยิ่งขึ้นเมื่อเปิดใช้การแสดงผลแบบขอบจรดขอบ ตอนนี้เนื้อหาของ Bottom Sheet แบบโมดอลสามารถใช้ส่วนแทรกของหน้าต่างได้แล้ว ซึ่งจะช่วยให้เนื้อหาที่มองเห็นได้อยู่เหนือแถบนำทาง พารามิเตอร์ 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 จนกว่า 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)
  • ตอนนี้เราใช้ ExposedDropdownMenu โดยใช้ Popup แล้ว ลักษณะการทำงานควรเหมือนกัน ยกเว้นเมนูที่โฟกัสได้ซึ่งมีช่องข้อความที่แก้ไขได้อาจปิดเมื่อพิมพ์บนแป้นพิมพ์

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

  • เราได้ปรับบทบาทพื้นฐานของ 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 ภายในคอมโพเนนต์หากจำเป็น การเปลี่ยนเป็นค่าว่างจะทำให้คอมโพเนนต์บางอย่างไม่จัดสรร 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)
  • แก้ไขปัญหาการแคชสีปุ่ม (3e5bbcb/327371655)

เวอร์ชัน 1.2.0

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

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

ปัญหาที่ทราบ

  • เราได้เปิดตัวข้อบกพร่องในการแสดงผลการทำงานร่วมกันของ View-Compose ใน PrimaryTabRow ซึ่งเป็นส่วนหนึ่งของการเปลี่ยนแปลงเพื่อปรับปรุงประสิทธิภาพ วิธีแก้ปัญหาเฉพาะหน้าคือใช้ TabRow กับ TabRowDefaults.PrimaryIndicator

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

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

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

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

เลื่อนระดับ 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 บูลีนใหม่เหล่านี้ช่วยกำหนดวิธีที่ Bottom Sheet แบบโมดัลควรจัดการเหตุการณ์ 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 โดยตรง คุณสามารถใช้ฟังก์ชันเหล่านี้แทนฟังก์ชัน Composable rememberDatePickerState และ rememberDateRangePickerState ได้เมื่อจำเป็น (I70326, b/291524052)
  • TabRowsแบบคงที่และแบบเลื่อนได้มีตัวแปรหลักและตัวแปรรองแล้ว ซึ่งจะแมปกับลักษณะการทำงานของสีและตัวบ่งชี้อย่างถูกต้องตามที่กำหนดไว้ใน Material3
  • PrimaryScrollableTabRow และ SecondaryScrollableTabRow จะแสดงสถานะการเลื่อนแล้ว (Iec8f5, b/260572337)
  • เพิ่มพารามิเตอร์ sheetMaxWidth ใหม่ที่นักพัฒนาแอปสามารถตั้งค่าเพื่อระบุความกว้างสูงสุดที่ชีตจะครอบคลุม คุณส่ง Dp.Unspecified สำหรับพารามิเตอร์ได้หากต้องการชีตที่ครอบคลุมความกว้างของหน้าจอทั้งหมด (Ifb7c9, b/266697696)
  • เพิ่ม API PlainTooltipBox และ RichTooltipBox กลับมาเป็นวิธีการที่เลิกใช้งานแล้ว (I246fa)

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

  • แก้ไขข้อขัดข้องเมื่อDatePickerเริ่มต้นด้วย DatePickerFormatter ที่มีโครงสร้างวันที่บางอย่างซึ่งยังคงเหมือนเดิมเมื่อแปลงเป็นรูปแบบวันที่ (เช่น YY) (I01f29)

เวอร์ชัน 1.2.0-alpha08

20 กันยายน 2023

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

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

  • ColorScheme ตอนนี้เป็นแบบเปลี่ยนแปลงไม่ได้แล้ว ซึ่งทำให้การอัปเดตสีแต่ละรายการมีประสิทธิภาพน้อยลง แต่ทำให้การใช้สีที่พบบ่อยมีประสิทธิภาพมากขึ้น เหตุผลที่อยู่เบื้องหลังการเปลี่ยนแปลงนี้คือแอปส่วนใหญ่ไม่ได้มี 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 มีแท็ก Anchor ที่ซ่อนไว้ที่กำหนดแล้ว แม้ว่าจะปิดใช้โดยค่าเริ่มต้นก็ตาม
  • อัปเดตเอกสาร 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)
  • คืนค่า Getter พร็อพเพอร์ตี้ LocalMinimuTouchTargetEnforcement และทําเครื่องหมายว่าเลิกใช้งานแล้ว พร้อมเปลี่ยนเส้นทางไปยัง LocalMinimumInteractiveComponentEnforcement (I60dd5)

เวอร์ชัน 1.1.0-alpha05

26 มกราคม 2023

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

ฟีเจอร์ใหม่

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

การอัปเดตทรัพยากร Dependency

  • ตอนนี้ 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 ใน Surfaces ระบบจะใช้พร็อพเพอร์ตี้นี้ในการเปลี่ยนแปลงในภายหลังซึ่งจะกำหนดลำดับการข้ามตามความหมายเชิงความหมายขององค์ประกอบต่างๆ เช่น พื้นผิว (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
  • อัปเดตลิ้นชักและชีตเพื่อหน่วงเวลาการกดอย่างถูกต้องในกรณีที่ท่าทางสัมผัสอาจกลายเป็นเหตุการณ์การเลื่อน

การอัปเดตทรัพยากร Dependency

  • ตอนนี้ 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

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

  • 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ฟังก์ชันลักษณะการทำงานให้เป็น Composable และระบุค่าเริ่มต้นสำหรับสถานะแถบแอปด้านบนและข้อกำหนดภาพเคลื่อนไหว (I642b3)
  • อัปเดตลายเซ็นของคอมโพเนนต์ FAB ให้ตรงกับ API ของ Surface (I3afaa)
  • เพิ่มการรองรับการแทรกในตัวสำหรับแถบแอปด้านบน ลิ้นชัก แถบนำทาง และแถบข้างนำทาง เมื่อใช้แยกกันหรือใช้กับ Scaffold คอมโพเนนต์เหล่านี้จะจัดการส่วนที่เว้นไว้สำหรับนักพัฒนาแอปโดยอัตโนมัติ หมายเหตุ: การเปลี่ยนแปลงนี้ไม่ได้เพิ่มการจัดการไอคอนแถบสถานะและความโปร่งใสของแถบสถานะและแถบนำทางโดยอัตโนมัติ โปรดดำเนินการด้วยตนเองต่อไปเพื่อให้มั่นใจว่าจะได้รับประสบการณ์การใช้งานแบบขอบจรดขอบที่ดีที่สุด (I7e4e6, b/183161866)
  • ค่าเริ่มต้นของคอมโพเนนต์ที่อัปเดตแล้วจะลดพื้นผิว API เพื่อความยืดหยุ่นและการปรับปรุงประสิทธิภาพในอนาคต (I31820)
  • จัดเรียงพารามิเตอร์ของชิปและชีตลิ้นชักการนำทางใหม่เพื่อรักษาความสอดคล้องภายใน API (I45d0b)
  • นำ startIndent ออกจากตัวคั่นและย้ายสีให้เป็นพารามิเตอร์สุดท้าย (If7be2)

เวอร์ชัน 1.0.0-alpha16

10 สิงหาคม 2022

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

ฟีเจอร์ใหม่

  • รองรับการระบุความกว้างที่กำหนดเองในลิ้นชักการนำทาง (Ia7f10)

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

  • จัดเรียงพารามิเตอร์แท็บ Reorder และแท็บไอคอน Leading ใหม่เพื่อรักษาความสอดคล้องภายใน API (Ie2637)
  • ทำเครื่องหมาย BadgeDefaults ว่าเป็นเวอร์ชันทดลอง (I98ef3)
  • นำฟังก์ชันลิ้นชักการนำทางที่เลิกใช้งานแล้วออก (I4f2db)
  • จัดเรียงพารามิเตอร์แถบเลื่อนการเรียงใหม่ใน Material 3 เพื่อรักษาความสอดคล้องกันภายใน API (I0aee7)
  • จัดเรียงพารามิเตอร์ NavigationBar และ NavigationRail ใหม่เพื่อให้สอดคล้องกันภายใน API (I51cda)
  • จัดลำดับพารามิเตอร์ใหม่ใน Material 3 เพื่อรักษาความสอดคล้องกันใน API (If4ae1)
  • จัดเรียงพารามิเตอร์ของแถบเลื่อนใหม่ใน Material 3 เพื่อรักษาความสอดคล้องภายใน API (I62673)
  • เปลี่ยนชื่อพารามิเตอร์ไอคอนเป็นการดำเนินการเพื่อให้สอดคล้องกับแถบแอปด้านบน (Id75be)
  • ทำเครื่องหมาย Badge และ BadgedBox เป็นเวอร์ชันทดลองเนื่องจากการจัดแนว Anchor ยังคงมีการเปลี่ยนแปลง (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

  • อัปเดต Surface API ของ Material 3 ซึ่งจะนำฟังก์ชันที่โอเวอร์โหลดกลับมาสำหรับ 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

การเปลี่ยนแปลง 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)

การอัปเดตทรัพยากร Dependency

  • ตอนนี้ขึ้นอยู่กับ 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

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