ページが読み込まれたとき、 この振る舞いによって 指定されたフィールドにフォーカスを設定します。 この振る舞いが行われない場合、ブラウザーは通常初期フォーカスをツールバーの「URL」フィールドに設定します。
フィールドが指定されている場合は、 そのフィールドがフォーカスされます。 それ以外の場合は、 そのページのタブ順序における 最初のフィールドがフォーカスされます。
<hx:inputHelperSetFocus>
<body> のみで使用します。
hX_5.addBehavior("#body", "onload", new hX_5.JSFBehaviorFocus(attributes)); 各部の意味は次のとおりです。
属性 |
コンマで区切られた属性のリスト。 各属性は、属性名と値から成る引用符付きストリングになっており、 コロンで区切られています (例: "label:MyLabel")。 |
特殊な ID #body の使用には注意してください。
イベント |
説明 |
---|---|
onload |
この振る舞いは、ページに初期フォーカスを指定するためにのみ使用できます。 |
属性名 |
説明 |
---|---|
focus-id |
フォーカスされているフィールドの ID。 省略した場合、ページのタブ順序で最初にくるフィールドがフォーカスされます。 |
select |
true の場合、フィールドの内容が選択されます (選択可能な場合)。 それ以外の場合、 フィールドがフォーカスされているときに ブラウザーで強制的に選択しない限り、 フィールドの内容は未選択のままになります。 |
イベント用に指定された他のハンドラーのあとに、実行されます。
イベントを停止しません。
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"));