JavaのFocusListenerインターフェースとは？重要性と実装方法を解説

FocusListenerインターフェースとは

Java AWT／SwingにおけるFocusListenerは、コンポーネントがキーボードフォーカスを取得・喪失したタイミングで発生するイベントを受け取るためのリスナーインターフェースです。ユーザーがどのコンポーネントを操作しているのかを検知できるため、入力フォームのバリデーションやガイド表示など、対話的なUIを実現するうえで重要な役割を担います。

• フォーカスイベントは、コンポーネントがキーボードフォーカスを取得または喪失したときに生成されます。
• フォーカスイベントを表すオブジェクトは、FocusEventクラスから作成されます。
• FocusEventクラスに対応するリスナーインターフェースがFocusListenerインターフェースであり、FocusEventの各リスナーはこのインターフェースを実装します。
• FocusListenerインターフェースには次の2つのメソッドが定義されています。
  • focusGained()：監視対象のコンポーネントがフォーカスを取得した直後にAWTによって呼び出されます。
  • focusLost()：監視対象のコンポーネントがフォーカスを失った直後にAWTによって呼び出されます。

これらのメソッドを活用することで、例えばテキストフィールドにフォーカスが移った瞬間に入力ヒントを表示したり、フォーカスが外れた時点で入力値の妥当性をチェックしたりといった、きめ細かなユーザー体験の設計が可能になります。

構文

public interface FocusListener extends EventListener {
    public void focusGained(FocusEvent fe);
    public void focusLost(FocusEvent fe);
}

実装例

以下は、JTextFieldにFocusListenerを実装し、フォーカスの取得・喪失をコンソールに出力するシンプルなサンプルプログラムです。

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

public class FocusListenerTest extends JPanel implements FocusListener {
    private JTextField textField;

    public FocusListenerTest() {
        setLayout(new BorderLayout());
        textField = new JTextField();
        textField.addFocusListener(this);
        add(textField, BorderLayout.NORTH);
    }

    public void focusGained(FocusEvent fe) {
        System.out.println("Text field gained focus");
    }

    public void focusLost(FocusEvent fe) {
        System.out.println("Text field lost focus");
    }

    public static void main(String args[]) {
        JFrame frame = new JFrame();
        frame.add(new FocusListenerTest());
        frame.setTitle("FocusListener Test");
        frame.setSize(375, 250);
        frame.setDefaultCloseOperation(JFrame.EXIT_ON_CLOSE);
        frame.setLocationRelativeTo(null);
        frame.setVisible(true);
    }
}

このコードでは、パネル自身（this）をリスナーとしてテキストフィールドに登録しています。テキストフィールドがクリックされてフォーカスを取得するとfocusGained()が、Tabキーなどでフォーカスが外れるとfocusLost()がそれぞれ呼び出されます。

実行結果

プログラムを起動してテキストフィールドをクリックすると「Text field gained focus」と出力され、ウィンドウの他の部分をクリックしてフォーカスが外れると「Text field lost focus」と出力されます。