DaisyNumericUpDown

Overview

> Added in v1.0.8

Key Features

• Increment/decrement buttons with chevron icons
• Up/Down arrow keys to increment/decrement values
• Direct text entry with real-time input filtering (blocks invalid characters)
• Multiple number bases: Decimal, Hexadecimal (0xFF), Binary (0b1010), Octal (0o755), ColorHex (#FF5733), IPAddress (192.168.1.1)
• Paste validation: Pasted text is filtered to remove invalid characters
• Max length enforcement: ColorHex (7 chars), IPAddress (15 chars)
• Thousand separators: Display with locale-aware separators (e.g., 1,234,567)
• Supports exponential notation in decimal mode (e.g., 1e5, 2.5E-3)
• Culture-aware decimal separator and sign handling
• Configurable min/max/increment values
• Format string support (currency, percentage, etc.)
• Optional button visibility
• Same variant and size system as DaisyInput

Variant Options

Size Options

Quick Examples

> Note: Value is always specified in decimal in XAML. The control displays the value in the selected notation (hex, binary, etc.) at runtime. For example, Value="255" with NumberBase="Hexadecimal" displays as 0xFF.

<!-- Basic usage -->
<controls:DaisyNumericUpDown Value="42" />

<!-- With constraints -->
<controls:DaisyNumericUpDown 
    Minimum="0" 
    Maximum="100" 
    Increment="5" 
    Value="50" />

<!-- Currency formatting -->
<controls:DaisyNumericUpDown 
    FormatString="C2" 
    Value="19.99" />

<!-- Percentage formatting -->
<controls:DaisyNumericUpDown 
    FormatString="P0" 
    Value="0.75" 
    Increment="0.05" />

<!-- Without spin buttons -->
<controls:DaisyNumericUpDown 
    ShowButtons="False" 
    Value="100" />

<!-- With variant and size -->
<controls:DaisyNumericUpDown 
    Variant="Primary" 
    Size="Large" 
    Value="999" />

<!-- With clear button (appears on focus, resets to 0) -->
<controls:DaisyNumericUpDown 
    ShowClearButton="True" 
    Value="123" />

<!-- Thousand separators (displays "1,234,567") -->
<controls:DaisyNumericUpDown 
    ShowThousandSeparators="True" 
    Value="1234567" />

<!-- Hexadecimal (displays "0xFF") -->
<controls:DaisyNumericUpDown 
    NumberBase="Hexadecimal" 
    Value="255" />

<!-- Binary (displays "0b1010") -->
<controls:DaisyNumericUpDown 
    NumberBase="Binary" 
    Value="10" />

<!-- Hex without prefix -->
<controls:DaisyNumericUpDown 
    NumberBase="Hexadecimal" 
    ShowBasePrefix="False" 
    Value="255" />

<!-- Hex lowercase (displays "0xab", auto-cases input) -->
<controls:DaisyNumericUpDown 
    NumberBase="Hexadecimal" 
    HexCase="Lower" 
    Value="171" />

<!-- Octal (displays "0o755" - Unix permissions!) -->
<controls:DaisyNumericUpDown 
    NumberBase="Octal" 
    Value="493" />

<!-- Color hex (displays "#FF5733", padded to 6 digits) -->
<controls:DaisyNumericUpDown 
    NumberBase="ColorHex" 
    Value="16734003" />

<!-- IPv4 address (displays "192.168.1.1", validates octets) -->
<controls:DaisyNumericUpDown 
    NumberBase="IPAddress" 
    Value="3232235777" />

<!-- Currency with fixed prefix (doesn't interfere with editing) -->
<controls:DaisyNumericUpDown 
    Prefix="$" 
    FormatString="N2" 
    Value="19.99" />

<!-- Percentage with fixed suffix -->
<controls:DaisyNumericUpDown 
    Suffix="%" 
    Minimum="0" 
    Maximum="100" 
    Value="75" />

<!-- Weight with unit suffix -->
<controls:DaisyNumericUpDown 
    Suffix="kg" 
    FormatString="N1" 
    Value="72.5" />

<!-- Currency with limited decimal places (max 2) -->
<controls:DaisyNumericUpDown 
    Prefix="$" 
    MaxDecimalPlaces="2" 
    FormatString="N2" 
    Value="19.99" />

<!-- Phone/PIN input (max 4 digits, no decimals) -->
<controls:DaisyNumericUpDown 
    MaxIntegerDigits="4" 
    MaxDecimalPlaces="0" 
    Value="1234" />

Properties

Value Conversion Methods

The control provides helper methods to get the value in different notations at runtime:

// Get value as hex string
string? hex = myInput.ToHexString();                 // "0xFF"
string? hexNoPrefix = myInput.ToHexString(false);    // "FF"

// Get value as binary string
string? bin = myInput.ToBinaryString();              // "0b11111111"
string? binNoPrefix = myInput.ToBinaryString(false); // "11111111"

// Get value as octal string
string? oct = myInput.ToOctalString();               // "0o755"
string? octNoPrefix = myInput.ToOctalString(false);  // "755"

// Get value as color hex string (6-digit padded)
string? color = myInput.ToColorHexString();          // "#FF5733"
string? colorNoPrefix = myInput.ToColorHexString(false); // "FF5733"

// Get value as IPv4 address string
string? ip = myInput.ToIPAddressString();             // "192.168.1.1"

// Get value formatted according to current NumberBase setting
string? formatted = myInput.ToFormattedString();      // Uses current NumberBase

Static Extension Methods (for ViewModels)

For scenarios where you need to convert values in a ViewModel without access to the control instance, use DecimalExtensions:

using Flowery.Extensions;

// Convert decimal to various notations
decimal value = 255m;
string hex = value.ToHexString();             // "0xFF"
string binary = value.ToBinaryString();       // "0b11111111"
string octal = value.ToOctalString();         // "0o377"

decimal colorValue = 16734003m;
string color = colorValue.ToColorHexString(); // "#FF5733"

decimal ipValue = 3232235777m;
string ip = ipValue.ToIPAddressString();      // "192.168.1.1"

// Parse strings back to decimal
decimal fromHex = DecimalExtensions.FromHexString("0xFF");              // 255
decimal fromBinary = DecimalExtensions.FromBinaryString("0b1010");      // 10
decimal fromOctal = DecimalExtensions.FromOctalString("0o755");         // 493
decimal fromColor = DecimalExtensions.FromColorHexString("#FF5733");  // 16734003
decimal fromIp = DecimalExtensions.FromIPAddressString("192.168.1.1");  // 3232235777

// Safe parsing with TryFrom* variants
if (DecimalExtensions.TryFromColorHexString("#ABC", out decimal parsed))
{
    // parsed = 11189196 (#AABBCC expanded from #ABC)
}

> Note: All From methods have corresponding TryFrom variants that return bool and use an out parameter for safe parsing.

Tips & Best Practices

• Use Prefix/Suffix for currency and units instead of FormatString="C2". The prefix/suffix stay fixed and don't interfere with editing.
• Default FormatString="0" displays integers (42 instead of 42.00). Override for decimals: "N2", "C2", "P0", etc.
• Use FormatString to display values in user-friendly formats (currency, percentage)
• Set Minimum and Maximum to constrain valid input ranges
• Choose Increment values that make sense for your use case (e.g., 0.01 for currency, 5 for percentages)
• Use ShowButtons="False" when you want a simple numeric text input without spinners
• The control inherits all keyboard shortcuts from Avalonia's NumericUpDown (Up/Down arrows, Page Up/Down)
• Visual feedback: Invalid keystrokes flash the border red briefly (ShowInputError=True by default, InputErrorDuration=150ms)

Input Filtering

The control filters keystrokes in real-time based on NumberBase:

> Note: All modes have safe max lengths to prevent overflow exceptions. Values exceeding these limits are silently rejected during input.

Paste Validation

When pasting text, the control:

1. Filters out invalid characters based on NumberBase

2. Applies HexCase transformation for hex modes

3. Enforces max length constraints

4. Truncates if the result exceeds max length

Comparison with DaisyInput