メールテキストコンポーネント email-text-component

Last update: Mon Jul 15 2024 00:00:00 GMT+0000 (Coordinated Universal Time)

トピック：
コアコンポーネント

作成対象：

開発者
管理者
ユーザー

メールテキストコンポーネントは、インプレース編集機能を備えたリッチテキスト編集および作成用コンポーネントです。

使用方法 usage

メールテキストコンポーネントは、シンプルなインラインエディターでもフルスクリーン形式でも容易にテキスト編集を行える、堅牢なリッチテキストエディターを提供します。

編集ダイアログには、限定的なオプションのみのインライン編集機能と、すべての機能を利用できるフルスクリーン編集機能が用意されています。
デザインダイアログを使用して、見出し、特殊文字、段落スタイルなどのテキスト書式設定オプションをコンテンツ作成者のテンプレートに設定できます。

バージョンと互換性 version-and-compatibility

メールテキストコンポーネントの最新バージョンは v1 です。このバージョンは 2022年10月にメールコアコンポーネントのリリース X で導入され、このドキュメントで説明されています。

コンポーネントのすべてのサポート対象バージョン、コンポーネントの各バージョンと互換性のある AEM バージョン、以前のバージョンのドキュメントへのリンクを次の表に示します。

コンポーネントのバージョン

AEM 6.5

AEM as a Cloud Service

互換性あり

コアコンポーネントのバージョンとリリースについて詳しくは、メールコアコンポーネントのバージョンのドキュメントを参照してください。

技術的詳細 technical-details

メールテキストコンポーネントに関する最新の技術ドキュメントについては、GitHub を参照してください。

コアコンポーネントの開発について詳しくは、コアコンポーネント開発者向けドキュメントを参照してください。

メールテキストコンポーネントとリッチテキストエディター the-text-component-and-the-rich-text-editor

メールテキストコンポーネントでは、AEM リッチテキストエディター（RTE）を利用します。RTE には、コンテンツ作成者がテキストコンテンツの編集に使用できる幅広い機能が用意されています。RTE は設定の柔軟性が高く、数多くのオプションを提供しています。RTE の設定方法の詳細については、リッチテキストエディターの設定やリッチテキストエディタープラグインの設定を参照してください。

このドキュメントではこの後、標準の RTE 設定を使用したメールテキストコンポーネントの標準設定について説明します。

NOTE

メールテキストコンポーネントでは、RTE の UI 設定で有効になっているオプションのみ使用できます。

編集ダイアログ edit-dialog

テキストコンポーネントの編集ダイアログ

書式設定オプション options

編集ダイアログには、テキストの作成を支援する標準のリッチテキスト書式設定ツールが用意されています。

太字

選択したテキストに太字書式を適用したり、カーソルの後に入力したテキストに太字書式を設定したりするために使用します。

Ctrl + B をキーボードショートカットとして使用できます。

斜体

選択したテキストに斜体書式を適用したり、カーソルの後に入力したテキストに斜体書式を設定したりするために使用します。

Ctrl + I をキーボードショートカットとして使用できます。

下線

選択したテキストに下線書式を適用したり、カーソルの後に入力したテキストに下線書式を設定したりするために使用します。

Ctrl + U をキーボードショートカットとして使用できます。

下付き文字

選択したテキストまたはカーソルの後に入力したテキストを下付き文字として書式設定するために使用します。

上付き文字

選択したテキストまたはカーソルの後に入力したテキストを上付き文字として書式設定するために使用します。

テキストとして貼り付け

コピーしたテキストを書式設定のないプレーンテキストとして貼り付けます。

このオプションを選択すると、ウィンドウが開き、テキストを書式設定のないプレーンテキストとして貼り付けた状態を、実際に挿入する前にプレビューできます。続行する場合はチェックマークをタップまたはクリックし、キャンセルする場合は「x」をタップまたはクリックします。

「テキストとして貼り付け」の例

Word から貼り付け

このオプションを選択すると、ウィンドウが開き、書式設定を維持しながらテキストを貼り付けた状態を、実際に挿入する前にプレビューできます。続行する場合はチェックマークをタップまたはクリックし、キャンセルする場合は「x」をタップまたはクリックします。

「Word から貼り付け」の例

ハイパーリンク

このオプションを使用すれば、選択したテキストをハイパーリンクに変換したり、定義済みのリンクを変更したりできます。このオプションを選択すると、リンクを設定するための追加オプションを含むウィンドウが開きます。

ハイパーリンクの例

パスを入力
- 選択を開く ダイアログを使用して、AEM 内のパスを選択します
- リンクが AEM 内でない場合は、絶対 URL を入力します
  - 絶対パス以外は、AEM を基準とした相対パスとして解釈されます
リンクの説明用代替テキストを入力します
リンクの動作を選択します
- ターゲット
- 同じタブ
- 新しいタブ
- 親フレーム
- トップフレーム

リンクを適用する場合はチェックマークをタップまたはクリックし、キャンセルする場合は「x」をタップまたはクリックします。

リンク解除

選択したテキストに既に適用されているリンクを削除する場合は、このオプションを使用します。このオプションは、リンクが既に選択されている場合にのみ有効です。

アンカー anchor

テキストにアンカーを挿入するには、このオプションを使用します。

検索

指定した文字列をテキスト内で検索する場合は、このオプションを使用します。このオプションを選択すると、検索オプションを指定するためのウィンドウが開きます。

検索の例

検索するテキストを入力し、「検索」をタップまたはクリックして検索を開始します。キャンセルする場合は、「x」をクリックまたはタップします。大文字と小文字を区別して完全一致検索を行う場合は、「大文字小文字を区別して一致」オプションを選択してから検索を開始します。
一致する文字列が見つかった場合は、それが強調表示され、検索ダイアログが淡色表示になります。一致する次の文字列を検索するには、淡色表示のダイアログで「検索」ボタンを再度タップまたはクリックします。

