本頁面由 Cloud Translation API 翻譯而成。

指定輸入法類型

每個文字欄位都要有特定類型的文字輸入，例如電子郵件地址、電話號碼或純文字您必須為應用程式中的每個文字欄位指定輸入類型，系統才會顯示適當的軟輸入方式，例如螢幕小鍵盤

除了提供輸入法的按鈕類型之外，您還可以指定行為，例如：輸入法是否會提供拼字建議、將新的句子大寫，並取代含有動作按鈕的回車按鈕，例如「完成」或「下一步」。本頁說明再選出這些特徵

指定鍵盤類型

請一律在文字欄位中加入 android:inputType敬上屬性加入 <EditText> 元素。

舉例來說，如果您要透過輸入法輸入電話號碼，請使用 "phone" 值：

<EditText
    android:id="@+id/phone"
    android:layout_width="fill_parent"
    android:layout_height="wrap_content"
    android:hint="@string/phone_hint"
    android:inputType="phone" />

敬上

如果文字欄位是輸入密碼，請使用 "textPassword" 值，因此文字欄位隱藏使用者的輸入內容：

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

使用 android:inputType 屬性記載了幾個可能的值。您可以結合一些值，指定輸入法的外觀行為

啟用拼字建議和其他行為

android:inputType 屬性可讓您指定輸入項目的各種行為。方法。最重要的是，如果您的文字欄位適用於基本文字輸入，例如簡訊- 使用 "textAutoCorrect" 啟用自動拼字更正功能值。

您可將不同的行為和輸入法樣式與 android:inputType 屬性。例如，以下示範如何建立文字欄位將句子的第一個字大寫，同時也自動更正拼字錯誤：

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

指定輸入法動作

大多數軟輸入方式會在底部角落提供適當的使用者動作按鈕。根據預設，系統會將這個按鈕用於「Next」或 Done (完成) 動作。除非您的文字欄位支援多行文字，例如： android:inputType="textMultiLine"：此時動作按鈕為車廂傳回。不過，您可以指定更適合文字欄位的其他動作。，例如 Send 或 Go。

如要指定鍵盤動作按鈕，請使用 android:imeOptions敬上以及動作值 (例如 "actionSend" 或 "actionSearch") 的屬性。例如：

傳送按鈕 — **圖 4.** 宣告時會顯示「傳送」按鈕 `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" />

接下來，您可以藉由定義 TextView.OnEditorActionListener 定義 EditText 元素在您的接聽程式，回應 EditorInfo 類別，例如 IME_ACTION_SEND, 如以下範例所示：

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;
    }
});

提供自動完成建議

如要在使用者輸入內容時提供建議，您可以使用已呼叫 EditText AutoCompleteTextView。如要實作自動完成功能，您必須指定提供文字的 Adapter 或取得寫作建議視資料來源而定，有多種轉接程式可供使用，例如：讀取來自資料庫或陣列的內容

文字建議 — **圖 5.** 含文字的`AutoCompleteTextView`範例或取得寫作建議

以下程序說明如何設定 AutoCompleteTextView 會使用 ArrayAdapter:

在版面配置中加入 AutoCompleteTextView。以下版面配置只有文字欄位：

<?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" />

定義包含所有文字建議的陣列。舉例來說國家/地區名稱陣列：

<?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>

在你的Activity或 Fragment，請使用以下程式碼指定提供建議的轉接程式：

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);

在上述範例中，新的 ArrayAdapter 會初始化，以繫結至將 countries_array 字串陣列轉換成 TextView simple_list_item_1 版面配置。這是 Android 提供的版面配置，清單中的文字外觀。

呼叫，將轉接器指派給 AutoCompleteTextView setAdapter()。