Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

https://github.com/hluhovskyi/HoldingButton

Button which is visible while user holds it. Main use case is controlling audio recording state (like in Telegram, Viber, VK).
https://github.com/hluhovskyi/HoldingButton

android-library button java material-design ui

Last synced: 1 day ago
JSON representation

Button which is visible while user holds it. Main use case is controlling audio recording state (like in Telegram, Viber, VK).

Host: GitHub
URL: https://github.com/hluhovskyi/HoldingButton
Owner: hluhovskyi
License: apache-2.0
Created: 2017-03-09T10:03:40.000Z (over 7 years ago)
Default Branch: master
Last Pushed: 2018-10-21T16:51:52.000Z (over 5 years ago)
Last Synced: 2024-05-22T06:10:39.091Z (25 days ago)
Topics: android-library, button, java, material-design, ui
Language: Java
Homepage:
Size: 2.23 MB
Stars: 597
Watchers: 17
Forks: 72
Open Issues: 9
Metadata Files:
- Readme: README.md
- License: LICENSE.txt

Lists

awesome-github-android-ui - HoldingButton - 控制录音状态的按钮 (按钮)

README

        # HoldingButton

  [![Android Arsenal](https://img.shields.io/badge/Android%20Arsenal-HoldingButton-brightgreen.svg?style=flat)](https://android-arsenal.com/details/1/5436)

Button which is visible while user holds it. Main use case is controlling audio recording state (like in Telegram, Viber, VK). 



## Getting started

Add library as dependency to your `build.gradle`.

```

compile 'com.dewarder:holdingbutton:0.1.3'

```

## How to use

1. Wrap your layout with `HoldingButtonLayout`. It is simple `FrameLayout` inside.

   ```xml

    

        

        ...

     

        

        ...

 

    

    ```

2. Set `app:hbl_holding_view` property to id of view which would be translated to `HoldingButton`

   ```xml

    

   ```

3. Set `app:hbl_icon` property to icon (usually it is the same as in translated view) which would be appeared in `HoldingButton`.

   ```xml

    

   ```

4. Listen events

   ```java

   

   mHoldingButtonLayout.addListener(new SimpleHoldingButtonLayoutListener() {

       @Override

       public void onOffsetChanged(float offset, boolean isCancel) {

           mSlideToCancel.setTranslationX(-mHoldingButtonLayout.getWidth() * offset);

           mSlideToCancel.setAlpha(1 - SLIDE_TO_CANCEL_ALPHA_MULTIPLIER * offset);

       }

   });

   

   ```

5. Enjoy!

   ![Check full example](https://github.com/dewarder/HoldingButton/tree/master/holdingbuttonsample)

## All XML properties

- `hbl_enabled` (`isButtonEnabled/setButtonEnabled`)

   Set enabled or disabled state of button only.

- `hbl_direction` (`getDirection/setDirection`)

   Set direction of sliding. Possible directions are `start` (from right to left) and `end` (from left to right).

   ![](/_arts/hbl_directions.png)

- `hbl_cancel_offset` (`getCancelOffset/setCancelOffset`)

   Set minimum offset for cancel action.

   ![](/_arts/hbl_cancel_offset.png)

- `hbl_icon` (`setIcon`)

   ![](/_arts/hbl_icon.png)

- `hbl_cancel_icon` (`setCancelIcon`)

   ![](/_arts/hbl_cancel_icon.png)

- `hbl_color` (`getColor/setColor`)

   ![](/_arts/hbl_color.png)

- `hbl_cancel_color` (`getCancelColor/CancelColor`)

   ![](/_arts/hbl_cancel_color.png)

- `hbl_radius` (`getRadius/setRadius`)

   ![](/_arts/hbl_radius.png)

- `hbl_second_radius` (`getSecondRadius/setSecondRadius`)

   ![](/_arts/hbl_second_radius.png)

- `hbl_second_alpha` (`getSecondAlpha/setSecondAlpha`)

   ![](/_arts/hbl_second_alpha.png)

- `hbl_offset_x` (`getOffsetX/setOffsetX`)

   ![](/_arts/hbl_offset_x.png)

- `hbl_offset_y` (`getOffsetY/setOffsetY`)

   ![](/_arts/hbl_offset_y.png)

- `hbl_animate_holding_view` (`setAnimateHoldingView/isAnimateHoldingView`)

## License

```

Copyright (C) 2017 Artem Glugovsky

Licensed under the Apache License, Version 2.0 (the "License");

you may not use this file except in compliance with the License.

You may obtain a copy of the License at

    http://www.apache.org/licenses/LICENSE-2.0

Unless required by applicable law or agreed to in writing, software

distributed under the License is distributed on an "AS IS" BASIS,

WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.

See the License for the specific language governing permissions and

limitations under the License.

```