検索例

一致する文字列がそれ以上見つからない場合は、メッセージが表示され、テキストの先頭から検索が再開されます。

これ以上出現しない場合の例を検索

置換

指定した文字列をテキスト内で検索し、一致する文字列を別の文字列に置き換える場合は、このオプションを使用します。このオプションを選択すると、検索および置換オプションを指定するためのウィンドウが開きます。

置換の例

検索する文字列と置換後の文字列を入力します。

検索を開始するには、「検索」をタップまたはクリックします。キャンセルする場合は、「x」をタップまたはクリックします。
大文字と小文字を区別して完全一致検索を行う場合は、「大文字小文字を区別して一致」オプションを選択してから検索を開始します。
「すべてを置換」をタップまたはクリックすると、一致するすべての文字列が一度に置換されます。

一致する文字列が見つかった場合は、それが強調表示され、検索ダイアログが淡色表示になります。一致する次の文字列を検索するには、淡色表示のダイアログで「検索」ボタンを再度タップまたはクリックします。強調表示されている一致文字列を置き換えるには、「置換」ボタンをタップまたはクリックします。「置換」ボタンは、一致する文字列が見つかった場合にのみ有効になります。

検索と置換ダイアログは、「検索」をクリックすると透明になり、「置換」をクリックすると不透明になります。これにより、作成者は、置換されるテキストを確認できます。

NOTE

置換機能を使用する場合は、検索文字列と同時に置換する文字列も入力する必要があります。ただし、置換する前に「検索」をクリックして文字列を検索することはできます。「検索」をクリックした後に置換後の文字列を入力すると、検索がリセットされ、テキストの先頭から再開されます。

取り消し

リッチテキストエディターで最後の編集を取り消すために使用します。

やり直し

取り消しアイコンを使用して、取り消した編集を元に戻すために使用します。

テキストを左揃え

テキストを左マージンに揃えます。

テキストを中央揃え

テキストを中央に揃えます。

テキストを右揃え

テキストを右マージンに揃えます。

箇条書き

選択したテキストを箇条書きリストとして書式設定するか、カーソルの後に箇条書きリストを挿入するために使用します。

箇条書きリストを終了するには、「箇条書き」ボタンをタップまたはクリックするか、キャリッジリターンを 2 回入力します。

番号付き

選択したテキストを番号付きリストとして書式設定するか、カーソルの後に番号付きリストを挿入するために使用します。

番号付きリストを終了するには、「番号付き」ボタンをタップまたはクリックするか、キャリッジリターンを 2 回入力します。

アウトデント

選択したテキストまたはカーソルの後に入力するテキストのインデントレベルを減らすために使用します。

選択したテキストまたはカーソルの位置が既にインデントされている場合にのみ有効です。

インデント

選択したテキストまたはカーソルの後に入力するテキストのインデントレベルを増やすために使用します。

テーブル

テキストにテーブルを挿入するために使用します。このオプションを選択すると、テーブルの詳細を指定するためのウィンドウが開きます。

テーブルの例

列 - テーブルの列数（必須）
行 - テーブルの行数（必須）
幅 - テーブルの幅
高さ - テーブルの高さ
セル内の余白 - セルコンテンツの周囲の空白
セルの間隔 - セル間の空白
ボーダー - テーブルの罫線の太さ
- テーブルの見出しについては次の選択肢があります。
  - 最初の行を使用する
  - 最初の列を使用する
  - 最初の行と最初の列を使用する
  - 見出しを使用しない
キャプション - テーブルのキャプション

画像

挿入した画像の位置を揃えるために使用します。

スペルチェック

テキストコンテンツのスペルをチェックするために使用します。スペルミスの可能性がある場合は、赤い破線が該当箇所の下に引かれます。

スペルチェックとスペルチェック辞書のカスタマイズについて詳しくは、リッチテキストエディタープラグインの設定を参照してください。

特殊文字 special-characters

テキストに特殊文字を挿入するために使用します。このオプションを選択するとウィンドウが開き、使用可能な文字が表示されます。

特殊文字の例

目的の文字をタップまたはクリックすると、テキストのカーソルの後に文字が挿入されます。複数の文字を挿入できます。「x」をタップまたはクリックすると、選択ウィンドウが閉じます。

ソース編集

テキストの HTML ソースを表示および変更するために使用します。

ソース編集 アイコンをタップまたはクリックすると、テキストの内容が、書式設定された表示から HTML コードの表示に変わります。このモードでは、他の書式設定オプションはすべて無効になっています。ソース編集 アイコンを再度タップまたはクリックすると、書式設定された表示に戻ります。

CAUTION

生の HTML コードにアクセスする場合は常にそうですが、「ソース編集」オプションを使用する際には注意する必要があります。

ソース編集 で入力した HTML コードはスキャンされて、XSS のリスクがないか確認されます。スクリプトを挿入してもすべて削除され、生成されるページには出現しません。ただし、ソース編集 で入力した HTML コードの形式が正しくない場合は、ページのテンプレートが破損して、予期しない書式設定になったり、生成されるページが使用できなくなるおそれがあります。

NOTE

ソース編集 で入力した HTML コードはスキャンされて、XSS のリスクやスクリプトがないか確認され、検出されたものはすべて自動的に削除されます。したがって、実際に保存されたコンテンツは、ソース編集 で入力した内容と異なる可能性があります。そのため、ソース編集 を使用して行った変更を保存する場合は、まず、ソース編集 を終了して、テキストを通常のエディターで表示する必要があります。