[Android] スマホにEditTextを使って文字を入力する

Androidアプリで文字入力を扱うにはEditTextを使います。
以下は EditText に文字を入れ、ボタンをタップすることにより TextView に表示される簡単な例です。

Android Studio
2024.1.1

EditText

単純な文字入力ですが、実は色々と奥深いものがあります。
入力の文字について、終了のタイミングとその入力の取得など、とりあえず基本的なところを理解しておきましょう。

EditTextの設定

基本的な使い方については、TextView などと同じようにレイアウトファイルの EditText の id で設定します。
　

// MainActivity.java
EditText editText = findViewById(R.id.edit_text);
...

// activity_main.xml
<EditText
        android:id="@+id/edit_text"
        android:layout_width="match_parent"
        android:layout_height="wrap_content" />

// MainActivity.java

EditText editText = findViewById(R.id.edit_text);

...

// activity_main.xml

<EditText

android:id="@+id/edit_text"

android:layout_width="match_parent"

android:layout_height="wrap_content" />

　
文字入力が終了した状態にて、Button を使って文字列を取り出すトリガーにします。
　
入力された文字を取り出すために
getText().toString()
を使います
　

button.setOnClickListener(new View.OnClickListener() {
    @Override
    public void onClick(View v) {
        // エディットテキストのテキストを取得
        String text = editText.getText().toString();
        // 取得したテキストを TextView に張り付ける
        textView.setText(text);
    }
});

button.setOnClickListener(new View.OnClickListener() {

@Override

public void onClick(View v) {

// エディットテキストのテキストを取得

String text = editText.getText().toString();

// 取得したテキストを TextView に張り付ける

textView.setText(text);

}

});

　
lambda式の場合は

button.setOnClickListener( v-> {
    // エディットテキストのテキストを取得
    String text = editText.getText().toString();
    // 取得したテキストを TextView に張り付ける
    textView.setText(text);
});

button.setOnClickListener( v-> {

// エディットテキストのテキストを取得

String text = editText.getText().toString();

// 取得したテキストを TextView に張り付ける

textView.setText(text);

});

サンプルコード

EditTextに文字を入れ、ボタンをタップすることにより TextView に表示されるアプリです。
　
MainActivity.java

//package your.package.name;
import android.os.Bundle;

import androidx.activity.EdgeToEdge;
import androidx.appcompat.app.AppCompatActivity;
import androidx.core.graphics.Insets;
import androidx.core.view.ViewCompat;
import androidx.core.view.WindowInsetsCompat;
import android.widget.Button;
import android.widget.EditText;
import android.widget.TextView;

public class MainActivity extends AppCompatActivity {

    private EditText editText;
    private TextView textView;

    @Override
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        EdgeToEdge.enable(this);
        setContentView(R.layout.activity_main);
        ViewCompat.setOnApplyWindowInsetsListener(findViewById(R.id.main), (v, insets) -> {
            Insets systemBars = insets.getInsets(WindowInsetsCompat.Type.systemBars());
            v.setPadding(systemBars.left, systemBars.top, systemBars.right, systemBars.bottom);
            return insets;
        });

        editText = findViewById(R.id.edit_text);

        textView = findViewById(R.id.text_view);

        Button button = findViewById(R.id.button);

        button.setOnClickListener( v-> {
            // エディットテキストのテキストを取得
            String text = editText.getText().toString();
            // 取得したテキストを TextView に張り付ける
            textView.setText(text);
        });
    }
}

//package your.package.name;

import android.os.Bundle;

import androidx.activity.EdgeToEdge;

import androidx.appcompat.app.AppCompatActivity;

import androidx.core.graphics.Insets;

import androidx.core.view.ViewCompat;

import androidx.core.view.WindowInsetsCompat;

import android.widget.Button;

import android.widget.EditText;

import android.widget.TextView;

public class MainActivity extends AppCompatActivity {

private EditText editText;

private TextView textView;

@Override

protected void onCreate(Bundle savedInstanceState) {

super.onCreate(savedInstanceState);

EdgeToEdge.enable(this);

setContentView(R.layout.activity_main);

ViewCompat.setOnApplyWindowInsetsListener(findViewById(R.id.main), (v, insets) -> {

Insets systemBars = insets.getInsets(WindowInsetsCompat.Type.systemBars());

v.setPadding(systemBars.left, systemBars.top, systemBars.right, systemBars.bottom);

return insets;

});

editText = findViewById(R.id.edit_text);

textView = findViewById(R.id.text_view);

Button button = findViewById(R.id.button);

button.setOnClickListener( v-> {

// エディットテキストのテキストを取得

String text = editText.getText().toString();

// 取得したテキストを TextView に張り付ける

textView.setText(text);

});

}

　
レイアウトです
activity_main.xml

<?xml version="1.0" encoding="utf-8"?>
<androidx.constraintlayout.widget.ConstraintLayout 
    xmlns:android="http://schemas.android.com/apk/res/android"
    xmlns:app="http://schemas.android.com/apk/res-auto"
    xmlns:tools="http://schemas.android.com/tools"
    android:id="@+id/main"
    android:layout_width="match_parent"
    android:layout_height="match_parent"
    tools:context=".MainActivity">

