Android-CircleButton is a custom Android view that creates a circular button with a material-like ripple effect. It provides an easy way to implement circular buttons with animations in Android applications, enhancing the user interface with a modern and visually appealing design element.

Pros

• Simple implementation of circular buttons with ripple effects
• Customizable appearance through XML attributes
• Smooth animations for button state changes
• Compatible with older Android versions (API 14+)

Cons

• Limited to circular shape only
• May require additional customization for complex use cases
• Not actively maintained (last update was in 2016)
• Lacks some modern Android features and optimizations

Code Examples

1. Basic implementation in XML layout:

<at.markushi.ui.CircleButton
    android:layout_width="64dip"
    android:layout_height="64dip"
    android:src="@drawable/ic_action_tick"
    app:cb_color="#99CC00"
    app:cb_pressedRingWidth="8dip" />

2. Changing button color programmatically:

CircleButton button = findViewById(R.id.myCircleButton);
button.setColor(Color.RED);

3. Setting click listener:

CircleButton button = findViewById(R.id.myCircleButton);
button.setOnClickListener(new View.OnClickListener() {
    @Override
    public void onClick(View v) {
        // Handle button click
    }
});

Getting Started

1. Add the dependency to your build.gradle file:

dependencies {
    implementation 'com.github.markushi:android-circlebutton:1.1'
}

2. Add the CircleButton to your layout XML:

<at.markushi.ui.CircleButton
    android:id="@+id/myCircleButton"
    android:layout_width="64dip"
    android:layout_height="64dip"
    android:src="@drawable/my_icon"
    app:cb_color="#FF4081"
    app:cb_pressedRingWidth="8dip" />

3. Reference the button in your Activity or Fragment:

CircleButton circleButton = findViewById(R.id.myCircleButton);
circleButton.setOnClickListener(new View.OnClickListener() {
    @Override
    public void onClick(View v) {
        // Handle button click
    }
});