android-material-chips - GitLite

KO | EN

gitlite — search

#react #ai #golang #go #android #docker #nodejs #java #cli #awesome-list #vue #mcp #openai #open-source

android-material-chips

(★ 264)

A different approach to implement android material chips since using transformed images inside an EditText cause too many exceptions on older devices and older versions.

File Explorer

Download Latest Version (.zip)

- - gradle-wrapper.jar
  - gradle-wrapper.properties
- chip_error.png
- dc1.png
- dc2.png
- dc3.png
- dc4.png
- .gitignore
- android-material-chips.pom
- build.gradle
- proguard-rules.pro
- .gitignore
- build.gradle
- proguard-rules.pro
.gitignore
build.gradle
CHANGELOG.md
gradle.properties
gradlew
gradlew.bat
LICENSE
README.md
settings.gradle

# Installation Guide

1. Get the code

git clone https://github.com/DoodleScheduling/android-material-chips

Downloads the entire project code from GitHub to your computer.

cd android-material-chips

Moves into the project folder you just downloaded.

2. Gradle (Java/Kotlin)

Medium Recommended

Prerequisites

Git Needed to download the project code from GitHub.
JDK (Java) Required to build and run Java/Kotlin projects.
Gradle If the repo includes gradlew (Gradle Wrapper), you don't need to install Gradle separately.

./gradlew build

Builds the project using Gradle.

✅ A BUILD SUCCESSFUL message means it worked. The output is created under build/.

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# Android Material Chips

A different approach to implement android material chips since using transformed images inside an EditText cause too many exceptions on older devices and older versions.

## Features
**Enter an email address and it will automatically transform into a chip**

<p>
<img src="./images/dc1.png" title="MaterialChips1" width="40%" />
<img src="./images/dc2.png" title="MaterialChips2" width="40%" />
</p>

**Email validation dialog**

*** UPDATE: The dialog is not included in version 1.2.0 anymore. Show your own dialog instead. ***

<p>
<img src="./images/dc3.png" title="MaterialChips3" width="40%" />
<img src="./images/dc4.png" title="MaterialChips4" width="40%" />
</p>

**Customize your layout and text**

## Sample
**APK:** [sample-apk-1.0.1](https://github.com/DoodleScheduling/android-material-chips/releases/download/1.0.1/android-material-chips-1.0.1-sample.apk)
 
## Download

**Gradle:**

via [jCenter](https://bintray.com/doodlescheduling/com.doodle/doodle-android-chips)
```gradle
buildscript {
    repositories {
        jcenter()
    }
}

dependencies {
    compile 'com.doodle.android:android-material-chips:1.2.0'
}
```

via [JitPack.io](https://jitpack.io/#DoodleScheduling/android-material-chips)
```gradle
repositories {
    maven { url "https://jitpack.io" }
}

dependencies {
    compile 'com.github.DoodleScheduling:android-material-chips:1.2.0'
}
```

## Usage

Use the ChipsView class in your layout file.

```xml
<com.doodle.android.chips.ChipsView
    android:id="@+id/chipsView"
    android:layout_width="match_parent"
    android:layout_height="wrap_content" />
```

### Customize

**Layout**

Include ```xmlns:app="http://schemas.android.com/apk/res-auto"``` and customize your layout file.

```xml
<com.doodle.android.chips.ChipsView
	android:id="@+id/chipsView"
	android:layout_width="match_parent"
	android:layout_height="wrap_content"
	app:cv_max_height="120dp"
	app:cv_vertical_spacing="2dp"
	app:cv_bg_color="#f00"
	app:cv_bg_color_clicked="#0f0"
	app:cv_color="#00f"
	app:cv_color_clicked="#721"
	app:cv_text_color="#199"
	app:cv_text_color_clicked="#180"
	app:cv_bg_color_indelible="#f00"
	app:cv_text_color_indelible="#0f0"
	app:cv_icon_placeholder="@drawable/ic_bug_report_24dp"
	app:cv_icon_placeholder_tint="#06f"
	app:cv_icon_delete="@drawable/ic_close_24dp"
	app:cv_text_hint="This is the hint text"
	app:cv_chips_margin="2dp"
```
======
Find the View in your Activity or Fragment class.

```java
mChipsView = (ChipsView) findViewById(R.id.chipsView);
```

**Listener**

The ChipsView provides a listener to interact with your data.

```java
mChipsView.setChipsListener(new ChipsView.ChipsListener() {
    @Override
    public void onChipAdded(ChipsView.Chip chip) {
        // chip added
    }

@Override
    public void onChipDeleted(ChipsView.Chip chip) {
        // chip deleted
    }

@Override
    public void onTextChanged(CharSequence text) {
        // text was changed
    }
            
    @Override
    public boolean onInputNotRecognized(String text) {
        // return true to delete the input
        return false; // keep the typed text
    }
});
```

**Add a new chip**

```java
mChipsView.addChip(email, imgUrl, contact);
```

**Add a non-removable chip.**

```java
mChipsView.addChip(email, imgUrl, contact, true);
```

**Remove a chip**

```java
mChipsView.removeChipBy(contact);
```

**Add Custom chip validator**

```java
mChipsView.setChipsValidator(new ChipsView.ChipValidator() {
    @Override
    public boolean isValid(Contact contact) {
        return true;
    }
});
```

<p>
<img src="./images/chip_error.png" title="Chip Error" width="80%" />
</p>

## Apps with Android chips:

* [Doodle](https://doodle.com) Android App: [Play Store](https://play.google.com/store/apps/details?id=com.doodle.android)

## License

Copyright (C) 2016 Doodle AG.
 
    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.