Ecosyste.ms: Awesome

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

Awesome Lists | Featured Topics | Projects

https://github.com/bufferapp/BufferTextInputLayout

A simple customised version of the TextInputLayout from the Android Design Support Library ⌨️
https://github.com/bufferapp/BufferTextInputLayout

android android-library android-ui java textinputlayout

Last synced: 3 months ago
JSON representation

A simple customised version of the TextInputLayout from the Android Design Support Library ⌨️

Awesome Lists containing this project

README

        

Buffer Text Input Layout
-------------------------

(Coming to maven central soon!)

This is a simple customisation of the TextInputLayout found in the Design Support Library.

Whilst this is an awesome component that we've made great use of, we wanted to be able to display
the counter so that the value displayed was:

- Not formatted in the way that the support library version was
- Only visible when we reach a certain number of characters away from the maximum counter value

Hence why we created this simple component :)

## Ascending

![Ascending](/art/ascending.gif)

## Descending

![Descending](/art/descending.gif)

## Standard

![Standard](/art/standard.gif)

## Display when a given count away from the maximum value

![Hidden](/art/hidden.gif)

# How to use

In exactly the same way as the support library! Simply wrap an edit text field like so:

```xml

```

# Setting attributes via XML

In our XML layout, we can set two extra attributes for the BufferTextInputLayout:

- app:counterMode -> Set the mode in which the counter should use when being displayed (DESCENDING, ASCENDING, STANDARD)
- app:displayFromCount -> Set the value for which how many characters should be remaining until the counter becomes visible

e.g

```xml
app:displayFromCount="5"
app:counterMode="descending"
```

# Setting attributes programmatically

- setCounterMode(CounterMode counterMode) -> Set the mode in which the counter should use when being displayed (DESCENDING, ASCENDING, STANDARD)
- setCharactersRemainingUntilCounterDisplay(int remainingCharacters) -> Set the value for which how many characters should be remaining until the counter becomes visible

e.g.
```java
bufferTextInputLayout.setCounterMode(CounterMode.DESCENDING);
bufferTextInputLayout.setCharactersRemainingUntilCounterDisplay(40);
```