ExpandableTextView 常见问题 7 大清单按钮不显示、动画错乱、状态丢失的解决方案【免费下载链接】ExpandableTextViewAndroid TextView that can expand and collapse.项目地址: https://gitcode.com/gh_mirrors/expand/ExpandableTextViewExpandableTextView是一款轻量级 Android 组件库让普通TextView一键实现展开/收起效果长文本默认折叠为若干行底部出现展开按钮点击后带动画平滑展开再次点击可收起。本文整理了 7 个新手最常踩的坑——按钮不显示、动画错乱、列表中状态丢失等并给出逐一排查与解决思路。一、先弄懂原理排查才有方向 组件内部其实由两个TextView组成一个展示正文一个展示展开/收起按钮。核心逻辑位于 ExpandableTextView.java默认折叠行数8 行MAX_COLLAPSED_LINES动画时长300ms只有当文本实际行数超过折叠行数时才会显示展开按钮组件初始可见性为GONE必须调用组件自身的setText()才会显示内部布局为 expandabletextview.xml仅支持垂直方向。理解这四点下文 7 个问题基本都能自己对号入座。二、问题 1展开按钮不显示怎么办这是被提问最多的问题按出现频率从高到低排查排查项说明① 没有调用组件的setText()只对组件调用setText()如果拿到内部TextView单独设文本onMeasure的折叠判断不会生效② 文本行数 ≤ 折叠行数比如设了maxCollapsedLines4但文本只有 3 行按钮永远不会出现③ 文本为空空文本时组件会自动GONE属正常设计④ 方向设置错误组件只支持垂直方向设置水平方向会直接抛异常解决确认通过((ExpandableTextView) findViewById(R.id.tv)).setText(...)设置文本并把maxCollapsedLines调到小于文本实际行数即可。三、问题 2展开/收起动画错乱、跳变常见原因与对策快速连续点击组件在动画期间会通过onInterceptTouchEvent拦截所有触摸事件防止动画中二次触发。如果你自己又加了点击监听覆盖了这个逻辑就会出现高度跳变——请保持组件默认的点击接管方式。动画时长不合适用 XML 属性animDuration调整默认 300ms单位是毫秒例如app:animDuration200。外部强制修改高度不要在外部对组件设置固定layout_height请保持wrap_content高度由组件内部动画接管。属性完整定义可参考 attrs.xml。四、问题 3ListView 里展开状态丢失组件在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_widthmatch_parent android:layout_heightwrap_content app:maxCollapsedLines4 /me.chensir.expandabletextview.ExpandableTextView⚠️ 注意如果实际行数不超过该值展开按钮不会出现这是设计行为见问题 1 的排查表。七、问题 6如何监听展开/收起结果组件提供回调接口OnExpandStateChangeListener在动画结束后触发注意不是点击瞬间expandableTextView.setOnExpandStateChangeListener( (textView, isExpanded) - { /* isExpandedtrue 表示已展开 */ });适合用来同步刷新展开全文链接、埋点统计或联动其他 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只允许垂直方向 提示项目 README 注明已停止维护功能以 README.md 中列出的属性为准遇到问题优先对照本文速查表自查。【免费下载链接】ExpandableTextViewAndroid TextView that can expand and collapse.项目地址: https://gitcode.com/gh_mirrors/expand/ExpandableTextView创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考