テキスト入力フィールド

TextBoxは、ユーザーがテキスト入力を提供できる矩形であり、フォーカスが当たっているときに機能します。スクリプトを使用してTextBoxを操作すると、検索バーやフォームの入力フィールドとして利用できます。ユーザーが入力すべきテキストのタイプを理解できるように、PlaceholderTextプロパティを通じてプロンプトを提供することもできます。

これらのオブジェクトがGuiObjectsであるため、ユーザーはBackgroundColor3、BorderMode、Transparency、およびRotationなどのプロパティをカスタマイズして、体験の美学に合わせることができます。

画面上にテキスト入力を作成する

画面上のTextBoxは、フォームの入力フィールドなどに役立ちます。

画面にTextBoxを追加するには：

1. Explorerウィンドウで、StarterGuiを選択し、ScreenGuiを追加します。

   1. StarterGuiの上にカーソルを合わせ、⊕ボタンをクリックします。コンテキストメニューが表示されます。

   2. ScreenGuiを挿入します。

2. 新しいScreenGuiを選択し、TextBoxを追加します。

   1. ScreenGuiの上にカーソルを合わせ、⊕ボタンをクリックします。コンテキストメニューが表示されます。

   2. TextBoxを挿入します。

パーツの面にテキスト入力を作成する

パーツの面にTextBoxを追加するには：

1. Explorerウィンドウで、StarterGuiを選択し、SurfaceGuiを追加します。

   1. StarterGuiの上にカーソルを合わせ、⊕ボタンをクリックします。コンテキストメニューが表示されます。

   2. ScreenGuiを挿入します。

2. 新しいSurfaceGuiを選択し、TextBoxを追加します。

   1. SurfaceGuiの上にカーソルを合わせ、⊕ボタンをクリックします。コンテキストメニューが表示されます。

   2. TextBoxを挿入します。

3. TextBoxを表示したいpartにSurfaceGuiを装飾します。

   1. Propertiesウィンドウで、Adorneeプロパティを選択します。カーソルが変わります。

   2. Explorerウィンドウで、パーツを選択します。

テキスト入力をスクリプト化する

ボタンと同様に、ユーザーがTextBoxオブジェクトに対して操作を行う際に、任意のアクションをスクリプトすることができます。例えば、以下のスクリプトは、ユーザーがEnterボタンを押したり、ボックスの外をクリックした際に発生するFocusLostイベントを接続します。enterPressedがtrueの場合、つまりユーザーがただボックスの外をクリックしたのではなく、入力を送信した場合、スクリプトはエントリの内容をOutputウィンドウに出力します。

基本的なテキスト入力処理
local textBox = script.Parent

local function onFocusLost(enterPressed, inputObject)
	if enterPressed then
		print(textBox.Text)
	end
end

textBox.FocusLost:Connect(onFocusLost)

別の例として、TextBoxに数字のみを許可したい場合があります。以下のコードは、TextBox.GetPropertyChangedSignalイベントを使用してTextBox.Textが変更されたとき（ユーザーが入力を開始したときなど）に検出し、非数字を許可しないためにstring.gsub()関数を使用します。

テキスト入力を数字に制限する
local textBox = script.Parent

local function allowOnlyNumbers()
	textBox.Text = string.gsub(textBox.Text, "%D", "")
end

textBox:GetPropertyChangedSignal("Text"):Connect(allowOnlyNumbers)

テキストフィルタリング

さまざまなソースや入力に適用されるテキストフィルタリングは、ユーザーが不適切な言語や電話番号などの個人情報を目にするのを防ぎます。Robloxは、ゲーム内テキストチャットを通過したメッセージなど、一般的なテキスト出力を自動的にフィルタリングしますが、明示的な管理がない表示されるテキストはすべてフィルタリングする責任があります、ユーザーがテキスト入力を通じて入力する文字/文字列を含めて。