ARIAロール必須属性を調べる

未認識の名前と抽象ロールはinvalid_inputで失敗し、存在しないロールの属性を呼び出し側が捏造しないようにします。同じ純テーブルがブラウザの無料ツールと、成功1件あたり$0.002のプリペイドAPIを支えます。

必須および推奨のARIA属性の意味

WAI-ARIA仕様では、具体ロールごとにRequired States and Properties（ロールを有効にするために著者が必ず付ける属性）と、パターンがより豊かな状態を必要とするときに支援技術が期待するSupported States and Propertiesが列挙されます。必須属性は譲れません。 aria-checkedのないcheckbox、aria-valuenowのないslider、aria-controlsとaria-expandedのないcomboboxは自動検査に失敗し、スクリーンリーダーを混乱させます。応答は、そのロールがアクセシブルネームを必須とするか、その名前がどう計算され得るか（著者属性、要素内容、または禁止）も報告します。directoryのような非推奨の具体ロールは照会可能ですがフラグが付き、移行ツールが照会を止めずに警告できます。本APIの推奨属性は、正しいキーボードとATの挙動のために著者がよく必要とするサポート済みプロパティです。仕様は著者による使用を禁じており、本エンドポイントはマークアップに現れてはならないロール向けの必須属性リストを作りません。

入力契約、応答形状、エラー挙動

要件が条件付きのときは任意のnotesが付きます。例えばフォーカス可能なseparatorにはaria-valuenow、aria-valuemin、aria-valuemaxが必要ですが、静的な装飾separatorには不要です。例：role checkboxは必須のaria-checkedと、readonly、required、disabled、ラベリング、エラーメッセージ属性を含む推奨集合を返します。例：role scrollbarは必須の4属性aria-controls、aria-valuenow、aria-valuemin、aria-valuemaxを返します。リントやデザインシステムの文書と組み合わせてください。必須の文字列フィールドroleを持つJSON本文をPOSTしてください。value、name、query、aria_roleの別名でも受け付けます。エンジンは空白を整え、トークンを小文字化し、role=やaria-roleなどの任意接頭辞を取り除き、内部の空白やアンダースコアを削除するので、column headerとcolumnheaderはどちらも解決します。成功時、本文は正規化済みrole、category、superclass、description、abstract false、ソート済み文字列配列のrequired_attributesとrecommended_attributes、required_countとrecommended_count、name_required、name_from、deprecated、WAI-ARIA 1.2に設定されたspecを返します。role欠落、空文字、未知の名前、抽象ロールは問題を名指しするメッセージ付きでinvalid_inputを投げ、課金されません。本エンドポイントはページをクロールしたりライブのマークアップを検証したりせず、一度に1つのロール名について仕様上の問いだけに答えます。

ARIAロール属性照合が役立つ場面

研修プラットフォームとWCAG講座は、ブラウザの無料経路を使い、受講者がcheckboxとswitch、dialogとalertdialogを特性表の暗記なしで比較できるようにします。テストでは返却されるソート済み配列を固定し、分類名を誤ってコピーする著者向けに抽象ロール拒否を文書化すれば、フルのアクセシビリティエンジンを立てずにスタイルガイド、MCPツール、エッジ検証器向けの安定した契約が得られます。アクセシビリティリンターとCIプラグインはAPIをオラクルとして呼び、ノード上のrole文字列から必須属性を取得し、欠けるものがあればビルドを失敗させます。実装は解析コストモデルのparseティアAのため、成功した呼び出しはいずれも公開の基本料金$0.002で、ワーカー分離環境でオフライン実行され、W3Cサイトの取得に依存しません。