axe DevTools拡張機能の設定

This page is not available in the language you requested. You have been redirected to the English version of the page.
Link to this page copied to clipboard
Free Trial
Not for use with personal data

axe DevToolsブラウザ拡張機能の設定により、axe-coreバージョン、テスト基準、ルールセット、使用状況データの収集、機械学習、ベストプラクティスなどの機能を制御できます。ただし、ほとんどのユーザーにとって、デフォルトのaxe DevTools拡張機能の設定で問題なく動作します。このページでは、組織内でaxe DevTools拡張機能を設定する方法を説明します。

tip

プライベートクラウドのDevToolsサーバーをお持ちですか?プライベートクラウド用axe DevTools拡張機能の設定について詳しくはこちらをご覧ください。

tip

組織全体、および複数のDeque製品全体でこれらの設定を制御したいですか?axe設定をご覧ください!

拡張機能設定ページによる設定

拡張機能のスプラッシュ画面、「オプション」メニューを展開

ユーザーは、上部のメニューバーにある「オプション」(三点アイコン)メニュー項目をクリックし、「設定」メニュー項目をクリックすることで、拡張機能の設定ページにアクセスできます。

利用可能な設定

note

Proユーザーが一貫した結果を体験できるように、axe DevToolsはセッションが終了した後でも設定を記憶します。

外観

ブラウザ拡張機能の外観設定のスクリーンショット

設定名 説明
言語 拡張機能のテキストで使用される言語。
  • ブラウザのデフォルトを使用(デフォルト)
  • 英語
  • フランス語
  • 日本語
ハイライトテーマ 要素がハイライトされるときに使用されるハイライトテーマ
  • 高コントラスト(デフォルト)
  • Devtools
拡張機能テーマ 拡張機能UIのカラーテーマ。
  • ブラウザの設定に従う
  • ダーク
  • ライト

ルールと問題

ブラウザ拡張機能のルールと問題設定のスクリーンショット

設定名 説明
ベストプラクティス ベストプラクティスルールが有効になっているかどうかを決定します。これはフィルターとして機能し、テストを再実行せずに見つかった適用可能なベストプラクティスの問題を表示できます。
  • 有効
  • 無効(デフォルト)
アクセシビリティ基準を選択 すべての問題をフィルターするためのアクセシビリティ基準です。Trusted Tester v5は、axe-coreバージョン4.7.1以降でのみサポートされ、IGTの問題には現在TTv5タグが付いていません。RGAA 4は、axe-coreバージョン4.11.0以降でのみサポートされています。
  • すべて
  • WCAG 2.2 AAA
  • WCAG 2.2 AA
  • WCAG 2.2 A
  • WCAG 2.1 AAA
  • WCAG 2.1 AA
  • WCAG 2.1 A
  • WCAG 2.0 AAA
  • WCAG 2.0 AA
  • WCAG 2.0 A
  • Trusted Tester v5
  • RGAA 4
実験的ルール(Proプランのみ) 実験的ルールが有効かどうかを決定します。実験的ルールが無効の場合、これらのルールは実行されず、実験的ルールからの適用可能な問題を表示するためにテストを再実行する必要があります。
  • 有効
  • 無効(デフォルト)
axe-coreバージョンを選択(Proプランのみ) スキャンとインテリジェントガイドテストに使用されるaxe-coreバージョン。
  • 最新

さらに以下のバージョンも含む:

  • 初期のマイナーリリースから6ヶ月未満のaxe-coreのすべてのパッチバージョン
  • 上記のポリシー以外で常に含まれるaxe-coreの3つ前のパッチバージョン
  • 初期のマイナーリリースから15ヶ月未満のaxe-coreのすべてのマイナーバージョン
レビューが必要なオプション(Proプランのみ) レビューが必要な項目がどのように処理されるかを構成します。
  • レビューが必要な問題を有効にして、自動問題合計に含める
  • レビューが必要な問題を有効にするが、自動問題合計に含めない
  • レビューが必要な項目を完全に無効にする
カラーツールのコントラスト動作(Proプランのみ) 色のコントラストツール(「レビューが必要」な色のコントラスト項目が問題であるかどうかを自動的に判断するツール)が実行されるかどうか。また、色のコントラストツールを実行するには、「レビューが必要なオプション」が有効になっている必要があります。

