RichEditコンポーネントはDataverseの多行テキストカラム用のリッチテキストエディタです。Dynamics独自のリッチテキストエディタが提供するフォーマット(フォントやサイズ、色、リスト、インデント、アライメント、リンク、画像、表)を提供し、Dynamicsの書き方通りに作成するため、ポータルで編集したドキュメントとモデル駆動アプリで編集したドキュメントは両方で同じように見えます。Fluent UI独自のコントロールで描画され、テーマに沿って表示されます。
<RichEdit columnName="ppp_richdescription" /><RichEdit ColumnName="ppp_richdescription" />Dataverseでリ ッチテキスト の形式を持つカラムは、他のエディタと同様に、 ColumnEdit ラベル、長さ制限、必要なレベル、権限をカラムから取得した RichEdit をレンダリングします。
<ColumnEdit columnName="ppp_richdescription" /><ColumnEdit ColumnName="ppp_richdescription" />RichEditを直接使用して、他の多行テキストの列をリッチテキストとして編集できます。その値は文書のHTMLとなります。グリッドやエクスポートは、書式なしの列のテキストを表示します。
<RichEdit columnName="description" /><RichEdit ColumnName="description" />画像はツールバーから挿入、貼り付け、または削除できます。画像はDynamicsが保存する msdyn_richtextfile レコードとして保存され、ユーザーがそれらを作成・閲覧できるときにテーブルで権限を付与します。その許可がなければ、画像は文書内に保持されます。画像をオフにするには AllowImages を false に設定してください。
<RichEdit columnName="ppp_richdescription" allowImages={false} /><RichEdit ColumnName="ppp_richdescription" AllowImages="false" />ToolbarModeをスペースの狭いエディターやメモのような短いテキスト用にCondensedに設定してください。ツールバーは最もよく使われるフォーマット(取り消し・やり直し、太字、斜体、下線、取り消し線、ハイライトとテキストの色、箇条書きと番号付きリスト、リンク)だけを表示します。そして、最後にボタンを開いては他のボタンごとに開いて閉じるボタンがあります。他のボタン名にはCondensedToolbarButtons(React: condensedToolbarButtons)という、RichEditToolbarButtonの値のリストがあります。ツールバーはそれらを、ツールバー全体が描画する順に表示します。ツールバー自体は、フルまたは凝縮して、ToolbarButtonsで指定されたボタンに限定してください(React: toolbarButtons);ボタンは制限され、フォーマットは制限されないため、キーボードショートカットや貼り付けたテキストは依然としてフォーマットされます。DisplayToolbarをfalseに設定して、ツールバーを一切表示しません。
<RichEdit columnName="ppp_richdescription" toolbarMode={RichEditToolbarMode.Condensed} /><RichEdit ColumnName="ppp_richdescription" ToolbarMode="RichEditToolbarMode.Condensed" /><RichEdit columnName="ppp_richdescription"
toolbarMode={RichEditToolbarMode.Condensed}
condensedToolbarButtons={[RichEditToolbarButton.Bold, RichEditToolbarButton.Italic, RichEditToolbarButton.Link]} /><RichEdit ColumnName="ppp_richdescription"
ToolbarMode="RichEditToolbarMode.Condensed"
CondensedToolbarButtons="[RichEditToolbarButton.Bold, RichEditToolbarButton.Italic, RichEditToolbarButton.Link]" /><RichEdit columnName="ppp_richdescription"
toolbarButtons={[RichEditToolbarButton.Bold, RichEditToolbarButton.Italic, RichEditToolbarButton.Underline, RichEditToolbarButton.Link]} /><RichEdit ColumnName="ppp_richdescription"
ToolbarButtons="[RichEditToolbarButton.Bold, RichEditToolbarButton.Italic, RichEditToolbarButton.Underline, RichEditToolbarButton.Link]" />エディターの枠、ツールバー、フォーカスインジケーターはFluent UIのデザイントークンを使用しており、明暗のテーマやアクセントカラーで他のエディターと一致します。ドキュメント自体のフォーマット、つまりフォントや色は、Dynamicsが示す通りに表示されます。
リッチテキストの列にバインドされた RichEdit で、例文書で開かれます。
以下のコントロールを使って利用可能な物件を探りましょう。
名称 | 種類 | デフォルト | 概要 |
|---|---|---|---|
AllowImages | bool | True | 画像を挿入できるかどうか(ツールバーから、貼り付け、または削除)。デフォルト true。 |
AutoFitHeight | bool | False | 編集エリアが内容に合うかどうかは、一行から RichEdit.Rows行までです スクロール — 常に RichEdit.Rows 行長ではなく。デフォルトは false。 |
ChildContent | RenderFragment? | コンポーネントの子コンテンツ | |
ColumnName* | string | テーブルレコードからエディタをバインドするための論理カラム名。 | |
CondensedToolbarButtons | IReadOnlyCollection<RichEditToolbarButton>? | 圧縮されたツールバーに表示されるボタンは( RichEditToolbarMode.Condensed)、描かれています ツールバー全体が描く順番、名前の順番は何であれ;その末尾にあるボタン それでも RichEdit.ToolbarButtons他の部分に開放されます。セットでも空でもない、 最も使われるフォーマット(RichEdit.DefaultCondensedToolbarButtons):元に戻し、やり直し、太字、 イタリック体、下線、取り消し線、ハイライトとテキストの色、箇条書きと番号付きリスト、 リンク。 | |
Description | string? | 説明はツールチップに表示されます。 | |
Disabled | bool? | エディターを無効にすべきか。 | |
DisplayLabelWhenAvailable | bool | True | ラベルが可能であれば表示するかどうかを明記しています。 |
DisplayToolbar | bool | True | フォーマットツールバーが表示されるかどうか。デフォルトは trueです。 |
DisplayTooltipWhenAvailable | bool | True | ツールチップが表示されるかどうかを指定します。 |
DisplayValidationErrorMessage | bool | True | コンポーネントが検証に失敗したときに検証エラーメッセージを表示するべきでしょうか? |
IsVisible | bool | True | エディターは見えますか? |
Label | string? | 編集者用のラベルとして表示されるテキスト。 | |
LabelPosition | EditorLabelPosition? | ラベルがコントロールに対して位置する位置。 null (デフォルト)の場合 編集者は最も近い囲いの EditorLabelPosition.Auto 。 | |
MaxLength | int? | 保存値の最大長さ(フォーマットも含む):列に格納される内容。解決済み 設定されていない場合、列のメタデータから。 | |
MinLength | int? | テキストの最小文字数 — テキストの書式ではなく、テキストそのものです。 | |
Placeholder | string? | エディタ内で空の状態で表示されます。 | |
ReadOnly | bool? | エディターは読み取り専用であるべきです。 | |
Required | bool? | 価値が求められるかどうか。 | |
Rows | int | 10 | テキストの行で占める編集領域の高さは、文書がどれだけ埋まるかに関わらず、より長い コンテンツスクロール。 RichEdit.AutoFitHeightでは最大まで成長します。デフォルトは10です。 |
ToolbarButtons | IReadOnlyCollection<RichEditToolbarButton>? | ツールバーに表示されるボタンは、フルまたは凝縮されたもので、ツールバー全体の順番で描かれています 描画します。凝縮されたツールバーには、以下のもの RichEdit.CondensedToolbarButtons が表示されます。 ここに、そしてこれらに向かって開く;もう見せるものがなく、開けるボタンもない 終了。ボタンの操作を制限しているだけで、フォーマットは制限されません。キーボードショートカットや貼り付けたテキストは依然として存在します フォーマット。セットや空ではなく、すべてのボタンが表示されます。 | |
ToolbarMode | RichEditToolbarMode | Full | ツールバーのどのくらいが表示されているか:すべてのボタン、あるいはボタンで最も使われるフォーマット それで残りは( RichEditToolbarMode.Condensed)を示します。デフォルトは RichEditToolbarMode.Full。 |
Value | string? | エディタの値、すなわち列のHTMLを取得したり設定したりします。 |
AllowImagestrue。AutoFitHeightRichEdit.Rows行までです スクロール — 常に RichEdit.Rows 行長ではなく。デフォルトは false。ChildContentColumnName*CondensedToolbarButtonsRichEditToolbarMode.Condensed)、描かれています ツールバー全体が描く順番、名前の順番は何であれ;その末尾にあるボタン それでも RichEdit.ToolbarButtons他の部分に開放されます。セットでも空でもない、 最も使われるフォーマット(RichEdit.DefaultCondensedToolbarButtons):元に戻し、やり直し、太字、 イタリック体、下線、取り消し線、ハイライトとテキストの色、箇条書きと番号付きリスト、 リンク。DescriptionDisabledDisplayLabelWhenAvailableDisplayToolbartrueです。DisplayTooltipWhenAvailableDisplayValidationErrorMessageIsVisibleLabelLabelPositionnull (デフォルト)の場合 編集者は最も近い囲いの EditorLabelPosition.Auto 。MaxLengthMinLengthPlaceholderReadOnlyRequiredRowsRichEdit.AutoFitHeightでは最大まで成長します。デフォルトは10です。ToolbarButtonsRichEdit.CondensedToolbarButtons が表示されます。 ここに、そしてこれらに向かって開く;もう見せるものがなく、開けるボタンもない 終了。ボタンの操作を制限しているだけで、フォーマットは制限されません。キーボードショートカットや貼り付けたテキストは依然として存在します フォーマット。セットや空ではなく、すべてのボタンが表示されます。ToolbarModeRichEditToolbarMode.Condensed)を示します。デフォルトは RichEditToolbarMode.Full。Value名称 | 種類 | 概要 |
|---|---|---|
ValueChanged | EventCallback<ColumnValueBase> | バウンド値を更新するコールバックを取得または設定します。 |
ValueChanged名称 | パラメータ | 種類 | 概要 |
|---|---|---|---|
FocusAsync | Task | カーソルをエディターに置く。 | |
GetValidationErrors | List<string> | 現在の値に対して検証エラーを返します:最小値はテキスト数、最大値は 保存されたものを数えます。 | |
OnImageError | string fileName string reason | void | JS → C#:ユーザーが選択した画像は挿入できません。エディターの下に記載されています。 |
OnStateChanged | JsonElement state | void | JS → C#:ツールバーに表示される内容は、選択が動いたかフォーマットが変わったかです。 |
OnValueChanged | string value | Task | JS → C#:文書が変更されました。保存する値を保持し、空の場合はnullにします。 |
UploadImageAsync | IJSStreamReference image string fileName long size | Task<string> | JS → C#:ユーザーが挿入した画像を null ID、または 代わりに画像は文書内に保持されます。 |
FocusAsyncGetValidationErrorsOnImageErrorOnStateChangedOnValueChangedUploadImageAsyncnull ID、または 代わりに画像は文書内に保持されます。