Compose Material 3

Struktur

Compose adalah kombinasi tujuh ID Grup Maven dalam androidx. Setiap Grup berisi subkumpulan fungsi yang ditargetkan, masing-masing dengan kumpulan catatan rilisnya sendiri.

Tabel ini menjelaskan grup tersebut dan disertai link ke setiap kumpulan catatan rilis.

Mendeklarasikan dependensi

Untuk menambahkan dependensi pada Compose, Anda harus menambahkan repositori Maven Google ke project Anda. Baca repositori Maven Google untuk informasi selengkapnya.

Tambahkan dependensi untuk artefak yang diperlukan dalam file build.gradle bagi aplikasi atau modul Anda:

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

android {
    buildFeatures {
        compose true
    }

    composeOptions {
        kotlinCompilerExtensionVersion = "1.1.1"
    }

    kotlinOptions {
        jvmTarget = "1.8"
    }
}

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

android {
    buildFeatures {
        compose = true
    }

    composeOptions {
        kotlinCompilerExtensionVersion = "1.1.1"
    }

    kotlinOptions {
        jvmTarget = "1.8"
    }
}

Untuk informasi dependensi selengkapnya, lihat Menambahkan dependensi build.

Masukan

Masukan Anda membantu meningkatkan kualitas Jetpack. Beri tahu kami jika Anda menemukan masalah baru atau mempunyai masukan untuk meningkatkan kualitas library ini. Harap periksa masalah yang sudah diketahui dalam library ini sebelum membuat laporan baru. Anda dapat memberikan suara untuk masalah yang sudah diketahui dengan mengklik tombol bintang.

Laporkan masalah baru

Lihat dokumentasi Issue Tracker untuk informasi selengkapnya.

Compose Material3 Common Versi 1.0

Versi 1.0.0-alpha01

17 April 2024

androidx.compose.material3:material3-common:1.0.0-alpha01, androidx.compose.material3:material3-common-android:1.0.0-alpha01, dan androidx.compose.material3:material3-common-desktop:1.0.0-alpha01 dirilis. Versi 1.0.0-alpha01 berisi commit ini.

Fitur Baru

Komponen tanpa tema yang dapat digunakan untuk membangun komponen Desain Material:

• Palet Nuansa
  • TonalPalette
• Ikon
  • Icon
• Ukuran target sentuh
  • LocalMinimumInteractiveComponentSize

Compose Material3 Adaptive Navigation Suite Versi 1.0

Versi 1.0.0-alpha07

1 Mei 2024

androidx.compose.material3:material3-adaptive-navigation-suite:1.0.0-alpha07, androidx.compose.material3:material3-adaptive-navigation-suite-android:1.0.0-alpha07, dan androidx.compose.material3:material3-adaptive-navigation-suite-desktop:1.0.0-alpha07 dirilis. Versi 1.0.0-alpha07 berisi commit ini.

Perubahan API

• Menjadikan API suite navigasi tidak bersifat eksperimental (If62af)

Perbaikan Bug

• Menggunakan inset untuk konten secara default (50266df)

Versi 1.0.0-alpha06

17 April 2024

androidx.compose.material3:material3-adaptive-navigation-suite:1.0.0-alpha06, androidx.compose.material3:material3-adaptive-navigation-suite-android:1.0.0-alpha06, dan androidx.compose.material3:material3-adaptive-navigation-suite-desktop:1.0.0-alpha06 dirilis. Versi 1.0.0-alpha06 berisi commit ini.

Perubahan API

• Menambahkan containerColor dan contentColor ke NavigationSuiteScaffoldDefaults. (I64e3a, b/331993720)
• Menambahkan fungsi itemColors ke NavigationSuiteDefaults. (Idf719, b/328480012)
• Membuat NavigationSuiteScope tertutup rapat. (Iefa57)

Versi 1.0.0-alpha05

6 Maret 2024

androidx.compose.material3:material3-adaptive-navigation-suite:1.0.0-alpha05, androidx.compose.material3:material3-adaptive-navigation-suite-android:1.0.0-alpha05, dan androidx.compose.material3:material3-adaptive-navigation-suite-desktop:1.0.0-alpha05 dirilis. Versi 1.0.0-alpha05 berisi commit ini.

Perubahan API

• Menjadikan konstruktor NavigationSuiteItemColors publik. (Ica83a, b/324886877)

Versi 1.0.0-alpha04

21 Februari 2024

androidx.compose.material3:material3-adaptive-navigation-suite:1.0.0-alpha04, androidx.compose.material3:material3-adaptive-navigation-suite-android:1.0.0-alpha04, dan androidx.compose.material3:material3-adaptive-navigation-suite-desktop:1.0.0-alpha04 dirilis. Versi 1.0.0-alpha04 berisi commit berikut ini.

Update Dependensi

• Perbarui dependensi adaptif Material3 ke jalur modul baru. (Ibc421)
• Bermigrasi untuk menggunakan class ukuran jendela versi Window Manager. (I3794d)

Versi 1.0.0-alpha03

7 Februari 2024

androidx.compose.material3:material3-adaptive-navigation-suite:1.0.0-alpha03, androidx.compose.material3:material3-adaptive-navigation-suite-android:1.0.0-alpha03, dan androidx.compose.material3:material3-adaptive-navigation-suite-desktop:1.0.0-alpha03 dirilis. Versi 1.0.0-alpha03 berisi commit berikut ini.

Perubahan API

• Memperbarui nama paket menjadi navigationsuite dari navigation-suite (I7eff7)
• Komponen Material3 yang mengekspos MutableInteractionSource di API-nya telah diupdate untuk mengekspos MutableInteractionSource nullable yang ditetapkan secara default ke null. Tidak ada perubahan semantik di sini: meneruskan null berarti Anda tidak ingin mengangkat MutableInteractionSource, dan MutableInteractionSource akan dibuat di dalam komponen jika diperlukan. Mengubahnya menjadi null memungkinkan beberapa komponen tidak pernah mengalokasikan MutableInteractionSource, dan memungkinkan komponen lain hanya membuat instance secara lambat saat diperlukan, yang meningkatkan performa di seluruh komponen ini. Jika Anda tidak menggunakan MutableInteractionSource yang diteruskan ke komponen ini, sebaiknya teruskan null. Sebaiknya Anda juga membuat perubahan serupa pada komponen Anda sendiri. (I41abb, b/298048146)

Versi 1.0.0-alpha02

13 Desember 2023

androidx.compose.material3:material3-adaptive-navigation-suite:1.0.0-alpha02, androidx.compose.material3:material3-adaptive-navigation-suite-android:1.0.0-alpha02, dan androidx.compose.material3:material3-adaptive-navigation-suite-desktop:1.0.0-alpha02 dirilis. Versi 1.0.0-alpha02 berisi commit berikut ini.

Fitur Baru

• Menambahkan NavigationSuiteType 'Tidak Ada' (If8cb1, b/313688598)

Perbaikan Bug

• Memperbaiki komponen navigasi yang mengisi seluruh layar saat permukaan root memiliki modifier.fillMaxSize. (c9cf250, b/312664933)

Versi 1.0.0-alpha01

15 November 2023

androidx.compose.material3:material3-adaptive-navigation-suite:1.0.0-alpha01 dirilis. Versi 1.0.0-alpha01 berisi commit ini.

Fitur Baru

• NavigationSuiteScaffold
  • NavigationSuiteScaffoldLayout
  • NavigationSuite

Compose Material3 Adaptif Versi 1.0

Versi 1.0.0-alpha06

7 Februari 2024

androidx.compose.material3:material3-adaptive:1.0.0-alpha06, androidx.compose.material3:material3-adaptive-android:1.0.0-alpha06, dan androidx.compose.material3:material3-adaptive-desktop:1.0.0-alpha06 dirilis. Versi 1.0.0-alpha06 berisi commit berikut ini.

Fitur Baru

• Menambahkan opsi perilaku tambahan untuk navigasi kembali ThreePaneScaffoldNavigator. (I858aa)
• Menambahkan konten tujuan opsional ke histori navigasi. (Ibd7e6)

Versi 1.0.0-alpha05

24 Januari 2024

androidx.compose.material3:material3-adaptive:1.0.0-alpha05, androidx.compose.material3:material3-adaptive-android:1.0.0-alpha05, dan androidx.compose.material3:material3-adaptive-desktop:1.0.0-alpha05 dirilis. Versi 1.0.0-alpha05 berisi commit ini.

Fitur Baru

• Mendukung kepekaan terhadap histori dalam navigasi scaffold dan penghitungan nilai (I71d46)

Versi 1.0.0-alpha04

10 Januari 2024

androidx.compose.material3:material3-adaptive:1.0.0-alpha04, androidx.compose.material3:material3-adaptive-android:1.0.0-alpha04, dan androidx.compose.material3:material3-adaptive-desktop:1.0.0-alpha04 dirilis. Versi 1.0.0-alpha04 berisi commit berikut ini.

Fitur Baru

• Menambahkan dukungan layar penuh di scaffold panel (I1b462)

Perubahan API

• Memindahkan properti batas engsel di Postur ke daftar info engsel (I24f90)

Perbaikan Bug

• Memperbaiki AnimatedPane tidak dikomposisi ulang (c3f573d)

Versi 1.0.0-alpha03

13 Desember 2023

androidx.compose.material3:material3-adaptive:1.0.0-alpha03, androidx.compose.material3:material3-adaptive-android:1.0.0-alpha03, dan androidx.compose.material3:material3-adaptive-desktop:1.0.0-alpha03 dirilis. Versi 1.0.0-alpha03 berisi commit berikut ini.

Perubahan API

• Ubah peran scaffold menjadi alias ThreePaneScaffoldRole. (I65bd1)
• Membuat class dasar untuk peran kerangka (I4784d)
• Menghapus parameter yang tidak perlu dari konten AnimatedPane (Ibc73b)
• Mengganti nama collectWindowSizeAsState dan menampilkan nilai mentah (I480f4)

Versi 1.0.0-alpha02

29 November 2023

androidx.compose.material3:material3-adaptive:1.0.0-alpha02, androidx.compose.material3:material3-adaptive-android:1.0.0-alpha02, dan androidx.compose.material3:material3-adaptive-desktop:1.0.0-alpha02 dirilis. Versi 1.0.0-alpha02 berisi commit ini.

Perubahan API

• Memisahkan API navigasi dari API scaffold adaptif. (Ic4045)
• Menghapus kelas GutterSize. (I785b3)

Perbaikan Bug

• Memperbaiki panel yang tidak diganti saat AnimatedPane tidak digunakan (d88f181)

Versi 1.0.0-alpha01

15 November 2023

androidx.compose.material3:material3-adaptive:1.0.0-alpha01 dirilis. Versi 1.0.0-alpha01 berisi commit ini.

Fitur Baru

API kondisi adaptif Material3:

• Postur

API direktif scaffold panel adaptif Material3:

• PaneScaffoldDirective
  • calculateStandardPaneScaffoldDirective
  • calculateDensePaneScaffoldDirective
  • AdaptStrategy
  • ThreePaneScaffoldAdaptStrategies
  • HingePolicy

API scaffold panel adaptif Material3:

• API dasar struktur panel
  • PaneScaffoldScope
  • ThreePaneScaffoldRole
  • PaneAdaptedValue
  • ThreePaneScaffoldValue
  • calculateThreePaneScaffoldValue
  • AnimatedPane

Compose Material3 Versi 1.5

Versi 1.5.0-alpha07

22 Oktober 2025

androidx.compose.material3:material3-*:1.5.0-alpha07 dirilis. Versi 1.5.0-alpha07 berisi commit ini.

Perubahan API

• Meningkatkan SearchBar.InputField dengan parameter keyboardOptions, yang memungkinkan input teks yang dioptimalkan dengan menentukan opsi keyboard dan parameter lineLimits yang memungkinkan untuk menentukan scrolling pembungkusan teks (Id08a4, b/416991049)

Perbaikan Bug

• Memperbaiki bug di Slider saat interaksi tekan tidak dipancarkan saat sentuh ke bawah. Perubahan ini memastikan bahwa PressInteraction.Press segera dipancarkan di awaitFirstDown, sehingga memberikan masukan visual instan. (If9e25, b/308501482)
• Memperbaiki masalah dengan kursor Tooltip yang tidak berubah arah saat men-scroll. TooltipBox kini memicu rekomposisi setiap kali pop-up tooltip berpindah sisi, sehingga memastikan arah tanda sisipan diperbarui dengan benar. (I5ad1e, b/438875827)

Versi 1.5.0-alpha06

8 Oktober 2025

androidx.compose.material3:material3-*:1.5.0-alpha06 dirilis. Versi 1.5.0-alpha06 berisi commit ini.

Perubahan API

• Menambahkan warna yang di-scroll untuk AppBarWithSearch. Selain itu, warna penampung kolom input kotak penelusuran kini transparan secara default. Warna penampung default pada kotak penelusuran itu sendiri tidak berubah. (I4fe32)
• Menambahkan composable indikator peluapan default ke FloatingToolbar. (I6a6f8, b/415833723)
• Perbarui isExpanded menjadi isShowing untuk API menu dalam grup tombol. (I86309, b/412419514)
• Memperbarui initialIsExpanded menjadi initialIsShowing dan menambahkan composable indikator overflow default di ButtonGroupDefaults. (I6e67c, b/412419514)
• Menghapus fitur tarik untuk mengubah ukuran dari permukaan API publik (Ic85ba, b/437953743, b/442636084)

Perbaikan Bug

• Memperbaiki urutan fokus navigasi keyboard tombol, dan juga memperbaikinya untuk RTL. (Ibba27, b/422220597)
• Memperbaiki navigasi keyboard pada petak pemilihan tahun di pemilih tanggal. (I02363, b/422425720, b/446814683)
• Navigasi keyboard tetap untuk petak pemilihan tanggal di pemilih tanggal. (I594ef, b/422220597, b/422223115)
• Memperbaiki toolbar di luar layar yang menerima fokus keyboard. (I01a73, b/422786812)
• Memperbaiki navigasi keyboard RangeSlider dan Penggeser. (Ib6bcf, b/424845268, b/422942624)

Versi 1.5.0-alpha04

10 September 2025

androidx.compose.material3:material3-*:1.5.0-alpha04 dirilis. Versi 1.5.0-alpha04 berisi commit ini.

Fitur Baru

• Menambahkan overload composable Text yang menerima lambda ColorProducer yang memungkinkan perubahan warna yang efisien tanpa memicu rekomposisi penuh. (I9ff25, b/407055128)

Perubahan API

• Ganti nama Scrim() menjadi LevitatedPaneScrim() dan sembunyikan properti class Levitated dan Reflowed. (I090e1, b/427953101)
• Menyembunyikan API calculatePosture() sebagai internal (Ie7227, b/424442112)
• Mengekspos PaneScaffoldHorizontalOrder sebagai API publik tertutup (Ia4ebe)
• Menandai API terkait ukuran dan postur jendela sebagai eksperimental. (I4ee96)

Perbaikan Bug

• Memperbaiki urutan navigasi keyboard sehingga fokus berpindah dari tombol fab ke item pertama di bagian atas. (Icaaa1, b/422762939)
• Meningkatkan aksesibilitas keyboard Panel Navigasi: panel tidak lagi dapat difokuskan saat ditutup, dapat ditutup melalui tombol esc, dan kontennya menerima fokus saat dibuka. (Idb995, b/422793544, b/422793651, b/422797424)
• Tampilan jam pemilih waktu kini merespons navigasi/input keyboard. (I9d5d9, b/425710631)
• Menggunakan anchor awal baru saat daftar anchor perluasan panel berubah (I91cd1, b/438829477)

Versi 1.5.0-alpha03

27 Agustus 2025

androidx.compose.material3:material3-*:1.5.0-alpha03 dirilis. Versi 1.5.0-alpha03 berisi commit ini.

Perubahan Perilaku

• Ukuran kotak centang dan warna indikator telah disesuaikan agar sesuai dengan spesifikasi. Untuk meminimalkan gangguan UI, tanda isCheckboxStylingFixEnabled telah ditambahkan untuk membantu migrasi. Aktifkan secara manual di aplikasi Anda. Flag ini akan dihapus pada versi mendatang. (I5bcd3, b/304300693)

Perubahan API

• Menambahkan parameter contentPadding untuk TopAppBar (Ia5fea)
• Menambahkan penggantian komponen untuk scaffold suite nav (I85312)

Perbaikan Bug

• Parameter containerColor di TimePickerDialog kini diterapkan dengan benar, sehingga memungkinkan penyesuaian warna latar belakang dialog. (I47f89, b/403183883)
• Kolom samping navigasi modal tidak lagi kehilangan fokus saat diciutkan, dan kini ditutup sebagai respons terhadap tombol ESC. (4255257)
• Snackbar kini memiliki urutan fokus keyboard yang benar untuk tombol tindakan dan tutup, tombol tutup juga mendukung tampilan tooltip. (11fa13d)

Versi 1.5.0-alpha02

13 Agustus 2025

androidx.compose.material3:material3-*:1.5.0-alpha02 dirilis. Versi 1.5.0-alpha02 berisi commit ini.

Perubahan API

• Di PullToRefreshDefaults, shape diganti namanya menjadi indicatorShape dan containerColor diganti namanya menjadi indicatorContainerColor, serta indicatorMaxDistance ditambahkan untuk penggunaan indikator. (Ib6cbe)
• Menghapus tag penghentian penggunaan dari PullToRefreshDefaults.indicatorColor (Iaaee2)
• Menambahkan AppBarWithSearch, menggantikan TopSearchBar dan mendukung ikon tindakan/navigasi. (I213a5)

Perbaikan Bug

• Memperbaiki bug saat tombol kembali salah memperbarui offset panel. (I85624, b/427778135)
• SwipeToDismissBox kini melakukan penggantian ke targetValue yang sudah diselesaikan jika tidak ada anchor lain. BottomSheetScaffold kini melakukan penggantian ke targetValue yang Diperluas jika tidak ada anchor lain. (I73d5e, b/428856426)
• Memperbaiki padding tombol di AlertDialog saat disusun secara vertikal. (Ia2118)
• [FAB] Memperbaiki bug saat FAB masih dapat diklik setelah Modifier.animateFloatingActionButton menyembunyikannya (I8ea6c, b/430336834)
• [Penggeser] Memperbaiki navigasi keyboard untuk Penggeser (I3a405)

Versi 1.5.0-alpha01

30 Juli 2025

androidx.compose.material3:material3-*:1.5.0-alpha01 dirilis. Versi 1.5.0-alpha01 berisi commit ini.

Fitur Baru

• Menambahkan lebih banyak penyedia posisi untuk tooltip sehingga kini developer dapat mengontrol apakah tooltip ditempatkan di atas, bawah, kiri, atau kanan anchor. Menambahkan API yang menerima Bentuk untuk penanda, sehingga lebih banyak bentuk kustom dapat diberikan. (Ie513c)

Perubahan API

• Metode TextFieldColors untuk menghitung warna komponen berdasarkan status kini bersifat publik. (I03165)
• Anotasi penangguhan telah dihapus dari callback onDismiss. (Ie3166)
• DatePickerState.getDisplayedMonth(): YearMonth? dan DateRangePickerState.getDisplayedMonth(): YearMonth? telah diupdate untuk menampilkan nilai non-nullable. (Ice09c, b/427952972)
• Hapus ModalWideNavigationRailDefaults, pindahkan isinya ke WideNavigationRailDefaults, dan ganti nama terkait bentuknya. (Ic5e61)
• Fungsi yang tidak digunakan lagi untuk warna dan teks WideNavigationRailItem harus memiliki tingkat Tersembunyi. (Id7e82)
• Mengubah tingkat API WideNavigationRail yang tidak digunakan lagi menjadi Peringatan dan menjadikannya eksperimental. (I89085)

Perbaikan Bug

• Memastikan DatePicker mematuhi lokalitasnya sendiri untuk pemformatan angka. Sebelumnya, jika DatePicker dikonfigurasi untuk lokalitas Arab, DatePicker dapat salah merender digit Latin jika lokalitas sistem perangkat menggunakan sistem penomoran yang berbeda. (Iccf76, b/432616196)
• Memperbaiki masalah LinearProgressIndicator yang tidak merender indikator berhenti dengan benar dalam tata letak RTL. (I0734c)
• Pemisah PrimaryScrollableTabRow dan SecondaryScrollableTabRow kini meluas ke ukuran layar penuh, meskipun konten tab tidak meluas ke akhir layar. (Ic1e9c, b/261741384)

Compose Material3 Versi 1.4

Versi 1.4.0

