Awesome

SSJetPackComposeProgressButton

SSJetPackComposeProgressButton is an elegant button with a different loading animations which makes your app attractive.

Features

• Android’s modern toolkit - Jetpack Compose support.
• Newly designed loading animation make your app attractive.
• Blinking icon button for your hot-feature.
• Button with text, right and left icon.
• Different types of state makes it easy to manage button. (Idle, Loading, Success, Failure)
• Fully customized button (Corner radius, background, colors, animation speed etc.)
• Customize button loading animation with your logo and special animation effect.
• Supports displaying GIFs via URL or local file in the button's loading state.
• Supports swipe to animate buttons.

🎬 Preview

🎬 Swipeable Buttons

🎬 Customized loading animation

Installation

1. Add it in your root build.gradle at the end of repositories:

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

• Add the dependency in your app's build.gradle file

  dependencies {
          implementation 'com.github.SimformSolutionsPvtLtd:SSJetPackComposeProgressButton:<LATEST_TAG>'
  }
  

Usage

• Just use SSJetPackComposeProgressButton where you want button.

  var submitButtonState by remember { mutableStateOf(SSButtonState.IDLE) }
  SSJetPackComposeProgressButton(
      type = SSButtonType.CLOCK,
      width = 300.dp,
      height = 50.dp,
      onClick = {
          //Perform action on click of button and make it's state to LOADING
          submitButtonState = SSButtonState.LOADING
      },
      assetColor = Color.Red,
      buttonState = submitButtonState
  )
  

  // On Success change submitButtonState to success state
  submitButtonState = SSButtonState.SUCCESS
  

  // On Failure change submitButtonState to failure state
  submitButtonState = SSButtonState.FAILIURE
  

Migration guide from release v1.0.9

• Added support displaying GIFs via URL or local file in the button's loading state.
• Added blinkingIconColor to animate with your custom color.
• You can now apply different tints by using these updated variables: leftImageIconTintColor rightImageTintColor successIconTintColor failureIconTintColor These variables allow you to customize tints as per your specific requirements, while defaulting to null if not specified.
• Changed default cornerRadius value to 0 from 20.
• Renamed blinkingIcon to isBlinkingIcon in SSJetPackComposeProgressButton.
• Renamed colorChanger in fadeInOut in SSCustomLoadingEffect.
• Removed buttonBorderStroke and instead use buttonBorderWidth, buttonBorderColor and animatedButtonBorderColor to offer more control over button borders.
• Removed default values for successIconPainter and failureIconPainter and set to null to offer more control over what is displayed when animation is completed.
• Removed default value for customLoadingIconPainter and set to null to offer more control over what is displayed when animation is in progress.

Customization

• You can customize loading icon and animation effect according to your requirement.You can apply multiple animation effect from rotation, zoom-in-out and fade-in-out too.

  
  var submitButtonState by remember { mutableStateOf(SSButtonState.IDLE) }
  SSJetPackComposeProgressButton(
                  type = SSButtonType.CUSTOM,
                  width = 480.dp,
                  height = 60.dp,
                  onClick = {
                      //Perform action on click of button and make it's state to LOADING
                      submitButtonState = SSButtonState.LOADING
                      CoroutineScope(Dispatchers.Default).launch {
                          // Do your heavy work once completed show success or failure
                          delay(2000) 
                          submitButtonState = SSButtonState.SUCCESS
                      }
                  },
                  cornerRadius = 20,
                  assetColor = Color.Red,
                  buttonState = submitButtonState,
                  successIconPainter = rememberVectorPainter(image = Icons.Default.Done),
                  successIconTintColor = LIGHT_PINK,
                  failureIconPainter = rememberVectorPainter(image = Icons.Outlined.Info),
                  failureIconTintColor = LIGHT_PINK,
                  colors = ButtonDefaults.buttonColors(
                      containerColor = Color.White,
                      disabledContainerColor = Color.White
                  ),
                  padding = PaddingValues(12.dp),
                  text = stringResource(id = R.string.app_name),
                  textModifier = Modifier.padding(10.dp),
                  fontWeight = FontWeight.Bold,
                  leftImagePainter = painterResource(id = R.drawable.baby_pink_android),
                  isBlinkingIcon = true,
                  blinkingIconColor = Color.White,
                  buttonBorderWidth = 3.dp,
                  animatedButtonBorderColor = LIGHT_PINK,
                  buttonBorderColor = LIGHT_PINK,
                  customLoadingIconPainter = painterResource(id = R.drawable.baby_pink_android),
                  customLoadingEffect = SSCustomLoadingEffect(
                      zoomInOut = true,
                  )
              )
  

  // On Success change submitButtonState to success state
  submitButtonState = SSButtonState.SUCCESS
  

  // On Failure change submitButtonState to failure state
  submitButtonState = SSButtonState.FAILIURE
  

All Attributes

Our JetPackCompose Sample

SSComposeCookBook : A Collection of major Jetpack compose UI components which are commonly used.

Find this library useful? ❤️

Support it by joining stargazers for this repository.⭐

How to Contribute🤝

Whether you're helping us fix bugs, improve the docs, or a feature request, we'd love to have you! 💪 Check out our Contributing Guide for ideas on contributing.

Bugs and Feedback

For bugs, feature requests, and discussion please use GitHub Issues.

Medium Blog

For more info go to Progress Button using JetPack Compose : SSJetPackComposeProgressButton

Awesome Mobile Libraries

• Check out our other available awesome mobile libraries

License

Distributed under the MIT License. See LICENSE for details.