<uix:textInput>タグ
ネームスペース: http://xmlns.oracle.com/uix/ui
派生元: <uix:formElement>タグ
タグの型: UINode

このタグは、ブラウザ入力テキスト項目を作成します。

構文
<uix:textInput
    [ columns="unsignedInt" ]
    [ maximumLength="unsignedInt" ]
    [ onChange="string" ]
    [ onSelect="string" ]
    [ required="ui:requiredType" ]
    [ rows="unsignedInt" ]
    [ secret="boolean" ]
    [ text="string" ]
    [ wrap="ui:wrap" ]
    [ enterClientActionBinding ="data binding to oracle.cabo.ui.action.ClientAction" ]
    [ onBlurValidaterBinding ="data binding to oracle.cabo.ui.validate.ClientValidater" ]
    [ onSubmitValidaterBinding ="data binding to oracle.cabo.ui.validate.ClientValidater" ]
    [ primaryClientActionBinding ="data binding to oracle.cabo.ui.action.ClientAction" ]
>
   <uix:contents><!-- indexed children --></uix:contents>
   <uix:onBlurValidater></uix:onBlurValidater>
   <uix:onSubmitValidater></uix:onSubmitValidater>
</uix:textInput>

注意:
  • このタグは派生元タグのすべての属性と子タグを持つことができます。

  • 説明

    このタグは、ブラウザ入力テキスト項目を作成します。 行数により、このコントロールはテキストフィールド(単一行コントロールの場合)またはテキスト領域(複数行コントロールの場合)のいずれかにマップされます。 パスワードなど、表示中に入力をユーザーから隠す必要がある場合、secretプロパティが使用されます。

    DecimalValidaterが設定されている場合、テキストは数値形式(ほとんどのロケールで右揃え)で入力されます。


    属性

    説明
    columns テキスト・コントロールに表示する列数。 値が指定されていない場合、デフォルトの30列が使用されます。 1列は、ブラウザの現行表示フォントの約1文字に相当します。
    unsignedInt
    maximumLength テキスト・コントロールに入力できる1行当たりの最大文字数。 この値は、表示される列とは無関係であることに注意してください。
    unsignedInt
    onChange 値が変更された場合のイベント・ハンドラ。
    string
    onSelect テキストが選択された場合のイベント・ハンドラ。
    string
    required 関連付けられたコントロールにユーザー入力が必要かどうか。 次の3つの値を指定できます。
    • "yes"

      このフィールドにはユーザー入力が必要で、しかも設定されたバリデータが検証に成功する必要があります。

    • "no"

      このフィールドは空か、または設定されたバリデータが検証に成功する必要があるかのいずれかです。

    • "validaterOnly"

      設定されたバリデータが検証に成功する必要があります。 したがって、検証の成功はバリデータにのみ依存し、テキストがこのフィールドに入力されているかどうかは関係ありません。

    これらはTextInputBeanに設定されたClientValidaterと対話して、フィールドの検証に成功したかまたは失敗したかを判断します。

    この属性のデフォルトはnoです。


    ui:requiredType
    rows テキスト・コントロールに表示する行数。 デフォルトは1です。 複数行に設定すると、secretなどの一部の属性が使用できなくなります。
    unsignedInt
    secret 単一行テキスト・コントロールに対してのみ適用されるブール値。 trueに設定されている場合、ユーザーが入力したテキストの実際の値を隠します。
    boolean
    text 入力フィールドのテキスト値。
    string
    wrap 複数行テキスト・コントロールで使用されるテキスト折返しのタイプ。 この属性は単一行コントロールでは無視されます。 デフォルトでは、複数行テキストは見た目には折り返されますが、送信される値に改行は含まれません。 offに設定すると、複数行テキストは折り返されず、横にスクロールします。 hardに設定すると、テキストの値に行の折返しに必要な改行を含めることを指定します。
    ui:wrap
    enterClientActionBinding ユーザーが[Enter]キーを押した場合に、クライアント上で起動するclientAction。 複数行のtextInputには適用されません。
    oracle.cabo.ui.action.ClientActionへのデータ・バインディング
    onBlurValidaterBinding TextInputBeanがキーボード・フォーカスを失った場合に、クライアント上で起動するclientValidater。
    oracle.cabo.ui.data.DataObjectへのデータ・バインディング
    onSubmitValidaterBinding TextInputBeanを含むフォームが送信された場合に、クライアント上で起動するclientValidater。
    oracle.cabo.ui.data.DataObjectへのデータ・バインディング
    primaryClientActionBinding textInputのテキストを変更した場合に、クライアント上で起動するclientAction。
    oracle.cabo.ui.action.ClientActionへのデータ・バインディング

    子タグ

    説明 必須 組込み可能な数
    <uix:contents>
    Beanの索引付けされた子。
    いいえ 1
    <uix:onBlurValidater>
    TextInputBeanがキーボード・フォーカスを失った場合に、クライアント上で起動するclientValidater。
    いいえ 1
    <uix:onSubmitValidater>
    TextInputBeanを含むフォームが送信された場合に、クライアント上で起動するclientValidater。
    いいえ 1