Skip to content

TalbotGooday/ToothyProgress

Repository files navigation

flow

Platform Languages

A polyline determinated ProgressBar written in Kotlin. Inspired by this Reddit post

Getting started

Add to your root build.gradle:

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

Add the dependency:

dependencies {
      implementation 'com.github.TalbotGooday:ToothyProgress:x.x.x'
}

Code example

Settle the ToothyProgress somewhere in your XML like this:

<com.goodayapps.widget.ToothyProgress
	android:id="@+id/toothyProgress"
	android:layout_width="match_parent"
	android:layout_height="80dp"
	app:progress=".5"
	app:progressColor="#ffffff"
	app:progressBackgroundColor="#959595"
	app:progressWidth="3dp"
	app:trackWidth="3dp"
	app:trackColor="#959595"
	app:strokeLineCapProgress="round"
	app:strokeLineCapProgressBackground="square"
	app:strokeLineCapTrack="square"
	app:progressBackgroundWidth="3dp"
	/>

Seekbar-like listener:

toothyProgress.setListener(object : ToothyProgress.Listener {
	override fun onProgressChanged(progress: Float, fromUser: Boolean) {
		// invokes every time the progress's been changed
	}
	override fun onStartTrackingTouch(progress: Float) {
		// invokes when user touches the view
	}
	override fun onStopTrackingTouch(progress: Float) {
		// invokes when user releases the touch
	}
})

Visual Editor

In recent versions, the ability to customize the type of progress using the Visual Editor has been added.

How to use Visual Editor

  1. Open editor
  2. Move the apexes as you like. Add new apexes
  3. Click Load into demo player to check the result
  4. Check the Logcat for the FractureData tag and copy the initialization code from the logs

TODO

  • Indeterminate Progress
  • Style initialization from a .json file
  • Visual Editor improvements

License

This project is licensed under the MIT License - see the LICENSE file for details