Android复制TextView内容常用方法汇总

一、前言

最近在项目中,需要提供TextView的复制功能,让用户可以自由复制App中某些界面的特定内容。

需求来源于用户有时需要复制编号,用于其它地方的搜索,比如下图中TD开头的这一长串编号。

如果在搜索时,需要手输这一长串字符,先不说记住这一串数据需要怎样的记忆力,就说输入这一长串字符的时间,对于用户来说就是不可接受的。

二、需求分析

这时候,我们很自然地就会想到,我们经常使用的复制功能,是类似这样的:

长按某一段文字后,在文字上方或标题栏处会出现全选复制等功能按钮,点击后就能复制,然后在你需要输入的地方长按,就会出现粘贴按钮,点击后就能成功粘贴。

三、功能实现

查看TextView的API,里面就有这么一段介绍:

To allow users to copy some or all of the TextView's value and paste it somewhere else, set the XML attribute android:textIsSelectable to "true" or call setTextIsSelectable(true). The textIsSelectable flag allows users to make selection gestures in the TextView, which in turn triggers the system's built-in copy/paste controls.

意思就是使用textIsSelectable属性就可以触发系统内置的复制/粘贴功能。

那么最简单的方法就是直接在XML文件中,给TextView设置textIsSelectable属性为true

<TextView
    android:layout_width="wrap_content"
    android:layout_height="wrap_content"
    android:text="TD201612120166"
    android:textIsSelectable="true" />

当然,也可以使用java代码实现:

tv.setTextIsSelectable(true);

效果也确实立杆见影,一步完成。

好嗨森,可以收工啦,赶紧把项目中另一个地方也改掉,就可以提交代码啦~

四、掉坑了

由于本项目为老项目,列表使用的是ListView(SDK使用的是19),而另一个需要修改的地方,就是ListView列表里面的子项TextView。

当为其设置textIsSelectable属性后,长按这一长串数字编号,这时候数字是选中了,但是并没有弹出复制的选项啊,而且更重要的是,ListView的Item点击事件没有了啊啊啊~~~

注:在某些SDK版本上,长按TextView后,会在ToolBar(ActionBar)位置弹出全选复制等功能按钮(如下图),而当设置textIsSelectable属性后,该功能条会下滑出现,而在一瞬间又上滑消失,实际看到的效果就是ToolBar处会有内容闪现并瞬间消失,但是看不清具体内容。

五、解决

网上搜索一番,果然也有不少解决方案,但有一些亲测无效,就不列出了,以下是亲测可用的解决方案。

以下方法,基本都是使用系统的剪贴板管理器ClipboardManager进行内容的复制。

1. LongClick事件 + PopupWindow

原理是在TextView的长按事件中,显示一个带操作按钮的PopupWindow,点击其中的复制按钮后,复制TextView内容。

先初始化PopupWindow,弹出窗口上会有复制按钮(也可以自定义其它需要的按钮):

private void initPopupWindow() {
    View popupView = getLayoutInflater().inflate(R.layout.layout_popup_window, null);

    mPopupWindow = new PopupWindow(popupView, ViewGroup.LayoutParams.WRAP_CONTENT, ViewGroup.LayoutParams.WRAP_CONTENT, true);
    mPopupWindow.setTouchable(true);
    mPopupWindow.setOutsideTouchable(true);
    mPopupWindow.setBackgroundDrawable(new BitmapDrawable(getResources(), (Bitmap) null));

    Button btnCopy = (Button) popupView.findViewById(R.id.btn_copy);
}

然后为ListView中的TextView设置长按事件,在TextView下方显示PopupWindow:

mTextView.setOnLongClickListener(new View.OnLongClickListener() {
    @Override
    public boolean onLongClick(View view) {
        // 方法1:LongClick事件 + PopupWindow
        mPopupWindow.showAsDropDown(view);
        mCopiedText = ((TextView) view).getText().toString();

        return false;

    }
});

最后为弹出窗口中的复制按钮设置响应事件,利用ClipboardManager复制TextView内容:

btnCopy.setOnClickListener(new View.OnClickListener() {
    @Override
    public void onClick(View v) {
        copyText(mCopiedText);

        if (mPopupWindow != null && mPopupWindow.isShowing()) {
            mPopupWindow.dismiss();
        }
    }
});

private void copyText(String copiedText) {
    ClipboardManager clipboardManager = (ClipboardManager)getSystemService(Context.CLIPBOARD_SERVICE);
    clipboardManager.setPrimaryClip(ClipData.newPlainText(null, copiedText));

    showToast("Copy Text: " + copiedText);
}

以上就可以在你需要输入的地方长按,就会出现粘贴按钮,点击后就能成功粘贴刚才复制的内容了。

但是这边会有个问题:无法自由选择文字内容,没有选中文字的效果

2. LongClick事件 + ContextMenu

