フォーカス振る舞い

ページのロード時に、指定されたフィールドや、ページのタブ順序の最初のフィールドに初期フォーカスを設定します。

ページが読み込まれたとき、 この振る舞いによって 指定されたフィールドにフォーカスを設定します。 この振る舞いが行われない場合、ブラウザーは通常初期フォーカスをツールバーの「URL」フィールドに設定します。

フィールドが指定されている場合は、 そのフィールドがフォーカスされます。 それ以外の場合は、 そのページのタブ順序における 最初のフィールドがフォーカスされます。

コンポーネントを発行する JSF タグ

<hx:inputHelperSetFocus>

基本 HTML

<body> のみで使用します。

JavaScript コンストラクター

hX_5.addBehavior("#body", "onload", new hX_5.JSFBehaviorFocus(attributes)); 各部の意味は次のとおりです。

属性

コンマで区切られた属性のリスト。 各属性は、属性名と値から成る引用符付きストリングになっており、 コロンで区切られています (例: "label:MyLabel")。

特殊な ID #body の使用には注意してください。

サポートされるイベント

イベント

説明

onload

この振る舞いは、ページに初期フォーカスを指定するためにのみ使用できます。

属性

表 1.

属性名

説明

focus-id

フォーカスされているフィールドの ID。 省略した場合、ページのタブ順序で最初にくるフィールドがフォーカスされます。

select

true の場合、フィールドの内容が選択されます (選択可能な場合)。 それ以外の場合、 フィールドがフォーカスされているときに ブラウザーで強制的に選択しない限り、 フィールドの内容は未選択のままになります。

順序付け

イベント用に指定された他のハンドラーのあとに、実行されます。

イベントを停止しません。

API 呼び出し

表 2. フォーカス振る舞い API 呼び出し

API 呼び出し

説明

object = setAttribute(attribute)

属性を設定します。 属性がすでに設定されたものである場合は、 その値を変更します。

string = getAttribute(attribute-name)

属性の現行値を取得します。

制限

サンプル・コード

そのページのタブ順序内の最初のフィールドに、フォーカスを設定します。 コンテンツを選択します。

hX.addBehavior("#body", "onload", new hX.JSFBehaviorFocus("select"));

指定されたフィールドにフォーカスを設定します。

hX.addBehavior("#body", "onload", new hX.JSFBehaviorFocus("focus-id:form1:menu2"));

フィードバック