MaterialDayPicker

Materialdaypicker

Terinspirasi oleh pemetik hari di aplikasi Android Clock Builtin.

Catatan: Saya tidak aktif mengerjakan fitur baru untuk perpustakaan ini. Saya hanya membahas bug kritis. Dengan itu dikatakan kontribusi untuk fitur baru lebih dari disambut dan saya tersedia untuk meninjau permintaan tarik. Lihat Kontribusi.MD jika Anda tertarik untuk berkontribusi.

Penggunaan normal	Penggunaan lokal	Penggunaan mode gelap

Fitur

• ? Tema yang dapat disesuaikan
• ✅ Mudah digunakan API/kait
• ? Sepenuhnya terlokalisasi
• ? Mendukung Mode Gelap

What's New: Versi 0.7.4 - Konfigurasi yang Lebih Baik + Perbaikan Bug

• Anda sekarang dapat secara manual mengesampingkan hari pertama dalam seminggu yang ditampilkan di pemilih dengan menggunakan properti firstDayOfWeek yang baru ditambahkan

Perubahan dari 0,7,3

• Ditingkatkan MaterialDayPicker ke Target API 30 dan meningkatkan dependensi Androidx -nya

Perubahan dari 0,7,2

Perbaikan bug

• Memperbaiki bug saat menggunakan Android Gradle Plugin 3.6.1 yang akan menyebabkan pembangunan gagal karena tidak dapat menemukan atribut selectionMode .

Perubahan dari 0,7.1

Perbaikan bug

• Memperbaiki masalah di mana panggilan setSelectedDays akan menyebabkan hari -hari yang dipilih untuk menyala dan menyala.

Perubahan dari 0,7.0

Peningkatan konfigurasi

• Anda sekarang dapat mengaktifkan/menonaktifkan hari dari dipilih menggunakan metode enableday/disableday. Lihat lebih lanjut di bawah ini.
• Anda sekarang dapat mengatur mode seleksi melalui XML dengan menggunakan atribut app:selectionMode .

Unduh versi terbaru dengan menambahkan yang berikut ini ke file build.gradle proyek Anda:

dependencies {
    implementation ' ca.antonious:materialdaypicker:0.7.4 '
}

Menggunakan materialdaypicker di aplikasi Anda

Anda bisa memasukkan tampilan ke XML yang ada:

< ca .antonious.materialdaypicker.MaterialDayPicker
    android : id = " @+id/day_picker "
    android : layout_width = " match_parent "
    android : layout_height = " wrap_content " />

Anda bisa mendapatkan hari -hari yang saat ini dipilih dengan menggunakan:

 val selectedDays = materialDayPicker.selectedDays
// returns [MaterialDayPicker.Weekday.TUESDAY, MaterialDayPicker.Weekday.FRIDAY]

Anda dapat mengatur hari yang dipilih dengan melakukan:

 val daysToSelect = listOf ( MaterialDayPicker . Weekday . TUESDAY , MaterialDayPicker . Weekday . FRIDAY )
materialDayPicker.setSelectedDays(daysToSelect)

Jika Anda hanya ingin membiarkan satu hari dipilih pada suatu waktu yang dapat Anda lakukan:

materialDayPicker.selectionMode = SingleSelectionMode .create()

Ini juga dapat diatur melalui XML menggunakan atribut selectionMode :

< ca .antonious.materialdaypicker.MaterialDayPicker
    ...
    app : selectionMode = " ca.antonious.materialdaypicker.SingleSelectionMode " />

Anda dapat mengaktifkan/menonaktifkan hari menggunakan metode berikut. CATATAN Jika Anda menonaktifkan hari ketika dipilih itu tidak dapat dipilih:

materialDayPicker.enableDay( MaterialDayPicker . Weekday . Monday )
materialDayPicker.disableDay( MaterialDayPicker . Weekday . Monday )
materialDayPicker.setDayEnable( MaterialDayPicker . Weekday . Monday , isEnabled = false )

Jika Anda ingin mendengarkan kapan pun pilihan hari diubah, Anda dapat menggunakan:

materialDayPicker.setDaySelectionChangedListener { selectedDays ->
    // handle selection change
}

Jika Anda perlu tahu kapan hari tertentu dipilih/tidak dipilih, Anda dapat menggunakan:

materialDayPicker.setDayPressedListener { weekday, isSelected ->
    // handle weekday selection
}

Menyesuaikan MaterialDayPicker untuk aplikasi Anda

Anda dapat mengesampingkan warna -warna ini untuk mengubah penampilan materialdaypicker. Anda juga dapat memperbarui nilai -nilai ini di direktori Sumber Daya Warna Malam Anda untuk memperbarui bagaimana MaterialPicker terlihat dalam mode gelap:

< color name = " dayPressed " >@color/colorPrimaryDark</ color >
< color name = " daySelected " >@color/colorPrimary</ color >
< color name = " daySelectedTextColor " >@android:color/white</ color >
< color name = " dayDeselected " >#FAFAFA</ color >
< color name = " dayDeselectedTextColor " >@android:color/black</ color >

<!-- Customizing colors for disabled days -->
< color name = " daySelectedAndDisabled " >#43444F</ color >
< color name = " daySelectedAndDisabledTextColor " >@color/daySelectedTextColor</ color >
< color name = " dayDeselectedAndDisabled " >@color/dayDeselected</ color >
< color name = " dayDeselectedAndDisabledTextColor " >@android:color/darker_gray</ color >

Jika Anda tidak ingin menggunakan lokal perangkat saat ini, Anda dapat menimpanya dengan melakukan:

materialDayPicker.locale = Locale . ENGLISH // or any other locale

Jika Anda ingin menentukan hari pertama dalam seminggu secara eksplisit:

materialDayPicker.firstDayOfWeek = MaterialDayPicker . Weekday . MONDAY // or any other day 

Lisensi

 MIT License

Copyright (c) 2017 George Antonious

Permission is hereby granted, free of charge, to any person obtaining a copy
of this software and associated documentation files (the "Software"), to deal
in the Software without restriction, including without limitation the rights
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
copies of the Software, and to permit persons to whom the Software is
furnished to do so, subject to the following conditions:

The above copyright notice and this permission notice shall be included in all
copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
SOFTWARE.