24 September 2025

androidx.compose.material3:material3-*:1.4.0 dirilis. Versi 1.4.0 berisi commit ini.

Perubahan penting sejak versi 1.3.0:

Pengumuman perubahan pustaka

Library androidx.compose.material.icons tidak lagi direkomendasikan untuk menampilkan Ikon Material di Compose, karena Simbol Material adalah cara baru yang lebih baik. Kami telah berhenti memublikasikan update ke library ini dan library ini telah dihapus dari rilis library Material 3 terbaru. Anda masih dapat mereferensikannya secara manual jika belum dapat melakukan migrasi.

Sebagai gantinya, sebaiknya download file XML Vektor Drawable dari tab Android di https://fonts.google.com/icons untuk mendapatkan akses ke ikon bergaya terbaru: Simbol Material.

Mengapa kami tidak merekomendasikan perpustakaan lagi? Library ikon ("Ikon Material") telah digantikan oleh tampilan baru Simbol Material dan kami melihat bahwa library ini dapat meningkatkan waktu build aplikasi Anda secara signifikan karena mencakup semua ikon yang mungkin tidak diperlukan.

Untuk mengetahui informasi selengkapnya: https://developer.android.com/develop/ui/compose/graphics/images/material

Perubahan Perilaku

• Library ini tidak lagi menambahkan dependensi ke material-icons-core. Jadi, jika project Anda mengandalkan dependensi tersebut, Anda harus menambahkan dependensi tersebut secara eksplisit di file build.gradle[.kts]. (I735ff, b/349894318)

• Warna label aktif NavigationBarItem dan NavigationRailItem berubah dari onSurface menjadi sekunder untuk meningkatkan kegunaan, kontras warna, dan meningkatkan koherensi dalam sistem (Ibc297). Untuk kembali ke perilaku sebelumnya, salin warna default dan ubah selectedTextColor menjadi MaterialTheme.colorScheme.onSurface.

• Komponen Material 3 kini menggunakan MotionScheme baru untuk menentukan gerakannya. (Ie0f93)

• Perubahan gerakan Indikator Progres melingkar tidak tentu (I3c07e)

Komponen Desain Material 3 Baru

• HorizontalCenteredHeroCarousel
• VerticalDragHandle
• Mengamankan kolom teks untuk kolom entri sandi
  • SecureTextField
  • OutlinedSecureTextField

Peningkatan pada komponen Desain Material 3 yang ada

• Teks kini mendukung autoSize
  • Teks dengan string
  • Teks dengan annotatedString
• Menambahkan dekorator Material 3 untuk BasicTextField2
  • Textfield
  • OutlineTextfield
• Menambahkan API TimePickerDialog yang dapat digunakan untuk TimePicker, TimeInput, atau untuk memiliki versi yang dapat diubah.
• API kotak penelusuran baru:
  • Kotak penelusuran yang diciutkan dan "tampilan" penelusuran yang diperluas kini menjadi composable terpisah:
  • SearchBar mewakili kotak penelusuran dalam status diciutkan.
  • ExpandedFullScreenSearchBar dan ExpandedDockedSearchBar menampilkan kotak penelusuran dalam keadaan diperluas. Link ini akan terbuka di jendela baru.
  • SearchBarState untuk mengontrol status kotak penelusuran
• Mempromosikan API eksperimental menjadi stabil.
• Peningkatan performa

Versi 1.4.0-rc01

10 September 2025

androidx.compose.material3:material3-*:1.4.0-rc01 dirilis. Versi 1.4.0-rc01 berisi commit ini.

Versi 1.4.0-beta03

27 Agustus 2025

androidx.compose.material3:material3-*:1.4.0-beta03 dirilis. Versi 1.4.0-beta03 berisi commit ini.

Versi 1.4.0-beta02

13 Agustus 2025

androidx.compose.material3:material3-*:1.4.0-beta02 dirilis. Versi 1.4.0-beta02 berisi commit ini.

Perubahan Dependensi

• Menghapus dependensi graphics-shapes (I219e0, b/436230765)

Perubahan API

• Di PullToRefreshDefaults, shape diganti namanya menjadi indicatorShape dan containerColor diganti namanya menjadi indicatorContainerColor, serta indicatorMaxDistance ditambahkan untuk penggunaan indikator. (Ib6cbe)
• Menghapus tag penghentian penggunaan dari PullToRefreshDefaults.indicatorColor (Iaaee2)
• BasicAlertDialogOverrideScope secara tidak sengaja dipromosikan menjadi stabil dan anotasi eksperimentalnya dihapus di aosp/3701846. Menandainya sebagai internal. Fitur ini akan tetap menjadi eksperimental publik di 1.5.0-alpha (I9182a)

Perbaikan Bug

• Memperbaiki bug saat tombol kembali salah memperbarui offset panel. (I85624, b/427778135)

Versi 1.4.0-beta01

30 Juli 2025

androidx.compose.material3:material3-*:1.4.0-beta01 dirilis. Versi 1.4.0-beta01 berisi commit ini.

Perubahan yang dapat menyebabkan gangguan

• Semua API publik yang diberi tag ExperimentalMaterial3ExpressiveApi atau ExperimentalMaterial3ComponentOverrideApi telah dihapus. Beralihlah ke 1.5.0-alpha untuk terus menikmati fitur ini. (Ie4ae0)
• Harap perhatikan bahwa API pullToRefresh yang distabilkan berikut akan diganti namanya dalam rilis berikutnya. (Ib6cbe)

Fitur Baru

• Tooltip kini mendukung bentuk kursor kustom dan posisi kursor kustom (di atas, di bawah, di kiri, atau di kanan anchor). (Ie513c)

Perubahan API

• Anotasi penangguhan telah dihapus dari callback onDismiss. (Ie3166)
• DatePickerState.getDisplayedMonth(): YearMonth? dan DateRangePickerState.getDisplayedMonth(): YearMonth? telah diupdate untuk menampilkan nilai non-nullable. (Ice09c, b/427952972)
• Hapus ModalWideNavigationRailDefaults, pindahkan isinya ke WideNavigationRailDefaults, dan ganti nama terkait bentuknya. (Ic5e61)

Perbaikan Bug

• Memastikan DatePicker mematuhi lokalitasnya sendiri untuk pemformatan angka. Sebelumnya, jika DatePicker dikonfigurasi untuk lokalitas Arab, DatePicker dapat salah merender digit Latin jika lokalitas sistem perangkat menggunakan sistem penomoran yang berbeda. (Iccf76, b/432616196)
• Memperbaiki masalah LinearProgressIndicator yang tidak merender indikator berhenti dengan benar dalam tata letak RTL. (I0734c)
• Pemisah PrimaryScrollableTabRow dan SecondaryScrollableTabRow kini meluas ke ukuran layar penuh, meskipun konten tab tidak meluas ke akhir layar. (Ic1e9c, b/261741384)

Versi 1.4.0-alpha18

16 Juli 2025

androidx.compose.material3:material3-*:1.4.0-alpha18 dirilis. Versi 1.4.0-alpha18 berisi commit ini.

Fitur Baru

• ModalBottomSheetProperties kini menyediakan opsi untuk menonaktifkan dismissRequest dari klik scrim. (I8e715)
• Menambahkan dukungan trackCornerSize ke Jalur RangeSlider. (Iec529)

Perubahan API

• Menjadikan railExpanded sebagai parameter wajib untuk WideNavigationRailItem, menambahkan modalContentColor untuk WideNavigationRailColors, dan memindahkan WideNavigationRailDefaults.modalContainerShape ke ModalWideNavigationRailDefaults.containerShape. (Id60c5)
• Pindahkan param fungsi warna baru WideNavigationRail menjadi yang terakhir, dan hentikan penggunaan fungsi lama. (Iac7f7)
• PullToRefresh sekarang menjadi API stabil (I18537)
• Update pada API DatePickers. Kami menghapus tanggal akhir null default untuk DateRangePicker dan mewajibkannya untuk diteruskan. Kami juga mengklarifikasi penggunaan tengah malam UTC dari representasi tanggal dalam dokumentasi API, dan menandai getter dan setter terbaru yang menggunakan java.time API sebagai eksperimental untuk saat ini. (I121b3, b/427952972)
• Mengubah API Icon dengan parameter tint: ColorProducer dari eksperimental menjadi non-eksperimental. (Ia0133)
• Menghapus anotasi eksperimental dari DatePicker, DateRangePicker, dan status, class, serta jenis pendukungnya. (I0e4e0, b/391848485)
• Mengubah nilai fokus default menjadi salah (false) untuk memperbaiki fokus a11y, dan menambahkan parameter hasAction ke TooltipBox. (I62998)
• Meluluskan API WideNavigationRail, ShortNavigationBar, dan NavigationItem eksperimental. (I3ca3c)
• Menghapus anotasi @ExperimentalMaterial3Api dari beberapa fungsi panel aplikasi atas, class pendukung, dan objek. (I0a9b7)

Versi 1.4.0-alpha17

2 Juli 2025

androidx.compose.material3:material3-*:1.4.0-alpha17 dirilis. Versi 1.4.0-alpha17 berisi commit ini.

Fitur Baru

• Perbarui animasi grup tombol untuk menganimasikan ke 75% animasi saat diklik, bukan ditekan. (593942a, b/423596967)

Perbaikan Bug

• Memperbaiki masalah saat item carousel, dalam beberapa kasus, dapat melebihi ukuran elemen besar selama perhitungan tata letak, yang memotong seluruh widget. (I1c3d7, b/397489534)
• Memperbaiki lompatan melewati beforeContentPadding saat men-scroll carousel dengan offset pergeseran awal dan akhir yang tumpang-tindih. (c3d5f3a, b/420618979)
• Perbarui perilaku yang diaktifkan SwipeToDismiss untuk mengamati status yang diselesaikan, bukan status saat ini. Memulihkan perilaku yang ada saat perilaku penahan hanya dinonaktifkan saat komponen diselesaikan dalam status ditutup. (3844e07, b/425006844)
• Menu pop-up ExposedDropdownMenu kini dapat dibuka melalui input keyboard. Selain itu, menu kini dapat dijangkau melalui keyboard untuk variasi yang dapat diedit. (46ead03)

Versi 1.4.0-alpha16

18 Juni 2025

androidx.compose.material3:material3-*:1.4.0-alpha16 dirilis. Versi 1.4.0-alpha16 berisi commit ini.

Fitur Baru

• Menambahkan komponen carousel utama yang rata tengah (I6f6d3)

Perubahan API

• Penerapan XR menggantikan toolbar vertikal (Ia1604)
• Menambahkan fungsi scroll terprogram ke CarouselState (I12f8e)
• Menambahkan ComponentOverride untuk ModalWideNavigationRail (I4f440)
• Menambahkan ComponentOverride untuk WideNavigationRail (I6354f)
• Membuat ComponentOverride untuk HorizontalFloatingToolbar (I51116)
• Buat ComponentOverride untuk ShortNavigationBar (I30e24)
• Referensi SwipeToDismissBoxState ke confirmValueChange telah ditandai sebagai tidak digunakan lagi. Pengguna harus memanfaatkan callback onDismissed API SwipeToDismissBox. (Iee780)
• Menambahkan parameter userScrollEnabled ke composable Carousel. (I1d4d2)
• currentItem Carousel kini dapat diamati dari CarouselState. (Ie87e9)

Perbaikan Bug

• Memperbaiki masalah saat bentuk arbitrer pada FAB yang diteruskan ke FloatingToolbar tidak menerapkan bayangannya dengan benar. (Icdcc9, b/423336922)
• Semua Carousel kini menggunakan peran semantik Carousel secara default. (I7af12)
• Memperbaiki gerakan penunjuk yang salah saat status penggeser diperbarui melalui LaunchedEffect (Id9f31, b/302774166)

Versi 1.4.0-alpha15

20 Mei 2025

androidx.compose.material3:material3-*:1.4.0-alpha15 dirilis. Versi 1.4.0-alpha15 berisi commit ini.

Perubahan API

• Menambahkan MotionTheme.LocalMotionScheme, komposisi lokal. Hal ini memungkinkan akses ke skema gerakan tema dari CompositionLocalConsumerModifierNodes, dengan currentValueOf(MotionTheme.LocalMotionScheme). (I014b1)
• Konstruktor ColorScheme tanpa peran warna Tetap kini tidak digunakan lagi. Lakukan migrasi ke konstruktor yang menyertakan peran tetap. (Iad0ee)
• Komponen Teks M3 kini mendukung TextAutoSize. (I7f524)
• Menambahkan API untuk membuat varian ukuran tombol terpisah dan menambahkan sampel. (Ice30b)

Perbaikan Bug

• Memperbaiki masalah saat Snackbar dan FloatingActionButton diposisikan secara tidak benar saat layar penuh diaktifkan. Scaffold kini menerapkan inset horizontal dengan benar ke komponen ini. (Ib7c30, b/244400727)
• Perbaiki gerakan BottomSheet dari diperluas sepenuhnya menjadi diperluas sebagian. BottomSheet sekarang menggunakan efek cepat MotionScheme saat menyembunyikan atau menciutkan, dan default-spatial saat meluaskan. (Ifa46f, b/416063171)
• Konstruktor ColorScheme tanpa peran penampung permukaan telah ditandai sebagai tersembunyi dan tidak lagi direkomendasikan untuk digunakan. (Ia7237)
• Menghapus persyaratan CircularWavyProgressIndicator Size.minDimension > 0, yang sebelumnya memunculkan pengecualian, untuk memberikan fleksibilitas yang lebih besar. (Ic9418, b/377531195)
• Hyperlink di Text(AnnotatedString) kini memiliki gaya Material secara default. (I78288, b/339843816)
• Memperbaiki masalah saat fungsi toShape() di RoundedPolygon menyimpan Path dalam cache dan menyebabkan masalah saat beberapa panggilan createOutline dilakukan dengan ukuran yang berbeda. (I4026d)

Versi 1.4.0-alpha14

7 Mei 2025

androidx.compose.material3:material3-*:1.4.0-alpha14 dirilis. Versi 1.4.0-alpha14 berisi commit ini.

Perubahan API

• Menambahkan composable AppBarColumn baru yang berfungsi dengan cara yang sama seperti AppBarRow, tetapi untuk konten yang disusun dalam kolom. (Iaf6bd)
• Menambahkan item maks ke AppBarRow, hal ini diperlukan untuk menerapkan spesifikasi material dengan benar untuk panel aplikasi atas. (I92ce4)
• Menambahkan metode di TooltipScope untuk mendapatkan layoutCoordinates anchor. Menghentikan penggunaan metode drawCaret karena developer dapat menggunakan metode baru ini untuk mendapatkan batas penahan layoutCoordinates dan membuat bentuk yang sesuai yang berisi tanda sisipan. (Ia2e12, b/329470609)
• Menambahkan dukungan java.time untuk Pemilih Tanggal: Memperkenalkan overload rememberDatePickerState/rememberDateRangePickerState yang menerima objek java.time (misalnya, LocalDate awal, YearMonth). Juga menambahkan fungsi ekstensi pada objek status untuk mendapatkan/menetapkan nilai menggunakan jenis seperti LocalDate dan YearMonth. Memerlukan API 26+ atau desugaring. (I70f29, b/266202516, b/281859606)
• Tambahkan composable CenteredTrack yang memungkinkan penggunaan Penggeser dengan jalur yang dimulai dari tengah. (I5b1d6)

Perbaikan Bug

• Meningkatkan performa Indikator Progres Bergelombang: Jenis Linear kini dimuat ~8,5% lebih cepat dengan ~11% lebih sedikit alokasi, sementara jenis Circular mengalami peningkatan kecepatan yang signifikan sebesar ~47% dan pengurangan alokasi sebesar ~39%. (I595d8)

Versi 1.4.0-alpha13

23 April 2025

androidx.compose.material3:material3-*:1.4.0-alpha13 dirilis. Versi 1.4.0-alpha13 berisi commit ini.

Perubahan API

• isAppearanceLightStatusBars dan isAppearanceLightNavigationBars diperkenalkan kembali ke ModalBottomSheetProperties sebagai parameter khusus Android. (Id4bc0)
• Tambahkan composable AppBarRow, yang menangani item yang meluap dan tidak muat di luar batasnya. (I742bd)
• Mengupdate API DatePicker dan DateRangePicker untuk meminta fokus saat beralih ke mode input tanggal. Kami telah mengganti parameter boolean requestFocus dengan parameter focusRequester opsional yang menggunakan FocusRequester. (I14b69)
• Menghapus pengubah dan sumber interaksi dari item yang dapat diklik dan diaktifkan/dinonaktifkan secara default. Sebagai gantinya, jadikan sebagai detail penerapan. (I95ed6)
• Memperbarui ButtonGroup agar meluap ke menu dropdown jika ada terlalu banyak tombol yang tidak muat di layar. (I7b88b)

Perbaikan Bug

• Sheet bawah kini menggunakan inset atas jika lebih kecil dari offset saat ini. Hal ini memungkinkan pengguna memberikan inset atas untuk perilaku yang diperluas. BottomSheetDefaults.windowInsets kini menyertakan WindowInsets.safeDrawing.Top. (I0ab67, b/321877275, b/336962418, b/342093067)
• Mengaktifkan animasi masuk/keluar (memudar/menggeser) untuk ikon/avatar utama dan ikon pengiring Chip saat ditambahkan atau dihapus. Hal ini terutama bermanfaat bagi Chip yang dapat dipilih (Filter, Input), tetapi berlaku secara umum. (I9af21)
• Memperbaiki perilaku Penggeser RTL yang rusak akibat LookaheadScope. (Ieb152, b/408118041)
• Memperbaiki error AppBar Bawah yang terkait dengan men-scroll dengan UI sistem tersembunyi. (Ic6140, b/405996228)

Versi 1.4.0-alpha12

9 April 2025

androidx.compose.material3:material3-*:1.4.0-alpha12 dirilis. Versi 1.4.0-alpha12 berisi commit ini.

Perubahan API

• Menghapus parameter khusus Android dari ModalBottomSheetProperties (Iab97f, b/362539765)
• Memperkenalkan fungsi overload untuk default ukuran tuas tarik (I0ed0d)
• Tambahkan fungsi NavigationSuiteScaffold dan NavigationSuiteScaffoldLayout baru untuk mendukung jenis tata letak baru dan menambahkan dukungan untuk konten tindakan utama opsional. (Ib262a, b/353144478)
• Menghentikan penggunaan Modifier.weight dengan parameter pengisian di ButtonGroup. Menambahkan versi tanpa pengisian. (Id32bb)
• Mengganti nama komponen IconButton xSmall- dan xLarge- menjadi extra. (Ib6e0f)
• Tambahkan fungsi NavigationSuite, NavigationSuiteItem, dan NavigationSuiteColors baru untuk mendukung jenis tata letak baru. (I203d6)
• Tambahkan NavigationSuiteTypes baru dan tambahkan fungsi navigationSuiteType baru yang menyertakan pilihan tata letak tersebut (If68f9)

Perbaikan Bug

• ColorScheme.contentColorFor kini memetakan surfaceDim ke onSurface. (I8891a)
• Memperbarui penerapan DateInputTextField untuk mengatasi masalah saat kolom input tidak mencerminkan tanggal yang ditetapkan secara terprogram. (I6c8d1, b/401143451)
• Memperbaiki urutan fokus talkback untuk kolom samping navigasi dan kolom samping navigasi lebar (I6cf6f, b/407048224)

Versi 1.4.0-alpha11

26 Maret 2025

androidx.compose.material3:material3-*:1.4.0-alpha11 dirilis. Versi 1.4.0-alpha11 berisi commit ini.

Perubahan API

• Perbarui kapitalisasi untuk properti composable dalam objek default untuk tombol dan tombol ganti. Tambahkan metode di ToggleButtonDefaults dan ButtonDefaults untuk padding konten, bentuk, ukuran ikon, jarak ikon, dan gaya teks yang direkomendasikan, bergantung pada tinggi penampung. (Iea69e)
• Menghapus fungsi dan konstanta eksperimental yang tidak digunakan lagi dari FloatingToolbar. (I8f339)
• Komponen elevasi kini berbagi antarmuka umum dan memiliki konstruktor serta properti publik. (Ibb172)
• Menambahkan pengubah animateWidth di ButtonGroupScope yang akan digunakan dengan turunan grup tombol untuk menganimasikan turunan dengan benar. (Ia3bb6)

Perbaikan Bug

• Memperbaiki padding Toolbar Mengambang untuk memastikan keseimbangan visual saat diciutkan, dan meningkatkan fleksibilitas untuk konten yang lebih besar. (I06c00)

