Syncfusion .NET MAUI NumericUpDown
The SfNumericUpDown control provides a user-friendly numeric input experience with built-in validation, formatting options, and convenient increment/decrement buttons. Perfect for building professional forms that require validated numeric entry.
When to Use This Skill
Use this skill when you need to:
- Build numeric input fields in .NET MAUI applications
- Format numbers as currency (C2), percentages (P2), or decimals (N2)
- Restrict input to valid ranges (Minimum/Maximum values)
- Provide quick value adjustments with up/down arrow buttons or keyboard controls
- Display placeholders for empty numeric fields
- Handle validation automatically with OnKeyFocus or OnLostFocus modes
- Customize appearance of buttons, colors, borders, and fonts
- Support cultural formats with culture-aware number display
Component Overview
The SfNumericUpDown (or NumericUpDown) control is a specialized input field designed for entering and editing numeric values in .NET MAUI applications. It combines three interaction patterns:
What It Does:
- Accepts numeric input with optional text field for direct entry
- Provides increment/decrement buttons (up/down arrows) for quick value adjustment
- Supports keyboard navigation (arrow keys, Page Up/Down, Tab, Return)
- Enforces validation with configurable ranges (Minimum/Maximum)
- Formats numbers according to culture, currency, or custom specifications
- Displays placeholder text when no value is set
Key Characteristics:
- Smart Validation: OnKeyFocus (real-time) or OnLostFocus (deferred) validation modes
- Flexible Formatting: Currency (C2), percentages (P2), decimals (N2), or custom formats
- Customizable Buttons: Placement modes (Inline, InlineVertical), alignment (Left, Right, Both), color, and custom templates
- Constraint Support: Min/Max ranges, null handling (AllowNull), text-only mode (IsEditable=false)
- Event Driven: ValueChanged, Completed, Focused/Unfocused events for form integration
- Accessible: Support for WCAG compliance, screen readers, and keyboard-only navigation
When to Choose NumericUpDown:
- Need a professional numeric input with built-in increment buttons
- Want automatic validation and formatting without custom code
- Building financial forms (prices, discounts, percentages)
- Creating inventory systems (quantities, stock levels)
- Implementing settings or preference screens
- Need culture-aware number formatting
Documentation and Navigation Guide
Getting Started
📄 Read: references/getting-started.md
- Installation and NuGet package setup
- Registering handlers in MauiProgram.cs
- Adding a basic NumericUpDown control
- XAML and C# initialization patterns
- First render and validation modes
Value Management & Constraints
📄 Read: references/value-management.md
- Setting and binding numeric values
- Minimum and Maximum value restrictions
- Null value handling with AllowNull property
- Default values and initial setup
- Preventing manual text editing with IsEditable
Formatting & Display Options
📄 Read: references/formatting-display.md
- Custom number formats (currency, percentage, decimal)
- Placeholder text and placeholder color customization
- Culture-aware number display
- Maximum decimal digits management
- Percentage display modes (Value vs Compute)
- Custom format specifiers (0, #, C, P, N)
Validation & Events
📄 Read: references/validation-events.md
- ValueChanged event with OldValue and NewValue
- Completed event when editing is finished
- Focused and Unfocused events
- ValueChangeMode (OnKeyFocus vs OnLostFocus)
- Programmatic focus management
- Return key commands
Up/Down Button Control
📄 Read: references/buttons-updown.md
- SmallChange and LargeChange increments
- Keyboard shortcuts (Arrow keys, Page Up/Down)
- Mouse scroll wheel support
- Up/Down button placement modes (Inline, InlineVertical)
- Button alignment (Left, Right, Both)
- Button color customization
- Custom button templates
- Auto-reverse behavior
Customization & UI Features
📄 Read: references/customization.md
- Border visibility and stroke color
- Text color and alignment customization
- Font family, size, and attributes
- Clear button visibility and customization
- Cursor position and text selection
- Return key types and keyboard behavior
- Advanced styling patterns
- Common gotchas and troubleshooting
1---2name: syncfusion-maui-toolkit-numeric-updown3description: Implement the Syncfusion .NET MAUI NumericUpDown control for numeric input with validation, formatting, and increment/decrement buttons. Use this skill when building forms requiring numeric entry with up-down buttons, currency formatting, percentage values, decimal precision, custom formats, input validation, or placeholder text.4---5
6# Syncfusion .NET MAUI NumericUpDown
7
8The **SfNumericUpDown** control provides a user-friendly numeric input experience with built-in validation, formatting options, and convenient increment/decrement buttons. Perfect for building professional forms that require validated numeric entry.
9
10## When to Use This Skill
11
12Use this skill when you need to:
13
14- **Build numeric input fields** in .NET MAUI applications
15- **Format numbers** as currency (C2), percentages (P2), or decimals (N2)
16- **Restrict input** to valid ranges (Minimum/Maximum values)
17- **Provide quick value adjustments** with up/down arrow buttons or keyboard controls
18- **Display placeholders** for empty numeric fields
19- **Handle validation** automatically with OnKeyFocus or OnLostFocus modes
20- **Customize appearance** of buttons, colors, borders, and fonts
21- **Support cultural formats** with culture-aware number display
22
23## Component Overview
24
25The **SfNumericUpDown** (or NumericUpDown) control is a specialized input field designed for entering and editing numeric values in .NET MAUI applications. It combines three interaction patterns:
26
27**What It Does:**
28- Accepts numeric input with optional text field for direct entry
29- Provides increment/decrement buttons (up/down arrows) for quick value adjustment
30- Supports keyboard navigation (arrow keys, Page Up/Down, Tab, Return)
31- Enforces validation with configurable ranges (Minimum/Maximum)
32- Formats numbers according to culture, currency, or custom specifications
33- Displays placeholder text when no value is set
34
35**Key Characteristics:**
36- **Smart Validation:** OnKeyFocus (real-time) or OnLostFocus (deferred) validation modes
37- **Flexible Formatting:** Currency (C2), percentages (P2), decimals (N2), or custom formats
38- **Customizable Buttons:** Placement modes (Inline, InlineVertical), alignment (Left, Right, Both), color, and custom templates
39- **Constraint Support:** Min/Max ranges, null handling (AllowNull), text-only mode (IsEditable=false)
40- **Event Driven:** ValueChanged, Completed, Focused/Unfocused events for form integration
41- **Accessible:** Support for WCAG compliance, screen readers, and keyboard-only navigation
42
43**When to Choose NumericUpDown:**
44- Need a professional numeric input with built-in increment buttons
45- Want automatic validation and formatting without custom code
46- Building financial forms (prices, discounts, percentages)
47- Creating inventory systems (quantities, stock levels)
48- Implementing settings or preference screens
49- Need culture-aware number formatting
50
51## Documentation and Navigation Guide
52
53### Getting Started
54📄 **Read:** [references/getting-started.md](references/getting-started.md)
55- Installation and NuGet package setup
56- Registering handlers in MauiProgram.cs
57- Adding a basic NumericUpDown control
58- XAML and C# initialization patterns
59- First render and validation modes
60
61### Value Management & Constraints
62📄 **Read:** [references/value-management.md](references/value-management.md)
63- Setting and binding numeric values
64- Minimum and Maximum value restrictions
65- Null value handling with AllowNull property
66- Default values and initial setup
67- Preventing manual text editing with IsEditable
68
69### Formatting & Display Options
70📄 **Read:** [references/formatting-display.md](references/formatting-display.md)
71- Custom number formats (currency, percentage, decimal)
72- Placeholder text and placeholder color customization
73- Culture-aware number display
74- Maximum decimal digits management
75- Percentage display modes (Value vs Compute)
76- Custom format specifiers (0, #, C, P, N)
77
78### Validation & Events
79📄 **Read:** [references/validation-events.md](references/validation-events.md)
80- ValueChanged event with OldValue and NewValue
81- Completed event when editing is finished
82- Focused and Unfocused events
83- ValueChangeMode (OnKeyFocus vs OnLostFocus)
84- Programmatic focus management
85- Return key commands
86
87### Up/Down Button Control
88📄 **Read:** [references/buttons-updown.md](references/buttons-updown.md)
89- SmallChange and LargeChange increments
90- Keyboard shortcuts (Arrow keys, Page Up/Down)
91- Mouse scroll wheel support
92- Up/Down button placement modes (Inline, InlineVertical)
93- Button alignment (Left, Right, Both)
94- Button color customization
95- Custom button templates
96- Auto-reverse behavior
97
98### Customization & UI Features
99📄 **Read:** [references/customization.md](references/customization.md)
100- Border visibility and stroke color
101- Text color and alignment customization
102- Font family, size, and attributes
103- Clear button visibility and customization
104- Cursor position and text selection
105- Return key types and keyboard behavior
106- Advanced styling patterns
107- Common gotchas and troubleshooting
gabrielmoreira