RangeSeekBar

A beautiful and powerful SeekBar what supports single、 range、steps、vetical、custom（一款美观强大的支持单向、双向范围选择、分步、垂直、高度自定义的SeekBar)

2,502

385

2,502

View on GitHub

Top Related Projects

A custom SeekBar on Android, which can be changed the size ,color , thumb drawable , tick drawable , tick text and indicator , also , will show an indicator view with progress above SeekBar when seeking. https://github.com/warkiz/IndicatorSeekBar

Quick Overview

The Jay-Goo/RangeSeekBar is an Android library that provides a customizable range slider widget for Android applications. It allows users to select a range of values within a specified range, with various customization options for the appearance and behavior of the slider.

Pros

Customizable Appearance: The library offers a wide range of customization options, allowing developers to adjust the color, size, and style of the slider to match the design of their application.
Smooth Interaction: The slider provides a smooth and responsive user experience, with support for touch and drag gestures.
Flexible Range Selection: Users can select a range of values, rather than just a single value, which can be useful in various scenarios such as price filtering or date range selection.
Extensive Documentation: The project's documentation is comprehensive and provides clear instructions for integrating and using the library.

Cons

Limited Platform Support: The library is designed specifically for Android and may not be suitable for cross-platform development.
Potential Performance Issues: Depending on the complexity of the UI and the number of sliders used in an application, the library may have some performance implications.
Dependency on Android SDK: The library is tightly coupled with the Android SDK, which means that developers must have a good understanding of Android development to use it effectively.
Lack of Active Maintenance: The project appears to have limited active maintenance, with the last commit being over a year ago. This may raise concerns about the long-term viability and support for the library.

Code Examples

Here are a few examples of how to use the RangeSeekBar library in your Android application:

// Create a RangeSeekBar and set its properties
val rangeSeekBar = RangeSeekBar(context)
rangeSeekBar.setRangeValues(0f, 100f)
rangeSeekBar.setSelectedMinValue(20f)
rangeSeekBar.setSelectedMaxValue(80f)
rangeSeekBar.setOnRangeSeekBarChangeListener { minValue, maxValue ->
    // Handle changes to the selected range
    println("Min value: $minValue, Max value: $maxValue")
}

// Customize the appearance of the RangeSeekBar
rangeSeekBar.setBarHeight(16f)
rangeSeekBar.setBarColor(Color.GRAY)
rangeSeekBar.setThumbColor(Color.BLUE)
rangeSeekBar.setThumbRadius(12f)
rangeSeekBar.setTextColor(Color.BLACK)
rangeSeekBar.setTextSize(14f)

// Disable the RangeSeekBar
rangeSeekBar.isEnabled = false

// Set the RangeSeekBar's values programmatically
rangeSeekBar.setSelectedMinValue(30f)
rangeSeekBar.setSelectedMaxValue(70f)

Getting Started

To use the RangeSeekBar library in your Android project, follow these steps:

Add the library to your project's build.gradle file:

dependencies {
    implementation 'com.github.Jay-Goo:RangeSeekBar:2.1.4'
}

Add the RangeSeekBar to your layout XML file:

<com.jaygoo.widget.RangeSeekBar
    android:id="@+id/rangeSeekBar"
    android:layout_width="match_parent"
    android:layout_height="wrap_content" />

In your activity or fragment, create an instance of the RangeSeekBar and customize its properties:

val rangeSeekBar = findViewById<RangeSeekBar>(R.id.rangeSeekBar)
rangeSeekBar.setRangeValues(0f, 100f)
rangeSeekBar.setSelectedMinValue(20f)
rangeSeekBar.setSelectedMaxValue(80f)
rangeSeekBar.setOnRangeSeekBarChangeListener { minValue, maxValue ->
    // Handle changes to the selected range

Competitor Comparisons

discreteSeekBar

2,111

Pros of discreteSeekBar

Offers discrete steps, allowing for more precise value selection
Provides a customizable indicator bubble for displaying current value
Supports both horizontal and vertical orientations

Cons of discreteSeekBar

Limited to single-point selection, unlike RangeSeekBar's dual-thumb support
Less extensive customization options for appearance compared to RangeSeekBar
Lacks built-in support for range selection functionality

Code Comparison

discreteSeekBar:

<org.adw.library.widgets.discreteseekbar.DiscreteSeekBar
    android:layout_width="match_parent"
    android:layout_height="wrap_content"
    app:dsb_min="0"
    app:dsb_max="100"
    app:dsb_value="50" />

RangeSeekBar:

<com.jaygoo.widget.RangeSeekBar
    android:layout_width="match_parent"
    android:layout_height="wrap_content"
    app:rsb_min="0"
    app:rsb_max="100"
    app:rsb_mode="range" />

Both libraries offer easy-to-use seekbar implementations, but they cater to different use cases. discreteSeekBar is ideal for scenarios requiring precise, step-based selection, while RangeSeekBar excels in range selection and offers more extensive customization options.

IndicatorSeekBar

2,158

Pros of IndicatorSeekBar

Offers more customization options for the indicator, including custom layouts and animations
Supports both continuous and discrete modes with configurable tick marks
Provides built-in text formatting options for the indicator

Cons of IndicatorSeekBar

Lacks support for dual-thumb (range) selection
May have a steeper learning curve due to more configuration options

Code Comparison

RangeSeekBar:

RangeSeekBar seekBar = findViewById(R.id.seekBar);
seekBar.setRange(0, 100);
seekBar.setValue(20, 80);
seekBar.setOnRangeChangedListener(new OnRangeChangedListener() {
    @Override
    public void onRangeChanged(RangeSeekBar view, float leftValue, float rightValue, boolean isFromUser) {
        // Handle range change
    }
});

IndicatorSeekBar:

IndicatorSeekBar seekBar = findViewById(R.id.seekBar);
seekBar.setMin(0);
seekBar.setMax(100);
seekBar.setProgress(50);
seekBar.setOnSeekChangeListener(new OnSeekChangeListener() {
    @Override
    public void onSeeking(SeekParams seekParams) {
        // Handle progress change
    }
});

Both libraries offer easy-to-use APIs for creating customizable seek bars. RangeSeekBar focuses on dual-thumb range selection, while IndicatorSeekBar provides more options for single-thumb seek bars with advanced indicator customization.

Convert designs to code with AI

Introducing Visual Copilot: A new AI model to turn Figma designs to high quality code using your components.

Try Visual Copilot

README

ææ¡£è¿æ¯ä¸æå¥½

Demo

APK download

fir.im

Usage

Dependencies

Release Version

    allprojects {
		repositories {
			...
			maven { url 'https://jitpack.io' }
		}
	}

	dependencies {
		// sample: implementation 'com.github.Jay-Goo:RangeSeekBar:v3.0.0'
	        implementation 'com.github.Jay-Goo:RangeSeekBar:Release Version'
	}