JavaのJTextFieldとJTextAreaの違いとは？特徴と使い分けを解説

JavaのGUIアプリケーションにおけるJTextFieldとJTextAreaの最大の違いは、JTextFieldが1行のテキスト入力に対応しているのに対し、JTextAreaは複数行のテキスト入力に対応しているという点です。どちらもSwingが提供するテキストコンポーネントであり、共通の親クラスであるJTextComponentを継承しています。

JTextFieldとは

• JTextFieldは、ユーザーが1行形式でテキストを入力できる、最も基本的かつ重要なコンポーネントの一つです。
• テキストフィールド内で入力操作を行うと、ActionListenerインターフェースによるイベントが発生します。
• JTextComponentはJTextFieldのスーパークラスであり、JTextFieldで利用される共通のメソッド群を提供しています。
• JTextFieldクラスの代表的なメソッドには、setText()、getText()、setEnabled()などがあります。

サンプルコード

import javax.swing.*;
import java.awt.*;

public class JTextFieldTest {
    public static void main(String[] args) {
        final JFrame frame = new JFrame("JTextField デモ");

        JLabel lblFirstName = new JLabel("名:");
        JTextField tfFirstName = new JTextField(20);
        lblFirstName.setLabelFor(tfFirstName);

        JLabel lblLastName = new JLabel("姓:");
        JTextField tfLastName = new JTextField(20);
        lblLastName.setLabelFor(tfLastName);

        JPanel panel = new JPanel();
        panel.setLayout(new FlowLayout());
        panel.add(lblFirstName);
        panel.add(tfFirstName);
        panel.add(lblLastName);
        panel.add(tfLastName);

        frame.setDefaultCloseOperation(JFrame.EXIT_ON_CLOSE);
        frame.setSize(300, 100);
        frame.getContentPane().add(panel, BorderLayout.CENTER);
        frame.setVisible(true);
    }
}

実行結果

JTextAreaとは

• JTextAreaは、テキストを表示したり、ユーザーにテキスト入力を許可したりするための複数行テキストコンポーネントです。
• JTextAreaは、カーソル（キャレット）の移動などを検知するCaretListenerインターフェースを利用できます。
• JTextComponentはJTextAreaのスーパークラスでもあり、JTextAreaで利用される共通のメソッド群を提供しています。
• JTextAreaクラスの代表的なメソッドには、setText()、append()、setLineWrap()、setWrapStyleWord()、setCaretPosition()などがあります。

サンプルコード

import java.awt.*;
import javax.swing.*;
import javax.swing.event.*;

public class JTextAreaTest {
    public static void main(String args[]) {
        JFrame frame = new JFrame("JTextArea の例");
        frame.setDefaultCloseOperation(JFrame.EXIT_ON_CLOSE);

        JTextArea textArea = new JTextArea();
        JScrollPane scrollPane = new JScrollPane(textArea);
        frame.add(scrollPane, BorderLayout.CENTER);

        CaretListener listener = new CaretListener() {
            public void caretUpdate(CaretEvent caretEvent) {
                System.out.println("キャレット位置(Dot): " + caretEvent.getDot());
                System.out.println("選択終了位置(Mark): " + caretEvent.getMark());
            }
        };
        textArea.addCaretListener(listener);

        frame.setSize(250, 150);
        frame.setVisible(true);
    }
}

実行結果

JTextFieldとJTextAreaの比較一覧

使い分けのポイント

氏名やメールアドレス、検索ワードのように短い情報を1行で受け取る場合はJTextFieldが適しています。一方、お問い合わせ内容やメモのように複数行にわたる長文を扱う場合はJTextAreaを選びましょう。JTextAreaではスクロールバーを付けるためにJScrollPaneと組み合わせて使うのが一般的です。また、折り返し表示が必要な場合はsetLineWrap(true)を設定すると、ウィンドウ幅に合わせて自動的に改行されるようになります。