「アクセシビリティ基準を選択」や「axe-coreバージョンを選択」といった特定のデフォルト値がどこから来たのかを示します:

  • 「(組織のデフォルト)」:指定された設定について、企業組織が設定したデフォルト値(管理者がaxe設定で設定)
  • 「(ユーザーのデフォルト)」:指定された設定について、現在のユーザーが設定したデフォルト値(axe設定でユーザーが設定)
  • 「(axeのデフォルト)」:指定された設定について、axe拡張機能のデフォルト値
tip

要レビュー、ベストプラクティス、およびWCAGレベルはすべてフィルターとして機能します。つまり、これらの設定のいずれかを変更すると、すべての以前のテストデータと問題が、テストを再実行することなくそれに応じて更新されます。

エクスポート設定(プロプランのみ)

ブラウザ拡張機能のエクスポート設定のスクリーンショット

設定名 説明
エクスポートスキーマ CSV問題のエクスポートスキーマ。
  • axe DevTools Pro(デフォルト)
  • axe DevTools Reporter

詳細設定(プロプランのみ)

ブラウザ拡張機能の詳細設定のスクリーンショット

設定名 説明
共有問題のスクリーンショットを有効にする 共有問題にスクリーンショットを追加できるようにします。
  • 有効(デフォルト)
  • 無効
AI駆動機能 AI駆動機能は、人的関与が必要なことを自動化する機能を最適化することで、時間を節約し、正確な結果を保証します。
  • 有効(デフォルト)
  • 無効
AIデータ共有 有効にした場合、スクリーンショットを含むテストデータがAIのトレーニングと改善に使用されます。
  • 有効(デフォルト)
  • 無効
important

機械学習を有効にするの設定はaxe DevTools Extension v4.113.4で廃止されています。今後、AI機能とデータプライバシーに関するより詳細な制御のためにAI駆動機能AIデータ共有の設定を使用してください。

移行ガイダンス:

  • 以前の機械学習を有効にするの設定は、機械学習の拡張が有効かどうかを制御していました。
  • 同等の機能を維持するには、AI駆動機能AIデータ共有の両方を有効にします。
  • AI機能やデータ共有を制限したい場合は、これらの設定を独立して構成し、より細かい制御を行うことができます。

サーバー設定

ブラウザ拡張機能のサーバー設定のスクリーンショット

設定名 説明
デフォルト(サーバー)設定を使用 axeサーバーURLおよび使用データのデフォルト設定を使用します(下記参照)。
  • オン / チェック済み(デフォルト)
  • オフ / 未チェック
axeサーバーURL axe DevToolsサーバーのURLです(axeアカウントポータル)。Dequeのクラウドまたは自身のホスティングインスタンスでプライベートサーバーを使用している場合にのみ変更が必要です。 https://axe.deque.com(デフォルト)
使用データを送信 アプリケーションの使用に関する分析データに加えて、テスト結果。
  • オン / チェック済み(デフォルト)
  • オフ / 未チェック
使用サービスURL 使用データが送信されるサーバーのURL。 https://usage.deque.com(デフォルト)
使用サービス組織名 使用分析にメタデータとして追加する組織名。Dequeの使用サービスを利用する場合は、以下のセクションを参照してください。 なし(デフォルト)
使用サービス部門名 使用分析にメタデータとして追加する部門名。Dequeの使用サービスを利用する場合は、以下のセクションを参照してください。 なし(デフォルト)
使用サービスアプリケーション名 使用分析にメタデータとして追加するアプリケーション名。Dequeの使用サービスを利用する場合は、以下のセクションを参照してください。 なし(デフォルト)

オフラインモード(エンタープライズ機能)

ブラウザ拡張のオフラインモード設定のスクリーンショット

設定名 説明
オフラインモードを有効にする オフラインモード機能を有効にするかどうか。
  • 未チェック(デフォルト)
  • チェック済み
オフラインライセンスキー オフラインモードエンタープライズサブスクリプションのライセンスキーを入力する場所。

使用サービス組織/部門/アプリケーション

