テキスト編集

TextEditコンポーネントはDataverseの文字列カラムに対して1行のテキスト入力をレンダリングします。

React

Blazor

テキストフィールドタイプ

入力タイプを変更する TextFieldType 設定してください。オプションには Text (デフォルト)、 Email、 Password、 Tel、 Url、 Search、 Number、 Colorがあります。ブラウザは各タイプに対してネイティブなフォーマットと検証を適用します。

React

Blazor

長さ制約

テキスト長の制約を強制するために MinLength と MaxLength を使いましょう。明示的に設定されていない場合、 MaxLength はカラムメタデータから自動的に入力されます。

React

Blazor

入力マスク

Maskをユーザーが入力する際に値を制約・フォーマットする設定にします。MaskMode.PatternPatternで提供されたスロット付きテンプレートを適用します。0数字、文字A*、英数字文字を受け入れ、残りの文字はすべて自動的に文字挿入されます。MaskMode.RegexAllowedPattern正則表現に対して各文字をフィルタリングし、一致しないものは除外します。マスキングはブラウザ上で動作し、再フォーマット時にキャレットの位置を保持するため、その中間での編集は自然に動作します。デフォルトのMaskMode.Noneはフィールドをプレーンテキスト入力のままにし、相互運用性のオーバーヘッドはありません。

マスクの有無にかかわらず保管方法

デフォルトではマスクされたフィールドはマスクされていない値を保存します — 電話パターンの場合は(555) 123-4567ではなく5551234567です。StoreMaskedValue="true"で、フォーマット済みのテキスト(リテラルも含む)をカラムに永続化するように設定してください。いずれにせよ、負荷時にフィールドは正しく再マスキングされるため、選択は下流システムが何を期待するかに委ねられます。

例

文字列カラムにバインドされた基本の TextEdit です。

Reactの例

ブレイザーの例

React TypeScript

Razor

携帯電話

設定オプション

以下のコントロールを使って利用可能な物件を探りましょう。

Reactの例

ブレイザーの例

React TypeScript

Razor

読み取り専用ですか?

必須ですか?

障害者?

最小長さ

最大長さ

種類

カラー

メール

番号

パスワード

検索

components.PowerPortalsPro.Demo.Client.Customizations.Pages.Editors.TextEdit.TextEditPropertiesDemo.textFieldType.Telephone

本文

URL

携帯電話

マスクプリセット

ドロップダウンからマスクを選び、フィールドに入力すると、ライブで安全なマスクを確認できます。各プリセットはPatternまたはAllowedPatternでMaskします。マスキング値を切り替えて、カラムに永続するものを比較します。フィールド下の読み取りはリアルタイムで保存値を反映します。

Reactの例

ブレイザーの例

React TypeScript

Razor

マスク

なし(プレーンテキスト)

電話 — (000) 000-0000

社会保障番号 — 000-00-0000

クレジットカード — 0000 0000 0000 0000

郵便番号+4 — 00000-0000

文字のみ — [A-Za-z]

マスク値を保存します

マスクドバリュー

保存価値: —

反応してください

ブレイザー

TextEdit クラス

パラメータ

名称	種類	デフォルト	概要
`AllowedPattern`	string?		各文字は `MaskMode.Regex` に対して正則表現を許可します(例: [A-Za-z])。
`Autocomplete`	bool	False	テキスト編集のブラウザ自動補完を有効にします。
`ChildContent`	RenderFragment?		コンポーネントの子コンテンツ
`ColumnName`*	string		テーブルレコードからエディタをバインドするための論理カラム名。
`Description`	string?		説明はツールチップに表示されます。
`Disabled`	bool?		エディターを無効にすべきか。
`DisplayLabelWhenAvailable`	bool	True	ラベルが可能であれば表示するかどうかを明記しています。
`DisplayTooltipWhenAvailable`	bool	True	ツールチップが表示されるかどうかを指定します。
`DisplayValidationErrorMessage`	bool	True	コンポーネントが検証に失敗したときに検証エラーメッセージを表示するべきでしょうか?
`EndContent`	RenderFragment?		入力後、フィールドのエンドスロットにレンダリングされるコンテンツ。
`Immediate`	bool	False	`true`時、エディタはキーストロークごとにその値をコミットします (DOM入力イベント)で、ぼかし(DOM変更イベント)ではなく。複数の編集者が同じ列に割り当てられている場合に有効です。ユーザータイプです。既存の消費者が保持できるように`false`デフォルト彼らのブラーコミット行動。転送`MaskedTextField.Immediate`; マスクドパスとファストパスの微妙な違いについては、その性質を参照してください。
`ImmediateDelay`	int	0	デバウンスは、キーストロークプッシュにミリ秒単位で適用されます `TextEdit.Immediate` は `true`。ゼロ(デフォルト)はコミットしますすべてのキーストローク;正の値は、前回の最後のキーストロークから同じくらい待つ解雇された価値変更。 `MaskedTextField.ImmediateDelay`に転送されました。
`IsVisible`	bool	True	エディターは見えますか?
`Label`	string?		編集者用のラベルとして表示されるテキスト。
`Mask`	MaskMode	None	入力にマスキング戦略を適用しました。デフォルトは `MaskMode.None`で、そのままゼロ相互運用性ファストパス上のフィールド(平文のテキストフィールド)。設定 `MaskMode.Pattern` または `MaskMode.Regex` 、ケアレットに安全なマスキングを可能にします。
`MaxLength`	int?		許容弦の最大長さ。
`MinLength`	int?		許容弦の最大長さ。
`Pattern`	string?		スロット付きテンプレート(例:(000) 000-0000)`MaskMode.Pattern`。
`ReadOnly`	bool?		エディターは読み取り専用であるべきです。
`Required`	bool?		価値が求められるかどうか。
`Rows`	int?		指定された場合、制御が占有する行数を決定します。
`StartContent`	RenderFragment?		フィールドの開始スロット(入力の前)にレンダリングされるコンテンツ — アイコン、プレフィックスなど。
`StoreMaskedValue`	bool	False	マスク値がマスク付きで保存されるかなしにするかを制御します。 `true`時、この列はマスキングテキストをリテラルや区切り符(例: (555) 123-4567)を含む保存します。 `false` (デフォルト)の場合、マスクされていない値(例: 5551234567)を保存します。 `TextEdit.Mask` が `MaskMode.None`中は効果がありません。
`TextFieldType`	TextInputType	Text	テキスト編集用のフィールドの種類
`Value`	string?		コントロールの価値。

