diff --git a/files/ja/web/api/shadowroot/delegatesfocus/index.md b/files/ja/web/api/shadowroot/delegatesfocus/index.md index 3283d521ff23d1..9ae871c425b859 100644 --- a/files/ja/web/api/shadowroot/delegatesfocus/index.md +++ b/files/ja/web/api/shadowroot/delegatesfocus/index.md @@ -1,28 +1,39 @@ --- -title: ShadowRoot.delegatesFocus +title: "ShadowRoot: delegatesFocus プロパティ" +short-title: delegatesFocus slug: Web/API/ShadowRoot/delegatesFocus +l10n: + sourceCommit: 26091e4af9c73bb6c5d1466df5070c949498fdbd --- {{APIRef("Shadow DOM")}} **`delegatesFocus`** は {{domxref("ShadowRoot")}} インターフェイスの読み取り専用プロパティで、シャドウルートがフォーカスを委任する場合は `true`、そうでなければ `false` を返します。 -`true` の場合、シャドウ DOM のフォーカスを受け取れない部分がクリックさると、フォーカスを受け取ることができる最初の部分がフォーカスを受け取り、シャドウホストが `:focus` のスタイルになります。 +`true` の場合、シャドウ DOM のフォーカスを受け取れない部分がクリックされるか、ホスト要素に対して `.focus()` が呼び出されると、フォーカスを受け取ることができる最初の部分がフォーカスを受け取り、シャドウホストが `:focus` のスタイルになります。 -このプロパティの値は {{domxref("Element.attachShadow()")}}) に渡されたオブジェクトの `delegatesFocus` プロパティを使用して設定します。 +キーボードのユーザー(スクリーンリーダーを使用するユーザーも含む)にとっては、フォーカスが特に重要です。 `delegatesFocus` の既定の動作は、最初のフォーカス可能な要素にフォーカスを当てるというものです。これは、その要素がタブ順序の一部として意図されていない場合(例えば、`tabindex="-1"` の要素)や、より「重要な」フォーカス可能な要素に初期フォーカスを当てるべき場合(例えば、最初のテキストフィールドをその前にある「閉じる」ボタンより優先させるなど)には望ましくない場合があります。このような場合、初期フォーカスを受け取る要素に `autofocus` 属性を指定することができます。 `autofocus` 属性は、アクセシビリティに関する課題を引き起こす可能性があるため、使用する際には注意が必要です。例えば、DOM の順序が後にある要素にフォーカスが設定されているために気づかないような重要なコンテンツを回避するといった課題です。 + +このプロパティ値は、元々、{{domxref("Element.attachShadow()")}} に渡すオブジェクトの `delegatesFocus` プロパティを使用するか、またはシャドウルートを宣言的に作成する際の [`