Dequeの使用サービス報告を利用している場合、次を使用してください:

  • 使用サービス組織:Dequeの担当者(プロジェクトマネージャー/営業担当)から組織の識別子を取得する
  • 使用サービス部門:使用サービスで追跡したい異なるチーム/製品を表すユニークな値を決定する。これらの値は様々なグループによって「部門」値として使用されるべきです。
  • 使用サービスアプリケーション:上の部門と同様に、アプリケーション設定を使用してより詳細なデータ表現を行うことができます。この設定により、使用データに別の属性を添付することができます。

拡張ポリシーによる設定

ChromeとEdgeでは、管理者がユーザーの環境を構成し、インストールされた拡張機能のオプションを詳細に制御する方法を提供します。ポリシーによって設定された各設定は、自動的に適用され、「ロック」され(無効化され、変更できない)、すべてのユーザーに対して適用されます。ポリシーによって構成されていない設定については、ユーザーが自由に値を変更できるようになります。

オフラインモード機能の「オフライン」性質のため、axe設定を取り込むことはできません。その結果、組織全体のオフラインモードユーザーの設定を制御する唯一の方法は、以下に示す拡張ポリシーによるものです。

tip

ポリシー設定ではなく、axe設定を使用することをお勧めします。それはより柔軟性があり、メンテナンスも少なくて済みます。

note

axe設定とポリシーの両方で設定されている場合は、ポリシーの値に対してaxe設定の値が優先されます。

important

Google ChromeストアからMicrosoft Edgeにaxe DevTools拡張をダウンロードした場合、Chrome拡張ID(lhdoppojpmngadmnindnejefpokejbdd)が使用されます。(Microsoft Edgeで使用するためにChrome拡張をダウンロードすることが可能です。)そうでなければ、Microsoft Edgeストアから拡張をダウンロードする場合、拡張IDは以下のWindowsレジストリキーに示されるようにkcenlimkmjjkdfcaleembgmldmnnlfknになります。

MacOSポリシー設定

desired policy設定を含むconfiguration.plistファイルを作成します(サポートされる特定のプロパティの内訳については、以下の表を参照してください):

<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
<plist version="1.0">
<dict>
<key>com.google.Chrome.extensions.lhdoppojpmngadmnindnejefpokejbdd</key>
  <dict>
    <key>AxeURL</key>
    <dict>
      <key>state</key>
      <string>always</string>
      <key>value</key>
      <string>https://axe.biz</string>
    </dict>
    <key>UsageServiceURL</key>
    <dict>
      <key>state</key>
      <string>always</string>
      <key>value</key>
      <string>https://usage.biz</string>
    </dict>
    <key>DataGather</key>
    <dict>
      <key>state</key>
      <string>always</string>
      <key>value</key>
      <true />
    </dict>
  </dict>
</dict>
</plist>

次のコマンドを実行してplistファイルを読み込みます:

dscl -u YOUR_OS_ADMIN_USERNAME /Local/Default -mcximport /Computers/local_computer ./configuration.plist
note

上記のdsclコマンドがパスが無効であるというエラーを投げる場合、次のコマンドを使用してローカルマシンのノードを作成できます:

