ExpandableTextView

An Expandable TextView for Android written in Kotlin. The main ideia was study how create a library in Android and deploy on Maven Central Repository.

Table of Contents

• Demo project
• Getting started
• Features
• Usage
  • XML
  • Programmatically
• Contributing
• License
• Acknowledgments

Demo Project

ExpandableTextView is a custom TextView that allows long text to be collapsed or expanded, either inline within the layout or via a popup dialog. Take a look at the demo project.

Getting Started

The library is included in Maven Central Repository, so just add this dependency to your module level gradle.build:

dependencies {
    implementation 'io.github.glailton.expandabletextview:expandabletextview:$LatestVersion'
}

Current latest version is:

Features

• Collapsible/expandable text with animation.
• Two expansion modes: layout-based and popup.
• Custom "read more" / "read less" labels.
• Ellipsized text with custom color and underline.
• Optional fade animation on expand/collapse.
• Supports usage in XML, programmatically, or with data binding.

---

XML Attributes

| Attribute | Type | Description | |------------------------|---------|-----------------------------------------------------------------------------| | collapsedLines | Integer | Number of lines to show when collapsed. Default is 3. | | isExpanded | Boolean | Initial expansion state. Default is false. | | animDuration | Integer | Animation duration in milliseconds. Default is 300. | | readMoreText | String | Text shown to expand the view. Default is "Read more". | | readLessText | String | Text shown to collapse the view. Default is "Read less". | | expandType | Enum | Either layout or popup. Default is layout. | | ellipsizeTextColor | Color | Color of the ellipsis and expand label. Default is Color.BLUE. | | isUnderlined | Boolean | Whether the expand/collapse label should be underlined. Default is false. | | fadeAnimationEnabled | Boolean | Enable or disable fade animation. Default is true. |

---

Usage

In XML

Xml snippet:

<io.github.glailton.expandabletextview.ExpandableTextView
        android:id="@+id/expand_tv"
        android:layout_width="match_parent"
        android:layout_height="wrap_content"
        expandableTextView:collapsedLines="3"
        expandableTextView:fadeAnimationEnabled="true"
        expandableTextView:animDuration="500"
        expandableTextView:readMoreText="Leia mais"
        expandableTextView:readLessText="Leia menos"
        expandableTextView:textMode="line"
        expandableTextView:isExpanded="true"
        app:expandType="layout"
        android:text="@string/very_long_text" />

Programmatically

        binding.expandTvProg
          .setAnimationDuration(500)
          .setFadeAnimationEnabled(true)
          .setReadMoreText("View More")
          .setReadLessText("View Less")
          .setCollapsedLines(3)
          .setIsExpanded(true)
          .setIsUnderlined(true)
          .setExpandType(EXPAND_TYPE_POPUP)
          .setEllipsizedTextColor(ContextCompat.getColor(this, R.color.purple_200))

        binding.expandTvProg.text =
            "Lorem ipsum dolor sit amet, consectetur adipiscing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua." +
                    "Ut enim ad minim veniam, quis nostrud exercitation ullamco laboris nisi ut aliquip ex ea commodo consequat." +
                    "Duis aute irure dolor in reprehenderit in voluptate velit esse cillum dolore eu fugiat nulla pariatur." +
                    "Excepteur sint occaecat cupidatat non proident, sunt in culpa qui officia deserunt mollit anim id est laborum."

        binding.expandTvProg.setOnClickListener {
            binding.expandTvProg.toggle()
            if (binding.expandTvVeryLong.isExpanded && binding.expandTvVeryLong.expandType == EXPAND_TYPE_LAYOUT)
                binding.expandTvVeryLong.toggle()
        }

Contributing

If you wish to send a pull request, please make sure to checkout from main branch and merge with main branch as well.

License

This project is licensed under the MIT License - see the LICENSE file for details.

Acknowledgments

This library was based on: viewmore-textview.