• Stars
    star
    165
  • Rank 228,906 (Top 5 %)
  • Language
    Kotlin
  • License
    Apache License 2.0
  • Created over 5 years ago
  • Updated over 2 years ago

Reviews

There are no reviews yet. Be the first to send feedback to the community and the maintainers!

Repository Details

Create circular view in android (change color, border & shadow) âšĢ

CircleView

sample

Platform API Maven Central Twitter

This is an Android project allowing to realize a circular View in the simplest way possible. Finish the oval shapes of all colors in your projects.

Android app on Google Play

USAGE

To make a circular View add CircleView in your layout XML and add CircleView library in your project or you can also grab it via Gradle:

implementation 'com.mikhaellopez:circleview:1.4.1'

XML

<com.mikhaellopez.circleview.CircleView
    android:id="@+id/circleView"
    android:layout_width="300dp"
    android:layout_height="300dp"
    app:cv_border="true"
    app:cv_border_color="#000000"
    app:cv_border_width="8dp"
    app:cv_color="#3f51b5"
    app:cv_shadow="true"
    app:cv_shadow_color="#3f51b5"
    app:cv_shadow_radius="10" />

You must use the following properties in your XML to change your CircleView.

Properties Type Default
app:cv_color color WHITE
app:cv_color_start color cv_color
app:cv_color_end color cv_color
app:cv_color_direction left_to_right, right_to_left, top_to_bottom or bottom_to_top left_to_right
app:cv_border boolean false
app:cv_border_width dimension 4dp
app:cv_border_color color BLACK
app:cv_border_color_start color cv_border_color
app:cv_border_color_end color cv_border_color
app:cv_border_color_direction left_to_right, right_to_left, top_to_bottom or bottom_to_top left_to_right
app:cv_shadow boolean false
app:cv_shadow_color color BLACK
app:cv_shadow_radius float 8.0f
app:cv_shadow_gravity center, top, bottom, start or end bottom

ℹī¸ You can also use android:elevation instead of app:cv_shadow to have default Material Design elevation.

KOTLIN

sample

val circleView = findViewById<CircleView>(R.id.circleView)
circleView.apply {
    // Set Color
    circleColor = Color.WHITE
    // or with gradient
    circleColorStart = Color.BLACK
    circleColorEnd = Color.RED
    circleColorDirection = CircleView.GradientDirection.TOP_TO_BOTTOM
    
    // Set Border
    borderWidth = 10f
    borderColor = Color.BLACK
    // or with gradient
    borderColorStart = Color.BLACK
    borderColorEnd = Color.RED
    borderColorDirection = CircleView.GradientDirection.TOP_TO_BOTTOM
    
    // Add Shadow with default param
    shadowEnable = true
    // or with custom param
    shadowRadius = 15f
    shadowColor = Color.RED
    shadowGravity = CircleView.ShadowGravity.CENTER
}

JAVA

CircleView circleView = findViewById(R.id.circleView);

// Set Color
circleView.setCircleColor(Color.WHITE);
// or with gradient
circleView.setCircleColorStart(Color.BLACK);
circleView.setCircleColorEnd(Color.RED);
circleView.setCircleColorDirection(CircleView.GradientDirection.TOP_TO_BOTTOM);

// Set Border
circleView.setBorderWidth(10f);
circleView.setBorderColor(Color.BLACK);
// or with gradient
circleView.setBorderColorStart(Color.BLACK);
circleView.setBorderColorEnd(Color.RED);
circleView.setBorderColorDirection(CircleView.GradientDirection.TOP_TO_BOTTOM);

// Add Shadow with default param
circleView.setShadowEnable(true);
// or with custom param
circleView.setShadowRadius(15f);
circleView.setShadowColor(Color.RED);
circleView.setShadowGravity(CircleView.ShadowGravity.CENTER);

SUPPORT ❤ī¸

Find this library useful? Support it by joining stargazers for this repository ⭐ī¸
And follow me for my next creations 👍

LICENCE

CircleView by Lopez Mikhael is licensed under a Apache License 2.0.

More Repositories

1

CircularImageView

Create circular ImageView in Android in the simplest way possible
Kotlin
1,949
star
2

CircularProgressBar

Create circular ProgressBar in Android ⭕
Kotlin
1,698
star
3

CircularFillableLoaders

Realize a beautiful circular fillable loaders to be used for splashscreen 🌊
Java
1,222
star
4

BestAndroidGists

Find best Android Gist đŸ”Ĩ
890
star
5

RxAnimation

Simple way to animate your views on Android with Rx 🚀
Kotlin
590
star
6

AndroidWebServer

Android Web Server (NanoHttpd)
Java
433
star
7

CleanRxArchitecture

Clean Rx Kotlin Architecture sample on GitHub Api 🚀
Kotlin
387
star
8

LazyDatePicker

LazyDatePicker an alternative to the native Android Date Picker 📅
Java
372
star
9

RateBottomSheet

To help to promote your android app by prompting users to rate your app in a BottomSheet ⭐ī¸
Kotlin
308
star
10

GradientView

Create gradient view in Android in the simplest way possible 🌈
Kotlin
197
star
11

HFRecyclerView

Add Header and/or Footer in your RecyclerView in the simplest way possible.
Kotlin
170
star
12

Biometric

The easiest way is to use the new version of Biometric under AndroidX 🔒
Kotlin
140
star
13

PokeCardCompose

PokeCard Compose is a demo app 100% write in Compose, Flow and Koin based on MVI Clean Architecture 🐱⚡ī¸
Kotlin
115
star
14

SaveInsta

Example dynamic update of your theme based on a main color
Java
85
star
15

AutoScrollTextView

Sample Android application show how to set auto scroll in text view in android.
Java
51
star
16

FavoriteAndroidLibrary

My Farorite Android Library
49
star
17

MyToast

Custom Toast on Android
Java
39
star
18

DualShot

With DualShot you take two photos with the front and the back camera, and share both of them in a single image.
Java
23
star
19

WebSideMVC

Structure MVC for Web Side in PHP
PHP
1
star