$ GUID=\`uuidgen\`
$ ETHER=ifconfig en0 | awk '/ether/ {print $2}'
$ dscl -u admin_username /Local/Default -create /Computers/local_computer
$ dscl -u admin_username /Local/Default -create /Computers/local_computer RealName "Local Computer"
$ dscl -u admin_username /Local/Default -create /Computers/local_computer GeneratedUID $GUID
$ dscl -u admin_username /Local/Default -create /Computers/local_computer ENetAddress $ETHER

最後に、次のコマンドを実行して変更を反映します:

sudo mcxrefresh -n YOUR_OS_ADMIN_USERNAME

Windowsポリシー設定

Windowsでは、レジストリエントリを作成することでポリシーが適用されます。

以下はレジストリエントリの例です:

Windows Registry Editor Version 5.00

[HKEY_LOCAL_MACHINE\Software\Policies\Google\Chrome\3rdparty\extensions\lhdoppojpmngadmnindnejefpokejbdd\policy]
"PROPERTY_NAME"="PROPERTY_VALUE"

ここで、PROPERTY_NAMEは以下のプロパティの1つであり、PROPERTY_VALUEはプロパティの任意の有効な値です(以下の「タイプ」列に基づく)。 複数のプロパティを宣言する必要がある場合は、改行で区切るべきです。

複数のプロパティが宣言された完全な例
 [HKEY_LOCAL_MACHINE\Software\Policies\Google\Chrome\3rdparty\extensions\lhdoppojpmngadmnindnejefpokejbdd\policy]
 "DataGather"="1"
 "UsageServiceURL"=https://usage.deque.com"
 "EnableAutomaticColorContrast"="1"
 "WCAGLevel"="wcag21aa"
 "IncludedNeedsReviewInIssueCount"="1"
 "AutomaticColorContrastReview"="Manual"

ポリシー経由で設定可能な設定一覧

プロパティ名 関連するaxe DevTools設定 タイプ
AxeURL axeサーバーURL テキスト
DataGather 使用データを送信 ブーリアン(Windowsレジストリにテキストとして設定 - trueの場合は「1」、falseの場合は「0」)
UsageServiceURL 使用サービスのURL テキスト
UsageServiceOrganization 使用サービス組織 テキスト
UsageServiceDepartment 使用サービス部門 テキスト
UsageServiceApplication 使用サービスアプリケーション テキスト
EnableIssueScreenshots 共有された問題のスクリーンショット ブーリアン(Windowsレジストリにテキストとして設定 - trueの場合は「1」、falseの場合は「0」)
EnableMachineLearning 機械学習 ブーリアン(Windowsレジストリにテキストとして設定 - trueの場合は「1」、falseの場合は「0」)
EnableAutomaticColorContrast 色のコントラストツールの動作 ブーリアン(Windowsレジストリにテキストとして設定 - trueの場合は「1」、falseの場合は「0」)
DisableAllScreenshots これはポリシーのみの設定であり(設定ページにはありません)、永続的なスクリーンショットを作成するすべての機能を無効にします。 ブーリアン(Windowsレジストリにテキストとして設定 - trueの場合は「1」、falseの場合は「0」)
WCAGLevel(非推奨、代わりにAccessibilityStandardを使用してください) WCAGレベルを選択(許可される値はAccessibilityStandardを参照) テキスト
AccessibilityStandard アクセシビリティ標準を選択。利用可能な値は次のとおりです:
  • wcag22aaa
  • wcag22aa
  • wcag22a
  • wcag21aaa
  • wcag21aa
  • wcag21a
  • wcag2aaa
  • wcag2aa
  • wcag2a
  • TTv5
テキスト
AxeVersion axe-coreのバージョンを選択(許可される値は上記の表を参照) テキスト
DisableIGT これはポリシーのみの設定であり(設定ページにはありません)、すべてのIGTを無効化/非表示にします。 ブーリアン(Windowsレジストリにテキストとして設定 - trueの場合は「1」、falseの場合は「0」)
IncludeNeedsReviewInIssueCount 自動的な問題に"レビューが必要"な問題を含める ブーリアン(Windowsレジストリにテキストとして設定 - trueの場合は「1」、falseの場合は「0」)
AutomaticColorContrastReview 色のコントラストツールの動作 テキスト("automatic"は「各スキャン後に自動的に実行」と同等、"manual"は「実行するタイミングを選択(推奨)」と同等です。)
DisableNeedsReview レビューが必要なオプション ブーリアン(Windowsレジストリにテキストとして設定 - trueの場合は「1」、falseの場合は「0」)
OfflineLicenseKey オフラインモード/オフラインライセンスキーを有効にする。ポリシーで設定された場合、ユーザーにはライセンスキーが非表示になります。 テキスト
RequireLogin 関連する設定はありません;trueに設定すると、すべてのユーザーは拡張機能を使用する前にログインが必須となります。 ブーリアン(Windowsレジストリにテキストとして設定 - trueの場合は「1」、falseの場合は「0」)
HideSocialProviders 関連設定なし。trueに設定されると、GoogleやGitHubなどのソーシャルログインオプションでログインすることはできません。 ブール値(Windowsレジストリではテキストとしてセット - 「1」はtrue、「0」はfalse

追加リソース

ユーザーのマシンと拡張機能を設定するためのポリシーを活用する方法についての詳細は、以下にリンクするWindows、FirefoxおよびChromeのそれぞれの文書を参照してください。