    <TextView
        android:id="@+id/text_view"
        android:layout_width="wrap_content"
        android:layout_height="wrap_content"
        android:gravity="center_horizontal"
        android:textSize="30sp"
        app:layout_constraintBottom_toBottomOf="parent"
        app:layout_constraintHorizontal_bias="0.5"
        app:layout_constraintLeft_toLeftOf="parent"
        app:layout_constraintRight_toRightOf="parent"
        app:layout_constraintTop_toTopOf="parent"
        app:layout_constraintVertical_bias="0.15" />

    <EditText
        android:id="@+id/edit_text"
        android:hint="@string/hint"
        android:autofillHints="@string/hint"
        android:inputType="text"
        android:layout_width="wrap_content"
        android:layout_height="wrap_content"
        android:background="#ffffff"
        app:layout_constraintBottom_toBottomOf="parent"
        app:layout_constraintLeft_toLeftOf="parent"
        app:layout_constraintRight_toRightOf="parent"
        app:layout_constraintTop_toTopOf="parent"
        app:layout_constraintVertical_bias="0.3" />

    <Button
        android:id="@+id/button"
        android:text="@string/button"
        android:layout_width="wrap_content"
        android:layout_height="wrap_content"
        app:layout_constraintBottom_toBottomOf="parent"
        app:layout_constraintLeft_toLeftOf="parent"
        app:layout_constraintRight_toRightOf="parent"
        app:layout_constraintTop_toTopOf="parent"
        app:layout_constraintVertical_bias="0.45" />

</androidx.constraintlayout.widget.ConstraintLayout>

<?xml version="1.0" encoding="utf-8"?>

<androidx.constraintlayout.widget.ConstraintLayout

xmlns:android="http://schemas.android.com/apk/res/android"

xmlns:app="http://schemas.android.com/apk/res-auto"

xmlns:tools="http://schemas.android.com/tools"

android:id="@+id/main"

android:layout_width="match_parent"

android:layout_height="match_parent"

tools:context=".MainActivity">

<TextView

android:id="@+id/text_view"

android:layout_width="wrap_content"

android:layout_height="wrap_content"

android:gravity="center_horizontal"

android:textSize="30sp"

app:layout_constraintBottom_toBottomOf="parent"

app:layout_constraintHorizontal_bias="0.5"

app:layout_constraintLeft_toLeftOf="parent"

app:layout_constraintRight_toRightOf="parent"

app:layout_constraintTop_toTopOf="parent"

app:layout_constraintVertical_bias="0.15" />

<EditText

android:id="@+id/edit_text"

android:hint="@string/hint"

android:autofillHints="@string/hint"

android:inputType="text"

android:layout_width="wrap_content"

android:layout_height="wrap_content"

android:background="#ffffff"

app:layout_constraintBottom_toBottomOf="parent"

app:layout_constraintLeft_toLeftOf="parent"

app:layout_constraintRight_toRightOf="parent"

app:layout_constraintTop_toTopOf="parent"

app:layout_constraintVertical_bias="0.3" />

<Button

android:id="@+id/button"

android:text="@string/button"

android:layout_width="wrap_content"

android:layout_height="wrap_content"

app:layout_constraintBottom_toBottomOf="parent"

app:layout_constraintLeft_toLeftOf="parent"

app:layout_constraintRight_toRightOf="parent"

app:layout_constraintTop_toTopOf="parent"

app:layout_constraintVertical_bias="0.45" />

</androidx.constraintlayout.widget.ConstraintLayout>

　
android:hint
android:autofillHints
android:inputType
を設定しないとwarningが出ます。
　
android:hint
ここに文字入力をしてくださいなどわかるように半透明の文字を出します。
入力し始めるとそれはなくなります。
　
android:autofillHints
これは以前に入力したものを再度使いたい場合など、ログインのID名などを表示してミスタイプを防ぐためのものです。
ただここを設定しただけではできないので、AutofillServiceなどの実装が必要です。ここでは扱わないので適当にwarningを消す目的だけの設定になっています。
　
android:inputType
以前はこれがなくてもwariningも出なかったのですが、想定されるものが数字か文字なのかなどによりキーボードの種類が変わります。
　
リソースです
strings.xml

<resources>
    <string name="app_name">Your App Name</string>
    <string name="button">Button</string>
    <string name="hint">input</string>
</resources>

<string name="button">Button</string>

<string name="hint">input</string>

</resources>

この方法は、昔のボタンしかなかった時のアプリでは有効ですが実際には困ることがあります。スマホの画面タッチはいつでも、どこでもできるので文字入力だけして、他のアイコンをタップしたり、Homeに戻ったりと文字を入力しても、確定してくれないユーザーもいるからです。スマホではそれができてしまいます
　
そんなケースにはリアルタイムに文字入力を監視するTextWatcher などを使います。
　

cat44 00 100x100 - [Android] スマホにEditTextを使って文字を入力する

[Android] 入力を監視するTextWatcher

TextWatcherはEditTextの文字入力を監視します。例えば入力パスワードの制限文字数がある場合に「文字数オーバー」と表示を出すな...

References:
EditText | Android Developers
Autofill framework | Android Developers