Compose Material 3

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

โครงสร้าง

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 สำหรับ แอปหรือโมดูล

ดึงดูด

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

android {
    buildFeatures {
        compose true
    }

    composeOptions {
        kotlinCompilerExtensionVersion = "1.1.1"
    }

    kotlinOptions {
        jvmTarget = "1.8"
    }
}

Kotlin

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

android {
    buildFeatures {
        compose = true
    }

    composeOptions {
        kotlinCompilerExtensionVersion = "1.1.1"
    }

    kotlinOptions {
        jvmTarget = "1.8"
    }
}

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

ความคิดเห็น

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

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

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

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

เวอร์ชัน 1.0.0-alpha01

23 กันยายน 2026

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

ฟีเจอร์ใหม่

ตัวแสดงผล Agent-to-UI (A2UI) ของ Jetpack Compose มีการติดตั้งใช้งานโปรโตคอล A2UI ซึ่งช่วยให้ Agent AI สร้างอินเทอร์เฟซผู้ใช้แบบอินเทอร์แอกทีฟที่สมบูรณ์ซึ่งแสดงผลคอมโพเนนต์ Compose แบบเนทีฟได้โดยไม่ต้องเรียกใช้โค้ดที่กำหนดเอง ไลบรารีนี้มีการใช้งานข้อกำหนดแคตตาล็อกพื้นฐานของ A2UI มาตรฐานที่พร้อมใช้งาน ซึ่งสร้างขึ้นโดยใช้คอมโพเนนต์ Material Design 3

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

  • อัปเดตลำดับของคอมโพเนนต์ใน A2uiBasicCatalogV ให้ ตรงกับข้อกำหนดแคตตาล็อกพื้นฐานทุกประการ (I23093, b/547851648)
  • เพิ่ม ChecksProperty ลงในอินเทอร์เฟซคอมโพเนนต์ที่เกี่ยวข้องทั้งหมด ภายใต้ A2uiBasicCatalogV1 และทําให้ค่าพร็อพเพอร์ตี้พร้อมใช้งาน ผ่านพารามิเตอร์ที่ส่งไปยัง TypedContent ของแต่ละคอมโพเนนต์ (I9f393, b/547851648)
  • เพิ่ม A2uiBasicCatalogV1.ChoicePicker และ MaterialA2uiBasicCatalogV1Defaults.choicePicker แล้ว (I875a6, b/547851648)
  • เพิ่ม A2uiBasicCatalogV1.Modal และ MaterialA2uiBasicCatalogV1Defaults.modal แล้ว (Icd553, b/547851648)
  • เพิ่ม AccessibilityProperty ลงในอินเทอร์เฟซคอมโพเนนต์ทั้งหมด ภายใต้ A2uiBasicCatalogV1 และทําให้ค่าพร็อพเพอร์ตี้พร้อมใช้งาน ผ่านพารามิเตอร์ที่ส่งไปยัง TypedContent ของแต่ละคอมโพเนนต์ (I76b80, b/547851648)
  • เพิ่ม A2uiBasicCatalogV1.TextField และ MaterialA2uiBasicCatalogV1Defaults.textField แล้ว (Ifdaec, b/547851648)
  • เพิ่ม A2uiBasicCatalogV1.Video และ MaterialA2uiBasicCatalogV1Defaults.video แล้ว (I8595c, b/547851648)
  • เพิ่ม A2uiBasicCatalogV1.AudioPlayer และ MaterialA2uiBasicCatalogV1Defaults.audioPlayer แล้ว (Ida509, b/547851648)
  • เพิ่ม A2uiBasicCatalogV1.Slider และ MaterialA2uiBasicCatalogV1Defaults.slider แล้ว (Ieb72d, b/547851648)
  • เพิ่ม A2uiBasicCatalogV1.CheckBox และ MaterialA2uiBasicCatalogV1Defaults.checkBox แล้ว (I84525, b/547851648)
  • เพิ่ม A2uiBasicCatalogV1.Divider และ MaterialA2uiBasicCatalogV1Defaults.divider แล้ว (I91208, b/547851648)
  • เพิ่ม A2uiBasicCatalogV1.Tabs และ MaterialA2uiBasicCatalogV1Defaults.tabs แล้ว (Ic33d3, b/547851648)
  • เพิ่ม A2uiBasicCatalogV1.List และ MaterialA2uiBasicCatalogV1Defaults.list แล้ว (I89f73, b/547851648)
  • เพิ่ม A2uiBasicCatalogV1.Icon และ MaterialA2uiBasicCatalogV1Defaults.icon แล้ว (I65524, b/547851648)
  • เพิ่ม A2uiBasicCatalogV1.Image และ MaterialA2uiBasicCatalogV1Defaults.image แล้ว (I673b3, b/547851648)
  • เพิ่ม A2uiBasicCatalogV1.Button และ MaterialA2uiBasicCatalogV1Defaults.button แล้ว (I5215f, b/547851648)
  • เพิ่ม A2uiBasicCatalogV1.Row/A2uiBasicCatalogV1.Column และ MaterialA2uiBasicCatalogV1Defaults.row/ MaterialA2uiBasicCatalogV1Defaults.column แล้ว (Ibcbe7, b/547851648)
  • เพิ่ม MaterialImageComponent เพื่อรองรับการแสดงรูปภาพในแคตตาล็อก A2UI ทดสอบ: MaterialImageComponentTest เข้าสู่ androidx-main
  • เพิ่ม MaterialImageComponent เพื่อรองรับการแสดงรูปภาพในแคตตาล็อก A2UI (I868fe)
  • เพิ่ม A2uiBasicCatalogV1.Card และ MaterialA2uiBasicCatalogV1Defaults.card แล้ว (Icf604, b/547851648)
  • เลิกใช้งานการโอเวอร์โหลด Slider และ RangeSlider แบบไม่เก็บสถานะเพื่อสนับสนุนเวอร์ชันแบบเก็บสถานะ เปลี่ยนชื่อ activeRangeStart และ activeRangeEnd ใน RangeSliderState เป็น startValue และ endValue พร้อมเลิกใช้งาน API แถบเลื่อนรุ่นเก่าที่ไม่ได้โปรโมตและเป็นเวอร์ชันทดลองด้วย DeprecationLevel.HIDDEN (If8995)
  • เพิ่ม A2uiSurface composable และ A2uiSurfaceDefaults สำหรับการแสดงผลแพลตฟอร์ม A2UI (I6e276, b/544713825)
  • เพิ่ม A2uiTestSurface ที่ใช้ร่วมกันได้เพื่อติดตั้งและทดสอบพื้นผิวและคอมโพเนนต์ A2UI แยกกัน (I03c8a, b/527415570)

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

  • compileSdk สำหรับไลบรารี Compose ที่อัปเดตเป็น 37.1 ซึ่งจะต้องอัปเดต compileSdk สำหรับแอปและไลบรารีทั้งหมดที่ใช้ Compose (I05b0f)

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)

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

  • ใช้ขอบแทรกสำหรับเนื้อหาโดยค่าเริ่มต้น (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 ที่ส่งไปยังคอมโพเนนต์เหล่านี้ เราขอแนะนำให้ส่งค่าเป็น 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 Adaptive Pane Scaffold

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

Compose Material3 เวอร์ชัน 1.5

เวอร์ชัน 1.5.0-alpha29

23 กันยายน 2026

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

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

  • การเปลี่ยนแปลงที่ทำให้ใช้งานร่วมกันไม่ได้: ตอนนี้ onValueChange เป็นพารามิเตอร์ที่จำเป็นใน Slider และ RangeSlider และลำดับในรายการพารามิเตอร์มีการเปลี่ยนแปลง

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

  • DatePicker ตอนนี้จะแสดงผลใน 1 เฟรมโดยการคำนวณความพร้อมใช้งานของการไปยังส่วนต่างๆ ของเดือนจากดัชนีเดือนที่แสดงโดยตรง (I08db7)
  • TimeInput ตอนนี้ใช้ TextFieldState API ช่องข้อความใหม่ภายในแล้ว (Ia7492, b/353692863)
  • DateInput ตอนนี้ใช้ TextFieldState API ช่องข้อความใหม่ภายในแล้ว (I5ad3d, b/353692863)
  • ตอนนี้ Slider และ RangeSlider จะจัดการ onValueChange และ onValueChangeFinished โดยตรงในการติดตั้งใช้งานของตนเองแทนที่จะส่งไปยัง SliderState และ RangeSliderState (I959ac)

เวอร์ชัน 1.5.0-alpha28

9 กันยายน 2026

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

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

  • เปลี่ยนชื่อและทำให้ API แคร์รอสเซลหลายแง่มุมง่ายขึ้นเป็นตัวแก้ไขcarouselParallaxScrollEffectส่วนกลาง (I46b17)
  • นำโอเวอร์โหลด ToggleButton ที่เลิกใช้งานแล้วออก เพิ่มฟังก์ชันยูทิลิตี (contentPaddingFor, shapesFor) และค่าคงที่เริ่มต้น (รวมถึง size) ลงใน ToggleButtonDefaults, ElevatedToggleButtonDefaults, FilledTonalToggleButtonDefaults และ OutlinedToggleButtonDefaults (I998cf)

  • เลิกใช้งานการโอเวอร์โหลด Slider และ RangeSlider แบบไม่เก็บสถานะเพื่อสนับสนุนเวอร์ชันแบบเก็บสถานะ เปลี่ยนชื่อ activeRangeStart และ activeRangeEnd ใน RangeSliderState เป็น startValue และ endValue พร้อมเลิกใช้งาน API แถบเลื่อนรุ่นเก่าที่ไม่ได้โปรโมตและเป็นเวอร์ชันทดลองด้วย DeprecationLevel.HIDDEN (If8995)

    วิธีย้ายข้อมูล Slider จาก kotlin var value by remember { mutableFloatStateOf(0.5f) } Slider(value = value, onValueChange = { value = it }) ไปยัง kotlin val state = remember { SliderState(value = 0.5f) } Slider(state = state)

    วิธีย้ายข้อมูล RangeSlider จาก kotlin var range by remember { mutableStateOf(0.2f..0.8f) } RangeSlider(value = range, onValueChange = { range = it }) ไปยัง kotlin val state = remember { RangeSliderState(startValue = 0.2f, endValue = 0.8f) } RangeSlider(state = state)

  • เพิ่มพารามิเตอร์บูลีนที่เปิดใช้และสีที่ปิดใช้ไปยัง ScrollField (Iab612)

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

  • เพิ่มการรองรับวงแหวนโฟกัสสำหรับ ScrollField (If21d6)
  • ปรับความคิดเห็นด้านการออกแบบสำหรับ TimePicker ที่สื่ออารมณ์ในโหมดการโทร (I8795e)
  • ปรับระยะขอบสำหรับ TimePicker ที่แสดงออกในโหมดเลื่อนและโหมดป้อนข้อมูล (Iddb33)
  • อัปเดตการคำนวณความสูง/เลย์เอาต์ของสวิตช์เปิด/ปิดตามจำนวนรายการสำหรับ TimePicker.kt ที่สื่อความหมายในโหมดที่ไม่มีคอนเทนเนอร์ (I30700)
  • แก้ไขปัญหาที่ตัวควบคุม AM/PM ถูกตัดทอนใน TimePicker เมื่อเปิดใช้ข้อความขนาดใหญ่หรือการปรับขนาดแบบอักษร (Iaca60)
  • อัปเดตคอมโพเนนต์ SecureTextField และ OutlinedSecureTextField (รวมถึงการโอเวอร์โหลด BasicSecureTextField ที่เลิกใช้งานแล้ว) เพื่อใช้ TextObfuscationMode.System เป็นโหมดการปกปิดเริ่มต้นแทน TextObfuscationMode.RevealLastTyped (I76c7e)

เวอร์ชัน 1.5.0-alpha27

26 สิงหาคม 2026

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

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

  • เปลี่ยนชื่อ RichTimePickerDialog เป็น VibrantTimePickerDialog, เปลี่ยนชื่อ richColors เป็น vibrantColors ใน TimePickerDefaults และ TimeInputDefaults, เปลี่ยนชื่อ richContainerColor และ richShape เป็น vibrantContainerColor และ vibrantShape ใน TimePickerDialogDefaults และเปลี่ยนชื่อพร็อพเพอร์ตี้สีที่ไม่ได้เลือกเป็น periodSelectorContainerColor, periodSelectorContentColor, timeSelectorContainerColor, timeSelectorContentColor และ clockDialContentColor (Iea5aa)
  • อัปเดต Rich TimePicker API เพื่ออนุญาตกล่องโต้ตอบการเลื่อน/ป้อนข้อมูลที่ไม่มีการจำกัด (I2b3b6)
  • เปิดตัว SelectableDropdownMenuItem และ CheckableDropdownMenuItem สำหรับรายการเมนูที่เลือกได้และทำเครื่องหมายได้ อัปเดต DropdownMenuItem ด้วยรูปร่างเพื่อใช้ MenuItemColors และเพิ่ม MenuDefaults.itemVibrantColors() เพื่อรองรับ MenuItemColors ที่สดใส (I160ca)
  • เพิ่มการโอเวอร์โหลด ToggleButton, ElevatedToggleButton, FilledTonalToggleButton และ OutlinedToggleButton ที่แสดงความคิดเห็นพร้อมช่อง ButtonSize และ icon เปลี่ยนชื่อเมธอด ToggleButtonDefaults, ElevatedToggleButtonDefaults, FilledTonalToggleButtonDefaults และ OutlinedToggleButtonDefaults ให้เป็น colors() และ border() (Iab484)
  • นำโอเวอร์โหลดที่เลิกใช้งานแล้วของ pinnedScrollBehavior และ enterAlwaysScrollBehavior ออกจาก TopAppBarDefaults โปรดใช้โอเวอร์โหลดที่ใช้ ScrollableState แทน (Idef9d)
  • นำ API การทดสอบ LocalMotionScheme ที่เลิกใช้งานแล้วออกจาก MaterialTheme โปรดใช้ MaterialTheme.motionScheme แทน (I4b61d)
  • เพิ่มTimeInputDefaultsและTimeInputColorsสำหรับ TimeInput (I7534e)

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

  • แก้ไขปัญหาที่ ScrollDisplayModeToggle ประกาศว่า "เปลี่ยนเป็นโหมดเลื่อน" ขณะอยู่ในโหมดเลื่อน (I2d588)
  • แก้ไขปัญหาที่ DropdownMenuItem ที่ไม่มีไอคอนนำหน้าไม่จัดแนวไอคอนต่อท้ายไปที่ท้ายรายการเมนู (Ia24ff, b/542873381)

เวอร์ชัน 1.5.0-alpha26

12 สิงหาคม 2026

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

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

  • เพิ่ม ElevatedToggleButtonDefaults, FilledTonalToggleButtonDefaults และ OutlinedToggleButtonDefaults รวมถึงล้างพร็อพเพอร์ตี้รูปร่างที่ไม่มีความหมายใน ToggleButtonDefaults (Ia0a85)
  • แก้ไขปัญหาคอนทราสต์ของฟีเจอร์การช่วยเหลือพิเศษสำหรับป้ายกำกับของ NavigationItem ในธีมที่มีคอนทราสต์สูง ตอนนี้คุณระบุสีของป้ายกำกับได้ผ่าน selectedTextColorTopIconPosition (สีของป้ายกำกับของรายการแนวตั้ง ซึ่งไม่มีการเปลี่ยนแปลง) และ selectedTextColorStartIconPosition (สีของป้ายกำกับของรายการแนวนอน ซึ่งตอนนี้ตั้งค่าให้ตรงกับ selectedIconColor) หากต้องการเปลี่ยนกลับการอัปเดตนี้ ให้ส่ง ShortNavigationBarItemDefaults/WideNavigationRailItemDefaults.colors().copy(selectedTextColorStartIconPosition = MaterialTheme.colorScheme.secondary) (I85855, b/490910896)
  • ระบบได้นำตัวแปรออฟเซ็ตการเลื่อนออกจาก SearchBarScrollBehavior แล้ว และตอนนี้ควรเข้าถึงผ่านคลาสใหม่ SearchBarScrollState (Ib24e4)
  • เลื่อนระดับ BottomAppBar และวิธีการที่เกี่ยวข้องเป็นเวอร์ชันเสถียร API เหล่านี้ไม่จำเป็นต้องเลือกใช้ @ExperimentalMaterial3Api อีกต่อไป (I42c61)
  • บันทึกโหมดการเลือกที่ใช้งานอยู่ใน TimePickerState เมื่อมีการคืนค่าสถานะ และเพิ่มพารามิเตอร์ initialSelection ลงในฟังก์ชัน Factory TimePickerState (Iad905)
  • ตอนนี้ ExposedDropdownMenu เป็นฟังก์ชันส่วนขยายใน ExposedDropdownMenuBoxScope แทนที่จะเป็นสมาชิก คุณอาจต้องอัปเดตรหัสด้วยการนำเข้าใหม่ (Ie8a65, b/356452026)

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

  • แก้ไขปัญหาที่การปรับแต่งสีบางส่วนใน MenuDefaults.itemColors เขียนทับสีที่ไม่ได้ระบุด้วย Color.Unspecified (Iea847)
  • แก้ไขTalkBackการอ่านออกเสียงเพื่ออ่านค่าเวลาที่จัดรูปแบบในTimePickerที่เลื่อนได้ (Ice981)
  • แก้ไขข้อขัดข้องใน ExposedDropdownMenu เมื่อความสูงของหน้าจอน้อยกว่าความสูงของเมนู (I6adf1)
  • แก้ไขการเว้นระยะห่างของเนื้อหาที่ไม่ถูกต้องของแถบข้างนำทางแบบกว้าง ตอนนี้ระยะห่างจากด้านล่างเป็น 0 หากต้องการเปลี่ยนกลับการอัปเดตนี้ คุณสามารถตั้งค่า contentPadding = PaddingValues(0.dp,44.dp,0.dp,44.dp) ได้ (I572bb)
  • อัปเดต API สาธารณะให้สอดคล้องกับความคิดเห็นจากการตรวจสอบ API ล่าสุด (I71aff, b/532657001)

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

  • แก้ไขปัญหา Slider Label Material3 ไม่แสดงขณะลากแถบเลื่อนด้วยเมาส์ (I97a6d, b/533483487)

เวอร์ชัน 1.5.0-alpha25

29 กรกฎาคม 2026

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

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

  • เปลี่ยนชื่อพารามิเตอร์ trailingIcon เป็น trailingContent ในรูปร่าง ตรวจสอบ และเลือกการโอเวอร์โหลด DropdownMenuItem ขณะที่ยังคงความเข้ากันได้แบบไบนารี (I2ecbd)
  • เพิ่มพร็อพเพอร์ตี้สีการเลือกและคอนเทนเนอร์ใหม่ลงใน MenuItemColors และเปลี่ยนชื่อ trailingIcon เป็น trailingContent ในตัวสร้างสีใหม่พร้อมคงความเข้ากันได้แบบไบนารี (I20b92)
  • ปรับปรุงการช่วยเหลือพิเศษ ScrollField และการรองรับการนำทางด้วยแป้นพิมพ์ (If7477)
  • นำ ComponentOverride API ออก (I3784b)
  • เลิกใช้งาน SliderState.Saver และ RangeSliderState.Saver แบบ 2 พารามิเตอร์เพื่อรองรับการโอเวอร์โหลดใหม่ที่ใช้ขั้นตอน SliderState ไม่ได้ใช้ DraggableState แบบสาธารณะอีกต่อไป (I7c91b)
  • BasicAlertDialog API ที่สำเร็จการศึกษาจากเวอร์ชันทดลอง (If157c)
  • เปลี่ยน ButtonGroupScope ใน ButtonGroup เป็น sealed interface แยก Modifier.animateWidth เป็น 2 โอเวอร์โหลดเพื่อให้ละเว้น compressionLimit และแก้ไขทิศทางเลย์เอาต์แบบไดนามิกได้ และเปลี่ยนประเภทพารามิเตอร์ compressionLimit จาก PaddingValues เป็น Dp (I8ef39)
  • เปลี่ยนชื่อ TonalToggleButton เป็น FilledTonalToggleButton แล้ว เพิ่มภาพเคลื่อนไหวของเส้นขอบแบบเรียบใน OutlinedToggleButton เลิกใช้งาน ToggleButtonDefaults.shapes แล้วหันมาใช้ shapesFor แทน (Icb433)
  • โปรโมต LinearTrackStopIndicatorSize, LinearIndicatorTrackGapSize และ CircularIndicatorTrackGapSize เป็น เวอร์ชันเสถียร (I794d0)
  • เลิกใช้งาน API SplitButtonLayout เพื่อใช้ SplitButton แทน (Ic9840)

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

  • อัปเดตการสลับโฟกัสในกรณีที่เกิดข้อผิดพลาดสำหรับอินพุต TimePickerTextField ใน TimePicker.kt (Ieceec)
  • แก้ไขรูปร่างของรายการในรายการที่แบ่งกลุ่มเมื่อรายการมีเพียงรายการเดียว (I2ea1c, b/479721696)
  • อัปเดต KDocs สำหรับ TimePickerDialog.kt (Ia5fb8)

เวอร์ชัน 1.5.0-alpha24

15 กรกฎาคม 2026

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

ฟีเจอร์

  • เพิ่มตัวแปรการเลื่อนใหม่สำหรับ TimePicker ที่สื่ออารมณ์ (I46f6b)
  • เพิ่มmaterial3-rippleไลบรารีใหม่ (I1b3a3) ซึ่งรองรับการวาดระลอกที่แสดงโฟกัสด้วยวงแหวนโฟกัสแบบฝังแทนเลเยอร์ความทึบ ไลบรารีใหม่นี้จะใช้แทน material-ripple และการใช้งานที่คาดไว้จะคล้ายกัน ดังนี้
    • หากคุณใช้ material3 เอง ให้ใช้การกำหนดค่าระลอก material3 ในตัวที่ผสานรวมกับธีมและใช้ material3-ripple ภายในเป็นรายละเอียดการติดตั้งใช้งาน
    • หากคุณใช้ material-ripple โดยตรงหรือต้องการรองรับวงแหวนโฟกัสแบบแทรกโดยไม่ต้องขึ้นอยู่กับ material3 ให้ใช้ไลบรารี material3-ripple ใหม่โดยตรง

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

  • เปลี่ยนพารามิเตอร์แถบเลื่อน ScrollIndicatorState ให้เป็นแบบไม่เป็นค่าว่าง (Iab7c7, b/529445739)
  • เพิ่มคำอธิบายประกอบ @ExperimentalMaterial3Api ลงใน API ของ AppBarWithSearch อีกครั้ง (I0b61a)
  • เลื่อนระดับ API SearchBarState ที่ได้รับการโปรโมตและ API SearchBar ตามช่องไปยังเวอร์ชันที่เสถียร SearchBar API รุ่นเก่าที่เลิกใช้งานแล้วซึ่งใช้ expanded/onExpandedChange (Ia3793)

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

  • แก้ไขปัญหาความล่าช้าในการแสดงผลที่เครื่องหมายแคร์เร็ต RichTooltip และ PlainTooltip ปรากฏขึ้นช้าในระหว่างภาพเคลื่อนไหวตอนเข้า (I874b6, b/395753083)
  • อัปเดตค่าขอบสำหรับตัวแปร Input/Scroll ของ TimePicker (I83f00)
  • SplitButton วัดปุ่มท้ายก่อนเพื่อให้มีพื้นที่ (Id3a1e)
  • แก้ไขปัญหาการช่วยเหลือพิเศษที่ผู้ใช้การเข้าถึงด้วยสวิตช์ไม่สามารถเปิดใช้งานช่องข้อความที่แก้ไขได้ภายใน ExposedDropdownMenuBox (I0ea17)
  • แก้ไขลำดับการประกาศของ TalkBack ใน TextField และ OutlinedTextField เมื่อมีคำนำหน้าหรือคำต่อท้าย (Ie79e7)
  • อัปเดตTimePickerขอบและตำแหน่งโคลอน (I6bfeb)
  • แก้ไขลำดับโฟกัสใน Talkback สำหรับ ScrollField (I4ca9f, b/526870141)
  • อัปเดตทรัพยากร Dependency ของ Compose ใน Material 3 เป็น 1.12.0-beta01 (Ie9417)
  • ตอนนี้เคล็ดลับเครื่องมือจะยึดติดกับขอบเขตของหน้าต่างเพื่อป้องกันไม่ให้ถูกตัดออกในหน้าจอขนาดเล็กหรือภายใต้การกำหนดค่าแบบอักษรขนาดใหญ่ (I421ff)
  • อัปเดต ScrollField ด้วยการเปลี่ยนตัวเลขที่สื่อความหมายมากขึ้น และปรับขนาด/การจัดรูปแบบตัวอักษร (Ic1614)

เวอร์ชัน 1.5.0-alpha23

1 กรกฎาคม 2026

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

ฟีเจอร์ - คอมโพเนนต์ expressive timepicker (Iaa45f) - เพิ่มตัวแปรแบบใหม่ที่ไม่โต้ตอบของรายการมาตรฐานและรายการที่แบ่งกลุ่มซึ่งเป็นไปตามข้อกำหนดของ Material Expressive เวอร์ชันที่ไม่ใช่แบบสื่ออารมณ์เลิกใช้งานแล้ว (Ide4de, b/491994186)

การเปลี่ยนแปลงลักษณะการทำงาน - แก้ปัญหาที่ความสูงขั้นต่ำของรายการในรายการแบบด่วนไม่เปลี่ยนแปลงตามบรรทัดของเนื้อหา เราได้เปิดตัวแฟล็กฟีเจอร์ isExpressiveListItemHeightBasedOnTextLinesFixEnabled เพื่อช่วยในการย้ายข้อมูล (Ibbb91, b/484693233)

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

  • API รายการที่มีการแสดงออกไม่ได้อยู่ในช่วงทดลองอีกต่อไป (I2836a)
  • นำ ComponentOverride API ออก (I820c4)
  • นำพารามิเตอร์ออฟเซ็ตที่ไม่ได้ใช้ออกจาก DropdownMenuPopup เพิ่มพร็อพเพอร์ตี้เมนูเริ่มต้นลงในค่าเริ่มต้นของเมนู อัปเดตการตั้งชื่อป้ายกำกับกลุ่มจาก MenuDefaults.Label เป็น MenuDefaults.DropdownMenuGroupLabel แล้ว เพิ่ม disabledContainerColor ลงใน MenuDefaults.selectableItemColors และ MenuDefaults.selectableItemVibrantColors เพิ่มพารามิเตอร์ Modifier ลงในฟังก์ชันที่ประกอบกันได้ใน MenuDefaults ซึ่งแสดงผลเลย์เอาต์ (I3d2b1)
  • เพิ่มตัวรับข้อมูลสาธารณะ flingAnimationSpec ไปยัง TopAppBarDefaults เพื่อแสดงข้อกำหนดภาพเคลื่อนไหวการดีดเริ่มต้น (Ic1daa)
  • เปลี่ยนจาก TopAppBar, MediumFlexibleTopAppBar,LargeTopAppBar,LargeFlexibleTopAppBar,TwoRowsTopAppBar,FlexibleBottomAppBar,FlexibleContentPadding,FlexibleBottomAppBarHeight,FlexibleHorizontalArrangement,FlexibleFixedHorizontalArrangement เป็นแบบไม่ทดลอง API และตัวแปรเหล่านี้ไม่จำเป็นต้องเลือกใช้ @ExperimentalMaterial3ExpressiveApi อีกต่อไป (Ia4af6)
  • ExpandedDockedSearchBarWithGap และ ExpandedFullScreenContainedSearchBar จะเปลี่ยนไปใช้เวอร์ชันที่ไม่ใช่เวอร์ชันทดลอง (Ie152d)

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

  • ล้างข้อมูล API (Ia8066)
  • แก้ไขลำดับการไปยังส่วนต่างๆ ด้วยแป้นพิมพ์ของ Scaffold (I77194, b/462577176)
  • นำข้อกำหนดสำหรับ compileSdk 37 ออก (If78b4)
  • เพิ่มการรองรับ a11y สำหรับคอมโพเนนต์ ScrollField กล่าวโดยละเอียดคือ ตอนนี้ ScrollField ได้นำการเลือกมาใช้และเคลื่อนไหวไปยังรายการที่เลือกเมื่อคลิกพร้อมประกาศที่เลือก/ไม่ได้เลือกใน Talkback (I7bdb7)
  • แก้ไขข้อบกพร่องที่ทำให้มีระยะห่างด้านล่างเพิ่มเติมหากเนื้อหาของโครงสร้าง Nav Suite มีการตั้งค่าระยะห่าง IME (I86d9d, b/389467593)

เวอร์ชัน 1.5.0-alpha22

17 มิถุนายน 2026

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

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

  • เพิ่ม snapAnimationSpec getter สาธารณะลงใน TopAppBarDefaults เพื่อแสดงข้อมูลจำเพาะของภาพเคลื่อนไหวสแนปเริ่มต้น (Ic7b37, b/519193808)
  • เพิ่มรูปร่างให้กับเมธอดภายในและส่วนตัวของ TimePicker.kt API (I9d09e, b/441573791)
  • รองรับรูปร่างใน AnimatedPane (Ie7c60, b/470517507)
  • แก้ไขคอนทราสต์ของปุ่มเปิด/ปิด AM/PM สำหรับ TimePicker (Ifc0b7, b/339079853)
  • เปลี่ยนสถานะ API ที่สื่ออารมณ์FloatingToolbarจากเวอร์ชันทดลองเป็นเวอร์ชันที่ไม่ใช่เวอร์ชันทดลอง (I5a4d8, b/497887216)
  • นำ transformOriginState ที่เลิกใช้งานแล้วออกจาก DropdownMenuPopupPositionProvider (I0d5b0, b/505481611)
  • อัปเดต pinnedScrollBehavior และ enterAlwaysScrollBehavior ให้ยอมรับ ScrollableState ซึ่งจะจัดการกรณีข้อยกเว้นโดยอัตโนมัติ เช่น เลย์เอาต์ที่กลับด้านและเนื้อหาที่เลื่อนไว้ล่วงหน้า การโอเวอร์โหลดเดิมจะเลิกใช้งาน ย้ายข้อมูลการใช้งาน isScrollingContentAtStart ไปยังโอเวอร์โหลดใหม่ด้วยพารามิเตอร์ scrollableState เลื่อนระดับ TopAppBarScrollBehavior และ API ที่เกี่ยวข้องเป็นเวอร์ชันเสถียร (Ib83cf, b/519193808)
  • อัปเดต pinnedScrollBehavior และ enterAlwaysScrollBehavior ให้ยอมรับ ScrollableState ซึ่งจะจัดการกรณีข้อยกเว้นโดยอัตโนมัติ เช่น เลย์เอาต์ที่กลับด้านและเนื้อหาที่เลื่อนไว้ล่วงหน้า เลื่อนระดับ TopAppBarScrollBehavior และ API ที่เกี่ยวข้องเป็นเวอร์ชันเสถียร (Ieda4b, b/405129274)
  • อัปเดต DropdownMenuPositionProvider เพื่อนำ MutableState ออกจาก transformOrigin ยุบ MenuAnchorPosition จากอินเทอร์เฟซที่ปิดผนึกเป็นคลาสเดียว แนะนํา MenuAnchorPositionScope ซึ่งมีข้อมูลที่ใช้สร้างผู้สมัคร x และ y ที่กําหนดเองได้ (I21f2b, b/505481611)
  • เลื่อนระดับ ButtonGroup API เป็นเวอร์ชันเสถียร นำ API การทดสอบที่เลิกใช้งานแล้วซึ่งเปิดตัวใน 1.5.0-alpha ออก (Idaf96, b/497876828)

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

  • แก้ไขข้อบกพร่องที่ภาพเคลื่อนไหวการบีบอัดของ ButtonGroup จัดการระยะขอบของปุ่มที่ไม่สมมาตรหรือทิศทางเลย์เอาต์ RTL ไม่ถูกต้อง และอาจเกิดข้อขัดข้องกับ IllegalArgumentException ภายใต้ความหนาแน่นของการแสดงผลบางอย่าง (I35074, b/516743181)
  • แก้ไขกลไกการจัดการข้อผิดพลาดในโหมดป้อนข้อความของ TimePicker (If4541, b/405054265)

เวอร์ชัน 1.5.0-alpha21

3 มิถุนายน 2026

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

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

  • เพิ่มรูปร่างลงใน API ของคอมโพเนนต์ Timepicker (I57f28, b/441573791)
  • เพิ่ม compressionLimit ลงใน animateWidth ซึ่งระบุระยะขอบของรายการที่กำลังบีบอัด ซึ่งบ่งบอกถึงการบีบอัดสูงสุดที่รายการสามารถบีบได้ เลิกใช้งาน animateWidth API โดยไม่มีพารามิเตอร์ compressionLimit นี้ (I4a725, b/418822334, b/403281052)
  • BottomSheet และ ModalBottomSheet PartiallyExpanded จะไม่ถูกนำออกโดยอัตโนมัติตามเงื่อนไขของเลย์เอาต์อีกต่อไป ตอนนี้ผู้ใช้จะควบคุม Anchor นี้อย่างชัดเจนผ่าน rememberBottomSheetState ได้แล้ว คุณเปิดใช้ลักษณะการทำงานเดิมของคอมโพเนนต์เหล่านี้ได้โดยการปิดใช้แฟล็กฟีเจอร์ isBottomSheetPartiallyExpandedDeterministicEnabled หรือใช้ฟังก์ชัน rememberModalBottomSheetState และ rememberStandardBottomSheetState ที่เลิกใช้งานแล้ว ตอนนี้เราได้นำ isAnchoredDraggableComponentsAnchorRecoveryEnabled ออกจากฟีเจอร์แฟล็กแล้ว (Ia4167, b/478210200, b/512076811)
  • เปิดตัวแท็กทดลองสำหรับ PullToRefreshDefaults.loadingIndicatorColor และ PullToRefreshDefaults.loadingIndicatorContainerColor อีกครั้ง (Ib9d15, b/513225663)
  • อัปเดตพารามิเตอร์ SelectableChipColors ให้เป็นแบบสาธารณะ (I559e0, b/512576750)
  • เพิ่มพารามิเตอร์ horizontalArrangement ลงใน MenuItems (Ie8088, b/497891817)
  • ทำเครื่องหมายฟังก์ชัน contentPaddingFor ของปุ่มทำซ้ำว่าเป็นการทดลอง (I07d3e, b/500355872)
  • เปิดตัว roundedShape และ tonalColors() ในทั้ง TextFieldDefaults และ OutlinedTextFieldDefaults ซึ่ง เป็นการกำหนดค่าภาพสำหรับสไตล์ที่สื่อถึงอารมณ์ (Id9185, b/448728288)
  • เลิกใช้งาน TextFieldLabelPosition.Attached และเปิดตัว Inside และ Cutout ซึ่งเป็นประเภทย่อยที่ช่วยให้ปรับแต่งได้มากขึ้น เช่น OutlinedTextField ที่มีป้ายกำกับด้านใน นอกจากนี้ เรายังเลิกใช้งาน OutlinedTextFieldDefaults.contentPadding() และเปิดตัว OutlinedTextFieldDefaults.contentPaddingWithLabel() และ OutlinedTextFieldDefaults.contentPaddingWithoutLabel() เพื่อ รองรับทั้ง 2 ตำแหน่งของป้ายกำกับ (I40f62, b/448728288)

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

  • แก้ไขปัญหาการช่วยเหลือพิเศษใน TimePicker ซึ่งโฟกัสแป้นพิมพ์หายไปเมื่อเปลี่ยนจากชั่วโมงเป็นนาทีบนแป้นหมุน ปรับปรุงการช่วยเหลือพิเศษสำหรับโฟกัสของแป้นพิมพ์ (I7dd81, b/498361169)

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

  • ปรับปรุงฟิสิกส์ของท่าทางการปิด BottomSheet เพื่อประสบการณ์การใช้งานที่ราบรื่นยิ่งขึ้น (I21df5)

เวอร์ชัน 1.5.0-alpha20

19 พฤษภาคม 2026

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

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

  • นำฟังก์ชัน shouldUsePrecisionPointerComponentSizing ออกแล้ว (I882c3, b/498698039)
  • แก้ไขปัญหาที่เครื่องหมายแคร์เร็ตของเคล็ดลับเครื่องมือจะปรากฏที่ด้านที่ไม่ถูกต้องเมื่อเคล็ดลับเครื่องมือพลิกเนื่องจากขอบหน้าจอ (Idc314, b/479224210)
  • เปิดตัว rememberBottomSheetState เป็น API แบบรวมสำหรับสถานะ BottomSheet เลิกใช้งาน rememberModalBottomSheetState และ rememberStandardBottomSheetState เพื่อให้ใช้ API ใหม่แบบรวม (I2724e, b/500005697)
  • นำ WideNavigationRail API ทดลองที่เลิกใช้งานแล้วออก (Iaadd6, b/497891040)
  • เปลี่ยนสถานะ API SplitButton เป็นแบบที่ไม่ใช่เวอร์ชันทดลอง (I4d395, b/497876691)
  • เลิกใช้งาน DropdownMenuItem API ที่มีพารามิเตอร์ที่เลือกและทำเครื่องหมายไว้ซึ่งมี supportingText เป็น Lambda ต่อท้าย ย้าย supportingText ให้เป็นพารามิเตอร์ที่อยู่หลัง trailingIcon ทันที (Icaf79, b/503047115)

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

  • อัปเดตตัวแฮนเดิลการย้อนกลับที่คาดการณ์ได้ของลิ้นชักการนำทางเพื่อให้ย้อนกลับได้ขณะที่ลิ้นชักกำลังเปิด แทนที่จะย้อนกลับได้เมื่อเปิดจนสุดเท่านั้น (I714ae, b/418556231)

เวอร์ชัน 1.5.0-alpha19

6 พฤษภาคม 2026

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

ฟีเจอร์ใหม่

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

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

  • นำ supportingText ออกจาก 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 apis (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 ที่ทดลองใช้สำหรับแถบเลื่อนเป็น 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)
  • นำ FilterChip และ AssistChip API ที่เลิกใช้งานแล้วซึ่งมีพารามิเตอร์ 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 anchor จะยังคงอยู่ใน Layout Pass แรกเพื่อให้คำนวณเลย์เอาต์ได้ (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 เรียกใช้การเรียกกลับของ SheetState confirmValueChange ด้วยค่าที่ไม่ถูกต้องเมื่อส่งแฮนเดิลการลากไปยัง 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)

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

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

เวอร์ชัน 1.5.0-alpha11

17 ธันวาคม 2025

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

ฟีเจอร์ใหม่

  • เพิ่ม ExpandedFullScreenContainedSearchBar แล้ว (Ie472d,b/454658635)
  • เพิ่มการรองรับการสร้าง 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)
  • ใช้จุดยึดเริ่มต้นใหม่เมื่อรายการจุดยึดการขยายแผงมีการเปลี่ยนแปลง (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 ซ่อน FAB (I8ea6c, b/430336834)
  • [แถบเลื่อน] แก้ไขการไปยังส่วนต่างๆ ด้วยแป้นพิมพ์สำหรับแถบเลื่อน (I3a405)

เวอร์ชัน 1.5.0-alpha01

30 กรกฎาคม 2025

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

ฟีเจอร์ใหม่

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

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

  • ตอนนี้เราได้เปิดตัวTextFieldColorsวิธีการคำนวณสีของคอมโพเนนต์ตามสถานะแล้ว (I03165)
  • นำการระงับคำอธิบายประกอบออกจากแฮนเดิล onDismiss แล้ว (Ie3166)
  • DatePickerState.getDisplayedMonth(): YearMonth? และ DateRangePickerState.getDisplayedMonth(): YearMonth? ได้รับการอัปเดตให้แสดงค่าที่ไม่ใช่ค่าว่าง (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 Icons") ได้รับการแทนที่ด้วยรูปลักษณ์ใหม่ของ Material Symbols แล้ว และเราพบว่าคลังนี้อาจเพิ่มเวลาบิลด์ของแอปของคุณอย่างมากเนื่องจากมีไอคอนต่างๆ ทั้งหมดซึ่งอาจไม่จำเป็น

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

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

  • ไลบรารีนี้จะไม่เพิ่มทรัพยากร Dependency ไปยัง material-icons-core อีกต่อไป ดังนั้นหากโปรเจ็กต์ของคุณใช้ทรัพยากร Dependency นั้น คุณจะต้องเพิ่มทรัพยากร Dependency ดังกล่าวอย่างชัดเจนในไฟล์ build.gradle[.kts] (I735ff, b/349894318)

  • NavigationBarItem และ NavigationRailItem จะเปลี่ยนสีป้ายกำกับที่ใช้งานอยู่จาก onSurface เป็นสีรองเพื่อปรับปรุงความสามารถในการใช้งาน คอนทราสต์ของสี และปรับปรุงความสอดคล้องกันภายในระบบ (Ibc297) หากต้องการเปลี่ยนกลับเป็นลักษณะการทำงานก่อนหน้า ให้คัดลอกสีเริ่มต้นและเปลี่ยน selectedTextColor เป็น MaterialTheme.colorScheme.onSurface

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

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

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

การปรับปรุงคอมโพเนนต์ 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? ได้รับการอัปเดตให้แสดงค่าที่ไม่ใช่ค่าว่าง (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 และทำเครื่องหมาย Getter และ Setter ล่าสุดที่ใช้ java.time API เป็นเวอร์ชันทดลองในตอนนี้ (I121b3, b/427952972)
  • เลื่อนระดับไอคอนด้วย tint: ColorProducer param 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 ของภาพสไลด์ (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 constructor ที่ไม่มีบทบาทของคอนเทนเนอร์พื้นผิวจะถูกทำเครื่องหมายว่าซ่อนอยู่และไม่แนะนำให้ใช้แล้ว (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 จะใช้ส่วนแทรกด้านบนเมื่อมีขนาดเล็กกว่าออฟเซ็ตปัจจุบัน ซึ่งจะช่วยให้ผู้ใช้ระบุระยะขอบด้านบนสำหรับลักษณะการทำงานที่ขยายได้ ตอนนี้ 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 ไม่อยู่ตรงกลาง ซึ่งอาจเกิดขึ้นเมื่อใช้expandedเพื่อยุบ (I33f67)
  • อัปเดต TopAppBarAPI เวอร์ชันทดลองให้ใช้ 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)
  • แคชค่าเริ่มต้นของรูปร่างลงในออบเจ็กต์ Shape การตั้งค่าเริ่มต้นของรูปร่าง @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 จะมีลำดับความสำคัญเหนือกว่าสีที่ขัดแย้งกันซึ่งกำหนดไว้ในรูปแบบข้อความของการออกแบบตัวอักษรของธีมอย่างถูกต้อง โปรดทราบว่าการอัปเดตนี้จะปรับตำแหน่งของพารามิเตอร์ color ในฟังก์ชันเครื่องมือเลือกวันที่ และเพิ่มพารามิเตอร์ contentColor สำหรับการปรับแต่งสีข้อความส่วนหัวและชื่อ (I30d03, b/347031394)
  • เปลี่ยนชื่อ SplitButton เป็น SplitButtonLayout และนำ API ของสินค้าย่อยตามสี SplitButton ออก โดยจะใช้สินค้าย่อยโดยการนำสินค้าย่อยของปุ่มที่ SplitButtonDefaults ให้มาใช้ซ้ำ (I44c36)
  • ModalBottomSheet ตอนนี้มีพารามิเตอร์ sheetGestureEnabled (I856cb, b/288211587) แล้ว
  • เปลี่ยนชื่อstandardMotionSchemeและexpressiveMotionSchemeเป็น "มาตรฐาน" และ "สื่ออารมณ์" ตอนนี้คุณเข้าถึงฟังก์ชันทั้ง 2 ได้ผ่านออบเจ็กต์ MotionScheme Companion โดยการเรียกใช้ 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)
  • อัปเดต LoadingIndicator API เพื่อแก้ไขการตั้งชื่อในออบเจ็กต์ค่าเริ่มต้น เพิ่มLoadingIndicatorElevationค่าคงที่PullToRefresh (I1d72b)
  • อัปเดต LoadingIndicator API เพื่อแก้ไขการตั้งชื่อในออบเจ็กต์ค่าเริ่มต้น เพิ่มLoadingIndicatorElevationค่าคงที่PullToRefresh (I1d72b)
  • เพิ่มพารามิเตอร์ amplitude และ waveSpeed ลงในรูปแบบที่ไม่แน่นอนของ LinearWavyProgressIndicator และ CircularWavyProgressIndicator (I2a0c5)
  • รองรับการเปลี่ยนรูปร่างของปุ่มสลับไอคอนตามสถานะที่กดหรือเลือก (Ibc781)
  • อัปเดตคลาสการพิมพ์เพื่อรองรับขนาดตัวอักษรที่เน้น (Ifa13c)
  • SplitButton การเปลี่ยนรูปร่างตามสถานะเริ่มต้น / สถานะที่กด นำ AnimatedTrailingButton api ออกเนื่องจาก TrailingButton api สามารถเสนอการปรับแต่งเดียวกันได้ (I95066)
  • เพิ่มตัวแก้ไขเพื่อเคลื่อนไหวการแสดงและการซ่อน FAB เช่น เมื่อเนื้อหาเลื่อน (I8338d)
  • เพิ่มรูปร่างและระยะห่างของกลุ่มปุ่มที่เชื่อมต่อกับ ButtonGroupDefaults เพื่อใช้ในตัวอย่าง (I68e30)
  • ปุ่มแยกจะเพิ่มระยะห่างจากขอบด้านซ้ายและขวาสำหรับปุ่มต่อท้าย และเปิดใช้การจัดกึ่งกลางแบบออปติคัลที่คำนวณจากความแตกต่างของมุมเริ่มต้นและมุมสิ้นสุด (I122e2)
  • ขอแนะนำ Material MotionScheme ใหม่ที่ช่วยให้ตั้งค่ารูปแบบการเคลื่อนไหวของคอมโพเนนต์ได้ โดยจะตั้งค่าสคีมผ่าน MaterialTheme (Id50c2)

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

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

เวอร์ชัน 1.3.0-alpha06

1 พฤษภาคม 2024

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

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

  • API การดึงเพื่อรีเฟรชใหม่

    • ปรับปรุง PullToRefreshState เพื่อใช้ค่าเศษส่วนแทนหน่วย Dp
    • ผู้ใช้จะเป็นผู้ควบคุมสถานะ isRefreshing แทน PullToRefreshState
    • แยกการเชื่อมต่อการเลื่อนที่ซ้อนกันออกจาก PullToRefreshState โดยจะจัดการโดย PullToRefreshBox หรือ Modifier.pullToRefresh ใหม่
    • การอัปเดตนี้เป็นการเปลี่ยนแปลงที่ทำให้ API ทดลองก่อนหน้านี้ใช้งานไม่ได้ (I0adeb, b/314496282, b/317177684, b/323787138, b/324573502, b/317177683)

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

  • ระบบได้นำ RippleConfiguration#isEnabled ออกแล้ว และทำให้ LocalRippleConfiguration เป็นค่า Null ได้ หากต้องการปิดใช้การกระเพื่อม ให้ระบุ null เป็น LocalRippleConfiguration แทนการระบุ RippleConfiguration เป็น isEnabled = false (I22725)
  • ModalBottomSheet วาดขอบดำเหนือแถบสถานะได้แม่นยำยิ่งขึ้นเมื่อเปิดใช้การแสดงผลแบบขอบจรดขอบ ตอนนี้เนื้อหาของ Bottom Sheet แบบโมดัลสามารถใช้ส่วนที่เว้นไว้ของหน้าต่างได้แล้ว ซึ่งจะช่วยให้เนื้อหาที่มองเห็นได้อยู่เหนือแถบนำทาง พารามิเตอร์ ModalBottomSheet windowInsets เปลี่ยนชื่อเป็น contentWindowInsets เพื่อระบุตำแหน่งที่จะใช้ระยะขอบภายใน ซึ่งจะไม่เชื่อมโยงกับตรรกะของหน้าต่างอีกต่อไป ประเภท contentWindowInsets ได้รับการเปลี่ยนเป็นฟังก์ชันที่แสดงผล WindowInsets เพื่อให้สามารถแก้ไขได้ภายในหน้าต่างใหม่ (I39630, b/274872542, b/300280229, b/290893168)
  • PrimaryScrollableTabRow และ SecondaryScrollableTabRow ตอนนี้ใช้เลย์เอาต์ที่กำหนดเองแทนการประกอบย่อย ซึ่งจะช่วยปรับปรุงประสิทธิภาพ (I991e0)
  • ลิงก์ข้อความมีตัวเลือกการจัดรูปแบบสถานะที่กดนอกเหนือจากการจัดรูปแบบปกติ การวางเมาส์ และการโฟกัส TextDefaults แต่ละเมธอดมีอาร์กิวเมนต์ pressedStyle เพื่อรองรับการดำเนินการดังกล่าว (Ic473f, b/139312671)

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

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

เวอร์ชัน 1.3.0-alpha05

17 เมษายน 2024

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

ฟีเจอร์ใหม่

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

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

  • ลิงก์ข้อความมีตัวเลือกการจัดรูปแบบสถานะที่กดนอกเหนือจากการจัดรูปแบบปกติ การวางเมาส์ และการโฟกัส (I5f864, b/139312671)
  • อัปเดต CarouselItemInfo เพื่อแสดง Rect ของมาสก์ที่ใช้ตัดรายการ (I785d8)
  • นำ BasicTooltipState ออกจาก API สาธารณะของ Material 3 โดยจะรวมฟังก์ชันการทำงานของ TooltipState เข้ากับ BasicTooltip ของ Foundation จนกว่าจะเสถียร (Icda29)
  • เพิ่มออบเจ็กต์ TextDefaults ที่มีเมธอดในการสร้าง LinkAnnotation และแยกวิเคราะห์สตริงที่ติดแท็ก HTML ซึ่งใช้ MaterialTheme กับลิงก์ (I98532, b/139312671)
  • ExposedDropdownMenuBoxScope ไม่อนุญาตให้ใช้คลาสย่อยอีกต่อไป ตอนนี้เมนูแบบเลื่อนลงที่เปิดเผยมี MenuAnchorType ซึ่งควรส่งไปยัง menuAnchor เพื่อรองรับ a11y ได้ดียิ่งขึ้น ควรใช้พารามิเตอร์นี้แทนการส่ง focusable ไปยัง ExposedDropdownMenu ซึ่งตอนนี้เลิกใช้งานแล้ว menuAnchor มีพารามิเตอร์ใหม่เพื่อควบคุมสถานะ enabled (I55ee6, b/257209915, b/308840226)
  • แก้ไขสีเส้นขอบของ OutlinedButton เมื่อปิดใช้ เพิ่มButtonDefaults.outlinedButtonBorder("enabled")โอเวอร์โหลดที่ใช้สถานะที่เปิดใช้ (Ie650b, b/318461363)
  • เพิ่มคลาส CarouselItemInfo ใหม่เพื่อช่วยให้ลูกค้าได้รับข้อมูลเกี่ยวกับขนาดสินค้า (I9070c)
  • ตอนนี้เราเลิกใช้งาน ColorScheme constructor ที่ไม่มีคอนเทนเนอร์พื้นผิวแล้ว โปรดย้ายไปยังเครื่องมือสร้างที่มีคอนเทนเนอร์แพลตฟอร์ม (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)
  • อัปเดต Nav Drawer ของ 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)
  • นำ Enum และ API ที่เลิกใช้งานแล้วของ DismissDirection และ DismissValue ออก (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 ที่ใช้ร่วมกันได้ (I9f315)
  • ตอนนี้เราได้ใช้ ExposedDropdownMenu โดยใช้ Popup แล้ว ลักษณะการทำงานควรเหมือนกัน ยกเว้นเมนูที่โฟกัสได้ซึ่งมีช่องข้อความที่แก้ไขได้อาจปิดเมื่อพิมพ์บนแป้นพิมพ์

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

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

เวอร์ชัน 1.3.0-alpha02

6 มีนาคม 2024

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

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

  • ทำให้สถานะแถบเลื่อนเสถียรอีกครั้ง กำลังทำให้ State.onValueChangeFinished เป็นค่าอีกครั้ง การห่อ 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)
  • อัปเดตสีคอนเทนเนอร์ของ Bottom Sheet และสีแฮนเดิลการลาก (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 ที่ส่งไปยังคอมโพเนนต์เหล่านี้ เราขอแนะนำให้ส่งค่าเป็น 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)
  • เราปรับการจัดแนวป้ายให้ใกล้กับกึ่งกลางของเนื้อหา Anchor มากขึ้นเมื่อเทียบกับมุมขวาบน (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 ที่ทดลองใช้เป็นเวอร์ชันเสถียร

การปรับปรุงประสิทธิภาพ

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

  • เพิ่มความสามารถในการเปิดใช้เครื่องหมายแคร์ตของเคล็ดลับเครื่องมือสำหรับ Plain Tooltip API (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 Saver และ Constructor ที่เลิกใช้งานแล้วออกแล้ว เราได้ทำเครื่องหมายคอมโพเนนต์ SwipeToDismiss, ออบเจ็กต์สถานะ และออบเจ็กต์ค่าเริ่มต้นว่าเป็นการทดลอง (Ib54f2)

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

  • ตอนนี้ตัวบ่งชี้เริ่มต้นสำหรับ PullToRefresh คือหัวลูกศรเปิดแทนสามเหลี่ยมทึบ (I67be3)

เวอร์ชัน 1.2.0-alpha12

29 พฤศจิกายน 2023

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

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

  • RangeSlider จะใช้ช่วง Kotlin (เช่น 0f..1f) แทนคลาสค่า FloatRange ที่กำหนดเอง ตอนนี้ SnapFlingBehavior.kt ใช้ช่วง Kotlin ด้วย (I025cb)
  • ทําเครื่องหมายฟังก์ชัน Factory ของตัวดัดแปลงเป็น @Stable (Ib109f)

เวอร์ชัน 1.2.0-alpha11

15 พฤศจิกายน 2023

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

ฟีเจอร์ใหม่

  • ใช้ PullToRefreshContainer และ PullToRefreshState ซึ่งทำงานร่วมกันเพื่อนำการดึงเพื่อรีเฟรชไปใช้ใน Material3 (I16456, b/261760718)

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

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

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

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

เวอร์ชัน 1.2.0-alpha10

18 ตุลาคม 2023

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

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

  • โปรโมต Badge และ BadgedBox เป็นเวอร์ชันเสถียร (I67f16, b/261565132)
  • เพิ่ม securePolicy เป็นพารามิเตอร์ใน ModalBottomSheet เพื่อให้ผู้ใช้กําหนดลักษณะการทํางานของ WindowManager.LayoutParams.FLAG_SECURE ได้ (Icdac8, b/296250262)
  • เพิ่มการโอเวอร์โหลดใหม่ของ LinearProgressIndicator และ CircularProgressIndicator ที่ใช้ progress เป็น Lambda ซึ่งควรมีประสิทธิภาพมากกว่าเวอร์ชันก่อนหน้า (I824e6, b/295616656)
  • เปลี่ยนชื่อ StandardSizeClasses เป็น AllSizeClasses (I8cb07)
  • รวมฟังก์ชันการคำนวณของคลาสขนาดหน้าต่าง (Iad935)

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

  • แก้ไขDatePickerข้อขัดข้องเมื่อคลิกปุ่มลูกศรนำทางอย่างรวดเร็วเมื่อเดือนที่แสดงอยู่ตรงขอบของช่วงปีที่อนุญาต (I46f36, b/290954897, b/297002119)
  • [แถบนำทาง] รองรับสีโปร่งใสสำหรับตัวบ่งชี้ (Ie0a9b, b/267289987)

เวอร์ชัน 1.2.0-alpha09

4 ตุลาคม 2023

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

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

  • ย้ายข้อมูล ModalNavigationDrawer และ DismissibleNavigationDrawer เพื่อใช้ AnchoredDraggable API ใหม่ DrawerState's animateTo ถูกแทนที่ด้วยเมธอดเปิดและปิดแล้ว และตอนนี้ออฟเซ็ตจะแสดงเป็น Float แทนออบเจ็กต์สถานะ คุณเข้าถึงการชดเชยได้โดยตรงผ่าน currentOffset (I0a72c)
  • มีการเพิ่มฟังก์ชันที่ไม่สามารถคอมโพสได้สำหรับการสร้าง DatePickerState และ DateRangePickerState โดยตรง คุณสามารถใช้ฟังก์ชันเหล่านี้แทนฟังก์ชันที่ประกอบกันได้ rememberDatePickerState และ rememberDateRangePickerState ได้เมื่อจำเป็น (I70326, b/291524052)
  • ตอนนี้ TabRows แบบคงที่และแบบเลื่อนได้มีตัวแปรหลักและตัวแปรรองแล้ว ซึ่งจะแมปกับลักษณะการทำงานของสีและตัวบ่งชี้อย่างถูกต้องตามที่กำหนดไว้ใน Material3
  • ตอนนี้ PrimaryScrollableTabRow และ SecondaryScrollableTabRow แสดงสถานะการเลื่อนแล้ว (Iec8f5, b/260572337)
  • เพิ่มพารามิเตอร์ sheetMaxWidth ใหม่ที่นักพัฒนาซอฟต์แวร์สามารถตั้งค่าเพื่อระบุความกว้างสูงสุดที่ชีตจะครอบคลุม คุณส่ง Dp.Unspecified สำหรับพารามิเตอร์ได้หากต้องการชีตที่ครอบคลุมความกว้างของหน้าจอทั้งหมด (Ifb7c9, b/266697696)
  • เพิ่ม API ของ PlainTooltipBox และ RichTooltipBox กลับมาเป็นวิธีการที่เลิกใช้งานแล้ว (I246fa)

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

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

เวอร์ชัน 1.2.0-alpha08

20 กันยายน 2023

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

การเปลี่ยนแปลงลักษณะการทำงานที่ทำให้เกิดข้อขัดข้อง

  • ColorScheme ตอนนี้เป็นแบบเปลี่ยนแปลงไม่ได้แล้ว ซึ่งทำให้การอัปเดตสีแต่ละรายการมีประสิทธิภาพน้อยลง แต่ทำให้การใช้สีที่พบบ่อยมีประสิทธิภาพมากขึ้น เหตุผลที่อยู่เบื้องหลังการเปลี่ยนแปลงนี้คือแอปส่วนใหญ่ไม่ได้มี Use Case หลักเป็นการอัปเดตสีแต่ละสี ยังคงทำได้ แต่จะมีการเขียนใหม่มากกว่าเดิม ซึ่งจะช่วยลดจำนวนการสมัครใช้บริการสถานะผ่านโค้ด Material ทั้งหมดได้อย่างมาก และจะส่งผลต่อต้นทุนการเริ่มต้นและการรันไทม์ของ Use Case มาตรฐานมากขึ้น (Ic447d, b/297212873)
  • การยกระดับโทนสีจะไม่เคลื่อนไหวในสถานะการโต้ตอบต่างๆ อีกต่อไปเพื่อให้ตรงกับข้อกำหนด (Icdd12)

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

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

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

  • นำการใช้ rememberSaveable สำหรับเคล็ดลับเครื่องมือออกแล้ว (Icc131, b/299500338)
  • เพิ่มแฟล็กชั่วคราวเพื่อควบคุมว่า Scaffold ควรวัดองค์ประกอบย่อยระหว่างการวัดหรือระหว่างการวางหรือไม่ โดยค่าเริ่มต้น ระบบจะวัดในหน่วยวัด หากพบปัญหาเกี่ยวกับลักษณะการทำงานใหม่ โปรดรายงานปัญหา (I0b354)
  • ขอบแนวนอนคงที่แบบขอบถึงขอบใน BottomSheet โดยใช้การวัดที่ถูกต้องสำหรับความกว้างของหน้าจออุปกรณ์ (I1df0c, b/299058752)
  • แก้ไขข้อบกพร่องที่ ModalBottomSheet ไม่เรียก onDismissedRequest เมื่อปิดโดยการปัดลงในชีต (Idfdd8)

เวอร์ชัน 1.2.0-alpha07

6 กันยายน 2023

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

ฟีเจอร์ใหม่

  • เราได้เพิ่มการรองรับไอคอนที่พลิกอัตโนมัติใน compose material 1.6.0-alpha05 แล้ว โปรดดูรายละเอียดเกี่ยวกับไอคอนที่พลิกอัตโนมัติในหมายเหตุประจำรุ่น

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

  • SliderState ใช้ DraggableState (I9b116)
  • เปลี่ยนรูปร่างให้เป็นพารามิเตอร์ที่ต้องระบุ เปลี่ยนชื่อ position เป็น index ในฟังก์ชันตัวช่วยรูปร่าง (I34941)
  • อัปเดต DatePicker formatWithSkeleton ให้มีแผนที่ซึ่งใช้เป็นแคชเพื่อปรับปรุงประสิทธิภาพ (I3195f)
  • เพิ่ม BasicTooltipBox ลงใน compose.foundation และอัปเดต PlainTooltipBox กับ RichTooltipBox ให้ใช้ TooltipBox กับ 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 จะพิจารณา Inset ของหน้าต่างที่ใช้แล้ว โปรดทราบว่าลักษณะการทำงานของการเพิ่มพื้นที่เนื้อหาตาม 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 ที่ทดลองใช้เป็นเวอร์ชันเสถียร

โปรดดูรายละเอียดเพิ่มเติมในบล็อกโพสต์นี้

เวอร์ชัน 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 เมื่อสร้างเครื่องมือเลือกวันที่ ตอนนี้คุณส่งค่า null สำหรับบรรทัดแรก ชื่อ และ showToggleMode = false ได้แล้วเพื่อแสดงเครื่องมือเลือกแบบไม่มีส่วนหัว (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)
  • ต่อไปนี้คือ Material 3 Text Field API ที่ไม่ใช่เวอร์ชันทดลองอีกต่อไป TextField, OutlinedTextField, textFieldWithLabelPadding, textFieldWithoutLabelPadding, outlinedTextFieldPadding (Ieb5c0, b/261561819)
  • TimePickers is24Hour ใช้การตั้งค่าระบบ (I18856)
  • นำคำอธิบายประกอบเวอร์ชันทดลองออกจาก 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)
  • การใช้งาน 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 เป็นค่าว่างได้อีกต่อไปและตอนนี้มีค่าเริ่มต้นแล้ว (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 และ IconToggleBotton ของ Material3 ให้เป็นรูปร่างเลเยอร์สถานะของคอมโพเนนต์ (เช่น รูปร่างวงกลม) (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 ให้เป็น Composables และระบุค่าเริ่มต้นสำหรับสถานะแถบแอปด้านบนและข้อกำหนดภาพเคลื่อนไหว (I642b3)
  • อัปเดตลายเซ็นของคอมโพเนนต์ FAB ให้ตรงกับ Surface API (I3afaa)
  • เพิ่มการรองรับในตัวสำหรับแถบแอปด้านบน ลิ้นชัก แถบนำทาง และแถบข้างนำทาง เมื่อใช้แยกกันหรือใช้กับ Scaffold คอมโพเนนต์เหล่านี้จะจัดการระยะขอบให้แก่นักพัฒนาแอปโดยอัตโนมัติ หมายเหตุ: การเปลี่ยนแปลงนี้ไม่ได้เพิ่มการจัดการไอคอนแถบสถานะและความโปร่งใสของแถบสถานะและแถบนำทางโดยอัตโนมัติ โปรดดำเนินการด้วยตนเองต่อไปเพื่อให้มั่นใจว่าจะได้รับประสบการณ์การใช้งานแบบขอบจรดขอบที่ดีที่สุด (I7e4e6, b/183161866)
  • ค่าเริ่มต้นของคอมโพเนนต์ที่อัปเดตแล้วจะลดพื้นผิว API เพื่อให้มีความยืดหยุ่นและปรับปรุงประสิทธิภาพในอนาคต (I31820)
  • จัดเรียงพารามิเตอร์ของชิปและชีตลิ้นชักการนำทางใหม่เพื่อรักษาความสอดคล้องภายใน API (I45d0b)
  • นำ startIndent ออกจากตัวคั่นและย้ายสีให้เป็นพารามิเตอร์สุดท้าย (If7be2)

เวอร์ชัน 1.0.0-alpha16

10 สิงหาคม 2022

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

ฟีเจอร์ใหม่

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

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

  • จัดเรียงพารามิเตอร์แท็บและพารามิเตอร์แท็บไอคอนนำใหม่เพื่อรักษาความสอดคล้องกันภายใน API (Ie2637)
  • ทำเครื่องหมาย BadgeDefaults ว่าเป็นเวอร์ชันทดลอง (I98ef3)
  • นำฟังก์ชันลิ้นชักการนำทางที่เลิกใช้งานแล้วออก (I4f2db)
  • จัดเรียงพารามิเตอร์ของแถบเลื่อนอีกครั้งใน Material 3 เพื่อรักษาความสอดคล้องภายใน API (I0aee7)
  • จัดเรียงพารามิเตอร์ NavigationBar และ NavigationRail ใหม่เพื่อให้สอดคล้องกันภายใน API (I51cda)
  • จัดลำดับพารามิเตอร์ใหม่ใน Material 3 เพื่อรักษาความสอดคล้องกันใน API (If4ae1)
  • จัดเรียงพารามิเตอร์ของแถบเลื่อนการจัดเรียงใหม่ใน Material 3 เพื่อรักษาความสอดคล้องภายใน API (I62673)
  • เปลี่ยนชื่อพารามิเตอร์ไอคอนเป็นการดำเนินการเพื่อให้สอดคล้องกับแถบแอปด้านบน (Id75be)
  • ทําเครื่องหมาย Badge และ BadgedBox เป็นเวอร์ชันทดลองเนื่องจากการจัดแนวจุดยึดยังคงเปลี่ยนแปลงอยู่ (I1712e, b/236524516)
  • เปลี่ยน@ExperimentalMaterial3Apiคำอธิบายประกอบในปุ่มไอคอนรูปแบบต่างๆ เป็น @OptIn (I070b5)
  • แยกเนื้อหาของ Navigation Drawer ออกเป็น 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

  • เปลี่ยนชื่อ Composable TextFieldDefaults.BorderStroke ที่วาดเส้นขอบใน OutlinedTextField เป็น TextFieldDefaults.BorderBox (I5f295)
  • การเปลี่ยนแปลงภาพของโฆษณาที่สลับ (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)
  • เพิ่ม FilledIconButton, FilledTonalIconButton และ OutlinedIconButton ของ Material3 (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