Versi 1.4.0-alpha10

12 Maret 2025

androidx.compose.material3:material3-*:1.4.0-alpha10 dirilis. Versi 1.4.0-alpha10 berisi commit ini.

Perubahan API

• TabRowDefaults.tabIndicatorOffset tidak digunakan lagi dan digantikan dengan TabIndicatorScope.tabIndicatorOffset. (Ib36b3)
• Memperbaiki kesalahan ketik untuk padding konten kecil di default tombol. (I19bfe)
• TabRow dan ScrollableTabRow tidak digunakan lagi dan digantikan dengan varian Primer dan Sekunder dari masing-masing warna. Baris tab Utama dan Sekunder memiliki performa yang lebih baik dan akurat sesuai spesifikasi. (I918e2)
• Menambahkan rememberSliderState dan rememberRangeSliderState. (I8e384)
• Menambahkan shouldAutoSnap ke SliderState untuk mengontrol mekanisme penempelan otomatis. Menonaktifkannya mungkin berguna untuk animasi kustom. (I07745)
• Lebar tab minimum baris tab yang dapat di-scroll kini menjadi parameter. Varian baris tab Primer dan Sekunder tidak lagi bersifat eksperimental. (If6f15, b/226665301)
• Membuat class ExitAlwaysFloatingToolbarScrollBehavior publik sehingga memungkinkan pembuatan tanpa komposisi. (Ibf31c)

Versi 1.4.0-alpha09

26 Februari 2025

androidx.compose.material3:material3-*:1.4.0-alpha09 dirilis. Versi 1.4.0-alpha09 berisi commit ini.

Perubahan API

• Ganti nama kolom setelan DragHandle dalam status default; pisahkan status ditekan dan ditarik; jadikan ukuran default bersifat publik. (I787b9)
• Update pada API TowRowsTopAppBar. Menghapus parameter lambda expanded dan menambahkan parameter terpisah untuk tinggi yang diperluas dan diciutkan. (Idd677, b/306697446, b/229134133, b/268068946)

Perbaikan Bug

• Panel aplikasi bawah kini mengamati layanan eksplorasi sentuh (misalnya, TalkBack) dan tetap menampilkannya setiap kali layanan aktif. (I4b34d)

Versi 1.4.0-alpha08

12 Februari 2025

androidx.compose.material3:material3-*:1.4.0-alpha08 dirilis. Versi 1.4.0-alpha08 berisi commit ini.

Fitur Baru

• Menambahkan API TimePickerDialog yang dapat digunakan untuk TimePicker, TimeInput, atau untuk memiliki versi yang dapat diubah. (Id2d83)

• API kotak penelusuran baru:

  • Kotak penelusuran yang diciutkan dan "tampilan" penelusuran yang diperluas kini menjadi composable terpisah.
  • SearchBar mewakili kotak penelusuran dalam status diciutkan.
  • ExpandedFullScreenSearchBar dan ExpandedDockedSearchBar menampilkan kotak penelusuran dalam keadaan diperluas. Link ini akan terbuka di jendela baru.
  • SearchBarState untuk mengontrol status kotak penelusuran
  • TopSearchBar untuk menambahkan penanganan inset dan perilaku scroll
  • Overload baru InputField yang menggunakan SearchBarState (Ie0723, b/261496232, b/283311462, b/350916229, b/352872248)

Perubahan API

• Mendukung perubahan bentuk sudut tombol ikon saat ditekan. (I21843)
• API kotak dekorasi/decorator kolom teks tidak lagi bersifat eksperimental. (I31d95)
• Menambahkan sampel dan default untuk varian yang terhubung untuk ButtonGroup. (I5c8ce)
• Jadikan parameter status yang terakhir di NavigationSuiteScaffold dan NavigationSuiteScaffoldLayout. (I9cc7b)

Perbaikan Bug

• Menambahkan tindakan aksesibilitas kustom ke FloatingToolbars sehingga layanan aksesibilitas kini dapat meluaskan atau menciutkan semua variasi FloatingToolbar. Versi yang dilengkapi FAB menerapkan hal ini ke FAB, sedangkan versi tanpa FAB menerapkannya ke konten utama. (I26420)
• FloatingToolbars kini mengamati layanan eksplorasi sentuh (misalnya, TalkBack) dan tetap memperluas serta menampilkan toolbar setiap kali layanan aktif. (I02172)
• Memperbaiki error pada indikator progres dan pemuatan jika Float.NaN diteruskan sebagai progres. (I4fa96, b/352364576)

Versi 1.4.0-alpha07

29 Januari 2025

androidx.compose.material3:material3-*:1.4.0-alpha07 dirilis. Versi 1.4.0-alpha07 berisi commit ini.

Fitur Baru

• Menambahkan fleksibilitas yang lebih besar dalam menyesuaikan tampilan Kotak Centang dengan API baru. API ini menyediakan parameter Stroke yang memungkinkan kontrol lebih besar atas cara tanda centang dan garis luar kotak centang dirender. (I65a88)
• Menambahkan API TwoRowsTopAppBar, alternatif yang lebih dapat disesuaikan untuk panel aplikasi Sedang dan Besar dalam membuat panel aplikasi atas dua baris. Developer kini memiliki kontrol atas konten judul dan subtitel dalam status diciutkan dan diperluas, dengan tinggi yang dapat disesuaikan untuk setiap status. (I0be3c, b/306697446, b/229134133, b/268068946)

Perubahan API

• Mengganti nama variasi BottomAppBar eksperimental menjadi FlexibleBottomAppBar, sehingga memberikan kontrol yang lebih besar terhadap pengaturan dan tinggi konten. (Iaa448)
• Perbarui penamaan untuk properti di objek default Grup Tombol menjadi CapitalCase. Perbarui nama animateFraction agar lebih tepat dengan perilaku yang diwakilinya. (I545cd)
• Menambahkan overload untuk tombol umum yang memungkinkan bentuk animasi pada interaksi penekanan. Menambahkan bentuk tombol yang di-cache. (I5ec20)
• Anda kini dapat mengontrol cara FloatingToolbar dengan FAB bereaksi terhadap scrolling dengan memberikan FloatingToolbarScrollBehavior. Untuk toolbar yang diposisikan di sepanjang tepi tengah (seperti tengah atas atau tengah bawah), sebaiknya gunakan perilaku scroll untuk menyembunyikan seluruh komponen saat scroll agar terlihat lebih rapi. Hal ini juga mencegah FAB menjadi tidak berada di tengah, yang dapat terjadi saat menggunakan flag expanded untuk menciutkan. (I33f67)
• Memperbarui API TopAppBar eksperimental untuk menggunakan Alignment.Horizontal, bukan TopAppBarTitleAlignment kustom saat menyetel perataan judul dan subjudul. (I70ca2)
• SliderState#onValueChange kini bersifat publik untuk memberikan kontrol yang lebih besar kepada pengguna (I104eb)
• Memperkenalkan NavigationSuiteScaffoldState untuk memungkinkan animasi komponen navigasi. Juga memperkenalkan overload NavigationSuiteScaffold dan NavigationSuiteScaffoldLayout yang memiliki parameter status. (I6a8c9, b/328674235)

Perbaikan Bug

• Memindahkan class IconButtonColors dan IconToggleButtonColors dari IconButtonDefaults.kt kembali ke IconButton.kt. (I3c233)

Kontribusi Eksternal

• SliderState#isDragging kini bersifat publik. (I8458a)

Versi 1.4.0-alpha06

15 Januari 2025

androidx.compose.material3:material3-*:1.4.0-alpha06 dirilis. Versi 1.4.0-alpha06 berisi commit ini.

Perubahan Perilaku

• Menambahkan displayCutout ke grup inset yang diperhitungkan oleh komponen Material secara default, untuk menghindari konten yang tumpang-tindih dengan potongan layar. Ini adalah perubahan perilaku yang akan memengaruhi cara komponen yang mendukung inset berperilaku di sekitar potongan layar. Ini mencakup nilai default parameter WindowInsets untuk komponen Material 3 yang sadar inset, dan nilai WindowInsets yang diberikan dalam objek Default komponen untuk Material 2 dan Material 3. Jika perubahan ini menyebabkan perilaku yang tidak diinginkan, tentukan parameter WindowInsets secara manual berdasarkan per komponen. (I43ee9, b/362508045)

Perubahan API

• Update pada API TopAppBar. Ganti nama panel aplikasi atas sedang dan besar dengan subjudul menjadi *FlexibleTopAppBar. Menyatukan variasi warna ke dalam satu fungsi TopAppBarDefault.topAppBarColors(), dan menambahkan parameter warna subtitle yang akan diterapkan untuk Composable subtitle yang disediakan (I41b65)
• Menghapus WideNavigationRailArrangement API untuk mendukung Arrangement.Vertical (Id0341)
• Tambahkan VerticalSlider @Composable baru. (I2bfba)
• Menambahkan Jalur @Composable baru yang memungkinkan penentuan sudut jalur eksternal kustom dan ikon jalur. (I436a4)
• Perbarui API toolbar mengambang untuk menggunakan objek FloatingToolbarColors, bukan satu warna penampung. (I9a054)
• Menambahkan dan menggunakan anotasi eksperimental baru ExperimentalMaterial3ComponentOverrideApi (Ia1eaf)
• Modifier.indicatorLine kini menggunakan bentuk untuk kolom teks guna menangani pemangkasan. (I8c5f3, b/380704151)
• Mengganti nama fungsi FloatingAppBar eksperimental menjadi FloatingToolbar (I1dbf8)
• Menambahkan floatingToolbarVerticalNestedScroll baru yang dapat dilampirkan ke penampung yang dapat di-scroll untuk memperbarui status perluasan toolbar mengambang berdasarkan gerakan scroll yang melintasi nilai minimum. (I6d65f)
• Memperkenalkan API baru untuk membuat toolbar mengambang dengan Tombol Tindakan Mengambang (FAB) yang terlampir. API ini menyediakan opsi penyesuaian yang fleksibel, sehingga Anda dapat mengatur toolbar secara horizontal atau vertikal dan menempatkan FAB di awal atau akhir toolbar. (I9e350)

Perbaikan Bug

• Memperbaiki masalah aksesibilitas Snackbar yang menyebabkan Snackbar mengumumkan dirinya sendiri saat ditutup jika TalkBack aktif. (/I9db53)

Kontribusi Eksternal

• BasicTooltip yang umum di foundation dan BasicTooltip/Tooltip di material3. (Ifc2e6)

Versi 1.4.0-alpha05

12 Desember 2024

androidx.compose.material3:material3-*:1.4.0-alpha05 dirilis. Versi 1.4.0-alpha05 berisi commit ini.

Perubahan API

• Mengganti jenis dalam nilai WideNavigationRailState.current/target untuk enum agar lebih mudah dibaca (I2d6ab)
• SplitButton mengubah Shape API dari class data menjadi class untuk kompatibilitas biner. (I53812)
• Menambahkan API tooltip yang memiliki parameter onDismissRequest sehingga pembuat dapat memutuskan apa yang terjadi saat pengguna mengklik di luar tooltip. Menghentikan penggunaan API lama yang tidak berisi parameter baru ini. (I99aef)
• Ubah penamaan opticalCentering menjadi horizontalCenterOptically. Menjadikan pengubah internal. Ganti parameter padding dengan offset awal dan akhir maksimum. (I0b904)
• Ubah WideNavigationRailState agar memiliki nilai saat ini/target, hapus enum untuk mendukung boolean. (Idfa29, b/356039090)
• Menambahkan NavigationBarItemComponentOverride. (I3a06a)

Perbaikan Bug

• Memperbaiki perilaku panel aplikasi atas dan bawah agar dapat mengubah warna dengan andal saat konten di-scroll hingga akhir. (Idc4e8, b/293665988)
• Fungsi perilaku scroll untuk panel aplikasi atas dan bawah kini menampilkan perilaku yang diingat agar performanya lebih baik di seluruh rekomposisi. (I0fdbe, b/207957336)
• Parameter pengubah kini diterapkan setelah pengubah internal seperti perilaku penarikan dan semantik, bukan sebelumnya. Hal ini memengaruhi urutan penerapan pengubah. (I8d83f)
• Sheet bawah yang diluaskan tetap diluaskan saat ukuran berubah. (I2870b, b/324934884)
• Merutekan flag status dan menu navigasi dengan benar untuk properti jendela. (Ie674d, b/362539765)
• Pindahkan parameter pengubah ke root scaffold, seperti yang didokumentasikan. Hal ini menyelaraskan penerapan dengan M2. (I0235e, b/372311595)

Kontribusi Eksternal

• Fungsi DatePickerDialog yang umum. (I7dced)

Versi 1.4.0-alpha04

13 November 2024

androidx.compose.material3:material3-*:1.4.0-alpha04 dirilis. Versi 1.4.0-alpha04 berisi commit ini.

Perubahan Perilaku

• Mengembalikan perubahan warna yang diperkenalkan di aosp/3212478 ke iconButtonColors, iconToggleButtonColors, outlinedIconButtonColors, outlinedIconToggleButtonColors, dan outlinedIconToggleButtonBorder. Memindahkan perilaku yang kini dikembalikan ke set fungsi baru yang disebut iconButtonVibrantColors dan seterusnya untuk menekankan warna kontras tinggi yang ditampilkan. (Iffd8d)

Fitur Baru

• Memperkenalkan komponen VerticalDragHandle (I6c770)

Perubahan API

• Mengganti nama DismissibleModalWideNavigationRailDefaults menjadi ModalWideNavigationRailDefaults. (I8e877)
• Menambahkan NavigationBarComponentOverrides. (I8a3f3)
• Menambahkan NavigationRailComponentOverride. (I83e13)
• Memperkenalkan WideNavigationRailState untuk menangani penciutan/perluasan panel samping, memungkinkan ModalWideNavigationRail ditutup, dan menghapus DismissibleModalWideNavigationRail. (I88568)
• Tambahkan default ukuran xSmall, medium, large, dan xLarge ke default tombol toggle. (Ie95d1)
• Tambahkan default ukuran xSmall, medium, large, dan xLarge ke default tombol. (If8b6d)

Perbaikan Bug

• Warna ikon trailing chip filter telah diupdate dari Primer menjadi OnSurfaceContainer, sesuai spesifikasi. Semua warna garis tepi chip telah diupdate dari Garis Tepi menjadi Varian Garis Tepi, sesuai spesifikasi. (I68bd4)

Versi 1.4.0-alpha03

30 Oktober 2024

androidx.compose.material3:material3-*:1.4.0-alpha03 dirilis. Versi 1.4.0-alpha03 berisi commit ini.

Perubahan API

• Konstruktor SheetState dengan kepadatan tidak digunakan lagi dan digantikan dengan nilai minimum posisi dan kecepatan. (Ifd16e)
• Menambahkan rememberTooltipPositionProvider yang berisi logika penentuan posisi yang diperbarui. Menghentikan penggunaan rememberPlainTooltipPositionProvider dan rememberRichTooltipPositionProvider. (Ie66e2)
• ModalBottomSheetProperties tambahan memungkinkan penyesuaian warna status dan menu navigasi. Secara default, pembaruan ini didasarkan pada warna konten, bukan status tema gelap sistem. (Ib874e, b/362539765)
• Meningkatkan pengalaman input untuk pemilih tanggal: saat dalam mode input, kolom teks tanggal akan difokuskan untuk entri teks langsung. Perubahan ini menambahkan parameter requestFocus ke DatePicker dan DateRangePicker. Anda dapat mencegah fokus dengan meneruskan false. (I12d09, b/286399710, b/340102743)
• Menyimpan cache default bentuk ke dalam objek Shape. Menjadikan default bentuk @Composable untuk tombol ganti. Menciutkan bentuk menjadi satu bentuk default karena varian mengarah ke file token yang sama. (Iaa014)

Perbaikan Bug

• Mengoptimalkan perilaku Scaffold contentPadding untuk menghindari rekomposisi konten isi setiap kali contentPadding berubah. (I8c8e2, b/373904168)
• TextFieldLabelScope progress diganti namanya menjadi labelMinimizedProgress
• TextFieldLabelPosition Default diganti namanya menjadi Attached. Anggota antarmuka telah dihapus. (If75c6)
• Memperbaiki masalah pada DatePicker dalam mode input saat error validasi dapat menyebabkan perubahan tinggi komponen. (I2e229, b/280462363)
• Buat penggeser material mengubah nilainya saat tombol kontrol ditekan. (I1c442)

Versi 1.4.0-alpha02

16 Oktober 2024

androidx.compose.material3:material3-*:1.4.0-alpha02 dirilis. Versi 1.4.0-alpha02 berisi commit ini.

Perubahan API

• Pembaruan pada pemilih tanggal untuk memastikan penggunaan Locale yang konsisten di seluruh DatePicker dan DateRangePicker saat menyetel Locale secara langsung melalui DatePickerState atau DateRangePickerState. Perhatikan bahwa saat menyetel Locales langsung ke status, Anda harus memastikan bahwa teks judul dan headline dilokalkan dengan tepat, karena teks defaultnya akan tetap diterapkan sesuai dengan Locale platform default. (I37073, b/326490763, b/321657276)
• SheetState.isAnimationRunning kini ditampilkan. (I9a3d7)
• DatePickerColors kini diprioritaskan dengan benar daripada warna yang bertentangan yang ditentukan pada gaya teks Tipografi tema. Perhatikan juga bahwa update ini menyesuaikan posisi parameter color dalam fungsi pemilih tanggal dan memperkenalkan parameter contentColor untuk menyesuaikan warna teks header dan judul. (I30d03, b/347031394)
• Ganti nama SplitButton menjadi SplitButtonLayout dan hapus API varian warna SplitButton. Varian akan dicapai dengan menggunakan kembali varian tombol yang disediakan oleh SplitButtonDefaults. (I44c36)
• ModalBottomSheet kini memiliki parameter sheetGestureEnabled (I856cb, b/288211587)
• Mengganti nama standardMotionScheme dan expressiveMotionScheme menjadi standar dan ekspresif. Kedua fungsi kini dapat diakses melalui objek pendamping MotionScheme dengan memanggil MotionScheme.standard() dan MotionScheme.expressive(). (Iceccf)
• Menambahkan parameter maxWidth ke tooltip biasa dan tooltip kaya. Nilai defaultnya adalah spesifikasi desain 200 dp untuk tooltip biasa dan 320 dp untuk tooltip kaya. (I30ce9)

Perbaikan Bug

• DatePicker dan DateRangePicker kini memperbarui bulan yang ditampilkan dengan benar saat ditetapkan melalui displayedMonthMillis statusnya. (If9e47, b/333414302)
• Konten ModalBottomSheet kini memindahkan konten dari status bar. (I5114c, b/321877275, b/336962418, b/342093067)
• [Bottom Sheet] Mengubah kembali prioritas callback ke PRIORITY_DEFAULT untuk memungkinkan keyboard IME ditutup terlebih dahulu. (I447fb)
• Memperbaiki error di DatePicker dan DateRangePicker saat tahun minimum yang dapat dipilih ditetapkan ke tahun mendatang. (I78656, b/319395747)
• Memperbaiki masalah pemilih tanggal untuk memperbarui UI saat instance SelectableDates yang diperbarui diterapkan. (Iad59a, b/290135807, b/339898760)

Versi 1.4.0-alpha01

2 Oktober 2024

androidx.compose.material3:material3-*:1.4.0-alpha01 dirilis. Versi 1.4.0-alpha01 berisi commit ini.

Perubahan Perilaku

• Library tidak lagi menambahkan dependensi ke material-icons-core, jadi jika project Anda bergantung pada dependensi tersebut, Anda harus menambahkannya secara eksplisit dalam file build.gradle[.kts]. (I735ff, b/349894318)
• Warna label aktif NavigationBarItem dan NavigationRailItem berubah dari onSurface menjadi secondary untuk meningkatkan kegunaan, kontras warna, dan koherensi dalam sistem (Ibc297). Untuk kembali ke perilaku sebelumnya, salin warna default dan ubah selectedTextColor menjadi MaterialTheme.colorScheme.onSurface.
• Komponen Material 3 kini menggunakan MotionScheme baru untuk menentukan gerakannya. (Ie0f93)
• Perubahan gerakan Indikator Progres melingkar tidak tentu (I3c07e)
• Perbarui OutlinedIconButtonColors dan OutlinedIconToggleButtonColors untuk kontras warna yang lebih baik. (I2743d)
• Memperbarui warna penampung dan konten untuk FilledIconToggleButtonColors dan FilledTonalIconToggleButtonColors. (Ic5d0f)
• Warna batas OutlinedButton diperbarui dari outline menjadi outlineVariant. (057f00)

