SelectTextHelper
项目地址:ITxiaoguang/SelectTextHelper
简介: 高仿微信聊天消息列表自由复制文字,双击查看文本内容,用法超级简单~
标签:
掘金地址 github 地址
SelectTextHelper
打造一个全网最逼近微信聊天消息自由复制,双击查看文本内容框架。 汇聚底层TextView
框架、原理并加以整理得出的一个实用的Helper
。 仅用两个类实现便实现如此强大的功能,用法也超级简单。
项目演示
消息页全选 | 消息页自由复制放大镜 |
---|---|
消息页选中文本 | 查看内容 |
---|---|
更多效果图请看掘金
特点功能:
- 支持自由选择文本
- 支持自定义文本有:游标颜色、游标大小、选中文本颜色
- 支持默认全选文字或选 2 个文字
- 支持滑动依然显示弹窗
- 支持放大镜功能
- 支持全选情况下自定义弹窗
- 支持操作弹窗:每行个数、图片、文字、监听回调、弹窗颜色、箭头图片
Demo
如何添加
Gradle 添加:
1.在 Project 的build.gradle
中添加仓库地址
allprojects {
repositories {
...
maven { url "https://jitpack.io" }
}
}
2.在 Module 目录下的build.gradle
中添加依赖
dependencies {
implementation 'com.github.ITxiaoguang:SelectTextHelper:xxx'
}
传送门
主要实现
通过 仿照的例子 并改进弹窗坐标位置、大小加上EventBus
实现
简单用例
1.导入代码
把该项目里的selecttext Module
放入你的项目里面 或者 按照Gradle
添加的步骤导入依赖。
2.给你的TextView
创建Helper
和加监听
SelectTextHelper mSelectableTextHelper=new SelectTextHelper
.Builder(textView)// 放你的 textView 到这里!!
.setCursorHandleColor(0xFF1379D6/*ContextCompat.getColor(mContext, R.color.colorAccent)*/)// 游标颜色 default 0xFF1379D6
.setCursorHandleSizeInDp(24)// 游标大小 单位 dp default 24
.setSelectedColor(0xFFAFE1F4/*ContextCompat.getColor(mContext, R.color.colorAccentTransparent)*/)// 选中文本的颜色 default 0xFFAFE1F4
.setSelectAll(true)// 初次选中是否全选 default true
.setScrollShow(true)// 滚动时是否继续显示 default true
.setSelectedAllNoPop(true)// 已经全选无弹窗,设置了 true 在监听会回调 onSelectAllShowCustomPop 方法 default false
.setMagnifierShow(true)// 放大镜 default true
.setPopSpanCount(5)// 设置操作弹窗每行个数 default 5
.setPopStyle(R.drawable.shape_color_4c4c4c_radius_8/*操作弹窗背景*/, R.drawable.ic_arrow/*箭头图片*/)// 设置操作弹窗背景色、箭头图片
.setSelectTextLength(2)// 首次选中文本的长度,需要设置 setSelectAll(false) default 2
.setPopDelay(100)// 弹窗延迟时间 default 100 毫秒
.addItem(0/*item 的图标*/,"复制"/*item 的描述*/,
()->Log.i("SelectTextHelper","复制")/*item 的回调*/)// 操作弹窗的每个 item
.build();
mSelectableTextHelper.setSelectListener(new SelectTextHelper.OnSelectListener(){
/**
* 点击回调
*/
@Override
public void onClick(View v){
// clickTextView(textView.getText().toString().trim());
}
/**
* 长按回调
*/
@Override
public void onLongClick(View v){
// postShowCustomPop(SHOW_DELAY);
}
/**
* 选中文本回调
*/
@Override
public void onTextSelected(CharSequence content){
// selectedText = content.toString();
}
/**
* 弹窗关闭回调
*/
@Override
public void onDismiss(){
}
/**
* 点击 TextView 里的 url 回调
*/
@Override
public void onClickUrl(String url){
}
/**
* 全选显示自定义弹窗回调
*/
@Override
public void onSelectAllShowCustomPop(){
// postShowCustomPop(SHOW_DELAY);
}
/**
* 重置回调
*/
@Override
public void onReset(){
// SelectTextEventBus.getDefault().dispatch(new SelectTextEvent("dismissOperatePop"));
}
/**
* 解除自定义弹窗回调
*/
@Override
public void onDismissCustomPop(){
// SelectTextEventBus.getDefault().dispatch(new SelectTextEvent("dismissOperatePop"));
}
/**
* 是否正在滚动回调
*/
@Override
public void onScrolling(){
// removeShowSelectView();
}
});
3.demo 中提供了查看文本内容的SelectTextDialog
和 消息列表自由复制MainActivity
查看文本内容方法:
- 该方法比较简单,将
textView
参照步骤 2 放入SelectTextHelper
中,在dismiss
调用SelectTextHelper
的reset()
即可。
@Override
public void dismiss(){
mSelectableTextHelper.reset();
super.dismiss();
}
高仿微信聊天消息列表自由复制方法:
-
recycleView
+adapter
+ 多布局的使用在这里不阐述,请看本项目 demo。 -
为
adapter
里 text 类型ViewHolder
中的textView
参照步骤 2 放入SelectTextHelper
中,注册SelectTextEventBus
。 -
SelectTextEventBus
类特别说明、原理:SelectTextEventBus
在EventBus
基础上加功能。在register
时记录下类和方法,方便在Activity/Fragment Destroy
时unregister
所有SelectTextEventBus
的EventBus
。 -
text 类型
ViewHolder
添加EventBus
监听
/**
* 自定义 SelectTextEvent 隐藏 光标
*/
@Subscribe(threadMode = ThreadMode.MAIN)
public void handleSelector(SelectTextEvent event){
if(null==mSelectableTextHelper){
return;
}
String type=event.getType();
if(TextUtils.isEmpty(type)){
return;
}
switch(type){
case"dismissAllPop":
mSelectableTextHelper.reset();
break;
case"dismissAllPopDelayed":
postReset(RESET_DELAY);
break;
}
}
- 重写
adapter
里的onViewRecycled
方法,该方法在回收View
时调用
@Override
public void onViewRecycled(@NonNull RecyclerView.ViewHolder holder){
super.onViewRecycled(holder);
if(holder instanceof ViewHolderText){
// 注销
SelectTextEventBus.getDefault().unregister(holder);
}
}
- 防抖
/**
* 延迟显示 CustomPop
* 防抖
*/
private void postShowCustomPop(int duration){
textView.removeCallbacks(mShowCustomPopRunnable);
textView.postDelayed(mShowCustomPopRunnable,duration);
}
private final Runnable mShowCustomPopRunnable=
()->showCustomPop(text_rl_container,textMsgBean);
/**
* 延迟重置
* 为了支持滑动不重置
*/
private void postReset(int duration){
textView.removeCallbacks(mShowSelectViewRunnable);
textView.postDelayed(mShowSelectViewRunnable,duration);
}
private void removeShowSelectView(){
textView.removeCallbacks(mShowSelectViewRunnable);
}
private final Runnable mShowSelectViewRunnable=
()->mSelectableTextHelper.reset();
- 去除超链接点击背景色(感谢技术支持 文本中带链接 或者@字段段时候,链接颜色会较深,如何解决? · Issue #2 · ITxiaoguang/SelectTextHelper · GitHub )
textView.setHighlightColor(Color.TRANSPARENT)
- 对 ImageSpan 表情支持(感谢技术支持 对于设置过imageSpan拼接TextView的字符表情,无法设置选择态(即设置 BackgroundColorSpan无效),暂无法解决。 · Issue #4 · ITxiaoguang/SelectTextHelper · GitHub )
val emojiMap: MutableMap<String, Int> = HashMap()
emojiMap["\\[笑脸\\]"] = R.drawable.emoji_00
emojiMap["\\[瘪嘴\\]"] = R.drawable.emoji_01
emojiMap["\\[色\\]"] = R.drawable.emoji_02
emojiMap["\\[瞪大眼\\]"] = R.drawable.emoji_03
SelectTextHelper.putAllEmojiMap(emojiMap)
SelectTextHelper.putEmojiMap("\\[酷\\]", R.drawable.emoji_04)