An Android library that provides a simple and customizable ValuePicker.
An Android library that provides a simple and customizable ValuePicker.
mavenCentral()
repository to your top-level build.gradle
file.buildscript {
//...
repositories {
//...
mavenCentral()
}
//...
}
build.gradle
file.dependencies {
//...
implementation "com.paulrybitskyi.valuepicker:valuepicker:1.0.3"
//...
}
Basic usage of the ValuePickerView involves two steps - declaring a widget inside the XML file of your choice and configuring it in one of the Kotlin/Java classes.
Let's see how we can do that by following the steps listed above:
Declaring a widget inside the XML file.
<?xml version="1.0" encoding="utf-8"?>
<androidx.constraintlayout.widget.ConstraintLayout
xmlns:android="http://schemas.android.com/apk/res/android"
xmlns:app="http://schemas.android.com/apk/res-auto"
android:layout_width="match_parent"
android:layout_height="match_parent"
android:background="@color/colorPrimary">
<!-- Other widgets here -->
<com.paulrybitskyi.valuepicker.ValuePickerView
android:id="@+id/valuePickerView"
android:layout_width="wrap_content"
android:layout_height="wrap_content"
app:vpv_areDividersEnabled="true"
app:vpv_isInfiniteScrollEnabled="true"
app:vpv_maxVisibleItems="5"
app:vpv_textColor="@color/colorAccent"
app:vpv_dividerColor="@color/colorAccent"
app:vpv_flingSpeedFactor="0.3"
app:vpv_textSize="@dimen/date_picker_text_size"
app:vpv_textTypeface="@font/ubuntu_mono_bold"
app:vpv_divider="@drawable/custom_divider"
app:vpv_orientation="vertical"/>
</androidx.constraintlayout.widget.ConstraintLayout>
Configuring the widget in one of the Kotlin/Java classes.
override fun onViewCreated(view: View, savedInstanceState: Bundle?) {
super.onViewCreated(view, savedInstanceState)
//...
with(valuePickerView) {
onItemSelectedListener = ValuePickerView.OnItemSelectedListener { item ->
// Do something with item
}
val pickerItems = getPickerItems()
items = pickerItems
setSelectedItem(pickerItems[2])
}
}
private fun getPickerItems(): List<Item> {
return mutableListOf<Item>().apply {
for(number in 1..100) {
add(
PickerItem(
id = number,
title = number.toString()
)
)
}
}
}
@Override
public void onViewCreated(@NonNull View view, @Nullable Bundle savedInstanceState) {
super.onViewCreated(view, savedInstanceState);
ValuePickerView valuePickerView = view.findViewById(R.id.valuePickerView);
valuePickerView.setOnItemSelectedListener((item) -> {
// Do something with item
});
final ArrayList<Item> pickerItems = getPickerItems();
valuePickerView.setItems(getPickerItems());
valuePickerView.setSelectedItem(pickerItems.get(2));
}
private ArrayList<Item> getPickerItems() {
final ArrayList<Item> pickerItems = new ArrayList<>(100);
for(int i = 1; i <= 100; i++) {
pickerItems.add(
new PickerItem(
i,
String.valueOf(i)
)
);
}
return pickerItems;
}
See the Sample app.
ValuePicker is licensed under the Apache 2.0 License.