Perubahan API

• Menambahkan parameter reverseLayout opsional ke fungsi enterAlwaysScrollBehavior TopAppBar untuk mendukung konten yang ditetapkan dengan reverseLayout dengan lebih baik. (I4e0e5)
• SegmentedButton kini mendukung argumen contentPadding. (I5ad91, b/358414376)
• PullToRefreshState tidak lagi memiliki implementasi default untuk isAnimating (I6a593)
• Menambahkan overload baru dari TextField dan OutlinedTextField Material yang menggunakan TextFieldState. Menambahkan API kotak dekorasi yang kompatibel dengan TextFieldDecorator. (If13a1)
• Menambahkan parameter untuk mengontrol labelPosition kolom teks. Menggunakan alwaysMinimize memungkinkan pola UI menampilkan label dan placeholder di kolom teks secara bersamaan meskipun kolom tidak difokuskan. (I1ef2c)
• Menambahkan SecureTextField dan OutlinedSecureTextField Material untuk kolom entri sandi. (I7e22d)
• Menambahkan cakupan ke label kolom teks untuk mengkueri progres animasi. (If5ec8)
• Menambahkan dukungan untuk MotionEvent.CLASSIFICATION_DEEP_PRESS ke tooltip. (I62e6a)
• isAfternoon TimePickerState kini menjadi val ekstensi, bukan var di antarmuka, dan diganti namanya menjadi isPm (I89a97)
• Memperbarui class tipografi untuk mendukung skala huruf yang ditekankan. (Ifa13c)
• Menambahkan ModalWideNavigationRail API dan mengganti nama ModalExpandedNavigationRail API menjadi DismissibleModalWideNavigationRail. (Ic9118)
• FloatingAppBarScrollBehavior yang diperbarui untuk menghitung screenOffset secara otomatis dan tidak memerlukan @Composable. (Idf349)
• Update pada API LoadingIndicator untuk memperbaiki penamaan pada objek default-nya. Menambahkan konstanta LoadingIndicatorElevation di PullToRefresh. (I1d72b)
• Update pada API LoadingIndicator untuk memperbaiki penamaan pada objek default-nya. Menambahkan konstanta LoadingIndicatorElevation di PullToRefresh. (I1d72b)
• Menambahkan parameter amplitude dan waveSpeed ke variasi tidak pasti dari LinearWavyProgressIndicator dan CircularWavyProgressIndicator. (I2a0c5)
• Mendukung perubahan bentuk tombol toggle ikon berdasarkan status ditekan atau dicentangnya. (Ibc781)
• Memperbarui class tipografi untuk mendukung skala huruf yang ditekankan. (Ifa13c)
• Bentuk SplitButton berubah berdasarkan status default / ditekan. Menghapus AnimatedTrailingButton API karena TrailingButton API dapat menawarkan penyesuaian yang sama (I95066)
• Tambahkan pengubah untuk menganimasikan tampilan dan penyembunyian FAB, misalnya saat konten di-scroll. (I8338d)
• Menambahkan bentuk dan jarak grup tombol yang terhubung ke ButtonGroupDefaults untuk digunakan dalam sampel. (I68e30)
• Tombol terpisah menambahkan padding horizontal untuk tombol berikutnya dan mengaktifkan pemusatan optik yang dihitung dari perbedaan sudut awal dan akhir (I122e2)
• Memperkenalkan MotionScheme Material baru untuk memungkinkan penetapan skema gerakan komponen. Skema ditetapkan melalui MaterialTheme. (Id50c2)

Perbaikan Bug

• Terapkan indeks penjelajahan fokus yang benar ke Composable turunan Scaffold. Urutannya adalah topBar, bottomBar, fab, content, snackbar. (I5936b)
• Memperbaiki masalah di DatePicker dan DateRangePicker yang menyebabkan beberapa elemen tanggal (misalnya, nama bulan) tidak diawali dengan huruf kapital di lokalitas dan format-skeleton tertentu. (I1430f)
• Mengintegrasikan token komponen FAB dan Menu FAB (pembaruan visual kecil pada padding dan teks) (Ib57f3)
• ModalBottomSheet sekarang berada di urutan pertama dalam urutan penelusuran semantik, diikuti dengan scrim. (I436f9, b/358594665)
• Memperbaiki panel aplikasi bawah yang tidak menghilang sepenuhnya saat men-scroll di bawah tombol navigasi dalam mode layar penuh (I3ee21)

Compose Material3 Versi 1.3

Versi 1.3.2

9 April 2025

androidx.compose.material3:material3-*:1.3.2 dirilis. Versi 1.3.2 berisi commit ini.

Perbaikan Bug

• ListItem memperbaiki penghitungan tinggi intrinsiknya, kini mencadangkan jumlah ruang yang sesuai dalam Tata Letak.
• Menghapus padding label NavigationBarItem yang berlebihan, menyelaraskan dengan benar sesuai spesifikasi.
• Memperbaiki Tata Letak TabRow dalam mode RTL.

Versi 1.3.1

30 Oktober 2024

androidx.compose.material3:material3-*:1.3.1 dirilis. Versi 1.3.1 berisi commit ini.

Perbaikan Bug

• DatePicker dan DateRangePicker kini memperbarui bulan yang ditampilkan dengan benar saat ditetapkan melalui displayedMonthMillis statusnya. (If9e47, b/333414302)
• Memperbaiki error di DatePicker dan DateRangePicker saat tahun minimum yang dapat dipilih ditetapkan ke tahun mendatang. (I78656, b/319395747)
• Memperbaiki masalah pemilih tanggal untuk memperbarui UI saat instance SelectableDates yang diperbarui diterapkan. (Iad59a, b/290135807, b/339898760)
• Mengubah prioritas callback kembali yang digunakan oleh sheet bawah menjadi PRIORITY_DEFAULT agar keyboard IME dapat ditutup terlebih dahulu. (I447fb)

Versi 1.3.0

4 September 2024

androidx.compose.material3:material3-*:1.3.0 dirilis. Versi 1.3.0 berisi commit ini.

Perubahan penting sejak versi 1.2.0

Fitur utama 1.3.0

Komponen Desain Material 3 baru

• Carousel
  • HorizontalMultiBrowseCarousel dan HorizontalUncontainedCarousel Peningkatan pada komponen Desain Material 3 yang ada.
• [ModalBottomSheet] kini mendukung Kembali Prediktif di U+ (Iccf32, b/281967264, b/304850357)
• [SearchBar] kini mendukung Kembali Prediktif di U+ (I657f8)
• Panel Navigasi (ModalDrawerSheet dan DismissibleDrawerSheet) kini mendukung Kembali Prediktif di U+ sebagai keikutsertaan (Ie5b0b)
• DropdownMenu kini mendukung warna, bentuk, ketinggian, dan batas kustom. (I8e981,b/289554448, b/301887035, b/283654243)
• Memperbarui Penggeser untuk meningkatkan aksesibilitas dengan menambahkan indikator jeda dan berhenti. (I3058e)
• Memperbarui ProgressIndicator untuk meningkatkan aksesibilitas dengan menambahkan indikator jeda dan berhenti. (I21451)
• Menambahkan kursor default untuk tooltip kaya, mendukung kursor kustom yang akan digambar berdasarkan anchor LayoutCoordinates. (Ifd42c) Perubahan yang Dapat Menyebabkan Gangguan
• API tarik untuk memperbarui yang baru:
  • PullToRefreshState yang disederhanakan untuk menggunakan nilai pecahan, bukan unit Dp.
  • Status isRefreshing dikontrol oleh pengguna, bukan PullToRefreshState.
  • Memisahkan koneksi scroll bertingkat dari PullToRefreshState. Proses ini ditangani oleh PullToRefreshBox atau Modifier.pullToRefresh baru.
  • Update ini merupakan perubahan yang dapat menyebabkan gangguan pada API eksperimental sebelumnya. (I0adeb, b/314496282, b/317177684, b/323787138, b/324573502, b/317177683) Perubahan Visual yang Merusak
• Perbarui overlay status fokus menjadi 0,1f untuk memastikan kontras warna yang memadai. (I7ea77)
• Penyesuaian kecil pada default warna permukaan dan latar belakang di lightColorScheme dan darkColorScheme. (I9db52)
• Memperbarui warna Penggeser dan ProgressIndicator untuk mengikuti spesifikasi Kontras Non-Teks yang baru. (I26807)
• Varian SurfaceContainer kini digunakan oleh komponen. Komponen yang sebelumnya menghitung warna dengan Surface dan TonalElevation kini menggunakan peran SurfaceContainer secara default, yang tidak terpengaruh oleh elevasi tonal. (b/304584161)
• Peran dasar penampung Permukaan dan Permukaan telah disesuaikan sedikit, sehingga memberikan lebih banyak warna dalam tema terang dan gelap. (I677a5)
• Mempromosikan API eksperimental menjadi stabil.
• Peningkatan performa

Versi 1.3.0-rc01

21 Agustus 2024

androidx.compose.material3:material3-*:1.3.0-rc01 dirilis. Versi 1.3.0-rc01 berisi commit ini.

Perbaikan Bug

• ModalBottomSheet sekarang berada di urutan pertama dalam urutan penelusuran semantik, diikuti dengan scrim. (I436f9, b/358594665)

Versi 1.3.0-beta05

24 Juli 2024

androidx.compose.material3:material3-*:1.3.0-beta05 dirilis. Versi 1.3.0-beta05 berisi commit ini.

• Memperbaiki masalah yang menyebabkan konten BottomSheet hilang atau terpotong di Android N dan O (a10a2d)
• Meningkatkan batas semantik penggeser agar TalkBack dapat menampilkan indikator fokus di sekitar ibu jari dengan benar. (0b5a1d)

Versi 1.3.0-beta04

26 Juni 2024

androidx.compose.material3:material3-*:1.3.0-beta04 dirilis. Versi 1.3.0-beta04 berisi commit ini.

Versi 1.3.0-beta03

12 Juni 2024

androidx.compose.material3:material3-*:1.3.0-beta03 dirilis. Versi 1.3.0-beta03 berisi commit ini.

Kontribusi Eksternal

• Menyediakan androidx.compose.material3.DropdownMenu dari set sumber umum. (If62c0)

Versi 1.3.0-beta02

29 Mei 2024

androidx.compose.material3:material3-*:1.3.0-beta02 dirilis. Versi 1.3.0-beta02 berisi commit ini.

Perubahan API

• Modifier.pullToRefreshIndicator mendukung elevasi, perbarui Pull To Refresh API agar memiliki nilai boolean untuk diaktifkan, bukan lambda. Mendukung perataan konten di PullToRefreshBox (I75679)
• Menjadikan TooltipScope sebagai antarmuka tertutup dan membuat implementasi internal untuk digunakan di TooltipBox dan Label. (I3833e)
• Menambahkan dua pengubah baru ke CarouselItemScope - maskClip dan maskBorder - untuk memudahkan penambahan bentuk dan batas ke item carousel (Id67a1)
• TimePickerState sekarang menjadi antarmuka dan memungkinkan penyetelan waktu (I88546)
• Memperbarui API untuk menata gaya link: memindahkan TextLinkStyles ke TextStyle dan menghapus TextDefaults dari material. (I5477b)

Perbaikan Bug

• Ikon status ModalBottomSheet dan menu navigasi kini merespons status tema gelap. (Ie1fe7, b/338342149)
• Menambahkan semantik sheet tutup ke layar penutup ModalBottomSheet. (0e61cb,b/328801864)

Kontribusi Eksternal

• Menyediakan androidx.compose.material3.AlertDialog dari set sumber umum (Ia33f5)
• Menyediakan ModalBottomSheet dari set sumber umum (Id7cc7)

Versi 1.3.0-beta01

14 Mei 2024

androidx.compose.material3:material3-*:1.3.0-beta01 dirilis. Versi 1.3.0-beta01 berisi commit ini.

Perubahan API

• Menggunakan DpSize, bukan CaretProperties. Menghapus CaretProperties. Ganti nama CaretScope menjadi TooltipScope. (Id9a76)
• Memperbarui API untuk mendapatkan link bertema Material dalam teks. Secara khusus, metode dihapus dari TextDefaults untuk membuat LinkAnnotations bertema dan mengurai HTML dengan link bertema. Sebagai gantinya, tambahkan class TextLinkStyles yang memungkinkan penataan link sebagai parameter ke composable Text. (I31b93)

Versi 1.3.0-alpha06

1 Mei 2024

androidx.compose.material3:material3-*:1.3.0-alpha06 dirilis. Versi 1.3.0-alpha06 berisi commit ini.

Perubahan yang Dapat Menyebabkan Gangguan

• API tarik lalu muat ulang baru:

  • PullToRefreshState yang disederhanakan untuk menggunakan nilai pecahan, bukan unit Dp.
  • Status isRefreshing dikontrol oleh pengguna, bukan PullToRefreshState.
  • Memisahkan koneksi scroll bertingkat dari PullToRefreshState. Proses ini ditangani oleh PullToRefreshBox atau Modifier.pullToRefresh baru.
  • Update ini merupakan perubahan yang dapat menyebabkan gangguan pada API eksperimental sebelumnya. (I0adeb, b/314496282, b/317177684, b/323787138, b/324573502, b/317177683)

Perubahan API

• RippleConfiguration#isEnabled telah dihapus, dan LocalRippleConfiguration telah dibuat nullable. Untuk menonaktifkan riak, alih-alih memberikan RippleConfiguration dengan isEnabled = false, berikan null ke LocalRippleConfiguration. (I22725)
• ModalBottomSheet menggambar scrim di atas status bar secara lebih akurat saat layar penuh diaktifkan. Konten sheet bawah modal kini dapat menggunakan inset jendela, sehingga konten dapat terlihat di atas panel navigasi. Parameter ModalBottomSheet windowInsets diganti namanya menjadi contentWindowInsets untuk menentukan tempat inset akan diterapkan, yang tidak lagi terkait dengan logika jendela. Jenis contentWindowInsets telah diubah menjadi fungsi yang menampilkan WindowInsets, agar dapat diselesaikan dalam jendela barunya. (I39630, b/274872542, b/300280229, b/290893168)
• PrimaryScrollableTabRow dan SecondaryScrollableTabRow kini menggunakan tata letak kustom, bukan subkomposisi, yang akan meningkatkan performa. (I991e0)
• Link teks mendapatkan opsi gaya status ditekan selain gaya normal, saat dihover, dan saat difokuskan. Setiap metode TextDefaults mendapatkan argumen pressedStyle untuk mendukungnya. (Ic473f, b/139312671)

Perbaikan Bug

• Anchor penarikan panel navigasi kini cocok dengan lebar drawerContent. (Ibc72f, b/245355396)
• Padding atas OutlinedTextField untuk label kini memperhitungkan ukuran font sistem. (Idc781)
• Memperbaiki lokasi paket CalendarLocale. (Ifa235)
• [Kembali Prediktif] Mengupdate animasi kembali prediktif untuk menggunakan kurva interpolasi (0.1, 0.1, 0, 1) (I2591a)

Versi 1.3.0-alpha05

17 April 2024

androidx.compose.material3:material3-*:1.3.0-alpha05 dirilis. Versi 1.3.0-alpha05 berisi commit ini.

Fitur Baru

• SearchBar dan DockedSearchBar memiliki overload baru yang menggunakan parameter kolom teks. Hal ini memungkinkan penataan gaya kolom teks secara terpisah dari bagian kolom penelusuran lainnya serta meneruskan kolom teks kustom. Kolom teks implementasi saat ini telah tersedia sebagai SearchBarDefaults.InputField. (I50c73, b/275074248, b/278773336, b/326627700)
• lambda drawTick telah ditambahkan ke API publik untuk menyesuaikan tanda jika diperlukan (I0c048)

Perubahan API

• Link teks mendapatkan opsi gaya status ditekan selain gaya normal, saat dihover, dan saat difokuskan (I5f864, b/139312671)
• Memperbarui CarouselItemInfo untuk mengekspos Rect mask yang digunakan untuk menggunting item (I785d8)
• Menghapus BasicTooltipState dari API publik Material 3. Fungsinya digabungkan dengan TooltipState hingga BasicTooltip Foundation distabilkan. (Icda29)
• Menambahkan objek TextDefaults yang berisi metode untuk membuat LinkAnnotation dan mengurai string yang diberi tag HTML yang menerapkan MaterialTheme ke link (I98532, b/139312671)
• ExposedDropdownMenuBoxScope tidak lagi mengizinkan subkelas. Menu dropdown yang ditampilkan kini memiliki MenuAnchorType yang harus diteruskan ke menuAnchor untuk mendukung aksesibilitas yang lebih baik. Hal ini harus digunakan, bukan meneruskan focusable ke ExposedDropdownMenu, yang kini tidak digunakan lagi. menuAnchor memiliki parameter baru untuk mengontrol status enabled. (I55ee6, b/257209915, b/308840226)
• Memperbaiki warna batas OutlinedButton saat dinonaktifkan. Menambahkan overload ButtonDefaults.outlinedButtonBorder("enabled") yang mengambil status aktif. (Ie650b, b/318461363)
• Menambahkan class CarouselItemInfo baru untuk membantu klien mendapatkan informasi tentang ukuran item. (I9070c)
• Konstruktor ColorScheme tanpa container permukaan kini tidak digunakan lagi. Lakukan migrasi ke konstruktor yang menyertakan penampung platform. (I35c11)
• [Tergarisbatasi]TextFieldDefaults ContainerBox diganti namanya menjadi Container. (Ie8d3b)

Perbaikan Bug

• BottomSheetScaffold tidak akan lagi men-scroll dari scroll bertingkat jika sheetSwipeEnabled bernilai salah (false). (I5e1c1, b/306464779)
• Menghapus beberapa anotasi OptIn ExperimentalMaterial3Api di IconButtonSamples.kt. (I111d1)

Versi 1.3.0-alpha04

3 April 2024

androidx.compose.material3:material3-*:1.3.0-alpha04 dirilis. Versi 1.3.0-alpha04 berisi commit ini.

Fitur Baru

• Menambahkan dua versi eksperimental Carousel Material3 - HorizontalMultiBrowseCarousel dan HorizontalUncontainedCarousel (I88d64)
• Memperbarui Panel Navigasi M3 Compose (ModalDrawerSheet dan DismissibleDrawerSheet) untuk mendukung Kembali Prediktif di U+ sebagai keikutsertaan (Ie5b0b)
• Menambahkan API baru di Icon untuk memungkinkan penerusan tint warna sebagai lambda untuk menghindari rekomposisi. (I5b5a2)
• API panel aplikasi atas kini mendukung tinggi kustom untuk bagian tetap dan dapat diciutkan. (Ib8b0c, b/323403446)

Perubahan API

• API panel aplikasi atas kini mendukung tinggi kustom untuk bagian tetap dan dapat diciutkan. Memperbaiki masalah yang menyebabkan panel aplikasi atas satu baris melakukan rekomposisi terlalu sering saat men-scroll konten. Menyelesaikan masalah saat MediumTopAppBar memangkas judul di perangkat dengan setelan font/tampilan besar. (Ib8b0c, b/323403446, b/300953236, b/286296147, b/330410290, b/308540676)
• SegmentedButton dan API terkait kini stabil (I8a158)
• SwipeToDismissBox, SwipeToDismissBoxDefaults, SwipeToDismissBoxState, dan SwipeToDismissBoxValue kini ditandai stabil. (I5f000)
• Menghapus enum dan API DismissDirection dan DismissValue yang tidak digunakan lagi. (I89ccd)
• Menambahkan tag eksperimental ke objek pendamping CarouselState Carousel. (I94154)
• Menghentikan penggunaan LocalMinimumInteractiveComponentEnforcement dan memperkenalkan LocalMinimumInteractiveComponentSize untuk menggantikannya. (I7a7ac)
• Konstruktor SearchBarColors kini bersifat publik. (I769ca)
• Menambahkan parameter gesturesEnabled ke SwipeToDismissBox. (Idc59f, b/324170119)
• Menghapus API kolom teks yang ditandai sebagai tidak digunakan lagi dan eksperimental. (I1305f)

Versi 1.3.0-alpha03

20 Maret 2024

androidx.compose.material3:material3-*:1.3.0-alpha03 dirilis. Versi 1.3.0-alpha03 berisi commit ini.

Perubahan Visual yang Dapat Menyebabkan Gangguan

