安卓开发 | 实现输入框自动全选内容

在安卓开发中，当用户手动选中输入框时。输入框内部的内容全部选中是一个比较提升用户体验的功能，主要用在一些复制的场景中。

实现方法

实现这个功能，需要给输入框加上焦点改变监听器，在监听器中，调用选择内容的方法即可。

核心API

OnFocusChangeListener ：焦点改变监听器，可以获取输入框焦点改变事件，通过传入参数可以判断当前为聚焦或是失焦。

selectAll() ：选择全部内容方法。

setSelection(int start, int stop) ：选择指定部分内容方法。

XML布局

在 activity_main.xml 文件中添加组件元素，输入框的类型为 EditText ，修改输入类型为 text 。

<?xml version="1.0" encoding="utf-8"?>
<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android"
    xmlns:tools="http://schemas.android.com/tools"
    android:layout_width="match_parent"
    android:layout_height="match_parent"
    android:orientation="vertical"
    android:padding="16dp"
    tools:context=".MainActivity">

    <EditText
        android:id="@+id/editText1"
        android:layout_width="match_parent"
        android:layout_height="wrap_content"
        android:hint="输入框 1"
        android:inputType="text" />

</LinearLayout>

kotlin代码

在 MainActivity.kt 文件中获取输入框实例并添加焦点变化监听器。

package com.test.myapp

import android.os.Bundle
import android.view.View
import android.widget.EditText
import androidx.appcompat.app.AppCompatActivity

class MainActivity : AppCompatActivity() {

    private lateinit var editText1: EditText
    private lateinit var editText2: EditText

    override fun onCreate(savedInstanceState: Bundle?) {
        super.onCreate(savedInstanceState)
        setContentView(R.layout.activity_main)

        // 初始化视图
        editText1 = findViewById(R.id.editText1)


        // 为输入框添加焦点监听器
        editText1.onFocusChangeListener = View.OnFocusChangeListener { view, hasFocus ->
            if (hasFocus) {
                // 当获得焦点时，选中所有文本
                (view as EditText).selectAll()
            }
        }

    }
}

存在的问题

在部分情况下，上面的代码会出现：当选中输入框之后，该输入框并没有全选内容，而是将光标跳到内容的最后方。这是由于安卓系统在处理输入框焦点和弹出软键盘的时间顺序导致的，首先输入框获取焦点会触发全选逻辑，但是随后弹出软键盘，系统会认为用户需要输入而将光标放置在内容的末尾，从而解除了该输入框的全选状态。

解决办法

解决这个问题比较容易，在全选之后，延迟一下再重新选择全部内容。我们使用 post{} 来实现延迟效果。

// ... (之前的代码)

// 为输入框添加焦点监听器
editText1.onFocusChangeListener = View.OnFocusChangeListener { view, hasFocus ->
    if (hasFocus) {
        val editText = view as EditText
        editText.selectAll() // 立即全选

        // 延迟一点时间再尝试重新设置光标，对抗系统默认行为
        editText.post {
            editText.setSelection(0, editText.text.length) // 再次设置选择范围为全选
        }
    }
}
// ... (之前的代码)

post{} 会将括号中的代码放入消息队列中，事件循环（也就是系统处理完焦点变化事件和键盘弹出事件）后再执行，这样可以保证不会被系统事件干扰全选逻辑。