Chỉ định kiểu phương thức nhập

Thử cách dùng Compose
Jetpack Compose là bộ công cụ giao diện người dùng được đề xuất cho Android. Tìm hiểu cách sử dụng tính năng chạm và nhập trong Compose.
Đặt các lựa chọn về bàn phím →

Mỗi trường văn bản đều yêu cầu một loại dữ liệu đầu vào văn bản nhất định, chẳng hạn như địa chỉ email, số điện thoại hoặc văn bản thuần tuý. Bạn phải chỉ định loại dữ liệu đầu vào cho từng trường văn bản trong ứng dụng để hệ thống hiển thị phương thức nhập mềm thích hợp, chẳng hạn như bàn phím ảo.

Ngoài loại nút có sẵn với phương thức nhập, bạn có thể chỉ định các hành vi như liệu phương thức nhập có cung cấp đề xuất chính tả, viết hoa các câu mới và thay thế nút xuống dòng bằng nút hành động như Xong hoặc Tiếp theo hay không. Trang này cho biết cách chỉ định các đặc điểm này.

Chỉ định loại bàn phím

Luôn khai báo phương thức nhập cho các trường văn bản bằng cách thêm thuộc tính android:inputType vào phần tử <EditText>

đầu vào điện thoại
Hình 1. Loại dữ liệu đầu vào phone.

Ví dụ: nếu bạn muốn có một phương thức nhập để nhập số điện thoại, hãy sử dụng giá trị "phone":

<EditText
    android:id="@+id/phone"
    android:layout_width="fill_parent"
    android:layout_height="wrap_content"
    android:hint="@string/phone_hint"
    android:inputType="phone" />
loại đầu vào textPassword
Hình 2. Loại dữ liệu đầu vào textPassword.

Nếu trường văn bản dùng để nhập mật khẩu, hãy sử dụng giá trị "textPassword" để trường văn bản ẩn dữ liệu đầu vào của người dùng:

<EditText
    android:id="@+id/password"
    android:hint="@string/password_hint"
    android:inputType="textPassword"
    ... />

Có một số giá trị có thể được ghi lại bằng thuộc tính android:inputType và bạn có thể kết hợp một số giá trị để chỉ định giao diện phương thức nhập và các hành vi bổ sung.

Bật tính năng đề xuất chính tả và các hành vi khác

tự động sửa lỗi
Hình 3. Việc thêm textAutoCorrect sẽ cung cấp tính năng tự động sửa lỗi chính tả cho lỗi chính tả.

Thuộc tính android:inputType cho phép bạn chỉ định nhiều hành vi cho phương thức nhập. Quan trọng nhất là nếu trường văn bản của bạn dùng để nhập văn bản cơ bản (chẳng hạn như cho tin nhắn văn bản), hãy bật tính năng tự động sửa lỗi chính tả bằng giá trị "textAutoCorrect".

Bạn có thể kết hợp các hành vi và kiểu phương thức nhập khác nhau bằng thuộc tính android:inputType. Ví dụ: sau đây là cách tạo một trường văn bản viết hoa từ đầu tiên của câu và cũng tự động sửa lỗi chính tả:

<EditText
    android:id="@+id/message"
    android:layout_width="wrap_content"
    android:layout_height="wrap_content"
    android:inputType=
        "textCapSentences|textAutoCorrect"
    ... />

Chỉ định hành động của phương thức nhập

Hầu hết các phương thức nhập bằng bàn phím ảo đều cung cấp một nút hành động của người dùng ở góc dưới cùng, phù hợp với trường văn bản hiện tại. Theo mặc định, hệ thống sử dụng nút này cho hành động Tiếp theo hoặc Xong trừ phi trường văn bản của bạn hỗ trợ văn bản nhiều dòng (chẳng hạn như với android:inputType="textMultiLine"). Trong trường hợp đó, nút hành động là nút xuống dòng. Tuy nhiên, bạn có thể chỉ định các hành động khác phù hợp hơn với trường văn bản của mình, chẳng hạn như Gửi hoặc Truy cập.

Để chỉ định nút hành động của bàn phím, hãy sử dụng thuộc tính android:imeOptions với giá trị hành động như "actionSend" hoặc "actionSearch". Ví dụ:

nút gửi
Hình 4. Nút Gửi sẽ xuất hiện khi bạn khai báo android:imeOptions="actionSend".
<EditText
    android:id="@+id/search"
    android:layout_width="fill_parent"
    android:layout_height="wrap_content"
    android:hint="@string/search_hint"
    android:inputType="text"
    android:imeOptions="actionSend" />

