MaterialTextView

Material Design Text View that is displayed in a translucent box. Based on the Material Design guidelines.

Why Does This Exist?

Great Solutions already exist for Material Design EditText fields, but I wanted a solution for static data, or data that only gets changed via an action (such as a click, or date selection). The layout only consists of a few Views, but having a lot of them can result in a very inflated layout file and as such I'd much prefer adding a single View.

Installation

To get MaterialTextView into your project, add the repository to your build.gradle.

Gradle

1. Add the JitPack repository to your projects build.gradle:

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

2. Add the dependency to your modules build.gradle :

dependencies {
  implementation 'com.github.onemandan:MaterialTextView:0.0.5'
}

Maven

1. Add the JitPack repository to your build file:

<repositories>
  <repository>
    <id>jitpack.io</id>
    <url>https://jitpack.io</url>
  </repository>
</repositories>

2. Add the dependency:

<dependency>
  <groupId>com.github.onemandan</groupId>
  <artifactId>MaterialTextView</artifactId>
  <version>0.0.5</version>
</dependency>

Updates

0.0.5

• Added ability to set error, mtv_errorTextColour default to FF1744 (A400 Red)
• Added single line, sets maxLine of content to 1 (or Integer.MAX_VALUE if false), default to false
• Error gets turned off after setContentText, or by passing null to setError
• Passing an empty string to setError keeps current settings of helper text

0.0.4

• Added dense spacing, mtv_useDenseSpacing default to false
• Added nullable animation to content text

0.0.3

• Added custom clip View for background
• Edited current layout to use clip View, selectable ripple now respects rounded corners

0.0.2

• Edited mtv_keepLabelSpacing default to false
• Added mtv_backgroundColour and accessors
• Added Label/Content/Helper text colour accessors
• Added keep Label/Helper accessors

Usage

<uk.co.onemandan.materialtextview.MaterialTextView
  android:id="@+id/mtv_id"
  android:layout_width="wrap_content"
  android:layout_height="wrap_content"
  app:mtv_labelText="label"
  app:mtv_contentText="content"
  app:mtv_helperText="helper"
  app:mtv_labelTextColour="?android:textColorSecondary"
  app:mtv_contentTextColour="?android:textColorPrimary"
  app:mtv_helperTextColour="?colorAccent"/>

Attributes & Methods

Text

Attribute	Method Counterparts	Description	Default
app:mtv_labelText	void setLabelText(CharSequence text) CharSequence getLabelText()	The text for the label at the top of the view	Empty String
app:mtv_contentText	void setContentText(CharSequence text) CharSequence getContentText()	The text for the content of the view	Empty String
app:mtv_helperText	void setHelperText(CharSequence text) CharSequence getHelperText()	The text for the helper at the bottom of the view	Empty String

Colour

Attribute	Method Counterparts	Description	Default
app:mtv_labelTextColour	void setLabelTextColour(int colour) int getLabelTextColour()	The text colour for the label at the top of the view	?android:textColorSecondary
app:mtv_contentTextColour	void setContentTextColour(int colour) int getContentTextColour()	The text colour for the content of the view	?android:textColorPrimary
app:mtv_helperTextColour	void setHelperTextColour(int colour) int getHelperTextColour()	The text colour for the helper at the bottom of the view	?colorAccent
app:mtv_errorTextColor	void setErrorTextColour(int colour) int getErrorTextColour	The text colour of the label and helper text when using setError	A400 Red (#FF1744)
app:mtv_backgroundColour	void setBackgroundColour(int colour) int getBackgroundColour()	The colour of the MaterialTextView root view	6% Black (#0f000000)

Miscellaneous

Attribute	Method Counterparts	Description	Default
app:mtv_keepLabelSpacing	void setKeepLabelSpacing(boolean keepLabelSpacing) boolean getKeepLabelSpacing()	In the event that the label text is empty, whether or not the spacing should be kept by setting the respective TextView to GONE or VISIBLE	false
app:mtv_keepHelperSpacing	void setKeepHelperSpacing(boolean keepLabelSpacing) boolean getKeepHelperSpacing()	In the event that the helper text is empty, whether or not the spacing should be kept by setting the respective TextView to GONE or VISIBLE	false
app:mtv_useDenseSpacing	void setUseDenseSpacing(boolean useDenseSpacing) boolean getUseDenseSpacing()	Use denser vertical spacing for smaller displays	false
app:mtv_singleLine	void setSingleLine(boolean singleLine) boolean getSingleLine()	Sets content text maxLines to 1 or Integer.MAX_VALUE depending on boolean	false

Listeners

You can implement a click listener to the MaterialTextView:

materialTextView.setOnClickListener(new View.OnClickListener() {
  @Override
  public void onClick(View v) { ... }
});

In the event a click listener is added, the following attributes are set to the View:

setForeground(...[?selectableItemBackground]...);
setClickable(true);
setFocusable(true);

When removing the click listener, the attributes of the View are removed and the foreground restored to the previous state. To Remove the click listener:

materialTextView.setOnClickListener(null);

License

MIT License

Copyright (c) 2018 Daniel Hart

Permission is hereby granted, free of charge, to any person obtaining a copy
of this software and associated documentation files (the "Software"), to deal
in the Software without restriction, including without limitation the rights
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
copies of the Software, and to permit persons to whom the Software is
furnished to do so, subject to the following conditions:

The above copyright notice and this permission notice shall be included in all
copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
SOFTWARE.