• Perbarui overlay status fokus menjadi 0,1f untuk memastikan kontras warna yang memadai. (I7ea77)
• Penyesuaian kecil pada default warna permukaan dan latar belakang di lightColorScheme dan darkColorScheme. (I9db52)

Fitur Baru

• Menambahkan parameter untuk menyesuaikan ExposedDropdownMenu. Secara khusus, menu kini memiliki parameter focusable (default true) yang harus disetel ke false saat menggunakan kolom teks yang dapat diedit. (I4184c, b/323694447, b/278609042)

Perubahan API

• Flag ScaffoldSubcomposeInMeasureFix telah dihapus. (Ie2a4b)
• NavigationRailItemColors sekarang ditandai sebagai @Immutable. (If6112, b/327660613)
• NavigationBarItemColors sekarang ditandai sebagai @Immutable. (I42a30, b/298064514)
• Mengurutkan ulang parameter di composable Jalur Penggeser. (I9f315)
• ExposedDropdownMenu kini diimplementasikan menggunakan Popup. Perilakunya harus sama, kecuali menu yang dapat difokuskan dengan kolom teks yang dapat diedit dapat ditutup saat mengetik di keyboard.

Perbaikan Bug

• Peran dasar penampung Permukaan dan Permukaan telah disesuaikan sedikit, sehingga memberikan lebih banyak warna dalam tema terang dan gelap. (I677a5)
• Memperbarui warna Penggeser dan ProgressIndicator untuk mengikuti spesifikasi Kontras Non-Teks yang baru. (I26807)
• Perbarui overlay status fokus menjadi 0,1f untuk memastikan kontras warna yang memadai. (I7ea77)
• Penyesuaian kecil pada default warna permukaan dan latar belakang di lightColorScheme dan darkColorScheme. (I9db52)

Versi 1.3.0-alpha02

6 Maret 2024

androidx.compose.material3:material3-*:1.3.0-alpha02 dirilis. Versi 1.3.0-alpha02 berisi commit ini.

Perubahan API

• Membuat status penggeser stabil kembali. Menjadikan State.onValueChangeFinished sebagai val lagi. Menggabungkan onValueChangeFinished dalam rememberUpdatedState. (I82ab2, b/322269951)
• Komponen Navigation kini menggunakan peran SurfaceContainer baru. DrawerDefaults kini menyediakan atribut standardContainerColor dan modalContainerColor yang berbeda. DrawerDefaults.ModalDrawerElevation sekarang menjadi 0.dp. (I7fbac)
• Menghapus @Stable dari status Slider karena kita mengubah state.onValueChangeFinished menjadi var. (Ied34a, b/322269951)
• Spesifikasi animasi ModalBottomSheet dan StandardBottomSheet kini menjadi TweenSpec, yang diperbarui dari animasi pegas. Hal ini mengatasi masalah dengan overshoot yang terlihat. Konstruktor SheetState tanpa kepadatan yang tidak digunakan lagi kini telah dihapus. (I7babc, b/285847707)

Perbaikan Bug

• Varian SurfaceContainer kini digunakan oleh komponen. Komponen yang sebelumnya menghitung warna dengan Surface dan TonalElevation kini menggunakan peran SurfaceContainer secara default, yang tidak terpengaruh oleh elevasi tonal. (b/304584161)
• Memperbaiki bug yang menyebabkan warna penampung ElevatedFilterChip yang tidak dipilih dan dinonaktifkan menjadi hitam. (I400e6, b/322407043)
• Memperbaiki indikator progres tidak tentu saat progresnya 0 (Id6582)
• Memperbaiki masalah terkait Slider dan RangeSlider pada tata letak RTL (Iab0e1)
• Menambahkan SliderRangeTolerance untuk penghitungan rentang penggeser karena pembulatan Float dapat tidak akurat. (Ic918a, b/324934900)
• Pastikan DatePickerDialog menampilkan tombolnya saat menyusun DateRangePicker atau saat menampilkan jenis pemilih tanggal apa pun di layar kecil dengan font yang lebih besar. (Ie4758, b/325107799, b/277768544)
• Menu kini memanfaatkan peran SurfaceContainer untuk warna penampung. MenuDefaults.TonalElevation sekarang menjadi 0.dp. (I135b7)
• TextField kini memanfaatkan peran SurfaceContainerHighest untuk warna penampung. (I4dced)
• Chip yang ditinggikan kini memanfaatkan peran SurfaceContainerLow (I7cd2f)
• Warna penampung DatePicker sekarang adalah SurfaceContainerHigh. DatePickerDefaults.TonalElevation sekarang menjadi 0.dp. (Ida753)
• Memperbarui warna penampung Lembar Bawah dan warna tuas tarik. (I72a0a)
• Warna penampung RichTooltip sekarang adalah SurfaceContainer. (Ia8b45)
• Warna penampung SearchBar sekarang adalah SurfaceContainerHighest. SearchBarDefaults.TonalElevation sekarang menjadi 0.dp. (I88604)
• Memperbarui tombol yang dinonaktifkan dan trek/ikon yang tidak dipilih untuk memanfaatkan peran warna SurfaceContainerHighest. (I7687a)
• Warna penampung AlertDialog sekarang adalah SurfaceContainerHigh. (Ie0433)
• Warna penampung BottomAppBar sekarang adalah SurfaceContainer. Warna TopAppBar onScroll kini menjadi SurfaceContainer. (I41630)
• Warna penampung ElevatedCard sekarang adalah SurfaceContainerLow. FilledCard’s container color of SurfaceContainerHighest. (I35141)
• Warna penampung ElevatedButton sekarang adalah SurfaceContainerLow. FilledIconButton yang tidak dipilih kini memiliki warna penampung SurfaceContainerHighest. (I792c9)
• Memperbarui peran warna container TimePicker dan warna dial jam menjadi SurfaceContainerHighest. (I43b93)

Versi 1.3.0-alpha01

21 Februari 2024

androidx.compose.material3:material3-*:1.3.0-alpha01 dirilis. Versi 1.3.0-alpha01 berisi commit ini.

Fitur Baru

• Memperbarui Compose M3 ModalBottomSheet untuk mendukung Kembali Prediktif di U+ (Iccf32, b/281967264, b/304850357)
• Memperbarui SearchBar Compose M3 untuk mendukung Kembali Prediktif di U+ (I657f8)
• Memperbarui Penggeser untuk meningkatkan aksesibilitas dengan menambahkan indikator jeda dan berhenti. (I3058e)
• Memperbarui ProgressIndicator untuk meningkatkan aksesibilitas dengan menambahkan indikator jeda dan berhenti. (I21451)
• Menambahkan kursor default untuk tooltip lengkap, API tooltip lengkap baru kini memungkinkan kursor kustom digambar berdasarkan anchor LayoutCoordinates. (Ifd42c)

Perubahan Perilaku

• Komponen Material telah dimigrasikan untuk menggunakan API ripple baru, dan tidak lagi mengkueri RippleTheme.

Perubahan API

• drawStopIndicator seru kini bersifat publik. (I3f59f)
• Menandai fungsi formatWithSkeleton DatePicker sebagai internal (Ic65dc)
• DropdownMenu kini mendukung warna, bentuk, ketinggian, dan batas kustom. (I8e981, b/289554448, b/301887035, b/283654243)
• Komponen Material3 yang mengekspos MutableInteractionSource di API-nya telah diupdate untuk mengekspos MutableInteractionSource nullable yang secara default ditetapkan ke null. Tidak ada perubahan semantik di sini: meneruskan null berarti Anda tidak ingin mengangkat MutableInteractionSource, dan MutableInteractionSource akan dibuat di dalam komponen jika diperlukan. Mengubahnya menjadi null memungkinkan beberapa komponen tidak pernah mengalokasikan MutableInteractionSource, dan memungkinkan komponen lain hanya membuat instance secara lambat saat diperlukan, yang meningkatkan performa di seluruh komponen ini. Jika Anda tidak menggunakan MutableInteractionSource yang diteruskan ke komponen ini, sebaiknya teruskan null. Sebaiknya Anda juga membuat perubahan serupa pada komponen Anda sendiri. (I41abb, b/298048146)
• Menambahkan RippleConfiguration dan LocalRippleConfiguration untuk memungkinkan penyesuaian riak per komponen / sub-hierarki menggunakan nilai tetap. Misalnya, untuk mengubah warna komponen yang tidak Anda kontrol, atau untuk menonaktifkan riak untuk komponen. Dalam sebagian besar kasus, nilai default harus digunakan: API ini adalah solusi untuk penyesuaian komponen individual / sub-tree terbatas. Untuk perubahan yang lebih luas dan sistem desain kustom, Anda harus membuat riak Anda sendiri menggunakan createRippleModifierNode. (I7b5d6, b/298048146)
• Menambahkan API ripple baru di material3 yang menggantikan rememberRipple yang tidak digunakan lagi. Juga menambahkan CompositionLocal, LocalUseFallbackRippleImplementation sementara, untuk mengembalikan komponen material3 agar menggunakan API rememberRipple / RippleTheme yang tidak digunakan lagi. Hal ini akan dihapus dalam rilis stabil berikutnya, dan hanya dimaksudkan sebagai bantuan migrasi sementara untuk kasus saat Anda memberikan RippleTheme kustom. (I34cbc, b/298048146)

Perbaikan Bug

• Menghapus subkomposisi di dalam ModalBottomSheet untuk meningkatkan performa. Memperbaiki masalah ModalBottomSheet yang error dalam skenario tertentu jika dikombinasikan dengan LookaheadScope. (I2a198)
• Menghapus subkomposisi di dalam BottomSheetScaffold untuk meningkatkan performa. Memperbaiki masalah saat BottomSheetScaffold mengalami error dalam skenario tertentu jika dikombinasikan dengan LookaheadScope. (Ie6401)
• Penyesuaian perataan badge dilakukan agar lebih dekat ke tengah konten penjangkar sehubungan dengan sudut kanan atas. (I18a28)
• Memperbaiki masalah aksesibilitas dengan DateRangePicker yang menyampaikan judul teks Bulan-Tahun sebagai dapat ditindaklanjuti oleh pengguna pembaca layar, Tombol akses, dan Akses suara. (I2ac55)
• Memperbaiki bug urutan parameter mediumTopAppBarColors. (Ibe64a)

Versi 1.2

Versi 1.2.1

6 Maret 2024

androidx.compose.material3:material3-*:1.2.1 dirilis. Versi 1.2.1 berisi commit ini.

Perbaikan Bug

• Membuat status Penggeser stabil kembali. Menjadikan State.onValueChangeFinished sebagai val lagi. Menggabungkan onValueChangeFinished dalam rememberUpdatedState. (Ie8fd0, b/322269951)
• Menghapus @Stable dari status Slider karena kita mengubah state.onValueChangeFinished menjadi var. (I82ba1, b/322269951)
• Perbaiki NavigationBar warna kustom untuk disalin dari default. (80a779, b/326894020)
• Memperbaiki regresi di ExposedDropdownMenu agar dapat difokuskan lagi (3fcec1, b/323694447)
• Memperbaiki masalah pembuatan cache warna tombol (3e5bbcb/327371655)

Versi 1.2.0

7 Februari 2024

androidx.compose.material3:material3-*:1.2.0 dirilis. Versi 1.2.0 berisi commit ini.

Masalah Umum

• Bug rendering interoperabilitas View-Compose diperkenalkan di PrimaryTabRow sebagai bagian dari perubahan peningkatan performa. Solusinya adalah menggunakan TabRow dengan TabRowDefaults.PrimaryIndicator

Perubahan penting sejak 1.1.0

Komponen Desain Material 3 Baru

• Tarik untuk memuat ulang
  • PullToRefreshContainer
  • PullToRefreshState
• Tombol Tersegmentasi
  • SegmentedButton
  • SingleChoiceSegmentedButtonRow
  • MultiChoiceSegmentedButtonRow

Peningkatan pada komponen Desain Material 3 yang ada.

• Panel aplikasi bawah (penyelarasan RTL, sembunyikan otomatis saat men-scroll)
  • BottomAppBarScrollBehavior
• Pembaruan visual tab
  • PrimaryIndicator
  • SecondaryIndicator
• Badge (pembaruan penyesuaian)

API eksperimental kini stabil!

Peningkatan performa

• Lihat postingan blog ini untuk mengetahui detail selengkapnya.

Versi 1.2.0-rc01

24 Januari 2024

androidx.compose.material3:material3-*:1.2.0-rc01 dirilis. Versi 1.2.0-rc01 berisi commit ini.

Perbaikan Bug

• Memperbaiki bug urutan parameter mediumTopAppBarColors. (Ibe64a)
• Memperbaiki bug yang diperkenalkan di 1.2.0-beta02 dalam CardDefaults.cardColors yang tidak memperbarui contentColor berdasarkan nilai parameter containerColor. (Iee041, b/319671246)
• Memperbaiki bug di disabledContentColor yang muncul di 1.2.0-beta02 dan menambahkan pengoptimalan kecil. (I6dda1, b/318428829)

Versi 1.2.0-beta02

10 Januari 2024

androidx.compose.material3:material3-*:1.2.0-beta02 dirilis. Versi 1.2.0-beta02 berisi commit ini.

Bug Umum

• Bug di IconButtonColors secara default akan menetapkan disabledContentColor ke alfa (0.38f) LocalContentColor, bukan contentColor yang ditentukan pengguna. Solusinya adalah menetapkan disabledContentColor secara eksplisit. Masalah ini akan diperbaiki dalam rilis berikutnya.

Perubahan API

• Menambahkan kemampuan untuk mengaktifkan tanda sisipan tooltip untuk API Tooltip Plain. (Ibf767)
• SwipeToDismissState, rememberSwipeToDismiss, dan SwipeToDismissValue semuanya diganti namanya menjadi _SwipeToDismissBox_. (I68d6d)

Perbaikan Bug

• Memperbaiki nilai padding akhir ListItem agar selaras dengan spesifikasi. (Ibd68b, b/305342674)
• Warna garis batas untuk kartu bergaris batas kini dipetakan dengan benar ke OutlineVariant. (I75480, b/310979715)
• Warna dinamis kini diambil dari peran warna yang ditentukan sistem. Hal ini meningkatkan kontras untuk konten yang dapat diakses, dan menyelaraskan warna dinamis dengan spesifikasi Material secara lebih dekat. (I1de96)
• Memperbaiki penanganan kembali ModalBottomSheet di Android T/13+ saat android:enableOnBackInvokedCallback="true". (I728dc, b/306196110)

Versi 1.2.0-beta01

13 Desember 2023

androidx.compose.material3:material3-*:1.2.0-beta01 dirilis. Versi 1.2.0-beta01 berisi commit ini.

Perubahan API

• Menandai TabIndicatorScope sebagai eksperimental. (I45c88)
• Menghapus API eksperimental yang tidak digunakan lagi untuk tooltip. (I438cb)
• Ubah penggantian TabRow baru agar tidak menggunakan subkomposisi. Hal ini menghasilkan cara yang berbeda untuk membuat indikator TabRow dengan pengubah kustom yang diberikan. (Ife741)
• Menghentikan penggunaan DismissDirection dan DismissValue API. Keduanya telah digabungkan ke SwipeToDismissValue, yang nilainya menunjukkan posisi dan arah SwipeToDismissBox. DismissState.progress sekarang ditandai sebagai FloatRange antara 0.0 dan 1.0. Saver dan Konstruktor DismissState yang tidak digunakan lagi kini telah dihapus. Komponen SwipeToDismiss, objek status, dan default telah ditandai ulang sebagai eksperimental. (Ib54f2)

Perbaikan Bug

• Indikator default untuk PullToRefresh kini berupa ujung panah terbuka, bukan segitiga solid. (I67be3)

Versi 1.2.0-alpha12

29 November 2023

androidx.compose.material3:material3-*:1.2.0-alpha12 dirilis. Versi 1.2.0-alpha12 berisi commit berikut ini.

Perubahan API

• RangeSlider kini menggunakan rentang Kotlin (misalnya, 0f..1f), bukan class nilai FloatRange kustom. SnapFlingBehavior.kt kini juga menggunakan rentang Kotlin. (I025cb)
• Menandai fungsi factory Modifier sebagai @Stable. (Ib109f)

Versi 1.2.0-alpha11

15 November 2023

androidx.compose.material3:material3-*:1.2.0-alpha11 dirilis. Versi 1.2.0-alpha11 berisi commit berikut ini.

Fitur Baru

• Mengimplementasikan PullToRefreshContainer dan PullToRefreshState, yang bersama-sama menyediakan implementasi tarik untuk memperbarui di Material3. (I16456, b/261760718)

Perubahan API

• Menandai SwipeToDismissBox DismissDirection dan DismissValue sebagai eksperimental. (I517b0)
• Mengganti nama SwipeToDismiss menjadi SwipeToDismissBox. Mengganti nama background menjadi backgroundContent dan dismissContent menjadi lambda content terakhir. (I7f4d3)
• Jadikan konstruktor untuk ChipElevation dan SelectableChipElevation publik. (Ie0c48, b/308432421)
• Menambahkan ModalBottomSheetProperties. Memindahkan securePolicy ke ModalBottomSheetProperties. Menambahkan isFocusable dan shouldDismissOnBackPress ke ModalBottomSheetProperties. Boolean baru ini membantu menentukan cara sheet bawah modal harus menangani peristiwa IME. (Iea56f, b/278216859)
• Memperbarui status RangeSlider dan Slider untuk menghapus initialOnValueChange, awalan awal, dan kdocs yang sesuai. (I57d30)
• Menghentikan penggunaan class ChipBorder dan panggilan fungsi terkaitnya, sebaiknya gunakan BorderStroke secara langsung. (I89cc2)
• API Tooltip Foundation kini @ExperimentalFoundationApi. (I30b0b)
• TabRow dan ScrollableTabRow tidak lagi tidak digunakan. Varian Utama dan Sekunder baru ditandai sebagai eksperimental. (I0def6)
• Chip filter dan input kini menggunakan BorderStroke secara langsung. (I07a8d)
• SegmentedButton sekarang menggunakan BorderStroke secara langsung. (I89b9b)
• Mengganti nama fungsi AlertDialog generik menjadi BasicAlertDialog, dan menghentikan penggunaan fungsi sebelumnya. (Idbe52)
• Mengganti nama SwipeToDismiss API menjadi SwipeDismiss, dan mempromosikan SwipeDismiss API baru menjadi stabil. (I14cbe)
• Menambahkan tonalElevation dan shadowElevation ke API tooltip. Selain itu, memindahkan TooltipBox, PlainTooltip, dan RichTooltip API kembali ke eksperimental karena tidak sengaja dirilis sebagai stabil. (If0f66, b/293939035)
• Mempromosikan API chip eksperimental ke stabil. (Iea2c3)
• Menghapus anotasi @ExperimentalMaterial3Api dari Kartu yang dapat diklik Material3. (I88dbf)

Perbaikan Bug

• Memperbaiki masalah yang menyebabkan SwipeToDismiss mengalami error dalam skenario tertentu dengan tata letak Lookahead dan Lazy bersarang. (Ica8d1, b/297226562)

Versi 1.2.0-alpha10

18 Oktober 2023

androidx.compose.material3:material3-*:1.2.0-alpha10 dirilis. Versi 1.2.0-alpha10 berisi commit berikut.

Perubahan API

• Mempromosikan Badge dan BadgedBox ke stabil. (I67f16, b/261565132)
• Menambahkan securePolicy sebagai parameter ke ModalBottomSheet, sehingga pengguna dapat menentukan perilaku untuk WindowManager.LayoutParams.FLAG_SECURE. (Icdac8, b/296250262)
• Menambahkan overload baru dari LinearProgressIndicator dan CircularProgressIndicator yang menggunakan progress sebagai lambda. Versi ini seharusnya berperforma lebih baik daripada versi sebelumnya. (I824e6, b/295616656)
• Mengganti nama StandardSizeClasses menjadi AllSizeClasses. (I8cb07)
• Gabungkan fungsi penghitungan class ukuran jendela. (Iad935)

Perbaikan Bug

• Memperbaiki error DatePicker saat mengklik tombol panah navigasi dengan cepat ketika bulan yang ditampilkan berada di tepi rentang tahun yang diizinkan. (I46f36, b/290954897, b/297002119)
• [Panel/menu navigasi] Mendukung warna transparan untuk indikator. (Ie0a9b, b/267289987)

Versi 1.2.0-alpha09

4 Oktober 2023

androidx.compose.material3:material3-*:1.2.0-alpha09 dirilis. Versi 1.2.0-alpha09 berisi commit berikut ini.

Perubahan API