我们也可以使用ContextMenu来手动创建上下文菜单,实现跟原生复制功能一样的效果,在标题栏上方显示可操作的菜单,最终效果如下:

首先,实现 ActionMode.Callback 接口。这里面会包含ActionMode的生命周期方法,在onCreateActionMode()创建菜单项,如复制、全选等功能菜单,在onActionItemClicked()中处理菜单项的点击事件(重点代码用下三角▼▼▼标识了)

这两个方法就类似标题栏右边的选项菜单OptionsMenu,对应于onCreateOptionsMenu()onOptionsItemSelected()这两个方法。

private ActionMode.Callback mActionModeCallback = new ActionMode.Callback() {

    // Called when the action mode is created; startActionMode() was called
    @Override
    public boolean onCreateActionMode(ActionMode mode, Menu menu) {
        // Inflate a menu resource providing context menu items
        MenuInflater inflater = mode.getMenuInflater();

        // ▼▼▼重点:创建上下文菜单
        inflater.inflate(R.menu.context_menu, menu);
        return true;
    }

    // Called each time the action mode is shown. Always called after onCreateActionMode, but
    // may be called multiple times if the mode is invalidated.
    @Override
    public boolean onPrepareActionMode(ActionMode mode, Menu menu) {
        return false; // Return false if nothing is done
    }

    ...

    // Called when the user exits the action mode
    @Override
    public void onDestroyActionMode(ActionMode mode) {
        mActionMode = null;
    }
};

然后,为TextView设置长按事件,显示上下文菜单:

mTextView.setOnLongClickListener(new View.OnLongClickListener() {
    @Override
    public boolean onLongClick(View view) {
        // 方案2:LongClick事件 + ContextMenu
        if (mActionMode != null) {
            return false;
        }

        // Start the CAB using the ActionMode.Callback defined above
        mActionMode = startActionMode(mActionModeCallback);
        view.setSelected(true);
        mCopiedText = ((TextView) view).getText().toString();
        return true;
    }
});

最后,就是在第一步的onActionItemClicked()事件中,为复制按钮设置响应事件,利用ClipboardManager复制TextView内容:

private ActionMode.Callback mActionModeCallback = new ActionMode.Callback() {
    ...

    public boolean onActionItemClicked(ActionMode mode, MenuItem item) {
        switch (item.getItemId()) {
            // ▼▼▼重点:设置菜单项的点击事件
            case R.id.action_copy:
                copyText(mCopiedText);
    
                mode.finish(); // Action picked, so close the CAB
                return true;
            default:
                return false;
        }
    }
};

这边同样会有上面的问题:无法自由选择文字内容,没有选中文字的效果

3. Click事件 + ClipboardManager

此方案跟第1种原理是一样的,只不过省略了PopupWindow部分,点击后直接自动复制TextView内容,代码比较简单:

mTextView.setOnClickListener(new View.OnClickListener() {
    @Override
    public void onClick(View view) {
        copyText(((TextView) view).getText().toString());
    }
});

问题:无法自由选择文字内容

4. RecyclerView + textIsSelectable

其实最推荐的做法,还是将项目里的ListView替换成RecyclerView,再给TextView设置textIsSelectable=true属性即可:

这让我们再一次见证了RecyclerView的伟大啊~
本方案对项目后期维护及扩展更有好处,毕竟现在基本可以说,RecyclerView已经完全取代了ListView,比ListView性能更好,扩展性更强。

5. 额外赠送:SelectableTextHelper

网上还有位大神自定义了可选择TextView内容的帮助类,使用上非常方便,只要对原来的TextView加上如下设置即可:

mSelectableTextHelper = new SelectableTextHelper.Builder(mTextView)
    .setSelectedColor(getResources().getColor(R.color.selected_blue))
    .setCursorHandleSizeInDp(20)
    .setCursorHandleColor(getResources().getColor(R.color.cursor_handle_color))
    .build();

有兴趣的同学可以参考此文章了解更多:自定义选择复制功能的实现

亲测在文字选择时,左右两边选择文字范围的图标不好点中,应该是坐标处理有点问题;而且无法在ListView中使用;但不得不说,整体效果非常好,对代码的侵入非常少,在各个平台上的体验也是统一的。

六、总结

这几种方案来看的话:

  • 如果项目中需要复制的TextView没有嵌套在ListView中,那就可以直接大胆地使用textIsSelectable属性,一步搞定;
  • 如果使用到ListView,能改成RecyclerView来实现的话,建议直接改成RecyclerView,再加上textIsSelectable属性,也很好解决;(方案4)
  • 如果非要用ListView的话,看看是否能在满足项目需求的情况下,直接使用TextView的点击事件,配合ClipboardManager直接自动复制指定内容,但记得在复制完成后给用户显示必要的提示。(方案3)========> 本项目就是使用这种方案简单粗暴地解决ListView中无法长按选择复制TextView内容的问题的。
  • 如果这几种方案还不能解决你的问题,可以在其余几种方案中看看是否有符合要求的。

