diff --git a/README.md b/README.md index d623297..faa4593 100644 --- a/README.md +++ b/README.md @@ -1,10 +1,11 @@ -[![](https://jitpack.io/v/DeweyReed/HmsPickerView.svg)](https://jitpack.io/#DeweyReed/HmsPickerView) +[![](https://jitpack.io/v/xyz.aprildown/HmsPickerView.svg)](https://jitpack.io/#xyz.aprildown/HmsPickerView) # HmsPickerView -A beautiful little Android view to pick hours, minutes, seconds. +A beautiful little Android view to pick hours, minutes and seconds. -Screenshot +Port +Land ## Installation @@ -23,14 +24,16 @@ Step 2. Add the dependency ```Groovy dependencies { - implementation 'com.github.DeweyReed:HmsPickerView:${version}' + implementation "xyz.aprildown:HmsPickerView:${version}" } ``` -[![](https://jitpack.io/v/DeweyReed/HmsPickerView.svg)](https://jitpack.io/#DeweyReed/HmsPickerView) +[![](https://jitpack.io/v/xyz.aprildown/HmsPickerView.svg)](https://jitpack.io/#xyz.aprildown/HmsPickerView) ## Usage +In the XML: + ```XML ``` +In the code: + +```Kotlin +fun getHours(): Int +fun setHours(hours: Int) + +fun getMinutes(): Int +fun setMinutes(minutes: Int) + +fun getSeconds(): Int +fun setSeconds(seconds: Int) + +fun getTimeInMillis(): Long +fun setTimeInMillis(time: Long) + +fun setListener(l: HmsPickerView.Listener) +interface Listener { + /** + * Indicates [HmsPickerView] now has an valid input(anything except 00h 00m 00s). + * This methods can be used to allow user to go forward (such as enabling "next" button). + */ + fun onHmsPickerViewHasValidInput(hmsPickerView: HmsPickerView) + + /** + * Indicates [HmsPickerView]'s input becomes 00h 00m 00s. + * This methods can be used to prevent user from going forward(such as disabling "next" button). + */ + fun onHmsPickerViewHasNoInput(hmsPickerView: HmsPickerView) +} +``` + +### Use this view in a dialog + +1. Create a XML file like [this one](https://github.com/DeweyReed/HmsPickerView/blob/master/app/src/main/res/layout/layout_picker.xml#L1). +1. Wrap it into an AlertDialog like [this one](https://github.com/DeweyReed/HmsPickerView/blob/master/app/src/main/java/xyz/aprildown/hmspickerview/app/MainActivity.kt#L29). + +**🦄 Please star this repo if you like it 🦄** + ## License [LICENSE](./LICENSE) diff --git a/images/image.webp b/images/image.webp deleted file mode 100644 index 7ee6f18..0000000 Binary files a/images/image.webp and /dev/null differ diff --git a/images/land.webp b/images/land.webp new file mode 100644 index 0000000..adb6487 Binary files /dev/null and b/images/land.webp differ diff --git a/images/port.webp b/images/port.webp new file mode 100644 index 0000000..447b15a Binary files /dev/null and b/images/port.webp differ