• Memigrasikan ModalNavigationDrawer dan DismissibleNavigationDrawer untuk menggunakan API AnchoredDraggable baru. animateTo DrawerState telah diganti dengan metode buka dan tutup, dan offsetnya kini ditampilkan sebagai float, bukan objek status. Anda dapat mengakses offset secara langsung melalui currentOffset. (I0a72c)
• Fungsi non-Composable telah ditambahkan untuk membuat DatePickerState dan DateRangePickerState secara langsung. Fungsi ini dapat digunakan sebagai alternatif untuk fungsi Composable rememberDatePickerState dan rememberDateRangePickerState jika diperlukan. (I70326, b/291524052)
• TabRows Tetap dan Dapat Di-scroll kini memiliki varian Primer dan Sekunder. Ini dipetakan dengan benar ke perilaku warna dan indikator seperti yang ditentukan dalam Material3.
• PrimaryScrollableTabRow dan SecondaryScrollableTabRow kini mengekspos status scroll. (Iec8f5, b/260572337)
• Menambahkan parameter sheetMaxWidth baru yang dapat ditetapkan developer untuk menentukan lebar maksimum yang akan direntangkan sheet. Dp.Unspecified dapat diteruskan untuk parameter jika diinginkan sheet yang mencakup seluruh lebar layar. (Ifb7c9, b/266697696)
• Menambahkan kembali API PlainTooltipBox dan RichTooltipBox sebagai metode yang tidak digunakan lagi. (I246fa)

Perbaikan Bug

• Memperbaiki error saatDatePicker diinisialisasi dengan DatePickerFormatter yang memiliki kerangka tanggal tertentu yang tetap sama saat dikonversi menjadi pola tanggal (seperti YY). (I01f29)

Versi 1.2.0-alpha08

20 September 2023

androidx.compose.material3:material3-*:1.2.0-alpha08 dirilis. Versi 1.2.0-alpha08 berisi commit ini.

Perubahan yang Dapat Menyebabkan Gangguan Perilaku

• ColorScheme kini bersifat Immutable, sehingga pembaruan warna individual menjadi kurang efisien, tetapi penggunaan warna yang lebih umum menjadi lebih efisien. Alasan di balik perubahan ini adalah sebagian besar aplikasi tidak akan memperbarui setiap warna sebagai kasus penggunaan utama. Hal ini masih memungkinkan, tetapi akan merekomposisi lebih banyak dari sebelumnya. Dengan demikian, kita akan mengurangi jumlah langganan status secara signifikan di semua kode Material dan akan memengaruhi biaya inisialisasi dan runtime untuk kasus penggunaan yang lebih standar. (Ic447d, b/297212873)
• Elevasi Tone tidak lagi menganimasikan dalam status interaksi yang berbeda agar sesuai dengan spesifikasi. (Icdd12)

Perubahan API

• Menambahkan BottomAppBar baru yang menggunakan BottomAppBarScrollBehavior sebagai parameter untuk menyembunyikannya secara otomatis saat konten di-scroll. Menambahkan FabPosition.EndOverlay juga memungkinkan FAB melapisi panel aplikasi bawah di scaffold, bukan ditambatkan di atasnya. (Iecb47)
• Menambahkan komponen Label sederhana yang dibuat di atas BasicTooltipBox yang tidak akan ditutup saat mengetuk di luar batas label. (I821f9)

Perbaikan Bug

• Menghapus penggunaan rememberSaveable untuk tooltip. (Icc131, b/299500338)
• Memperkenalkan tanda sementara untuk mengontrol apakah Scaffold harus mengukur turunannya selama pengukuran atau selama penempatan. Secara default, nilai ini akan diukur dalam satuan pengukuran. Jika Anda mengalami masalah dengan perilaku baru ini, harap laporkan masalah. (I0b354)
• Edge ke Edge horizontal tetap di BottomSheet dengan menggunakan pengukuran yang benar untuk lebar layar perangkat. (I1df0c, b/299058752)
• Memperbaiki bug yang menyebabkan ModalBottomSheet tidak memanggil onDismissedRequest saat menutupnya dengan menggeser ke bawah pada sheet. (Idfdd8)

Versi 1.2.0-alpha07

6 September 2023

androidx.compose.material3:material3-*:1.2.0-alpha07 dirilis. Versi 1.2.0-alpha07 berisi commit ini.

Fitur Baru

• Dukungan ikon pencerminan otomatis telah ditambahkan di compose material 1.6.0-alpha05. Lihat catatan rilis untuk mengetahui detail tentang ikon pencerminan otomatis.

Perubahan API

• SliderState mengimplementasikan DraggableState (I9b116)
• Ubah bentuk menjadi parameter wajib. Ganti nama position menjadi index di fungsi bantuan bentuk. (I34941)
• Memperbarui DatePicker formatWithSkeleton untuk menyertakan peta yang digunakan sebagai cache untuk peningkatan performa. (I3195f)
• Menambahkan BasicTooltipBox ke compose.foundation dan memperbarui PlainTooltipBox dan RichTooltipBox untuk menggunakan TooltipBox dengan composable PlainTooltip dan RichTooltip baru. (I79e1d)

Perbaikan Bug

• dynamicLightColorScheme dan dynamicDarkColorScheme kini menampilkan warna chroma yang lebih tinggi untuk peran permukaan dan surfaceContainer. (I5e901)
• Memperbaiki masalah saat beberapa komponen yang menggunakan Subkomposisi (misalnya, BottomSheetScaffold) di dalam Scaffold di dalam LookaheadScope mencoba membaca ukurannya terlalu dini. (I297b4, I871f1, b/295536718)

Versi 1.2.0-alpha06

23 Agustus 2023

androidx.compose.material3:material3-*:1.2.0-alpha06 dirilis. Versi 1.2.0-alpha06 berisi commit ini.

Perbaikan Bug

• Memperbaiki penghitungan offset pada DropdownMenu sehingga offset x hanya bergantung pada arah tata letak lokal, dan offset y tidak akan lagi dibalik saat menu berada di dekat bagian bawah layar. (Iccc74, b/294103942)
• Memperbaiki penghitungan offset pada DropdownMenu sehingga offset x hanya bergantung pada arah tata letak lokal, dan offset y tidak akan lagi dibalik saat menu berada di dekat bagian bawah layar. (Ib87a2, b/294103942)

Versi 1.2.0-alpha05

9 Agustus 2023

androidx.compose.material3:material3-*:1.2.0-alpha05 dirilis. Versi 1.2.0-alpha05 berisi commit ini.

Perubahan API

• Pembaruan pada warna Checkbox dan TriStateCheckbox. CheckboxDefaults.colors() disabledUncheckedColor kini hanya memengaruhi batas kotak centang. Kasus khusus yang mengharuskan Anda menyetel warna kotak internal saat dinonaktifkan dan tidak dicentang memerlukan instance CheckboxColors yang dibuat khusus dengan nilai warna yang diinginkan. (I77d17, b/291943198)

Versi 1.2.0-alpha04

26 Juli 2023

androidx.compose.material3:material3-*:1.2.0-alpha04 dirilis. Versi 1.2.0-alpha04 berisi commit ini.

Fitur Baru

• API Tombol Bersegmen Eksperimental (Ifc8fb)
• Pembagi kini memiliki parameter untuk mengontrol orientasi guna mendukung pembagi vertikal. (I4c899, b/288438593)

Perubahan API

• Kami memindahkan dependensi kepadatan ke tingkat komponen. Hal ini berlaku untuk komponen berikut: SwipeToDismiss dan komponen berbasis Sheet. Gunakan overload baru yang disediakan dengan kepadatan sebagai parameter. (I1846e)
• Anotasi tambahan untuk menentukan input yang diizinkan ke composable (Ief234)
• Menambahkan parameter ikon ke tombol tersegmentasi, memisahkan semantik sehingga tombol tersegmentasi dapat dipilih untuk menerapkan pilihan tunggal, dan dapat diubah untuk menerapkan pilihan ganda, dengan SelectableSegmentedButtonRow dan ToggelableSegmentedButtonRow masing-masing. (I38740)
• Pembagi telah diganti namanya menjadi HorizontalDivider. Menambahkan fungsi VerticalDivider. (I5975c)
• Mengubah penggunaan ClosedFloatingPointRange untuk FloatRange yang lebih ringan di API Material3 eksperimental untuk meminimalkan autoboxing. (I4aab5)
• Menambahkan perataan Start baru untuk FabPosition (Ib7aea, b/170592777)

Perbaikan Bug

• ModalBottomSheet mematuhi arah tata letak lokal. (Ib4f44, b/285628622)

Versi 1.2.0-alpha03

21 Juni 2023

androidx.compose.material3:material3-*:1.2.0-alpha03 dirilis. Versi 1.2.0-alpha03 berisi commit ini.

Perubahan Perilaku

• includeFontPadding sekarang false secara default dalam tipografi Material 3. Gaya tinggi garis default juga telah diubah menjadi Trim.None dan Alignment.Center, dan lineHeight eksplisit (dalam sp) telah ditambahkan ke TextStyle Typography. Lihat dokumen API jika Anda ingin menyesuaikan nilai ini, dan lihat postingan blog untuk penjelasan mendalam tentang perubahan ini. (I6266f, Icabc3)

Fitur Baru

• Menambahkan overload untuk RangeSlider yang merupakan versi komponen stateful. Membuat RangeSliderState yang menyimpan semua informasi untuk jalur aktif saat ini, pengukuran komponen RangeSlider, dan logika penarikan dan gestur. (I8c270)
• Kotak penelusuran kini mendukung bayangan melalui parameter shadowElevation yang baru ditambahkan. (Ia5369, b/271040353)
• ColorScheme kini mendukung SurfaceContainer peran baru.
• Overlay elevasi tonal permukaan kini dapat dinonaktifkan dengan komposisi lokal LocalTonalElevationEnabled. (Ic203c, b/277774590)

Perubahan API

• Buka konstruktor warna komponen. (I8c4a6)
• Menambahkan parameter yang dapat difokuskan ke kedua API tooltip, sehingga developer dapat membuat tooltip menggunakan peristiwa sentuh atau tidak. Berhati-hatilah karena hal ini dapat merusak traversal otomatis fokus aksesibilitas. (Ie32d8)
• Aksesibilitas yang dioptimalkan untuk performa dan alokasi memori. (Iede48)
• Mengekspos DefaultSizeClasses dan membuat StandardSizeClasses untuk WindowSizeClasses (I91838)
• mengubah WindowWidth/HeightSizeClass menjadi class nilai float (Ie686e)

Perbaikan Bug

• Parameter contentWindowInsets Scaffold kini mematuhi inset jendela yang digunakan. Perhatikan bahwa perilaku padding konten berdasarkan topBar dan bottomBar tetap tidak berubah saat parameter ini diberikan. (I08b73, b/264601542)
• Perbaiki perataan panel aplikasi atas tengah untuk memastikan judul yang panjang tidak dirender di atas ikon tindakan atau ikon navigasi. (I4369f, b/236994621)
• Posisi tab kini menerapkan lebar konten minimum 24 dp. Hal ini menyediakan target sentuh yang dapat diakses untuk indikator tab. (Id8861)
• Palet warna dinamis dari dynamicLightColorScheme dan dynamicDarkColorScheme kini mendukung peran permukaan baru. (I1252e)
• Memperbarui perataan notifikasi badge agar tidak terpotong saat bertabrakan dengan induk kakek/nenek. (Idf75a)

Versi 1.2.0-alpha02

24 Mei 2023

androidx.compose.material3:material3-*:1.2.0-alpha02 dirilis. Versi 1.2.0-alpha02 berisi commit ini.

Perubahan API

• Menambahkan parameter inset jendela ke ModalBottomSheet.
  • Scrim untuk ModalBottomSheet kini dapat digambar di belakang status bar dengan windowInsets disetel ke nol
  • Memperbarui fungsi ModalBottomSheet default agar tetap berada di luar kolom sistem, termasuk navigasi
  • Penanganan inset status bar disediakan oleh tuas tarik dalam mode layar penuh.
  • BottomSheetDefaults mencakup inset jendela untuk BottomSheetWindow. (I31200, b/274872542, b/272973615, b/272334475, b/268432129, b/275849044, b/275486106, b/268433162)
• Menghentikan penggunaan Indicator dan menambahkan Primary/SecondaryIndicator agar sesuai dengan spesifikasi M3. PrimaryIndicator cocok dengan lebar konten tab, sedangkan SecondaryIndicator mencakup lebar penuh yang tersedia. SecondaryIndicator setara dengan Indicator yang kini tidak digunakan lagi dan dapat menjadi pengganti langsung. (I27604)
• Menambahkan opsi untuk meneruskan ScrollState saat membuat DropdownMenu atau ExposedDropdownMenu untuk mengontrol status scroll vertikal item menu yang ditampilkan. (Ia0734, b/185304441)
• Menambahkan overload untuk Slider yang merupakan versi komponen stateful. Membuat SliderState yang menyimpan semua informasi untuk jalur aktif saat ini, pengukuran komponen Slider, dan logika penarikan dan gestur. (I124a5)
• Mengganti nama properti Semantik isContainer menjadi isTraversalGroup (I121f6)
• Menambahkan TextStyle.merge(...) yang dioptimalkan dengan daftar parameter lengkap. (Iad234, b/246961787)
• Menjadikan TooltipState, RichTooltipState, dan PlainTooltipState sebagai antarmuka publik. Menambahkan RichTooltipStateImpl dan PlainTooltipStateImpl untuk status default. Menambahkan fungsi remember*State untuk mendapatkan status yang diterapkan ini. Menghapus TooltipSync dan menggantinya dengan TooltipDefault.GlobalMutatorMutex. (I7813d)
• Memperbarui DatePickerColors untuk menyertakan opsi penyesuaian tambahan untuk warna pemisah pemilih tanggal, navigasi, dan kolom input teks. (I1a685, b/274626815)
• DatePickerState dan DateRangePickerState kini menjadi antarmuka publik dengan penerapan default yang dapat diambil oleh rememberDatePickerState dan rememberDateRangePickerState. (I71c52)
• Menghapus dateValidator dari DatePicker dan DateRangePicker serta memperkenalkan antarmuka SelectableDates yang dapat disetel pada status untuk mengontrol tanggal atau tahun mana yang dapat dipilih di UI. (Ic2fc6)
• TimePicker dihapus dari API stabil, perubahan lebih lanjut diharapkan dalam state API (I3f39a)
• ModalBottomSheet dipindahkan ke Android saja. ModalBottomSheet tidak direkomendasikan untuk penggunaan di desktop, dan fungsinya tidak dikelola secara aktif. (Ib3778)

Perbaikan Bug

• Memperbaiki tindakan penutupan AlertDialog agar muncul di bawah tindakan konfirmasi saat tindakan ditumpuk satu sama lain agar sesuai dengan lebar dialog. Perbaikan ini menyelaraskan implementasi dengan spesifikasi Desain Material. (I029de, b/235454277)
• Memperbaiki bug di ListItem yang menggunakan padding yang salah untuk item tiga baris. (I6e235)
• ModalBottomSheet kini dapat menampilkan keyboard IME (Idc508, b/262140644, b/268380384, b/272483584)

Versi 1.2.0-alpha01

10 Mei 2023

androidx.compose.material3:material3:1.2.0-alpha01 dan androidx.compose.material3:material3-window-size-class:1.2.0-alpha01 dirilis. Versi 1.2.0-alpha01 berisi commit ini.

Versi 1.1

Versi 1.1.2

20 September 2023

androidx.compose.material3:material3:1.1.2 dan androidx.compose.material3:material3-window-size-class:1.1.2 dirilis. Versi 1.1.2 berisi commit ini.

Perbaikan Bug

• Memperbaiki pengubah yang salah diteruskan ke dua composable. (b/282761472)
• Memperbaiki TimePickerState yang menampilkan jam yang salah saat diinisialisasi dengan 23 jam. (b/278242122)
• Memperbaiki status tombol awal untuk validasi menit dan tengah hari. (b/269768197, b/282790635)
• Memperbaiki state.hour yang menampilkan nilai yang salah untuk pukul 23.00. (b/282761472, b/278242122)

Versi 1.1.1

21 Juni 2023

androidx.compose.material3:material3:1.1.1 dan androidx.compose.material3:material3-window-size-class:1.1.1 dirilis. Versi 1.1.1 berisi commit ini.

Perbaikan Bug

• Menambahkan panggilan untuk ModalBottomSheet tanpa parameter windowInset untuk kompatibilitas biner. (Ib7959)
• Menambahkan parameter inset jendela ke ModalBottomSheet.
  • Scrim untuk ModalBottomSheet kini dapat digambar di belakang status bar dengan windowInsets disetel ke nol
  • Memperbarui fungsi ModalBottomSheet default agar tetap berada di luar kolom sistem, termasuk navigasi
  • Penanganan inset status bar disediakan oleh tuas tarik dalam mode layar penuh.
  • BottomSheetDefaults mencakup inset jendela untuk BottomSheetWindow. (I31200, b/274872542, b/272973615, b/272334475, b/268432129, b/275849044, b/275486106, b/268433162)

Versi 1.1.0

10 Mei 2023

androidx.compose.material3:material3:1.1.0 dan androidx.compose.material3:material3-window-size-class:1.1.0 dirilis. Versi 1.1.0 berisi commit ini.

Fitur utama 1.1.0

Komponen Desain Material 3 baru

• Sheet bawah
  • ModalBottomSheet, BottomSheetScaffold
• Pemilih tanggal
  • DatePicker, DateRangePicker, DatePickerDialog
• Penelusuran
  • SearchBar, DockedSearchBar
• SwipeToDismiss
• Pemilih Waktu
  • TimePicker
  • TimeInput
• Tips alat
  • PlainTooltipBox, RichTooltip

Peningkatan pada komponen Desain Material 3 yang ada.

API eksperimental kini stabil!

Lihat postingan blog ini untuk detail selengkapnya.

Versi 1.1.0-rc01

19 April 2023

androidx.compose.material3:material3:1.1.0-rc01 dan androidx.compose.material3:material3-window-size-class:1.1.0-rc01 dirilis. Versi 1.1.0-rc01 berisi commit ini.

Perubahan API

• TimePicker dihapus dari API stabil, perubahan lebih lanjut diharapkan dalam state API (I3f39a)
• ModalBottomSheet dipindahkan ke Android saja. ModalBottomSheet tidak direkomendasikan untuk penggunaan di desktop, dan fungsinya tidak dikelola secara aktif. (Ib3778)

Versi 1.1.0-beta02

5 April 2023

androidx.compose.material3:material3:1.1.0-beta02 dan androidx.compose.material3:material3-window-size-class:1.1.0-beta02 dirilis. Versi 1.1.0-beta02 berisi commit ini.

Perubahan API

• SheetState kini memiliki parameter skipHiddenState opsional
• rememberStandardBottomSheetState kini memiliki parameter skipHiddenState opsional
• BottomSheetScaffold kini memiliki anchor Tersembunyi yang ditentukan, meskipun dinonaktifkan secara default
• Dokumentasi SheetState.requireOffset telah diperbarui
• BottomSheetDefaults.MinimizedShape diganti namanya menjadi BottomSheetDefaults.HiddenShape (I839f4, b/273870234)

Perbaikan Bug

• Jangan beralih dari tampilan jam dari jam ke menit saat eksplorasi sentuh diaktifkan. (I717d0)
• Semantik tuas tarik ModalBottomSheet dan BottomSheetScaffold kini digabungkan. (I05afb)
• Pengubah BottomSheetScaffold, parameter containerColor, dan contentColor kini hanya memengaruhi konten. (I992cb)
• BottomSheetScaffold nestedScroll untuk konten sheet kini menerapkan gerakan menggeser. (I992cb)

Versi 1.1.0-beta01

22 Maret 2023

androidx.compose.material3:material3:1.1.0-beta01 dan androidx.compose.material3:material3-window-size-class:1.1.0-beta01 dirilis. Versi 1.1.0-beta01 berisi commit berikut.

Perubahan API

• Tambahkan parameter jenis tata letak ke composable TimePicker. Memungkinkan penggunaan tata letak yang berbeda, bergantung pada konfigurasi layar (Ia0e16)
• SearchBarDefaults telah ditandai sebagai eksperimental. (I65561)
• Menambahkan elevasi bayangan ke BottomSheetScaffold (I94e0f)
• Menambahkan dukungan untuk menampilkan pemilih tanggal tanpa bagian header. Perubahan API untuk memungkinkan meneruskan judul null saat membuat pemilih tanggal. Anda kini dapat meneruskan judul, nama, dan showToggleMode = false null untuk menampilkan pemilih tanpa judul. (Id3f3a, b/266132421, b/267194809)

