【Unity】InputFieldの使い方 | 初期値、入力値取得、パスワード入力、入力制限

Unityでユーザーからのテキスト入力を受け付けるには、InputField（TextMeshProのTMP_InputField） を使うのが一般的です。

この記事では、InputFieldの基本からスクリプト制御、カスタマイズ、よくあるエラーと対策まで を詳しく解説します！

この記事で学べること

UnityのInputFieldの使い方

InputFieldの追加方法

① Hierarchy から追加

1. [Hierarchy]→[右クリック]→ [UI] → [InputField – TextMeshPro] を選択
2. シーン内にInputField(TMP)が追加される

② InputFieldの構成要素

• InputField(TMP) → 入力を管理するコンポーネント
• TextMeshPro(TMP) → ユーザーが入力したテキストを表示
• Placeholder（プレースホルダー） → 未入力時に表示されるテキスト
• Image（枠） → 入力欄の背景デザイン

※ Canvas、TextMeshPro、Imageは以下のサイトを参考にしてください。

【Unity】Canvasの使い方｜Render Mode、Canvas Scaler、Raycast、表示・非表示UnityのCanvasの使い方を解説。Render ModeやCanvas Scaler、Raycast設定、UIの表示・非表示の切り替え方法まで詳しく紹介します。...

【Unity】TextMeshProの使い方 | スクリプト、フォントの追加、日本語化対応、表示の切り替えUnityのTextMeshProをマスターしよう！スクリプトでの操作方法、フォント追加の手順、日本語対応の設定まで詳しく解説。初心者でもすぐに使えるサンプルコード付き！...

【Unity】Image・Panelの使い方 | 画像変更、色変更、alpha、spriteUnityのImageやPanelを自在に操作！画像の変更、色の設定、アルファ（透明度）調整、Spriteの適用方法まで詳しく解説。初心者でもすぐに実装できるサンプルコード付き！...

Placeholderを使用して初期値を設定

InputFieldを使うとなると初期時に薄いグレーの文字でヒントを出すことが多いと思います。

InspectorでPlaceholderの初期値を設定

スクリプトでPlaceholderの初期値を設定

スクリプトからInputFieldのプレースホルダーを変更すれば、InputFieldの初期値を設定できる。

using TMPro;
using UnityEngine;
using UnityEngine.UI;

public class InputExample : MonoBehaviour
{
    public TMP_InputField inputField;
    void Start()
    {
        inputField.placeholder.GetComponent<TextMeshProUGUI>().text = "Hello";
    }
}

スクリプトで入力値（テキスト）を取得・設定

入力された入力値（テキスト）を取得

TMP_InputFieldを使うと、ユーザーが入力したテキストを取得できる。

➡ ユーザーが入力した内容を取得できる
➡ ボタンを押した時にテキストを取得する場合に便利

using UnityEngine;
using TMPro; // TextMeshProを使う場合は必須
using UnityEngine.UI;

public class InputExample: MonoBehaviour
{
    public TMP_InputField inputField;

    public void GetInputText()
    {
        string userInput = inputField.text;
        Debug.Log("入力されたテキスト: " + userInput);
    }
}

初期値を設定する（テキスト）

スクリプトからInputFieldのテキストを変更すれば、InputFieldの初期値を設定できる。

using TMPro;
using UnityEngine;
using UnityEngine.UI;

public class InputExample : MonoBehaviour
{
    public TMP_InputField inputField;

    void Start()
    {
        inputField.text = "Hello";
    }
}

パスワード入力や制限の設定

パスワード入力をマスクする（Inspector）

InputFieldの Content Type を Password に設定することで可能

パスワード入力をマスクする（スクリプト）

InputFieldの Content Type を Password に設定することで可能
➡ ユーザーが入力した文字を ● や * で表示

inputField.contentType = TMP_InputField.ContentType.Password;
inputField.ForceLabelUpdate(); // 変更を即時反映

パスワード以外の設定

前項でパスワードの設定ができたが他にもいくつか設定できるので紹介しておきます。

よくあるエラーと対策

NullReferenceException が出る

・スクリプトでinputField.textを使う前に、InspectorでInputField(TMP) をセットしているか確認
・inputField.ForceLabelUpdate(); を呼び出して変更を即時適用する

入力しても反映されない

・InputFieldのRead Onlyがオフになっているか確認
・スクリプトでForceLabelUpdate()を実行して強制更新

モバイルでキーボードが開かない

・TouchScreenKeyboardを手動で有効化

inputField.ActivateInputField();

まとめ

・TMP_InputField.textで入力された文字を取得できる
・Content Typeを設定すれば、パスワード入力・数値入力も制限可能
・プレースホルダーやフォント、枠線のカスタマイズもできる
・スクリプトでForceLabelUpdate()を実行すれば、変更を即時適用可能