Sau đó, bạn có thể theo dõi các lần nhấn vào nút hành động bằng cách xác định TextView.OnEditorActionListener cho phần tử EditText. Trong trình nghe, hãy phản hồi mã nhận dạng hành động IME thích hợp được xác định trong lớp EditorInfo, chẳng hạn như IME_ACTION_SEND, như minh hoạ trong ví dụ sau:

Kotlin

findViewById<EditText>(R.id.search).setOnEditorActionListener { v, actionId, event ->
    return@setOnEditorActionListener when (actionId) {
        EditorInfo.IME_ACTION_SEND -> {
            sendMessage()
            true
        }
        else -> false
    }
}

Java

EditText editText = (EditText) findViewById(R.id.search);
editText.setOnEditorActionListener(new OnEditorActionListener() {
    @Override
    public boolean onEditorAction(TextView v, int actionId, KeyEvent event) {
        boolean handled = false;
        if (actionId == EditorInfo.IME_ACTION_SEND) {
            sendMessage();
            handled = true;
        }
        return handled;
    }
});

Đề xuất tự động hoàn thành

Nếu muốn đề xuất cho người dùng khi họ nhập, bạn có thể sử dụng một lớp con của EditText có tên là AutoCompleteTextView. Để triển khai tính năng tự động hoàn thành, bạn phải chỉ định một Adapter cung cấp các đề xuất văn bản. Có một số trình chuyển đổi, tuỳ thuộc vào nơi lấy dữ liệu, chẳng hạn như từ cơ sở dữ liệu hoặc mảng.

đề xuất văn bản
Hình 5. Ví dụ về AutoCompleteTextView có đề xuất văn bản

Quy trình sau đây mô tả cách thiết lập AutoCompleteTextView cung cấp đề xuất từ một mảng bằng cách sử dụng ArrayAdapter:

  1. Thêm AutoCompleteTextView vào bố cục. Sau đây là bố cục chỉ có trường văn bản: 
    <?xml version="1.0" encoding="utf-8"?>
<AutoCompleteTextView xmlns:android="http://schemas.android.com/apk/res/android"
    android:id="@+id/autocomplete_country"
    android:layout_width="fill_parent"
    android:layout_height="wrap_content" />
  2. Xác định mảng chứa tất cả đề xuất văn bản. Ví dụ: sau đây là mảng tên quốc gia: 
    <?xml version="1.0" encoding="utf-8"?>
<resources>
    <string-array name="countries_array">
        <item>Afghanistan</item>
        <item>Albania</item>
        <item>Algeria</item>
        <item>American Samoa</item>
        <item>Andorra</item>
        <item>Angola</item>
        <item>Anguilla</item>
        <item>Antarctica</item>
        ...
    </string-array>
</resources>
  3. Trong Activity hoặc Fragment, hãy sử dụng mã sau đây để chỉ định trình chuyển đổi cung cấp các đề xuất:

    Kotlin

    // Get a reference to the AutoCompleteTextView in the layout.
val textView = findViewById(R.id.autocomplete_country) as AutoCompleteTextView
// Get the string array.
val countries: Array<out String> = resources.getStringArray(R.array.countries_array)
// Create the adapter and set it to the AutoCompleteTextView.
ArrayAdapter<String>(this, android.R.layout.simple_list_item_1, countries).also { adapter ->
    textView.setAdapter(adapter)
}

    Java

    // Get a reference to the AutoCompleteTextView in the layout.
AutoCompleteTextView textView = (AutoCompleteTextView) findViewById(R.id.autocomplete_country);
// Get the string array.
String[] countries = getResources().getStringArray(R.array.countries_array);
// Create the adapter and set it to the AutoCompleteTextView.
ArrayAdapter<String> adapter =
        new ArrayAdapter<String>(this, android.R.layout.simple_list_item_1, countries);
textView.setAdapter(adapter);

    Trong ví dụ trước, một ArrayAdapter mới được khởi chạy để liên kết từng mục trong mảng chuỗi countries_array với TextView có trong bố cục simple_list_item_1. Đây là bố cục do Android cung cấp, mang đến giao diện chuẩn cho văn bản trong danh sách.

  4. Chỉ định trình chuyển đổi cho AutoCompleteTextView bằng cách gọi setAdapter().