Material Chip view. Can be used as tags for categories, contacts or creating text clouds. This library can be an alternative for Material Chip from Jetpack library. | ![]() |
---|
Android Arsenal | |
---|---|
MaterialChipVersion | |
ComposeChipVersion |
Add following line of code to your project level gradle file
repositories {
mavenCentral()
}
Add following line of code to your module(app) level gradle file
implementation 'com.robertlevonyan.view:MaterialChipView:<MaterialChipVersion>'
implementation("com.robertlevonyan.view:MaterialChipView:$MaterialChipVersion")
<dependency>
<groupId>com.robertlevonyan.view</groupId>
<artifactId>MaterialChipView</artifactId>
<version>MaterialChipVersion</version>
<type>pom</type>
</dependency>
implementation("com.robertlevonyan.compose:materialchip:$ComposeChipVersion")
<com.robertlevonyan.views.chip.Chip
android:id="@+id/chip"
android:layout_width="wrap_content"
android:layout_height="wrap_content"
android:text="@string/customTitle" />
app:mcv_closable="true"
app:mcv_selectable="true"
![]() |
![]() |
---|
app:mcv_chipIcon="@drawable/customIcon"
app:mcv_backgroundColor="@color/customChipBackgroundColor"
app:mcv_closeColor="@color/customCloseIconColor"
app:mcv_selectedBackgroundColor="@color/customSelectedChipColor"
app:mcv_textColor="@color/customTitleColor"
![]() |
![]() |
---|
Custom Atributes | Description |
---|---|
app:mcv_textColor |
Custom color for text label |
app:mcv_backgroundColor |
Custom background color |
app:mcv_selectedBackgroundColor |
Custom background color when selected |
app:mcv_chipIcon |
Icon resource for Chip |
app:mcv_closable |
Chip with close button |
app:mcv_closeColor |
Custom color for close button |
app:mcv_selectable |
Chip with selection button |
app:mcv_selectedTextColor |
Custom color for label when selected |
app:mcv_cornerRadius |
Change the corner radius of your Chip |
app:mcv_strokeSize |
Add stroke to your Chip |
app:mcv_strokeColor |
Choose a custom stroke color for your Chip |
app:mcv_selectedStrokeSize |
Stroke size when selected |
app:mcv_selectedStrokeColor |
Custom stroke color when selected |
app:mcv_iconText |
Instead of an image create icon from String |
app:mcv_iconTextColor |
Select a color for your String icon |
app:mcv_iconTextBackgroundColor |
Select a background color for String icon |
val chip = findViewById(R.id.chip);
Chip click listener
chip.setOnClickListener { view ->
//Your action here...
}
On Close button click listener
chip.setOnCloseClickListener { view ->
//Your action here...
}
On Icon click listener
chip.setOnIconClickListener { view ->
//Your action here...
}
On Select button click listener
chip.setOnSelectClickListener { view: View, selected: Boolean ->
//Your action here...
}
chip.text = "My awesome Chip" // Set Chip label
chip.chipTextColor = chipTextColor // Set Chip label color
chip.chipBackgroundColor = chipBackgroundColor //Set custom background color
chip.chipSelectedBackgroundColor = chipSelectedBackgroundColor //Set custom background color when selected
chip.chipIcon = myIconDrawable //Set Icon Drawable for Chip
chip.chipIconBitmap = myIconBitmap //Set Icon Bitmap for Chip
chip.closable = true //Set Chip has close button
chip.chipCloseColor = chipCloseColor //Set custom color for close button
chip.chipSelectedCloseColor = chipSelectedCloseColor //Set custom color for close button on selected state
chip.selectable = false //Set Chip has selection button
chip.chipSelected = true // Set Chip selected
chip.chipSelectedTextColor = chipSelectedTextColor //Set custom color for label when selected
chip.cornerRadius = 5 // Set corner radius of your Chip
chip.strokeSize = 2 // Set width of stroke
chip.strokeColor = strokeColor // Set stroke color for your Chip
chip.selectedStrokeSize = 2 // Set width of stroke when selected
chip.selectedStrokeColor = selectedStrokeColor // Set stroke color for your Chip when selected
chip.setIconText(text, iconTextColor, iconTextBackgroundColor); // Set Chip icon text, text color and background color (in case of Kotlin iconTextColor and iconTextBackgroundColor have default value of 0)
chip.chipHorizontalPadding = 10 // Set horizontal padding for chip
setContent {
Box(modifier = Modifier.fillMaxWidth()) {
MaterialChip(
text = "Some Text",
chipIcon = ChipIconRes(icon = R.drawable.android), // ChipIconBitmap or ChipIconDrawable
interaction = ChipInteraction.Closable, // Selectable, SelectableWithoutIcon or None
strokeSize = 1.dp,
selectedStrokeSize = 2.dp,
strokeColor = Color.Red,
selectedStrokeColor = Color.Blue,
onSelectClick = { selected ->
// your code here
},
onIconClick = {
// your code here
},
onChipClick = {
// your code here
},
onCloseClick = {
// your code here
}
)
}
}
Also there is a MaterialChipGroup
available for Jetpack Compose version
setContent {
Box(modifier = Modifier.fillMaxWidth()) {
MaterialChipGroup(
items = listOf("Chip1", "Chip2", "Chip3"),
createTitle = { it }, //returns a String for the title
initialSelectedElementIndex = 1, // default value is -1 (means nothing is selected)
onItemSelected = { position, element ->
// do something
},
// the rest is for Chip appearance
interaction = ChipInteraction.Selectable,
strokeSize = 1.dp,
selectedStrokeSize = 2.dp,
strokeColor = Color.Red,
selectedStrokeColor = Color.Blue,
backgroundColor = Color.Red,
selectedBackgroundColor = Color.Blue,
)
}
}
Jetpack Compose support added Chip Group added for JetpackCompose
Update to Java 11 SDK 31 ready Minor updates
Migration to mavenCentral
Minor changes, some missing parts pushed
New update, now it is possible to make chip selectable without selection icon
Minor changes, some missing parts pushed
New version of the library. Fully rewritten with Kotlin and AndroidX ready 🤩
General bug fixed
Selection option added
Icon text issue fixed
Updated version of Material Chip View: - the attribute names are changed to escape conflicts with other libs - added new features like customizable corner radius and stroke - recreation issue fixed for post Lollipop versions
Recreation issues are fixed
First version of library
- Email: [email protected]
- Website: https://robertlevonyan.com/
- Medium: https://medium.com/@RobertLevonyan
- Twitter: https://twitter.com/@RobertLevonyan
- Facebook: https://facebook.com/robert.levonyan
- Google Play: https://play.google.com/store/apps/dev?id=5477562049350283357
Material Chip View©
Copyright 2017 Robert Levonyan
Url: https://github.com/robertlevonyan/materialChipView
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.