名称: AllowedPattern

種類: string?

概要: 各文字は MaskMode.Regex に対して正則表現を許可します(例: [A-Za-z])。

名称: Autocomplete

種類: bool

デフォルト: False

概要: テキスト編集のブラウザ自動補完を有効にします。

名称: ChildContent

種類: RenderFragment?

概要: コンポーネントの子コンテンツ

名称: ColumnName*

種類: string

概要: テーブルレコードからエディタをバインドするための論理カラム名。

名称: Description

種類: string?

概要: 説明はツールチップに表示されます。

名称: Disabled

種類: bool?

概要: エディターを無効にすべきか。

名称: DisplayLabelWhenAvailable

種類: bool

デフォルト: True

概要: ラベルが可能であれば表示するかどうかを明記しています。

名称: DisplayTooltipWhenAvailable

種類: bool

デフォルト: True

概要: ツールチップが表示されるかどうかを指定します。

名称: DisplayValidationErrorMessage

種類: bool

デフォルト: True

概要: コンポーネントが検証に失敗したときに検証エラーメッセージを表示するべきでしょうか?

名称: EndContent

種類: RenderFragment?

概要: 入力後、フィールドのエンドスロットにレンダリングされるコンテンツ。

名称: Immediate

種類: bool

デフォルト: False

概要: true時、エディタはキーストロークごとにその値をコミットします (DOM入力イベント)で、ぼかし(DOM変更イベント)ではなく。複数の編集者が同じ列に割り当てられている場合に有効です。ユーザータイプです。既存の消費者が保持できるようにfalseデフォルト彼らのブラーコミット行動。転送MaskedTextField.Immediate; マスクドパスとファストパスの微妙な違いについては、その性質を参照してください。

名称: ImmediateDelay

種類: int

デフォルト: 0

概要: デバウンスは、キーストロークプッシュにミリ秒単位で適用されます TextEdit.Immediate は true。ゼロ(デフォルト)はコミットしますすべてのキーストローク;正の値は、前回の最後のキーストロークから同じくらい待つ解雇された価値変更。 MaskedTextField.ImmediateDelayに転送されました。

名称: IsVisible

種類: bool

デフォルト: True

概要: エディターは見えますか?

名称: Label

種類: string?

概要: 編集者用のラベルとして表示されるテキスト。

名称: Mask

種類: MaskMode

デフォルト: None

概要: 入力にマスキング戦略を適用しました。デフォルトは MaskMode.Noneで、そのままゼロ相互運用性ファストパス上のフィールド(平文のテキストフィールド)。設定 MaskMode.Pattern または MaskMode.Regex 、ケアレットに安全なマスキングを可能にします。

名称: MaxLength

種類: int?

概要: 許容弦の最大長さ。

名称: MinLength

種類: int?

概要: 許容弦の最大長さ。

名称: Pattern

種類: string?

概要: スロット付きテンプレート(例:(000) 000-0000)MaskMode.Pattern。

名称: ReadOnly

種類: bool?

概要: エディターは読み取り専用であるべきです。

名称: Required

種類: bool?

概要: 価値が求められるかどうか。

名称: Rows

種類: int?

概要: 指定された場合、制御が占有する行数を決定します。

名称: StartContent

種類: RenderFragment?

概要: フィールドの開始スロット(入力の前)にレンダリングされるコンテンツ — アイコン、プレフィックスなど。

名称: StoreMaskedValue

種類: bool

デフォルト: False

概要: マスク値がマスク付きで保存されるかなしにするかを制御します。 true時、この列はマスキングテキストをリテラルや区切り符(例: (555) 123-4567)を含む保存します。 false (デフォルト)の場合、マスクされていない値(例: 5551234567)を保存します。 TextEdit.Mask が MaskMode.None中は効果がありません。

名称: TextFieldType

種類: TextInputType

デフォルト: Text

概要: テキスト編集用のフィールドの種類

名称: Value

種類: string?

概要: コントロールの価値。

イベント

名称	種類	概要
`ValueChanged`	EventCallback<ColumnValueBase>	バウンド値を更新するコールバックを取得または設定します。

名称: ValueChanged

種類: EventCallback<ColumnValueBase>

概要: バウンド値を更新するコールバックを取得または設定します。

方法

名称	パラメータ	種類	概要
`GetValidationErrors`		List<string>	現在の検証エラーの集合を返します。

名称: GetValidationErrors

種類: List<string>

概要: 現在の検証エラーの集合を返します。