ExpandableTextView

ExpandableTextView

实现类似微博内容，@用户，链接高亮，@用户和链接可点击跳转，可展开和收回的TextView。觉得好用别忘了star哦，你的star是对我最大的激励

全平台国际化话翻译解决方案

项目国际化翻译解决方案，支持Android、iOS、Flutter、前端Vue、后端PHP等等，点几下按钮就能实现翻译内容的自动抓取和翻译后文件的自动生成，适合各类场景下的国际化需求。详情请查看：https://github.com/MZCretin/Eva-Translate 欢迎star

需求解决系列之-【系列工具概览】

此系列是大道至简的起始，将一系列简单恶心的操作封装起来，框架么，可以败絮其中，但一定要金絮其外！

快速使用

Gradle:

implementation 'com.github.MZCretin:ExpandableTextView:v1.6.1'

// if u use AndroidX, use the following

implementation 'com.github.MZCretin:ExpandableTextView:v1.6.1-x'

更新日志

• 2019-07-04 12:06:06更新，如果你需要监听展开和回收的时间监听，但是不需要控件真正的执行展开和回收操作，你可以在添加展开和收回操作的时候置顶是否需要真正执行展开和回收操作，具体效果可以参考效果图第2条的第二个，依赖版本请使用tag版本v1.6.1,查看说明

  java复制

  implementation 'com.github.MZCretin:ExpandableTextView:v1.6.1'

• 2019-05-20 15:14:04更新，如果你需要展示链接但是不想让链接自动转换成"网页链接"的形式，你可以禁用自动转换功能；如果你希望知道是否满足展开/收起的条件，添加一个监听就好了，依赖版本请使用tag版本1.6.0，查看说明

  java复制

  implementation 'com.github.MZCretin:ExpandableTextView:v1.6.0'

• 2019-03-14 10:25:57更新，修复在有些手机上偶尔会出现白屏，加载不出内容的情况，依赖版本请使用tag版本1.5.3

  java复制

  implementation 'com.github.MZCretin:ExpandableTextView:v1.5.3'

• 2018-10-09 17:20:45 更新，新增对展开和回收的点击事件监听，依赖版本请使用tag版本v1.5.2

  java复制

  implementation 'com.github.MZCretin:ExpandableTextView:v1.5.2'

• 2018-09-28 09:37:28 更新，优化了将"展开"和"收回"固定最右显示时中间空格数量的计算方式，依赖版本请使用tag版本v1.5.1，查看说明

  java复制

  implementation 'com.github.MZCretin:ExpandableTextView:v1.5.1'

• 2018-09-27 09:18:14 更新

  • 修复了不添加事件监听，点击链接会直接打开百度页面；
  • 在demo中添加自定义设置显示文本的功能，您可以自己设置需要显示的文本，然后查看对应的显示效果；
  • 新增了"展开"和"收回"按钮始终居右的功能，具体效果请查看效果图的第9条，依赖版本请使用tag版本v1.5，查看说明
  java复制

  implementation 'com.github.MZCretin:ExpandableTextView:v1.5'

• 2018-09-22 23:32:16 更新，新增自定义规则解析，具体效果请查看效果图的第10条，依赖版本请使用tag版本v1.4，查看说明

  java复制

  implementation 'com.github.MZCretin:ExpandableTextView:v1.4'

• 2018-09-21 11:51:24 更新，优化了demo的代码逻辑和注释

• 2018-09-21 08:45:13 更新，修复了自定义设置展开和收回内容无效的问题，依赖请使用tag版本v1.3.1

  java复制

  implementation 'com.github.MZCretin:ExpandableTextView:v1.3.1'

• 2018-09-20 16:31:13 更新

  • 一、提供了在RecyclerView中使用的时候，对之前状态的保存的功能支持，查看说明；
  • 二、新增对@用户和链接的处理，用户可以设置不对这些内容进行识别，仅仅使用展开和收回功能；
  • 三、优化的demo的效果，请大家重新下载apk进行体验。
  • 四、如果你没有设置对链接的监听，会默认调用系统浏览器打开链接
  • 五、支持语言国际化
  • 六、最新版请使用v1.3

• 2018-09-03 17:39:56 修复一些bug，链接sheSpan位置错误，未生成release，等待下次修复其他bug一起打tag依赖包，使用请本地依赖使用

• 2018-08-31 17:31:56 优化设置padding对宽度造成的影响，依赖请使用tag版本v1.2

  java复制

  implementation 'com.github.MZCretin:ExpandableTextView:v1.2'

• 2018-08-31 11:21:22 在V1.0的基础上进行了优化，依赖请使用tag版本v1.1

  java复制

  implementation 'com.github.MZCretin:ExpandableTextView:v1.1'

