ユーザーが WYSIWYG 編集領域のテキストを書式設定できるようにします。 出力形式は HTML です。
Description
リッチ テキスト エディター コントロールを使用すると、アプリユーザーは WYSIWYG 編集領域でテキストを書式設定できます。
入力と出力の形式は HTML ですが、コントロールは HTML エディターではありません。 エディターは、スクリプト、スタイル、オブジェクト、およびサポートされていない HTML 要素と属性を削除します。
サポートされる機能は次のとおりです。
- 太字、斜体、下線
- テキストと強調表示の色
- テキスト サイズ
- 番号付きリストと箇条書きリスト
- Hyperlinks
- 書式設定をクリアする
フォームでコントロールを使用するには、[ 複数行テキストの編集] カードを選択し、RTE コントロールを挿入してカスタマイズします。
重要なプロパティ
既定値 – エディターに表示される初期テキスト値の入力プロパティ
HtmlText – 結果のリッチ テキストの出力プロパティ (HTML 形式)
追加のプロパティ
AccessibleLabel – スクリーン リーダー用のラベル。 添付ファイルの目的を説明する必要があります。
DisplayMode – コントロールでファイルの追加と削除 (編集)、データの表示のみ (ビュー)、または無効 (無効) のどちらにするかを指定します。
EnableSpellCheck – ブラウザーのスペル チェックが有効になっているかどうか。 この機能は、ブラウザーの既定の言語でのみスペル チェックを行います。 Windows 向け Power Apps はこのプロパティをサポートしていません。
Height – コントロールの上端から下端までの距離。
TabIndex – 他のコントロールに関連するキーボード ナビゲーションの順序。
Visible – コントロールが表示されるかどうか。
Width – コントロールの左端から右端までの距離。
X – コントロールの左端から親コンテナーの左端までの距離。親コンテナーがない場合は画面。
Y – コントロールの上端から親コンテナーの上端までの距離。親コンテナーがない場合は画面。
アクセシビリティのガイドライン
スクリーン リーダー サポート
- AccessibleLabel が存在することを確認します。
キーボードのサポート
- TabIndex を 0 以上に設定して、キーボード ユーザーが移動できるようにします。
ヒント
エディターがフォーカスされている状態で Alt+0 キーを押して、他のキーボード ショートカットについて学習します。
注
ツール バーにフォーカスがある場合は、 Tab または Shift+Tab を選択して、ツール バー グループ間を移動します。 最後のグループから最初のグループに戻ることはできません。またはその逆もできません。
制限事項
他の製品を使用する場合、外観は保証されません
さまざまな製品でリッチ テキストを使用する場合、まったく同じようには見えない場合があります。
- Web ページ、Microsoft Word、その他のアプリからリッチ テキストを貼り付けることができます。 ただし、デバイス、ブラウザー、および外部ソースの機能によって外観が異なる場合があります。
- 同様に、キャンバス アプリの外部でリッチ テキストを作成すると、他のアプリの組み込みスタイルが存在しないため、外観が若干異なる場合があります。
- キャンバス アプリを別のアプリに埋め込む場合、ホスト アプリがリッチ テキストのスタイルをオーバーライドする可能性があります。 たとえば、モデル駆動型アプリでキャンバス アプリを カスタム ページ として使用すると、ホスト アプリはリスト スタイルを削除します。 箇条書きリストのカスタムページには、箇条点が表示されません。
リッチ テキストが表示される場所に基づいて異なる方法で表示したい場合があります。 たとえば、プライマリ フォントが別の製品で異なる場合や、ユーザーがダーク モードを有効にするとテキストの色が変わる場合があります。 一貫性のある表示を行う場合は、キャンバス アプリでのみリッチ テキストを作成して表示します。
貼り付けた画像が一貫して表示されない場合がある
貼り付けた画像はブラウザーに表示されますが、モバイル アプリには表示されない場合があります。 または、断続的に表示される場合もあれば、まったく表示されない場合もあります。 これらは、貼り付けたイメージが次の理由でサポートされていないことを示す兆候です。
- クロスオリジン リソース共有 (CORS)。 イメージ ホストは、Power Apps でのイメージの読み込みをブロックします。
- 認証。 イメージにはパブリックにアクセスできないため、イメージ ホストにサインインした後にのみアクセスできます。
- イメージ形式のサポート。 jpg や png などの一般的な画像形式はサポートされていますが、あまり一般的でない種類はブラウザーやデバイスではサポートされない可能性があります。
ブラウザーまたはデバイスは、リッチ テキストの画像を異なる方法で表すことができます。 画像を生データとしてコピーするものもあれば、イメージの URL を参照するものもあります。 上記の理由により、イメージ URL にアクセスできない場合があります。
ヒント
最適な結果を得るために、画面のクリッピングまたはスクリーンショット ツールを使用して画像をコピーして貼り付けます。
アプリを編集する場合、Alt キーを押してもコントロールとの対話は許可されません
Power Apps Studio では、クイック操作のために Alt キーを押しても機能しません。 リッチ テキスト エディターは、 アプリのプレビュー時にのみ操作できます。