ADF Facesの入力コンポーネントやコマンドおよび移動コンポーネントでのアクセス・キーのサポートによって、キーボードを使用してコンポーネントやリンクにアクセスする別の方法が提供されます。[Tab]キーを使用すると、Webアプリケーション内の特定のコントロールから次のコントロールに移動できますが、キーボード・ショートカットを使用すると、さらに便利で効率的です。コンポーネントにキーボード・ショートカットを提供するには、コンポーネントに対するラベルの定義やキーの指定が必要です。
入力コンポーネントまたはコマンド・コンポーネントに対してアクセス・キーを指定するには、通常、そのコンポーネントのaccessKey
属性を、コンポーネントへの簡単なアクセスに使用する文字キー(または数字キー)に設定します。次の項では、コンポーネントへのアクセス・キー指定に使用できるすべての属性について説明します。
次のいずれかの属性を使用して、簡単にアクセスできるキーボード・キーを指定します。
accessKey
: コンポーネントへの簡単なアクセスに使用するニーモニック文字。たとえば、goLink
コンポーネントのaccessKey
を文字"h"に設定した場合は、ユーザーが[Alt]キーを押しながら[h]キーを押すと、goLink
のtext
値にフォーカスが設定されます。コマンドおよび移動コンポーネントでは、この属性によって指定された文字がコンポーネント・インスタンスのtext
属性に存在している必要があります。存在しない場合は、コンポーネントにアクセス・キーがあることを示す表示は表示されません。
textAndAccessKey
: アンパサンド文字(&
)を使用したコンポーネントのテキストとニーモニック文字。JSPXファイルでは、通常のアンパサンド表記は&
です。JSPファイルでは、アンパサンド表記は単に&
です。たとえば、JSPXで、commandButton
コンポーネントのtextAndAccessKey
を"&Home
"に設定すると、ボタン・テキストにHomeが指定され、アクセス・キーがH(アンパサンド直後の文字)に設定されます。
labelAndAccessKey
: textAndAccessKey
に類似していますが、この属性は、通常のアンパサンド表記を使用して、(入力コンポーネントの)label
属性とアクセス・キーの両方を同時に設定する点が異なります。たとえば、selectInputDate
コンポーネントのlabelAndAccessKey
を"D&ate
"に設定すると、ラベルにDateが指定され、アクセス・キーがa(アンパサンドの直後の文字)に設定されます。
valueAndAccessKey
: textAndAccessKey
に類似していますが、この属性は、通常のアンパサンド表記を使用して、value
属性とアクセス・キーの両方を同時に設定する点が異なります。たとえば、outputLabel
コンポーネントのvalueAndAccessKey
を"Select D&ate
"に設定すると、ラベルにSelect Dateが指定され、アクセス・キーがa(アンパサンドの直後の文字)に設定されます。
<af:goLink text="Home" accessKey="h"/>
<af:commandButton text="commandButton 0" textAndAccessKey="&Home"/>
<af:selectInputDate value="Choose date" labelAndAccessKey="D&ate"/>
<af:outputLabel for="someid" valueAndAccessKey="Nam&e"/>
<af:inputText simple="true" id="someid"/>
同じアクセス・キーを複数のコンポーネントにバインドできます。同じアクセス・キーが同じページの複数の箇所に表示される場合、レンダリングを行うエージェントは、同じキーでアクセスされるコンポーネント間を順に移動します。つまり、アクセス・キーを押すたびに、特定のコンポーネントから別のコンポーネントにフォーカスが移動します。最後のコンポーネントまでフォーカスが移動すると、フォーカスは最初のコンポーネントに戻ります。
goButton
およびgoLink
コンポーネントでアクセス・キーを使用すると、各コンポーネントが複数のブラウザでただちにアクティブになることがあります。ブラウザによっては、1つのページ内の2つ以上のリンクに対して同じアクセス・キーが割り当てられている場合は、同じキーでアクセスされるコンポーネント間を移動せずに、最初のコンポーネントがアクティブになることがあります。
注意:
shortDesc
属性)でなんらかの説明を提供できます。
ADF Faces入力コンポーネントでのラベルおよびメッセージ表示のサポートについて
Copyright © 1997, 2006, Oracle. All rights reserved.