Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/mzcretin/expandabletextview

实现类似微博内容，@用户，链接高亮，@用户和链接可点击跳转，可展开和收回的TextView
https://github.com/mzcretin/expandabletextview

expandabletextview textview

Last synced: 4 days ago
JSON representation

实现类似微博内容，@用户，链接高亮，@用户和链接可点击跳转，可展开和收回的TextView

Host: GitHub
URL: https://github.com/mzcretin/expandabletextview
Owner: MZCretin
Created: 2018-08-17T13:34:46.000Z (over 6 years ago)
Default Branch: master
Last Pushed: 2024-01-11T01:46:21.000Z (12 months ago)
Last Synced: 2024-12-16T06:02:36.500Z (18 days ago)
Topics: expandabletextview, textview
Language: Java
Homepage:
Size: 36.3 MB
Stars: 1,417
Watchers: 20
Forks: 164
Open Issues: 44
Metadata Files:
- Readme: README.md
- Funding: .github/FUNDING.yml

Awesome Lists containing this project

README

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

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

-------

### [需求解决系列之-【系列工具概览】](https://juejin.im/post/5ed6174f51882542fb06d850)
此系列是大道至简的起始，将一系列简单恶心的操作封装起来，框架么，可以败絮其中，但一定要金絮其外！

### 快速使用

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,[查看说明](#v1612019-07-04-120205-更新了如下特性-版本v161可以正常使用)

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

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

```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下载](https://raw.githubusercontent.com/MZCretin/ExpandableTextView/master/extra/demo.apk)

扫描二维码下载：

### 代码说明

+ 以下属性都可以在xml中设置
```xml

//布局文件中使用可选也可以在代码中设置

app:ep_max_line="4"

app:ep_need_link="true"

app:ep_need_mention="true"

app:ep_need_contract="true"

app:ep_need_animation="true"

app:ep_expand_color="@color/colorAccent"

app:ep_contract_text="收回"

app:ep_end_color="@color/colorAccent"

app:ep_expand_text="展开"

app:ep_link_color="@color/colorAccent"

app:ep_link_res="@color/colorAccent"

app:ep_contract_color="@color/colorAccent"

app:ep_mention_color="@color/colorAccent"

app:ep_need_convert_url="false"

app:ep_need_self="true"

app:ep_self_color="@color/colorAccent"

app:ep_need_always_showright="true"

app:ep_need_expand="false" />

```

+ java代码
```java
/**
* 正常的使用
*/
ExpandableTextView expandableTextView = findViewById(R.id.ep_01);
//需要显示的内容
String yourText = " 我所认识的中国，强大、友好。@奥特曼 “一带一路”经济带带动了沿线国家的经济发展，促进我国与他国的友好往来和贸易发展，可谓“双赢”。http://www.baidu.com 自古以来，中国以和平、友好的面孔示人。汉武帝派张骞出使西域，开辟丝绸之路，增进与西域各国的友好往来。http://www.baidu.com 胡麻、胡豆、香料等食材也随之传入中国，汇集于中华美食。@RNG 漠漠古道，驼铃阵阵，这条路奠定了“一带一路”的基础，让世界认识了中国。";
//将内容设置给控件
expandableTextView.setContent(yourText);
//xml中的属性也可以通过代码设置比如
expandableTextView.setmNeedExpend(true);
//还有很多。。。。
//添加点击监听
expandableTextView.setLinkClickListener(new ExpandableTextView.OnLinkClickListener() {
@Override
public void onLinkClickListener(LinkType linkType, String content,String selfContent) {
//根据类型去判断
if (type.equals(LinkType.LINK_TYPE)) {
Toast.makeText(MainActivity.this, "你点击了链接内容是：" + content, Toast.LENGTH_SHORT).show();
} else if (type.equals(LinkType.MENTION_TYPE)) {
Toast.makeText(MainActivity.this, "你点击了@用户内容是：" + content, Toast.LENGTH_SHORT).show();
} else if (type.equals(LinkType.SELF)) {
Toast.makeText(MainActivity.this, "你点击了自定义规则内容是：" + content + " " + selfContent, Toast.LENGTH_SHORT).show();
}
}
});
//添加展开和收回操作
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();
}
});
//监听是否初始化完成在这里可以获取是否支持展开/收回
expandableTextView.setOnGetLineCountListener(new ExpandableTextView.OnGetLineCountListener() {
@Override
public void onGetLineCount(int lineCount, boolean canExpand) {
Toast.makeText(MainActivity.this, "行数：" + lineCount + " 是否满足展开条件：" + canExpand, Toast.LENGTH_SHORT).show();
}
});
//添加展开和收回操作只触发点击不真正触发展开和收回操作
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.1:2019-07-04 12:02:05 更新了如下特性版本v1.6.1+可以正常使用

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

```java
//添加展开和收回操作只触发点击不真正触发展开和收回操作
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条；如果你希望知道是否满足展开/收起的条件，添加一个监听就好了：

```java
//监听是否初始化完成在这里可以获取是否支持展开/收回
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](https://www.jianshu.com/p/5519fbab6907)

**掘金：** [【需求解决系列之三】Android 自定义可展开收回的ExpandableTextView](https://juejin.im/post/5b876a4de51d4571c5137660)