Perbaikan Bug

• Kotak penelusuran kini otomatis menghapus fokus saat tidak aktif. (I22a7c, b/261444487)
• Memperbarui DateRangePicker untuk memungkinkan pemilihan rentang dengan tanggal yang sama untuk awal dan akhirnya. (I16529, b/272882497)
• Kolom teks kini memosisikan elemen teksnya dengan benar saat ukuran font lebih kecil dari yang diharapkan. Hal ini dapat menyebabkan perubahan beberapa piksel di aplikasi Anda berdasarkan setelan font dan skrip. (I8b8d0)
• Tindakan semantik sheet bawah kini memiliki label. (I277b0)

Versi 1.1.0-alpha08

8 Maret 2023

androidx.compose.material3:material3:1.1.0-alpha08 dan androidx.compose.material3:material3-window-size-class:1.1.0-alpha08 dirilis. Versi 1.1.0-alpha08 berisi commit ini.

Fitur Baru

• Menambahkan dukungan untuk BottomSheetScaffold dan BottomSheetScaffoldState. (I063d4)

Perubahan API

• Menambahkan fungsi ke DatePickerState dan DateRangePickerState untuk memungkinkan penetapan tanggal setelah pembuatan awal status, serta mereset pilihan dengan menetapkan stempel waktu null. Penetapan tanggal secara manual harus dilakukan dengan hati-hati, dan fungsi setSelection baru akan menampilkan pengecualian jika tanggal yang diberikan gagal memenuhi prasyarat (lihat dokumentasi). (Ifa645, b/268609314, b/270427389)
• Mengganti nama Collapsed SheetValue menjadi PartiallyExpanded untuk menggambarkan perilaku dalam status ini secara lebih akurat dan fleksibel. (Ia1491)
• Memperbarui nama parameter ListItem menjadi _content, bukan _text. Pengambil default kini adalah ReadOnlyComposables jika relevan. (I69a25)
• Mengeluarkan API Surface interaktif dari eksperimental. (I90d59, b/261561812)

Perbaikan Bug

• Memperbaiki masalah saat status HalfExpanded ModalBottomSheet salah dihitung dan sheet akan tampak mengambang. (I45e84, b/268411386)
• Tambahkan pemeriksaan confirmValueChange ke ketukan scrim untuk ModalBottomSheet. (I2311a, b/270425759)
• Memindahkan tindakan semantik BottomSheet ke tuas tarik. (I158ba)
• ModalBottomSheet kini memerintahkan fokus saat peluncuran, menangani tombol kembali. (I4d2ab)
• ModalBottomSheet onDismissRequest kini juga ditangani selama pelemparan scroll bertingkat. (I655c5, b/268433166)

Versi 1.1.0-alpha07

22 Februari 2023

androidx.compose.material3:material3:1.1.0-alpha07 dan androidx.compose.material3:material3-window-size-class:1.1.0-alpha07 dirilis. Versi 1.1.0-alpha07 berisi commit ini.

Fitur Baru

• Menambahkan composable Input Waktu yang berfungsi dengan rememberTimePickerState(), yang mengikuti spesifikasi M3 untuk input waktu (Ia4fab)
• Menambahkan DateRangePicker API Material 3 untuk memilih rentang tanggal. (I7a6c3, b/267194809)
• Menambahkan dukungan mode input Material 3 untuk memilih rentang tanggal melalui DateRangePicker API. (Ifdbc4)
• Warna kolom teks kini dapat disesuaikan:
  • Warna kolom input dan teks placeholder berdasarkan status fokus dan error. Parameter textColor telah diganti namanya menjadi unfocusedTextColor, dan placeholderColor telah diganti namanya menjadi unfocusedPlaceholderColor.
  • Warna penampung untuk kolom teks yang diisi berdasarkan status error dengan parameter errorContainerColor baru.
• Warna kolom teks menu dropdown yang ditampilkan telah diupdate dengan parameter untuk mendukung API awalan dan akhiran baru. (I9c8b4, b/254284181, b/264766350)

Perubahan API

• Mengembalikan beberapa versi Slider API dan menghapus overload Slider yang redundan yang tercakup oleh Slider eksperimental baru dengan thumb dan track kustom. Mempromosikan RangeSlider agar stabil. (Ie8fbd)
• Mengganti nama defaultElevation menjadi elevation di fungsi elevasi chip. (I0f872)
• API kolom teks Material 3 berikut tidak lagi bersifat eksperimental: TextField, OutlinedTextField, textFieldWithLabelPadding, textFieldWithoutLabelPadding, outlinedTextFieldPadding. (Ieb5c0, b/261561819)
• TimePickers is24Hour menggunakan setelan sistem (I18856)
• Menghapus anotasi eksperimental dari API scaffold. (Ibb51e, b/261565765, b/261436953)

Perbaikan Bug

• Bentuk default ModalBottomSheet kini selalu SheetDefaults.ExpandedShape. (I0dfca)
• Peningkatan aksesibilitas untuk DatePicker dan DateRangePicker Material 3. (I5087e)
• Memperbaiki bug saat batasan tinggi maksimum diteruskan dan dapat menyebabkan error. (I30d8c)
• Menghapus peran semantik dari permukaan yang dapat diklik dan dipilih, memperbarui komponen yang menggunakannya untuk menetapkan peran menggunakan modifier.semantics (I793d9)

Versi 1.1.0-alpha06

8 Februari 2023

androidx.compose.material3:material3:1.1.0-alpha06 dan androidx.compose.material3:material3-window-size-class:1.1.0-alpha06 dirilis. Versi 1.1.0-alpha06 berisi commit ini.

Fitur Baru

• Kolom teks kini mendukung teks awalan dan akhiran (Ia8578, b/179884561)
• Menambahkan fungsi TimePicker untuk menampilkan pemilih waktu mengikuti spesifikasi Material 3, yang digunakan bersama TimePickerState dan metode yang mempermudah pekerjaan rememberTimePickerState (I71910)
• Input tanggal kini menjadi mode tampilan di DatePicker. Menambahkan dukungan untuk beralih antara mode pemilih tanggal dan input tanggal. (Ieeff7)
• Menambahkan API untuk RichTextTooltips. (I58ef3)
• Implementasi sheet bawah modal untuk Material 3, termasuk ModalBottomSheet dan ModalBottomSheetDefaults. Selain itu, memperkenalkan SheetState dan rememberSheetState yang dapat digunakan untuk komponen sheet pada masa mendatang. (I0853a, b/244189383)

Perubahan API

• Menstabilkan API showSnackbar (I195c2, b/261424370)
• Menstabilkan API untuk chip panduan dan chip saran (Ibb67b, b/261424370)
• Mempromosikan ListItem, ListItemDefaults, dan ListItemColors API menjadi non-eksperimental (I7e7fa, b/261438882)
• Mempromosikan SliderPositions, SliderDefaults.Thumb, dan SliderDefaults.Track menjadi stabil serta menambahkan Slider dan RangeSlider API non-eksperimental yang berisi thumb dan track kustom. Selain itu, menghentikan penggunaan Slider dan RangeSlider API sebelumnya. (Ie5ea6, b/261566890)
• Membuat Modifier.tooltipAnchor() menjadi publik, sehingga developer dapat meneruskannya ke anchor untuk menunjukkan tooltip yang harus ditampilkan saat menekan lama. Mengupdate PlainTooltipBox API agar tidak lagi membuat TooltipState nullable dan kini memiliki default. (Ie2fb7)
• ProgressIndicatorDefaults.circularTrackColor telah ditandai sebagai @Composable demi konsistensi. (Id29cc)
• Memulihkan pengambil properti LocalMinimuTouchTargetEnforcement dan menandainya sebagai tidak digunakan lagi dan mengalihkan ke LocalMinimumInteractiveComponentEnforcement. (I60dd5)

Versi 1.1.0-alpha05

26 Januari 2023

androidx.compose.material3:material3:1.1.0-alpha05 dan androidx.compose.material3:material3-window-size-class:1.1.0-alpha05 dirilis. Versi 1.1.0-alpha05 berisi commit ini.

Fitur Baru

• DatePickerDialog dan dukungan aksesibilitas
• Menambahkan thumb dan track Kustom ke RangeSlider.

Update Dependensi

• Compose UI dan Compose Material sekarang bergantung pada Lifecycle 2.6.0.

Versi 1.1.0-alpha04

11 Januari 2023

androidx.compose.material3:material3:1.1.0-alpha04 dan androidx.compose.material3:material3-window-size-class:1.1.0-alpha04 dirilis. Versi 1.1.0-alpha04 berisi commit ini.

Fitur Baru

• DatePicker API awal untuk memilih satu tanggal melalui UI kalender. API ini masih mengalami perubahan. (I722b9)
• Menambahkan dukungan untuk tooltip biasa melalui PlainTooltipBox. (I0cdfb)
• Kotak penelusuran (Iad128)
• SwipeToDismiss (I458a8, b/242889540)

Perubahan API

• Menambahkan properti semantik IsContainer di Platform. Properti ini akan digunakan dalam perubahan selanjutnya yang menentukan urutan traversal berdasarkan makna semantik elemen seperti platform. (I63379)
• Menandai API terkait panel navigasi sebagai stabil. (Iab01e, b/261439597)
• Menambahkan parameter warna track untuk indikator progres melingkar, dan parameter ujung goresan untuk indikator progres melingkar dan linear. (Ie668c, b/216325962, b/222964817)
• Lebih banyak nullability jenis nilai yang ditampilkan dari fungsi tersembunyi yang tidak digunakan lagi (Ibf7b0)
• Menambahkan Modifier.minimumInteractiveComponentSize. Ini dapat digunakan untuk menyimpan setidaknya 48.dp untuk membedakan interaksi sentuh jika elemen akan berukuran lebih kecil. (I33f58, b/258495559)
• Menambahkan API eksperimental untuk composable AlertDialog yang memiliki slot konten. (Iec4a2)

Perbaikan Bug

• Progres untuk indikator progres kini dikaitkan dengan benar ke rentang yang diharapkan. (I8a7eb, b/262262727)

Masalah Umum

• Saat mengupdate dari androidx.compose.foundation:1.4.0-alpha03 ke androidx.compose.foundation:1.4.0-alpha04, Anda mungkin mengalami error java.lang.NoSuchFieldError. Masalah awalnya dilaporkan di sini. Perbaikan telah dikirim dan akan tersedia di update Compose berikutnya. Sebagai solusi, update library androidx.compose.material dan androidx.compose.material3 ke versi terbaru (1.1.0-alpha04) atau downgrade androidx.compose.foundation ke 1.4.0-alpha03.

Versi 1.1.0-alpha03

7 Desember 2022

androidx.compose.material3:material3:1.1.0-alpha03 dan androidx.compose.material3:material3-window-size-class:1.1.0-alpha03 dirilis. Versi 1.1.0-alpha03 berisi commit ini.

Perubahan API

• Mengganti nama consumedWindowInsets() menjadi consumeWindowInsets() dan withConsumedWindowInsets() menjadi onConsumedWindowInsetsChanged(), dan membuat Pengubah menjadi publik. (Ie44e1)
• Menambahkan padding konten default baru untuk tombol teks dengan ikon yang akan digunakan. (I8f662)
• Menambahkan warna yang dinonaktifkan untuk menu navigasi dan kolom samping. (Ia7892, b/258867034)
• Menambahkan Modifier API untuk mengkueri info scroll ancestor. (I2ba9d, b/203141462)
• Digunakan di Clickable untuk menunda interaksi tekan dengan benar, saat gestur dapat menjadi peristiwa scroll.
• Memperbaiki Clickables yang tidak menunda ripple dengan benar, saat digunakan di dalam Scrollable ViewGroup.
• Mengupdate Panel Samping dan Sheet untuk menunda penekanan dengan benar jika gestur dapat menjadi peristiwa scroll.

Update Dependensi

• Compose UI dan Compose Material sekarang bergantung pada Lifecycle 2.5.1. (I05ab0, b/258038814)

Versi 1.1.0-alpha02

9 November 2022

androidx.compose.material3:material3:1.1.0-alpha02 dan androidx.compose.material3:material3-window-size-class:1.1.0-alpha02 dirilis. Versi 1.1.0-alpha02 berisi commit berikut ini.

Perubahan API

• awaitFirstDown dan waitForUpOrCancellation kini menerima PointerEventPass untuk fleksibilitas yang lebih besar (juga perbaikan ExposedDropdownMenuBox yang menampilkan menu saat men-scroll).(I7579a, b/212091796)
• Menambahkan parameter minLines ke dalam material dan material3 Text, TextField, dan OutlinedTextField yang memungkinkan penetapan tinggi minimum komponen dalam jumlah baris (I4af1d)
• Menghentikan fungsi TopAppBarDefaults smallTopAppBarColors dan menggantinya dengan fungsi topAppBarColors baru yang harus digunakan saat membuat TopAppBar. (Ie6cb9)
• Menambahkan parameter minLines ke BasicText dan BasicTextField. Perubahan ini memungkinkan untuk menyetel tinggi minimum composable ini dalam jumlah baris (I24294, b/122476634)

Perbaikan Bug

• Memotong konten Material3 IconButton dan IconToggleBotton ke bentuk lapisan status komponen (mis. bentuk melingkar). (I9da8f)
• Mengupdate panel aplikasi atas Material3 Medium dan Large untuk menerapkan warna latar belakang yang sama di seluruh platformnya, dan untuk memungkinkan setelan penggantian warna default dengan nilai warna transparan. (I67659, b/249688556, b/250838918)

Versi 1.1.0-alpha01

24 Oktober 2022

androidx.compose.material3:material3:1.1.0-alpha01 dan androidx.compose.material3:material3-window-size-class:1.1.0-alpha01 dirilis. Versi 1.1.0-alpha01 berisi commit ini.

Perbaikan Bug

• Perbaikan pada panel aplikasi atas saat judul diterapkan dengan TextStyle dan Brush. (If667e)

Versi 1.0

Versi 1.0.1

9 November 2022

androidx.compose.material3:material3:1.0.1 dan androidx.compose.material3:material3-window-size-class:1.0.1 dirilis. Versi 1.0.1 berisi commit ini.

Perbaikan Bug

• Mengupdate panel aplikasi atas Material3 Medium dan Large untuk menerapkan warna latar belakang yang sama di seluruh platformnya, dan untuk memungkinkan setelan penggantian warna default dengan nilai warna transparan. (I67659, b/249688556, b/250838918)

Versi 1.0.0

24 Oktober 2022

androidx.compose.material3:material3:1.0.0 dan androidx.compose.material3:material3-window-size-class:1.0.0 dirilis. Versi 1.0.0 berisi commit ini.

Fitur utama versi 1.0.0

Ini adalah rilis stabil pertama Compose Material 3!

Tema Desain Material 3 dan warna dinamis Material You

• MaterialTheme
• Warna
  • ColorScheme
  • lightColorScheme, darkColorScheme
• Warna dinamis
  • dynamicLightColorScheme, dynamicDarkColorScheme
• Tipografi
  • Tipografi
• Bentuk
  • Bentuk

Komponen Desain Material 3

• Badge
  • Badge, BadgedBox
• Bottom App Bar
  • BottomAppBar
• Tombol
  • Button, ElevatedButton, FilledTonalButton, OutlinedButton, TextButton
• FAB dan FAB yang diperluas
  • SmallFloatingActionButton, FloatingActionButton, LargeFloatingActionButton, ExtendedFloatingActionButton
• Kartu
  • Kartu, OutlinedCard, ElevatedCard
• Kotak centang
  • Kotak centang
• Chip
  • AssistChip, ElevatedAssistChip, FilterChip, ElevatedFilterChip, InputChip, SuggestionChip, ElevatedSuggestionChip
• Dialog
  • AlertDialog
• Pemisah
  • Pemisah
• Menu Dropdown
  • DropdownMenu, DropdownMenuItem, ExposedDropdownMenuBox
• Daftar
  • ListItem
• Menu navigasi
  • NavigationBar
• Panel navigasi
  • ModalNavigationDrawer, ModalDrawerSheet, DismissibleNavigationDrawer, DismissibleDrawerSheet, PermanentNavigationDrawer, PermanentDrawerSheet
• Kolom samping navigasi
  • NavigationRail
• Indikator Progres
  • CircularProgressIndicator, LinearProgressIndicator
• Tombol Pilihan
  • RadioButton
• Penggeser
  • Slider, RangeSlider
• Ganti
  • Ganti
• Tab
  • Tab, LeadingIconTab, TabRow, ScrollableTabRow
• Kolom Teks
  • TextField, OutlinedTextField
• Panel aplikasi atas
  • TopAppBar, CenterAlignedTopAppBar, MediumTopAppBar, LargeTopAppBar
• Ikon
  • Icon, IconButton
• Teks
  • Teks
• Permukaan
  • Permukaan
• Tata Letak
  • Scaffold
• Warna konten
  • LocalContentColor

Class Ukuran Jendela

• material3-window-size-class adalah library baru yang menyediakan dukungan untuk class ukuran jendela: sekumpulan titik henti sementara area pandang tidak berubah yang dapat Anda gunakan untuk mendesain, mengembangkan, dan menguji tata letak aplikasi yang dapat diubah ukurannya. Anda dapat menggunakan calculateWindowSizeClass untuk mengambil instance class ukuran jendela yang dapat digunakan untuk menentukan tampilan UI, seperti menampilkan kolom samping navigasi, bukan navigasi bawah untuk ukuran jendela yang lebih besar. Untuk informasi selengkapnya dan contoh penggunaan, lihat dokumentasi referensi API untuk WindowSizeClass.

• Lihat postingan blog ini untuk detail selengkapnya.

Versi 1.0.0-rc01

5 Oktober 2022

androidx.compose.material3:material3:1.0.0-rc01 dan androidx.compose.material3:material3-window-size-class:1.0.0-rc01 dirilis. Versi 1.0.0-rc01 berisi commit berikut ini.

Perubahan API

• Menambahkan parameter slot untuk mendukung teks ke API kolom teks (Iaac0d, b/227146125)

Versi 1.0.0-beta03

21 September 2022

androidx.compose.material3:material3:1.0.0-beta03 dan androidx.compose.material3:material3-window-size-class:1.0.0-beta03 dirilis. Versi 1.0.0-beta03 berisi commit berikut ini.

Perubahan API

• ExposedDropdownMenuDefaults kini mengekspos nilai padding untuk item menu. (I34ee1)
• ExposedDropdownMenuBoxScope kini memiliki pengubah Modifier.menuAnchor() yang harus diteruskan ke kolom teks untuk perilaku aksesibilitas yang tepat. (I27fa3)
• Menambahkan dua metode overload untuk Slider API saat ini agar pengguna dapat meneruskan thumb atau track untuk mengisi penggeser. (I21c00)

Perbaikan Bug

• Mengupdate pemetaan warna tema gelap untuk On Error Container ke tone 90 (Ic5612)
• Perbaikan untuk memungkinkan penyetelan latar belakang transparan untuk panel aplikasi atas Material 3 kecil. (I645e2, b/245575782)

Versi 1.0.0-beta02

7 September 2022

androidx.compose.material3:material3:1.0.0-beta02 dan androidx.compose.material3:material3-window-size-class:1.0.0-beta02 dirilis. Version 1.0.0-beta02 berisi commit berikut ini.

Perubahan API

• Inset komponen default yang diperkenalkan dalam komponen m3 pada versi beta01 tidak lagi memperhitungkan inset IME.
• Komponen Material3 Scaffold sekarang memiliki parameter contentWindowInsets, yang memungkinkan untuk menentukan jumlah inset yang harus ditangani untuk slot konten. (Icf11a, b/243713323)
• Tidak lagi menggunakan fungsi SmallTopAppBar Material 3 eksperimental dan memperkenalkan fungsi TopAppBar yang setara. Harap migrasikan penggunaan Anda ke yang baru. (I74404, b/226918634)
• Menambahkan kontrol terhadap perilaku snap dan ayunkan jari untuk panel aplikasi atas. (I15c81)
• Menghapus startIndent dari Pembagi, memindahkan warna ke parameter terakhir. (If7be2)

Perbaikan Bug

• Menyetel Dialog agar dapat mengidentifikasi pengguna talkback dengan mengucapkan kata Dialog saat ditampilkan. (I857ef)

Versi 1.0.0-beta01

24 Agustus 2022

androidx.compose.material3:material3:1.0.0-beta01 dan androidx.compose.material3:material3-window-size-class:1.0.0-beta01 dirilis. Versi 1.0.0-beta01 berisi commit ini.

