mcpField
S
syncfusion-maui-toolkit-numericentry

syncfusion-maui-toolkit-numericentry

github.com/syncfusionデザイン・UI3946 回インストール7 週間前に更新
リポジトリ

syncfusion-maui-toolkit-numericentry について

Syncfusion の SfNumericEntry を .NET MAUI アプリに実装するためのスキルです。数値の書式設定、検証、操作設定を案内します。

主な機能

  1. 01通貨・割合・カスタム書式
  2. 02最小値と最大値の制限
  3. 03リアルタイムまたはフォーカス解除時の検証
  4. 04カルチャに応じた数値書式
  5. 05値変更・フォーカスイベント

活用シーン

  1. 01価格や予算の入力フォーム作成
  2. 02数量や数値範囲の制限
  3. 03数値表示のローカライズ
  4. 04値の変更への対応

インストール

コマンドをコピーしてターミナルで実行します。

$npx skills add https://github.com/syncfusion/maui-toolkit-ui-components-skills --skill syncfusion-maui-toolkit-numericentry

インストール後、Claude Code で/syncfusion-maui-toolkit-numericentryを入力して読み込まれたか確認します。

同梱ファイル

SKILL.md と一緒にインストールされる参考資料やスクリプト。

references/
basic-features.md
events-and-methods.md
formatting.md
getting-started.md
restrictions.md

詳細

.NET MAUI 数値入力の実装

Syncfusion .NET MAUI 数値入力コントロールは、数値データを入力するための使いやすく高度な操作性を提供します。通貨、パーセンテージ、小数など、幅広い数値形式に対応しており、ほかの数値形式も設定できます。豊富な機能により、数値入力の検証や書式設定を簡素化しながら、ユーザーエクスペリエンス全体を向上させます。

このスキルを使用するタイミング

次のようなニーズがある場合に、このスキルを使用します。

  • 通貨入力が必要な金融アプリケーション
  • パーセンテージや小数の入力欄があるフォーム
  • 最小値／最大値の制約があるデータ入力シナリオ
  • 文化圏固有の数値書式設定が必要なアプリケーション
  • 科学計算や電卓形式の数値入力
  • 予算、価格、数量の入力欄

コンポーネントの概要

**Syncfusion .NET MAUI 数値入力（SfNumericEntry）**は、高度な機能を備えた数値データ入力専用のコントロールです。

主な機能
  • カスタマイズ可能な検証モードによる数値の自動検証
  • 豊富な書式設定オプション（通貨、パーセンテージ、小数、カスタムパターン）
  • 値の制限（最小値／最大値の範囲、null の処理）
  • 文化圏固有の数値書式設定とローカライズ
  • リアルタイムまたはフォーカス喪失時の検証モード
  • 幅広いスタイル設定とカスタマイズオプション
  • 値の変更、フォーカス、入力完了に対応する組み込みイベント
  • キーボード操作に対応したアクセシビリティサポート

ドキュメントとナビゲーションガイド

はじめに

📄 参照： references/getting-started.md

ユーザーが初めて NumericEntry を設定する場合：

  • Syncfusion MAUI Toolkit パッケージのインストールと設定
  • MauiProgram.cs でのハンドラーの登録
  • XAML と C# 用の名前空間のインポート
  • 基本的な NumericEntry コントロールの作成
  • 値の編集と検証モード（OnKeyFocus と OnLostFocus）の理解
  • 基本的な数値書式（通貨、パーセンテージ、小数）の適用
  • AllowNull を使用した null 値の動作の設定
基本機能と設定

📄 参照： references/basic-features.md

ユーザーが外観や操作性をカスタマイズする場合：

  • 空の状態で表示するプレースホルダーテキストと色の設定
  • クリアボタンの表示／非表示とスタイル設定
  • 値の変更モード（リアルタイム更新とフォーカス喪失時の更新）の設定
  • 枠線とストロークのカスタマイズ
  • 水平方向および垂直方向のテキスト配置
  • フォントのカスタマイズ（色、サイズ、ファミリー、属性）
  • キーボードのリターンタイプとコマンドの設定
  • カーソル位置とテキスト選択の管理
  • カスタムクリアボタンアイコンの作成
値の書式設定

📄 参照： references/formatting.md

ユーザーが数値を書式設定する場合：

  • CustomFormat プロパティと標準書式指定子（C、P、N）の使用
  • 文化圏固有の通貨記号を使用した通貨値の書式設定
  • Value または Compute の表示モードを使用したパーセンテージの書式設定
  • 精度を制御した小数の書式設定
  • ゼロプレースホルダーを使用した整数桁の表示制御
  • 小数部の桁数の精度制御

  • と 0 のプレースホルダーを使用したカスタム書式パターンの作成

  • 複数の文化圏とローカライズへの対応
  • MaximumNumberDecimalDigits を使用した小数桁数の制限
値の制限

📄 参照： references/restrictions.md

ユーザーが入力を制限または検証する場合：

  • AllowNull を使用した null 値の許可または禁止
  • 最小値と最大値の範囲の設定
  • 範囲外の値に対する検証動作の理解
  • IsEditable を使用したテキスト編集の禁止
  • 読み取り専用の数値表示の設定
  • エッジケースの処理（null とゼロの違い、最小値の動作）
イベントとメソッド

📄 読む： references/events-and-methods.md

ユーザーの操作に応答する必要がある場合：

  • ValueChanged イベントで値の変更を処理する
  • Completed イベントで Enter キーの押下に応答する
  • Focused および Unfocused イベントでフォーカスの取得と喪失を検出する
  • Focus() メソッドでプログラムからフォーカスを設定する
  • Unfocus() メソッドでフォーカスを解除する
  • イベント引数から変更前と変更後の値にアクセスする
  • フォーム送信とナビゲーションのパターンを実装する

コメント

Markdown 対応