ExpandableTextView 常见问题 7 大清单：按钮不显示、动画错乱、状态丢失的解决方案-平芜编程栈

ExpandableTextView 常见问题 7 大清单：按钮不显示、动画错乱、状态丢失的解决方案

【免费下载链接】ExpandableTextViewAndroid TextView that can expand and collapse.项目地址: https://gitcode.com/gh_mirrors/expand/ExpandableTextView

ExpandableTextView是一款轻量级 Android 组件库，让普通TextView一键实现展开/收起效果：长文本默认折叠为若干行，底部出现"展开"按钮，点击后带动画平滑展开，再次点击可收起。本文整理了 7 个新手最常踩的坑——按钮不显示、动画错乱、列表中状态丢失等，并给出逐一排查与解决思路。

一、先弄懂原理，排查才有方向 🧭

组件内部其实由两个TextView组成：一个展示正文，一个展示"展开/收起"按钮。核心逻辑位于 ExpandableTextView.java：

默认折叠行数8 行（MAX_COLLAPSED_LINES），动画时长300ms；
只有当文本实际行数超过折叠行数时，才会显示展开按钮；
组件初始可见性为GONE，必须调用组件自身的setText()才会显示；
内部布局为 expandabletextview.xml，仅支持垂直方向。

理解这四点，下文 7 个问题基本都能自己对号入座。

二、问题 1：展开按钮不显示怎么办？

这是被提问最多的问题，按出现频率从高到低排查：

排查项	说明
① 没有调用组件的`setText()`	只对组件调用`setText()`；如果拿到内部`TextView`单独设文本，`onMeasure`的折叠判断不会生效
② 文本行数 ≤ 折叠行数	比如设了`maxCollapsedLines="4"`但文本只有 3 行，按钮永远不会出现
③ 文本为空	空文本时组件会自动`GONE`，属正常设计
④ 方向设置错误	组件只支持垂直方向，设置水平方向会直接抛异常

解决：确认通过((ExpandableTextView) findViewById(R.id.tv)).setText(...)设置文本，并把maxCollapsedLines调到小于文本实际行数即可。

三、问题 2：展开/收起动画错乱、跳变

常见原因与对策：

快速连续点击：组件在动画期间会通过onInterceptTouchEvent拦截所有触摸事件，防止动画中二次触发。如果你自己又加了点击监听覆盖了这个逻辑，就会出现高度跳变——请保持组件默认的点击接管方式。
动画时长不合适：用 XML 属性animDuration调整（默认 300ms），单位是毫秒，例如app:animDuration="200"。
外部强制修改高度：不要在外部对组件设置固定layout_height，请保持wrap_content，高度由组件内部动画接管。

属性完整定义可参考 attrs.xml。

四、问题 3：ListView 里展开状态丢失？

组件在ListView中复用（ViewHolder 复用）时，item 滚出屏幕再回来，展开状态会被重置。这不是 bug，而是需要用带状态版本的setText：

// 三参版本：自动按 position 存取折叠状态 expandableTextView.setText(text, sparseBooleanArray, position);

官方示例的列表适配器 SampleTextListAdapter.java 就是标准写法：Adapter 中持有一个SparseBooleanArray，在getView里把position传进去，滚动回收后状态依然保留。列表页入口见 ListActivity.java。

五、问题 4：如何自定义"展开/收起"按钮的图标与文案？

组件在 activity_main.xml 中演示了三种按钮位置（DrawableAndTextGravity取left/center/right），可用属性一览：

属性	作用
`expandText`/`collapseText`	自定义"展开""收起"文案
`expandDrawable`/`collapseDrawable`	替换默认上下箭头图标
`expandCollapseTextColor`	按钮文字颜色
`DrawableAndTextGravity`	按钮相对正文的对齐方式
`contentTextColor`/`contentTextSize`/`contentLineSpacingMultiplier`	正文字体颜色、字号、行距

例如设置app:expandText="更多"后，按钮就会显示为"更多 ▾"。

六、问题 5：默认折叠 8 行太长/太短怎么调？

用maxCollapsedLines属性控制折叠时最多显示几行：

<me.chensir.expandabletextview.ExpandableTextView android:layout_width="match_parent" android:layout_height="wrap_content" app:maxCollapsedLines="4"> </me.chensir.expandabletextview.ExpandableTextView>

⚠️ 注意：如果实际行数不超过该值，展开按钮不会出现（这是设计行为，见问题 1 的排查表）。

七、问题 6：如何监听展开/收起结果？

组件提供回调接口OnExpandStateChangeListener，在动画结束后触发（注意：不是点击瞬间）：

expandableTextView.setOnExpandStateChangeListener( (textView, isExpanded) -> { /* isExpanded=true 表示已展开 */ });

适合用来同步刷新"展开全文"链接、埋点统计或联动其他 UI。

八、问题 7：布局报错 "only supports Vertical Orientation"？

如果你（或第三方库）把组件方向设为水平，会抛出IllegalArgumentException。该组件继承LinearLayout并强制垂直排列正文与按钮，请勿修改方向；如需并排展示，请在父布局中把两个组件横向排列。

快速上手：两步集成 ⚡

克隆仓库，将expandabletextview模块引入你的项目：

git clone https://gitcode.com/gh_mirrors/expand/ExpandableTextView

布局中声明组件，代码中设文本即可：

((ExpandableTextView) findViewById(R.id.tv)).setText("你的长文本");

完整可运行示例在sample模块：主页 MainActivity.java 演示三种按钮对齐方式，列表页演示状态保持。

常见问题速查表 ✅

症状	定位	一句话方案
按钮不显示	问题 1	用组件`setText()`且行数超过`maxCollapsedLines`
动画跳变	问题 2	别覆盖触摸拦截，保持`wrap_content`
列表状态丢失	问题 3	改用三参`setText(text, status, position)`
按钮样式丑	问题 4	配置`expandText`/`expandDrawable`等属性
折叠行数不对	问题 5	调`maxCollapsedLines`
需要联动 UI	问题 6	注册`OnExpandStateChangeListener`
抛方向异常	问题 7	只允许垂直方向