Referensi API

Untuk melihat tema, komponen, dan composable terbaru lainnya yang tersedia, lihat ringkasan Referensi API Compose Material 3.

Perubahan API

• Mengupdate panel aplikasi atas Material 3 agar langsung disetel dari status diciutkan sepenuhnya menjadi diperluas sepenuhnya. Selain itu, memperbarui fungsi perilaku TopAppBarDefaults menjadi Composable dan memberikan nilai default untuk status panel aplikasi atas dan spesifikasi animasi. (I642b3)
• Memperbarui tanda tangan komponen FAB agar sesuai dengan API platform (I3afaa)
• Menambahkan dukungan Build-in inset untuk Panel aplikasi atas, panel samping, menu navigasi, dan kolom samping. Saat digunakan secara terpisah atau dengan Scaffold, komponen ini akan otomatis menangani inset untuk developer. Catatan: Perubahan ini tidak menambahkan penanganan otomatis ikon status bar dan transparansi status dan menu navigasi. Terus lakukan secara manual untuk memastikan pengalaman dari tepi ke tepi yang terbaik. (I7e4e6, b/183161866)
• Mengupdate default komponen untuk memperkecil platform API guna meningkatkan performa dan fleksibilitas di masa mendatang. (I31820)
• Mengurutkan ulang parameter sheet panel navigasi dan chip untuk mempertahankan konsistensi dalam API (I45d0b)
• Menghapus startIndent dari Pembagi dan memindahkan warna menjadi parameter terakhir.(If7be2)

Versi 1.0.0-alpha16

10 Agustus 2022

androidx.compose.material3:material3:1.0.0-alpha16 dan androidx.compose.material3:material3-window-size-class:1.0.0-alpha16 dirilis. Versi 1.0.0-alpha16 berisi commit ini.

Fitur Baru

• Mendukung penetapan lebar kustom pada panel navigasi. (Ia7f10)

Perubahan API

• Mengurutkan ulang parameter tab ikon Utama dan Tab untuk menjaga konsistensi dalam API (Ie2637)
• Menandai BadgeDefaults sebagai eksperimental. (I98ef3)
• Menghapus fungsi panel navigasi yang tidak digunakan lagi. (I4f2db)
• Mengurutkan ulang parameter Penggeser di Material 3 untuk mempertahankan konsistensi dalam API (I0aee7)
• Mengurutkan ulang parameter NavigationBar dan NavigationRail untuk mempertahankan konsistensi dalam API (I51cda)
• Mengurutkan ulang parameter di Material 3 untuk mempertahankan konsistensi di seluruh API. (If4ae1)
• Mengurutkan ulang parameter Penggeser di Material 3 untuk mempertahankan konsistensi dalam API (I62673)
• Mengganti nama parameter ikon menjadi tindakan agar konsisten dengan panel aplikasi atas (Id75be)
• Menandai Badge dan BadgedBox sebagai eksperimental karena perataan anchor masih masuk. (I1712e, b/236524516)
• Mengubah anotasi @ExperimentalMaterial3Api pada varian tombol ikon menjadi @OptIn (I070b5)
• Memisahkan konten panel navigasi ke composable-nya sendiri untuk mendukung penentuan lebar kustom di composable. (Ia7f10)
• Menghapus Divider dari MenuDefaults dan TabDefaults (I4e33c)

Versi 1.0.0-alpha15

27 Juli 2022

androidx.compose.material3:material3:1.0.0-alpha15 dan androidx.compose.material3:material3-window-size-class:1.0.0-alpha15 dirilis. Versi 1.0.0-alpha15 berisi commit ini.

Fitur Baru

• Mengizinkan penarikan panel aplikasi atas dari panel itu sendiri. (I65c00, b/205873416)

Perubahan API

• Update pada FilterChip API dan ElevatedFilterChip API untuk menghapus slot selectedIcon dan mempromosikan penggunaan kembali leadingIcon untuk menampilkan status yang dipilih. (Ie5dc2)
• Menambahkan peran warna varian scrim dan outline. (Id6d54)
• Memperbaiki konvensi penamaan untuk default composable. (I62b27)
• Menandai ListItemDefaults dan ListItemColors sebagai eksperimental. (I1f3ec)
• Perubahan pada API panel aplikasi atas untuk lebih mencerminkan makna properti statusnya. Selain itu, menandai API panel aplikasi atas sebagai eksperimental. (Ic0ad8)
• Warna pemilihan teks kini telah ditambahkan ke TextFieldColors agar lebih mudah ditemukan. (Iba1b8)
• Menambahkan ButtonDefault.ButtonWithIconContentPadding untuk digunakan dengan tombol yang berisi ikon. (I2bf9c)
• Kolom teks telah ditandai sebagai eksperimental untuk memungkinkan fleksibilitas yang lebih besar pada perubahan API mendatang. (I127b5)
• Menghapus anotasi @ExperimentalMaterial3Api dari fungsi Checkbox. (I5eefc)
• Menghapus anotasi @ExperimentalMaterial3Api dari fungsi RadioButton. (I17e2a)
• Menghapus anotasi @ExperimentalMaterial3Api dari Kartu non-interaktif. (I9bd49)
• Memperbarui berbagai objek default komponen untuk menyertakan warna, bentuk, dll. (I96e11)

Perbaikan Bug

• Menghapus ikon tambahan yang tidak berfungsi dari sampel chip input untuk menghindari kebingungan pengguna di aplikasi katalog. (I9846a)

Versi 1.0.0-alpha14

29 Juni 2022

androidx.compose.material3:material3:1.0.0-alpha14 dan androidx.compose.material3:material3-window-size-class:1.0.0-alpha14 dirilis. Versi 1.0.0-alpha14 berisi commit ini.

Fitur Baru

• Menambahkan implementasi daftar M3, lihat dokumentasi untuk contoh penggunaan (Id7a20)

Perubahan API

• Mengubah nama parameter dari values menjadi value di RangeSlider (I3b79a)
• Perubahan API pada implementasi InputChip untuk mendukung status yang dapat dipilih sesuai spesifikasi Desain Material. Dukungan tambahan pada warna FilterChip untuk status nonaktif yang dipilih. (I55244, b/235792432)
• Menambahkan FAB default BottomAppBar (Ida4c8)
• ColorScheme.surfaceColorAtElevation ditambahkan (Id41af)
• Antarmuka di library Compose kini dibuat menggunakan metode antarmuka default jdk8 (I5bcf1)
• WindowWidthSizeClass dan WindowHeightSizeClass kini menerapkan Comparable, sehingga dapat dibandingkan menggunakan operator (<, <=, >=, >) dan API lainnya. (I747d0)

Perbaikan Bug

• Memperbarui contoh badge untuk memberikan deskripsi konten yang lebih bermakna. (I10b9d)
• Menambahkan opsi untuk menggunakan ukuran font sistem ke alat pilih tema katalog Material 3. (I10605)
• Menambahkan kode contoh untuk Badge dan indikator progres tidak tentu. (I8fbe0)

Versi 1.0.0-alpha13

1 Juni 2022

androidx.compose.material3:material3:1.0.0-alpha13 dan androidx.compose.material3:material3-window-size-class:1.0.0-alpha13 dirilis. Versi 1.0.0-alpha13 berisi commit ini.

Perubahan API

• Mendukung mempertahankan posisi panel aplikasi atas di perubahan konfigurasi. (I10459, b/216160958)

Versi 1.0.0-alpha12

18 Mei 2022

androidx.compose.material3:material3:1.0.0-alpha12 dan androidx.compose.material3:material3-window-size-class:1.0.0-alpha12 dirilis. Versi 1.0.0-alpha12 berisi commit ini.

Perbaikan Bug

• Induk penggeser kini dapat memiliki lebar 0. (b/231707291)

Versi 1.0.0-alpha11

11 Mei 2022

androidx.compose.material3:material3:1.0.0-alpha11 dan androidx.compose.material3:material3-window-size-class:1.0.0-alpha11 dirilis. Versi 1.0.0-alpha11 berisi commit ini.

Fitur Baru

• Menambahkan RangeSlider ke Material 3 (I18e38)
• Menambahkan dukungan AssistChip dan InputChip Material3 (I0d25a)
• Menambahkan dukungan FilterChip dan SuggestionChip Material3 (I9fdf3)

Perubahan API

• Mengganti nama composable TextFieldDefaults.BorderStroke yang menggambar goresan batas di OutlinedTextField menjadi TextFieldDefaults.BorderBox. (I5f295)
• Mengalihkan perubahan visual m3 (Iab30e)
• Mengizinkan penerusan warna ke tombol ikon standar. (Ia2445)

Perbaikan Bug

• Menambahkan pemeriksaan lint ke material3/Scaffold untuk memastikan bahwa padding bagian dalam sedang digunakan (I72293, b/226951418)

Versi 1.0.0-alpha10

20 April 2022

androidx.compose.material3:material3:1.0.0-alpha10 dan androidx.compose.material3:material3-window-size-class:1.0.0-alpha10 dirilis. Versi 1.0.0-alpha10 berisi commit ini.

Fitur Baru

• material3-window-size-class adalah library baru yang menyediakan dukungan untuk class ukuran jendela: sekumpulan titik henti sementara area pandang tidak berubah yang dapat Anda gunakan untuk mendesain, mengembangkan, dan menguji tata letak aplikasi yang dapat diubah ukurannya. Anda dapat menggunakan calculateWindowSizeClass untuk mengambil instance class ukuran jendela yang dapat digunakan untuk menentukan tampilan UI, seperti menampilkan kolom samping navigasi, bukan navigasi bawah untuk ukuran jendela yang lebih besar. Untuk informasi selengkapnya dan contoh penggunaan, lihat dokumentasi referensi API untuk WindowSizeClass. Untuk informasi definisi class ukuran jendela selengkapnya, lihat panduan publik terkait mendukung berbagai ukuran layar.

Perubahan API

• Menambahkan elevasi FAB default untuk BottomAppBar, menghapus lambda akhir dari BottomAppBar dengan FAB. (I92c47)
• Menambahkan Material3 FilledIconButton, FilledTonalIconButton, dan OutlinedIconButton. (Ib2bda)
• Mengupdate Material 3 Snackbar API untuk menerima nilai warna bagi tindakan opsional dan tindakan menutup. (Ibe4b4)
• Konsumsi parsial (posisi OR turun) tidak digunakan lagi di PointerInputChange. Anda dapat menggunakan consume() untuk sepenuhnya memakai perubahan. Anda dapat menggunakan isConsumed untuk menentukan apakah orang lain sudah pernah memakai perubahan tersebut sebelumnya.
• PointerInputChange::copy() kini selalu membuat shallow copy. Ini berarti bahwa salinan PointerInputChange akan dipakai setelah salah satu salinan tersebut digunakan. Jika Anda ingin membuat PointerInputChange yang tidak terikat, gunakan konstruktor. (Ie6be4, b/225669674)
• Perubahan pada API Cards untuk menerima warna penampung dan konten melalui antarmuka CardColors, dan untuk mendukung status dinonaktifkan untuk kartu yang dapat diklik. (I927df)
• Parameter backgroundColor telah diganti namanya menjadi containerColor di kolom teks Material 3 agar lebih konsisten dengan komponen lain. (I6fbd9)

Perbaikan Bug

• Mengupdate ke IconButton standar untuk menyesuaikannya dengan spesifikasi Material3. (I09eab)
• Memindahkan tinggi panel atas material3 Scaffold ke dalam padding yang diteruskan ke konten, sehingga konten dapat dirender di bawah panel aplikasi atas. Jika PaddingValues diabaikan, konten mungkin akan tertutup oleh panel atas. (I83cbc, b/217776202)

Versi 1.0.0-alpha09

6 April 2022

androidx.compose.material3:material3:1.0.0-alpha09 dirilis. Versi 1.0.0-alpha09 berisi commit berikut ini.

Fitur Baru

• Menambahkan Material 3 Switch API (I2c3ad)

Perubahan API

• Menambahkan dukungan untuk menu drop-down dengan kolom teks (alias 'menu dropdown yang ditampilkan' atau 'kotak kombinasi'). (I1b832)
• Menambahkan parameter bentuk ke subsistem MaterialTheme dan Shape. (I37426)
• Menambahkan parameter yang diperluas ke ExtendedFloatingActionButton untuk mengontrol apakah FAB diperluas atau diciutkan, dengan animasi di antara setiap status. Menambahkan Overload FAB yang diperpanjang untuk FAB yang diperluas dengan teks tambahan untuk ExtendedFAB tanpa ikon. (Iba7f1)

Versi 1.0.0-alpha08

23 Maret 2022

androidx.compose.material3:material3:1.0.0-alpha08 dirilis. Versi 1.0.0-alpha08 berisi commit ini.

Fitur Baru

• Menambahkan dukungan untuk kolom teks Material 3. (I795cc, b/199377790)

Perubahan API

• Menambahkan pembagi default untuk menu (I01374)
• Menambahkan parameter warna surfaceTint ke class ColorScheme. (I2f558)

Perbaikan Bug

• Memperbaiki Tombol Material3 untuk membaca nilai gaya teks defaultnya dari MaterialTheme. (Ie62fc)

Versi 1.0.0-alpha07

9 Maret 2022

androidx.compose.material3:material3:1.0.0-alpha07 dirilis. Versi 1.0.0-alpha07 berisi commit ini.

Perubahan API

• Update pada Material 3 Surface API yang menghadirkan kembali fungsi kelebihan beban untuk Platform yang dapat diklik, serta menambahkan fungsi untuk mendukung Platform yang dapat dipilih dan diganti. (I4bf18)
• LazyVerticalGrid dan LazyHorizontalGrid kini stabil. (I307c0)
• LazyVerticalGrid/LazyHorizontalGrid dan semua API terkait dipindahkan ke sub-paket .grid. Update impor Anda dari androidx.compose.foundation.lazy ke androidx.compose.foundation.lazy.grid. (I2d446)
• Mengembalikan perubahan sebelumnya yang hanya mengandalkan View untuk WindowInsetsControllerCompat, dan sekali lagi memerlukan Window yang diperlukan untuk mengelola beberapa flag jendela. ViewCompat.getWindowInsetsController tidak digunakan lagi dan diganti dengan WindowCompat.getInsetsController untuk memastikan bahwa Window yang benar digunakan (seperti jika View ada dalam dialog). (I660ae, b/219572936)
• Menambahkan LazyVerticalGrid API baru untuk menentukan ukuran sumbu silang (I17723)

Perbaikan Bug

• Update pada Card API untuk mengikuti perubahan di Platform API (I3c8b9)

Versi 1.0.0-alpha06

23 Februari 2022

androidx.compose.material3:material3:1.0.0-alpha06 dirilis. Versi 1.0.0-alpha06 berisi commit ini.

Perubahan API

• NavigationDrawerItem ditambahkan yang mewakili satu tujuan dalam panel samping (Ic396f, b/218286829)
• PermanentNavigationDrawer dan DismissibleNavigationDrawer telah ditambahkan sebagai API eksperimental. Keduanya adalah panel samping yang cocok untuk perangkat layar besar. (I5f8ab, b/218286829)
• Menambahkan dukungan panel aplikasi bawah Material 3 (Ic432a)
• NavigationDrawer diganti namanya menjadi ModalNavigationDrawer (I1807d, b/218286829)
• Menambahkan class dan token Penggeser Material 3 (I1ccee)
• Menambahkan implementasi Tab, lihat dokumentasi untuk contoh penggunaan (Ie0146)

Perbaikan Bug

• Memperbaiki masalah saat navigasi linier pembaca layar TalkBack memilih judul panel aplikasi atas yang kosong. (Id4690)
• Menambahkan IconSize ke FloatingActionButtonDefaults. (Ia71cf)
• Perbaikan bug untuk tombol AlertDialog yang tersembunyi saat teks panjang ditambahkan dengan LazyColumn. (Ib2cc9, b/216663029)

Versi 1.0.0-alpha05

9 Februari 2022

androidx.compose.material3:material3:1.0.0-alpha05 dirilis. Versi 1.0.0-alpha05 berisi commit ini.

Fitur Baru

Menambahkan komponen Desain Material 3

• Menu dropdown
  • DropdownMenu, DropdownMenuItem
• Kartu
  • Kartu, OutlinedCard, ElevatedCard

Perubahan API

• Fungsi Surface yang tidak digunakan lagi dan menggunakan callback onClick. Platform yang dapat diklik harus dibuat dengan InteractionSource dan Modifier.clickable(). (I211c6)
• Menambahkan dukungan elevasi yang ditekan dan difokuskan untuk FAB. (Ibb584)
• Mengubah Surface API untuk menerima InteractionSource yang memungkinkan mengontrol tampilannya dalam berbagai status. (Iafbc8)

Perbaikan Bug

• Menambahkan warna tersier yang hilang dalam skema warna dinamis (I456c4, b/214588434)

Versi 1.0.0-alpha04

26 Januari 2022

androidx.compose.material3:material3:1.0.0-alpha04 dirilis. Versi 1.0.0-alpha04 berisi commit ini.

Perubahan API

• Menambahkan NonRestartableComposable ke metode yang membebani metode yang ada tanpa logika yang kompleks. Tindakan ini akan mengurangi pemeriksaan memoisasi yang dihasilkan compiler (sama dengan) untuk semua parameter yang diulang dalam fungsi internal yang dipanggil. (I90490)
• Menambahkan pemisah Material 3. (Ica5fc)
• Menandai Checkbox dan RadioButton dengan anotasi API eksperimental. (Ie44bb)
• Menambahkan dukungan untuk indikator progres Material 3. (Iff232, b/205023841)

Perbaikan Bug

• Memperbarui warna penampung TextButton's yang dinonaktifkan agar menjadi transparan (I6b248, b/213339737)

Versi 1.0.0-alpha03

12 Januari 2022

androidx.compose.material3:material3:1.0.0-alpha03 dirilis. Versi 1.0.0-alpha03 berisi commit ini.

Perbaikan Bug

• Menambahkan LocalIndication ke MaterialTheme Material 3. (I7ce4e)
• Memperbaiki radius sudut yang diterapkan untuk Kotak centang (I38b03, b/175198975, b/202309440)

Update Dependensi

• Sekarang bergantung pada Kotlin 1.6.10.

Versi 1.0.0-alpha02

1 Desember 2021

androidx.compose.material3:material3:1.0.0-alpha02 dirilis. Versi 1.0.0-alpha02 berisi commit ini.

Fitur Baru

• Menambahkan dukungan untuk kotak centang dan tombol pilihan.
• Diupdate agar kompatibel dengan Kotlin 1.6.0

Perubahan API

• Menghapus panel samping dari scaffold Material 3. (I04f51)
• Menambahkan dukungan Checkbox Material 3. (Id5542)
• Menambahkan dukungan RadioButton Material 3. (I20334)

Perbaikan Bug

• Mengurangi radius ripple IconButton dari 40 dp menjadi 20 dp. (I68bbe, b/206674345)
• Jalur cepat string port untuk perubahan Text dari compose.material (I30b03)
• Memperbaiki error tombol hardcode agar selalu aktif. (Iea832, b/205335456)

Versi 1.0.0-alpha01

27 Oktober 2021

androidx.compose.material3:material3:1.0.0-alpha01 dirilis. Versi 1.0.0-alpha01 berisi commit ini.

Fitur Baru

Tema Desain Material 3 dan warna dinamis Material You

• MaterialTheme
• Warna
  • ColorScheme
  • lightColorScheme, darkColorScheme
• Warna dinamis
  • dynamicLightColorScheme, dynamicDarkColorScheme
• Tipografi
  • Typography

Komponen Desain Material 3

• Tombol
  • Button, ElevatedButton, FilledTonalButton, OutlinedButton, TextButton
• FAB dan FAB yang diperluas
  • SmallFloatingActionButton, FloatingActionButton, LargeFloatingActionButton, ExtendedFloatingActionButton
• Dialog
  • AlertDialog
• Menu navigasi
  • NavigationBar
• Panel navigasi
  • NavigationDrawer
• Kolom samping navigasi
  • NavigationRail
• Panel aplikasi atas
  • SmallTopAppBar, CenterAlignedTopAppBar, MediumTopAppBar, LargeTopAppBar
• Badge
  • Badge, BadgedBox
• Ikon
  • Icon, IconButton
• Teks
  • Text
• Permukaan
  • Surface
• Tata Letak
  • Scaffold
• Warna konten
  • LocalContentColor

Untuk informasi selengkapnya, lihat bagian Desain Material 3 dan Material You di panduan Tema Material dalam Compose.