アクセシブルな web ページとサイトを作成するための RTE の設定

Adobe Experience Manager は、様々なアクセシビリティ標準に従ったユーザーフレンドリーなアクセシビリティ機能をサポートしています。また、開発者は、リッチテキストエディター（RTE）を使用する Experience Manager コンポーネントを使用して、アクセシブルなコンテンツを作成するのに役立つ機能を提供するようカスタマイズまたは拡張できます。

Web ページをデザインし、そのページにコンテンツを追加する際に、コンテンツ開発者や作成者は RTE の機能を使用してアクセシビリティ関連の情報を提供できます。例えば、見出しから段落要素に至るまでの構造情報を追加できます。

これらの機能を設定およびカスタマイズするには、コンポーネントの RTE プラグインを設定します。例えば、paraformat プラグインを使用すると、ブロックレベルのセマンティック要素を追加できます。具体的には、デフォルトで提供される基本の H1、H2 および H3 に加え、見出しレベルの数を拡張する機能がサポートされます。

RTE は、タッチ操作対応 UI とクラシック UI 用の様々なコンポーネントで使用できます。ただし、RTE を使用する主なコンポーネントは​テキスト​コンポーネントで、これは両方のインターフェイスで使用できます。次の画像は、paraformat をはじめ様々なプラグインが有効になっている RTE を示しています。

図：タッチ操作対応 UI のテキストコンポーネント

図：クラシック UI のテキストコンポーネント

様々なインターフェイスで利用できる RTE 機能の違いについては、プラグインとその機能を参照してください。

プラグイン機能の設定

RTE の設定手順について詳しくは、リッチテキストエディターの設定ページを参照してください。ここでは、次の主な手順を含め、すべての項目について説明します。

• プラグインとその機能
• 設定場所
• プラグインのアクティベートと features プロパティの設定
• RTE のその他の機能の設定

CRXDE Lite の適切な rtePlugins サブブランチ内でプラグインを設定することにより、そのプラグインのすべての機能または特定の機能をアクティベートできます。

例 - RTE 選択フィールドで使用可能な段落形式を指定

意味的ブロックの新しい書式を選択可能にするには、次の手順を実行します。

1. 使用している RTE によって、設定場所を特定し、移動します。

2. プラグインをアクティベートすることにより、段落選択フィールドを有効にします。

3. 段落選択フィールドで使用可能にする書式を指定します。

4. これにより、コンテンツ作成者は、指定した段落書式を RTE の選択フィールドから選択できます。アクセス方法は次のとおりです。

   • タッチ操作対応 UI で段落記号アイコンを使用。
   • クラシック UI で「フォーマット」フィールド（ポップアップセレクター）を使用。

段落書式オプションを介して RTE で構造要素を使用できるので、AEM はアクセシブルなコンテンツの開発に適した基盤を提供します。コンテンツ作成者は、RTE を使用してフォントのサイズや色、その他の関連する属性を書式設定できないので、インライン書式設定は作成できません。代わりに、見出しなどの該当する構造要素を選択し、「スタイル」オプションから選択されるグローバルスタイルを使用する必要があります。これにより、独自のスタイルシートで閲覧するユーザーにとってはマークアップがクリーンになり、オプションも多くなるほか、コンテンツの構造が正確になります。

ソース編集機能の使用

コンテンツ作成者が、RTE を使用して作成された HTML ソースコードを調査および調整することが必要になる場合があります。例えば、WCAG 2.0 を確実に準拠するため、RTE 内で作成されたコンテンツの一部で追加のマークアップが必要となることがあります。これを行うには、RTE のソースの編集オプションを使用します。sourceedit 機能は misctools プラグインで指定できます。

その他の HTML 要素および属性のサポートを追加

AEM のアクセシビリティ機能をさらに拡張するには、RTE に基づく既存のコンポーネント（テキスト​コンポーネントや​テーブル​コンポーネントなど）を、要素や属性を追加して拡張することができます。

以下の手順では、支援テクノロジーのユーザーにデータテーブルに関する情報を提供する​キャプション​要素で​テーブル​コンポーネントを拡張する方法について説明します。

例 - テーブルのプロパティダイアログへのキャプションの追加

TablePropertiesDialog のコンストラクターで、キャプションの編集に使用するテキスト入力フィールドを追加します。itemId は、コンテンツを自動的に処理するために、caption（つまり、DOM 属性の名前）に設定する必要がある点に注意してください。

テーブル​で、DOM 要素に属性を明示的に設定したり削除したりします。値は、config オブジェクトのダイアログによって渡されます。DOM 属性は、ブラウザーの実装に伴う一般的な落とし穴を回避するために、対応する CQ.form.rte.Common メソッド（com は CQ.form.rte.Common のショートカット）を使用して、設定／削除する必要があります。

例 - テキストで強調を使用する際のアクセシブルな HTML の作成

RTE は b および i の代わりに strong および em タグを使用できます。次のノードを兄弟として、ダイアログの uiSettings および rtePlugins ノードに追加します。

<htmlRules jcr:primaryType="nt:unstructured">
    <docType jcr:primaryType="nt:unstructured">
        <typeConfig jcr:primaryType="nt:unstructured"
                useSemanticMarkup="{Boolean}true">
            <semanticMarkupMap
                    b="strong"
                    i="em"/>
        </typeConfig>
    </docType>
</htmlRules>

詳しい手順

1. CRXDE Lite を開始します。例：http://localhost:4502/crx/de/

2. コピー：

   /libs/cq/ui/widgets/source/widgets/form/rte/commands/Table.js

   コピー先：

   /apps/cq/ui/widgets/source/widgets/form/rte/commands/Table.js

   メモ

   中間フォルダーが存在しない場合は、作成する必要があります。

3. コピー：

   /libs/cq/ui/widgets/source/widgets/form/rte/plugins/TablePropertiesDialog.js

   コピー先：

   /apps/cq/ui/widgets/source/widgets/form/rte/plugins/TablePropertiesDialog.js。

4. 次のファイルを編集用に開きます（ダブルクリックで開く）。

   /apps/cq/ui/widgets/source/widgets/form/rte/plugins/TablePropertiesDialog.js

5. constructor メソッドで、次の行を読み込む前に：

   var dialogRef = this;
   

   次のコードを追加します。

   editItems.push({
       "itemId": "caption",
       "name": "caption",
       "xtype": "textfield",
       "fieldLabel": CQ.I18n.getMessage("Caption"),
       "value": (this.table && this.table.caption ? this.table.caption.textContent : "")
   });
   

6. 次のファイルを開きます。

   /apps/cq/ui/widgets/source/widgets/form/rte/commands/Table.js。

7. transferConfigToTable メソッドの最後に次のコードを追加します。

   /**
    * Adds Caption Element
   */
   var captionElement;
   if (dom.firstChild && dom.firstChild.tagName.toLowerCase() == "caption")
   {
      captionElement = dom.firstChild;
   }
   if (config.caption)
   {
       var captionTextNode = document.createTextNode(config.caption)
       if (captionElement)
       {
          dom.replaceNode(captionElement.firstChild,captionTextNode);
       } else
       {
           captionElement = document.createElement("caption");
           captionElement.appendChild(captionTextNode);
           if (dom.childNodes.length>0)
           {
              dom.insertBefore(captionElement, dom.firstChild);
           } else
           {
              dom.appendChild(captionElement);
           }
       }
   } else if (captionElement)
   {
     dom.removeChild(captionElement);
   }
   

8. すべて保存​を使用して変更を保存します。