書式付きテキスト (HTML) を編集・保存できる値フィールドです。ツールバーから太字・色・リンクなどの書式を適用できます。
- 書式ツールバー: 太字、斜体、下線、取り消し線
- 見出し設定: 標準テキスト / H1〜H6 の見出しレベル
- リスト: 箇条書きリスト、番号付きリスト
- テキスト配置: 左揃え、中央揃え、右揃え
- 文字色 / 背景色: 16色パレットから選択
- リンク挿入: URL指定でハイパーリンクを挿入
- 書式クリア / Undo / Redo
- HTML形式で保存: DBカラムにHTMLテキストとして永続化
「デザイナ表示名」は Designer (日本語環境) で表示されるラベルです。
| プロパティ | デザイナ表示名 | 型 | 説明 |
|---|---|---|---|
| DisplayName | 表示名 | string | フィールドの表示名 (ValueFieldDesignBase 継承) |
| DbColumn | DBカラム | string | データを保存するDBカラム名 |
| IsRequired | 必須 | bool | true で未入力をバリデーションエラー (ValueFieldDesignBase 継承) |
| OnDataChanged | データ変更イベント | string | データ変更時に呼び出すスクリプトイベント (ValueFieldDesignBase 継承) |
HTML文字列を格納するためのテキスト型カラムが必要です。長文を想定する場合は NVARCHAR(MAX) や TEXT 型を推奨します。
- 編集モード: ツールバー付きのエディタを表示。テキストの書式設定が可能
- 閲覧モード: HTMLをレンダリングして表示。リンクは新しいタブで開く
- HTML の消毒: 表示するとき・エディタに入れるとき・貼り付けるときに、ブラウザで HTML を消毒する (DOMPurify)。スクリプトが動くもの (script・イベント属性・javascript: の URL)・フォームの部品・class・位置や重なりを変える style (position・z-index 等) を落とす。文字の書式・色・揃え・表・画像・リンクは残る
| メンバー | 種別 | 説明 |
|---|---|---|
| Value | プロパティ | HTML文字列値の取得・設定 |
リッチテキストエディタの見た目はCSSクラスで自由にカスタマイズできます。全CSSクラス一覧とカスタマイズ例は RichTextField CSS カスタマイズガイド を参照してください。