实现效果：

下面是RecyclerView中的样式，可以保留之前展开和收回的状态

使用方式：

Step 1. Add the JitPack repository to your build file

Add it in your root build.gradle at the end of repositories:

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

Step 2. Add the dependency

dependencies {
	        implementation 'com.github.MZCretin:ExpandableTextView:请使用最新版本'
	}

demo下载

Demo下载

扫描二维码下载：

代码说明

• 以下属性都可以在xml中设置

…

• java代码

…

新特性额外说明

V1.6.1:2019-07-04 12:02:05 更新了如下特性 版本v1.6.1+可以正常使用

如果你需要监听展开和回收的时间监听，但是不需要控件真正的执行展开和回收操作，你可以在添加展开和收回操作的时候置顶是否需要真正执行展开和回收操作，具体效果可以参考效果图第2条的第二个控件效果：

//添加展开和收回操作 只触发点击 不真正触发展开和收回操作
        expandableTextView.setExpandOrContractClickListener(type -> {
            if (type.equals(StatusType.STATUS_CONTRACT)) {
                Toast.makeText(MainActivity.this, "收回操作，不真正触发收回操作", Toast.LENGTH_SHORT).show();
            } else {
                Toast.makeText(MainActivity.this, "展开操作，不真正触发展开操作", Toast.LENGTH_SHORT).show();
            }
        },false);

V1.6:2019-05-20 15:19:10 更新了如下特性 版本v1.6+可以正常使用

如果你需要展示链接但是不想让链接自动转换成"网页链接"的形式，你可以禁用自动转换功能，具体效果可以参考效果图第11条；如果你希望知道是否满足展开/收起的条件，添加一个监听就好了：

//监听是否初始化完成 在这里可以获取是否支持展开/收回
        views[10].setOnGetLineCountListener(new ExpandableTextView.OnGetLineCountListener() {
            @Override
            public void onGetLineCount(int lineCount, boolean canExpand) {
                Toast.makeText(MainActivity.this, "行数：" + lineCount + "  是否满足展开条件：" + canExpand, Toast.LENGTH_SHORT).show();
            }
        });

V1.5: 2018-09-27 09:20:28 更新了如下特性 版本v1.5+可以正常使用

如果你需要将"展开"和"收回"始终居右显示，你需要开启它，具体效果可以参考效果图第9条

//需要先开启始终靠右显示的功能
views[8].setNeedAlwaysShowRight(true);

//或者在xml中开启
app:ep_need_always_showright="true"

V1.4：2018-09-22 23:32:16 更新了如下特性 版本v1.4+可以正常使用

如果你觉得目前@用户和网页链接两种形式并不能完全满足你的业务，那么我提供了一个新的自定义规则给你，让你可以更加灵活的去适应自己的业务。

比如上面实现效果的第9条中，我们通过自定义规则对文字中的"--习大大"和"Github地址"进行了自定义规则，让其高亮显示并且可以添加触发相应的事件。

具体做法是：

• 在一段文字中将你需要处理的文字做上特殊标记，，标记的规则就是[显示的内容](动作)，这个标记的规则可以交给后台给你处理，或者你自己处理也可以。
• 比如上文中的"Github地址"，那么标记后就是这样的 [Github地址]( https://github.com/MZCretin/ExpandableTextView )，这样在控件中显示的就只是Github地址，可以点击，当点击之后，会将"显示的内容"和"动作"都通过接口回调的方式回传给调用者自己处理；
• 再比如上文中的"--习大大"，那么标记后就是这样的 [--习大大](schema_jump_userinfo)，这样控件中只会显示"--习大大"，然后根据后面的动作去做处理，比如这是一个用户，可以跳转到这个用户的个人详情页面。
• 默认不会对自定义规则进行解析，如需开启，请开启此功能：
  复制

  
  app:ep_need_self="true"

V1.3：2018-09-20 16:31:13 更新了如下特性 版本v1.3+可以正常使用

如果你希望在RecyclerView(或者ListView)中使用，请认真阅读demo中在RecyclerView中的使用，细节都在注释中。

如果你需要在列表中保留之前的展开或收回状态，特殊说明的有以下几点：

• 一、实现 ExpandableStatusFix
• 二、在你的model中定义一个 private StatusType status;
• 三、实现对应的方法，将你刚刚定义的status返回，
• 四、并在给ExpandableTextView设置内容之前，调用bind方法

实现思路讲解

简书： 【需求解决系列之三】Android 自定义可展开收回的ExpandableTextView

掘金： 【需求解决系列之三】Android 自定义可展开收回的ExpandableTextView