七、疑问

虽然项目问题解决了,但是还有以下几个问题,在查看了相关源码、进行一系列测试后,还是未能解决,暂且记录下来,说不定以后什么时候能力达到了,就能解决了呢?或者哪位小伙伴知道原因,还请不吝赐教~

  • 为什么设置textIsSelectabletrue后,ListView的ItemClick事件不响应了,明明该有的DOWN、MOVE、UP事件还是有?ItemClick的触发条件是什么?
  • 而这时候,为什么TextView不会弹出选中框,以及复制、全选等操作按钮?而在添加了android:selectAllOnFocus="true"后,长按后显示红色选择框,但不显示复制按钮,再次点击红色选择框,就会出现复制按钮。

PS:欢迎关注SherlockShi博客

最后编辑于
©著作权归作者所有,转载或内容合作请联系作者
  • 序言:七十年代末,一起剥皮案震惊了整个滨河市,随后出现的几起案子,更是在滨河造成了极大的恐慌,老刑警刘岩,带你破解...
    沈念sama阅读 194,088评论 5 459
  • 序言:滨河连续发生了三起死亡事件,死亡现场离奇诡异,居然都是意外死亡,警方通过查阅死者的电脑和手机,发现死者居然都...
    沈念sama阅读 81,715评论 2 371
  • 文/潘晓璐 我一进店门,熙熙楼的掌柜王于贵愁眉苦脸地迎上来,“玉大人,你说我怎么就摊上这事。” “怎么了?”我有些...
    开封第一讲书人阅读 141,361评论 0 319
  • 文/不坏的土叔 我叫张陵,是天一观的道长。 经常有香客问我,道长,这世上最难降的妖魔是什么? 我笑而不...
    开封第一讲书人阅读 52,099评论 1 263
  • 正文 为了忘掉前任,我火速办了婚礼,结果婚礼上,老公的妹妹穿的比我还像新娘。我一直安慰自己,他们只是感情好,可当我...
    茶点故事阅读 60,987评论 4 355
  • 文/花漫 我一把揭开白布。 她就那样静静地躺着,像睡着了一般。 火红的嫁衣衬着肌肤如雪。 梳的纹丝不乱的头发上,一...
    开封第一讲书人阅读 46,063评论 1 272
  • 那天,我揣着相机与录音,去河边找鬼。 笑死,一个胖子当着我的面吹牛,可吹牛的内容都是我干的。 我是一名探鬼主播,决...
    沈念sama阅读 36,486评论 3 381
  • 文/苍兰香墨 我猛地睁开眼,长吁一口气:“原来是场噩梦啊……” “哼!你这毒妇竟也来了?” 一声冷哼从身侧响起,我...
    开封第一讲书人阅读 35,175评论 0 253
  • 序言:老挝万荣一对情侣失踪,失踪者是张志新(化名)和其女友刘颖,没想到半个月后,有当地人在树林里发现了一具尸体,经...
    沈念sama阅读 39,440评论 1 290
  • 正文 独居荒郊野岭守林人离奇死亡,尸身上长有42处带血的脓包…… 初始之章·张勋 以下内容为张勋视角 年9月15日...
    茶点故事阅读 34,518评论 2 309
  • 正文 我和宋清朗相恋三年,在试婚纱的时候发现自己被绿了。 大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
    茶点故事阅读 36,305评论 1 326
  • 序言:一个原本活蹦乱跳的男人离奇死亡,死状恐怖,灵堂内的尸体忽然破棺而出,到底是诈尸还是另有隐情,我是刑警宁泽,带...
    沈念sama阅读 32,190评论 3 312
  • 正文 年R本政府宣布,位于F岛的核电站,受9级特大地震影响,放射性物质发生泄漏。R本人自食恶果不足惜,却给世界环境...
    茶点故事阅读 37,550评论 3 298
  • 文/蒙蒙 一、第九天 我趴在偏房一处隐蔽的房顶上张望。 院中可真热闹,春花似锦、人声如沸。这庄子的主人今日做“春日...
    开封第一讲书人阅读 28,880评论 0 17
  • 文/苍兰香墨 我抬头看了看天上的太阳。三九已至,却和暖如春,着一层夹袄步出监牢的瞬间,已是汗流浃背。 一阵脚步声响...
    开封第一讲书人阅读 30,152评论 1 250
  • 我被黑心中介骗来泰国打工, 没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留,地道东北人。 一个月前我还...
    沈念sama阅读 41,451评论 2 341
  • 正文 我出身青楼,却偏偏与公主长得像,于是被迫代替她去往敌国和亲。 传闻我的和亲对象是个残疾皇子,可洞房花烛夜当晚...
    茶点故事阅读 40,637评论 2 335

推荐阅读更多精彩内容