テキスト入力

Text Input 分類は nl.textInput ウィジェットの Self ノード集合です。ノードは3つで、いずれも同じもの、すなわちフィールドの実行時の値を扱います。これらは nl.textInput 要素自身の widgetMain ブループリントのパレットにのみ現れ、その要素に対して作用します。別のフィールドにアクセスするには、Element 分類にある同名の blueprint.element.textInput.* ノードを使用してください。これは element:nl.textInput 入力を取ります。

ノードが3つしかないのは、実行時の値がこの文字列以外に何も運ばないためです。placeholder、readOnly、disabled、inputMode、maxLength は作者が設定する props のままであり——これらへのブループリントによるパッチは静かに破棄されるため、対応するノードは一切提供されません。入力への反応は、Events 分類にあるこのウィジェットの Value Changed と Submit イベントで処理してください。

規約

• ターゲットピンはありません。 Self ノードには Element 入力がなく、ブループリントの実行元からターゲットを解決します。
• この値はセッション状態です。 プレイヤーが入力した内容はそのセッションの実行時ストアに存在し、プロジェクトドキュメントに書き戻されることはありません。Get Text はそのストアを読み取り、Set Text と Clear Text はそこに書き込みます。作者が設定した props.value は、フォールバック時の起点にすぎません。
• Get Text は Pure、2つの書き込みノードは Latent です。 読み取りは event、function、macro グラフで合法です。書き込みはグラフを一時停止させるため function グラフには置けません——function は同期的に戻るため、保留中の書き込みを置いておく場所がありません。
• Blueprint Value では使用できません。 Blueprint Value の宿主は widgetValue であり、これらのノードのスコープは widgetMain であるため、Get Text はそのパレットには現れません。Blueprint Value 内であるフィールドを読み取るには、Element を対象とした Get Text を Element のリテラルとともに使用してください。
• 書き込みにはゲームの実行が必要です。 ホスト API はブループリントの実行時の下でのみ存在します。エディターのキャンバス上では、書き込みノードは Host API unavailable (use Dev Mode) で失敗し、Get Text は何も生成しません。
• 書き込まれた値もクランプされます。 改行は単一のスペースに畳み込まれます——単一行のフィールドは、グラフから改行を紛れ込ませてはいけません——また、maxLength がゼロでない場合は文字列がその長さに切り詰められます。ただし inputMode のフィルターは適用されません。これはキーボード上で不正なキー入力を拒否する仕組みであるため、ブループリントは number フィールドに文字を書き込むことができます。
• ブループリントによる書き込みはキー入力ではありません。 値を移動させ、flush をキューに入れるだけです。Value Changed と Submit はプレイヤーの入力によってのみ発生し、Set Text や Clear Text によって発生することはありません。そのため、自分自身のフィールドに書き戻すハンドラーが無限ループに陥ることはありません。
• 何も変わらない書き込みは何もしません。 フィールドがすでに保持している値を設定しても flush はキューに入らず、要素は On Flush を発行しません。

Get Text

blueprint.textInput.getValue · Pure

フィールドの現在の値と、その長さを合わせて読み取ります。これにより、「空かどうか / 十分な長さかどうか」というよくある判定のために別の文字列ノードを用意する必要がなくなります。

Set Text

blueprint.textInput.setValue · Latent

フィールドの値を置き換えます。実行時ストアに直接書き込み、フォーカスは移動させません。

Clear Text

blueprint.textInput.clear · Latent

空文字列を書き込みます。何も接続していない Set Text と同じですが、カード上でその意図を明示します。