Implementing.NET MAUI Numeric Entry
The Syncfusion.NET MAUI Numeric Entry control is designed to deliver a user-friendly and advanced input experience for numeric data. It supports a broad range of numeric formats, including currency, percentages, decimals, and other configurable number types. With its rich set of features, the control enhances the overall user experience while simplifying numeric input validation and formatting.
When to Use This Skill
Use this skill when users need to:
- Accept numeric input with validation and formatting
- Create currency, percentage, or decimal input fields
- Implement value increment/decrement with up/down buttons
- Restrict numeric values within a minimum and maximum range
- Format numeric values with culture-specific patterns
- Provide numeric input with keyboard shortcuts (arrow keys, page keys)
- Build price entry fields, quantity selectors, or rating systems
- Create age inputs, discount calculators, or measurement fields
- Implement read-only numeric displays with button controls
- Add modern translucent glass effects to numeric inputs
Component Overview
The Syncfusion.NET MAUI Numeric Entry (SfNumericEntry) is a specialized input control designed for numeric data entry with advanced features:
Key Capabilities
- Numeric Validation: Restricts alphabetic input, validates on Enter key or focus loss
- Format Support: Currency (C), Percentage (P), Decimal (N), and custom formats
- Value Controls: Up/down buttons, keyboard arrows, mouse scrolling for value changes
- Range Restrictions: Enforce minimum and maximum value constraints
- Customization: Full control over appearance, fonts, colors, borders, and buttons
- Culture Support: Adapt to different regional number formats
- Accessibility: WCAG compliance with AutomationId support
Documentation and Navigation Guide
Getting Started
📄 Read: references/getting-started.md
When to read: Setting up Numeric Entry for the first time, need basic implementation
Topics covered:
- Create.NET MAUI project
- Install Syncfusion.Maui.Inputs NuGet package
- Register handler in MauiProgram.cs with ConfigureSyncfusionCore()
- Add namespace and basic Numeric Entry control (XAML/C#)
- Edit values with validation on Enter key or focus loss
- Change number format with CustomFormat property
- Accept or restrict null values with AllowNull
- UI customization (PlaceholderColor, TextColor, Font properties)
- Caret and selection control (CursorPosition, SelectionLength)
- Methods: Focus(), Unfocus()
- Events: Focused, Unfocused with FocusEventArgs
Basic Features and Configuration
📄 Read: references/basic-features.md
When to read: Configuring placeholder, clear button, events, borders, or text alignment
Topics covered:
- Setting placeholder text with Placeholder property
- Clear button visibility (ShowClearButton) and color (ClearButtonColor)
- Custom clear button paths with ClearButtonPath
- Value change notifications with ValueChanged event
- Value change modes (OnLostFocus, OnKeyFocus)
- Completed event (return key pressed)
- ClearButtonClicked event
- Border customization (Stroke, ShowBorder)
- Text alignment (HorizontalTextAlignment, VerticalTextAlignment)
- Select all text on focus with SelectAllOnFocus
- Keyboard return type configuration with ReturnType
- Return commands (ReturnCommand, ReturnCommandParameter)
- AutomationId for UI testing and accessibility
Value Formatting
📄 Read: references/formatting.md
When to read: Need to format values as currency, percentage, or custom numeric formats
Topics covered:
- Currency format (C2): $1,234.56
- Percentage format (P2): 45.50%
- Decimal format (N2): 1,234.56
- Custom format strings with 0 and # specifiers
- Integer digit formatting with zero placeholder
- Fractional digit formatting
- Custom format combinations (e.g., "$00.00##")
- Culture-based formatting with Culture property
- Percentage display modes (Value vs Compute)
- Maximum decimal digits with MaximumNumberDecimalDigits
Value Restrictions
📄 Read: references/restrictions.md
When to read: Need to enforce minimum/maximum values or prevent null values
Topics covered:
- Restrict null values with AllowNull property
- Behavior when AllowNull is false (returns 0 or Minimum)
- Restrict value within range using Minimum and Maximum
- Default values (double.MinValue, double.MaxValue)
- Prevent text editing with IsEditable property
- Value changes still allowed via buttons, keys, and scroll
- Range validation and edge cases
UpDown Buttons
📄 Read: references/updown-buttons.md
When to read: Implementing increment/decrement buttons or keyboard/mouse value changes
Topics covered:
- Increase/decrease with keyboard arrows and Page keys
- SmallChange (arrow keys, mouse scroll, up/down buttons)
- LargeChange (Page Up/Down keys)
- UpDown button placement modes:
- Hidden (default, no buttons shown) - Inline (horizontal buttons) - InlineVertical (vertical stacked buttons)
- Button alignment (Left, Right, Both)
- Button order (UpThenDown, DownThenUp)
- Button color customization (UpDownButtonColor)
- Custom button templates (UpButtonTemplate, DownButtonTemplate)
- Auto-reverse behavior (restart at min/max with AutoReverse)
Liquid Glass Effect
📄 Read: references/liquid-glass-effect.md
When to read: Implementing modern translucent glass design (.NET 10, iOS 26+, macOS 26+)
Topics covered:
- Liquid Glass Effect overview
- Wrap Numeric Entry in SfGlassEffectView
- Set Background to Transparent for glass effect
- Configure EffectType and EnableShadowEffect
- Platform requirements and limitations