NiceEntry 1.6.1

NiceEntry

Labeled input controls for .NET MAUI with built-in validation, required field indicators, and light/dark theme support.

Features

• LabeledEntry — Text input with floating label
• LabeledPicker — Dropdown picker with label
• LabeledDatePicker — Date selector with label
• LabeledTimePicker — Time selector with label
• LabeledAutoCompleteEntry — Entry with inline suggestion dropdown (new in 1.5)
• NiceButton — Standalone tappable icon/text button with shapes, shadow, and command binding
• Built-in validation error display (red border + error messages)
• Required field indicator (*)
• Unit suffix label with customizable font, size, and color
• Configurable content padding
• Example/hint text below the control
• Platform-specific native styling (Android & iOS)
• Light and dark theme support

Platforms

Installation

dotnet add package NiceEntry

Usage

Add the namespace to your XAML:

xmlns:nice="clr-namespace:NiceEntry;assembly=NiceEntry"

Basic entry

<nice:LabeledEntry Label="Name"
                   Text="{Binding Name}"
                   Placeholder="Enter your name"
                   IsRequired="True" />

Entry with unit suffix

<nice:LabeledEntry Label="Battery size"
                   Text="{Binding BatterySize}"
                   Unit="kWh"
                   Keyboard="Numeric" />

Custom unit styling

<nice:LabeledEntry Label="Weight"
                   Text="{Binding Weight}"
                   Unit="kg"
                   UnitFontSize="20"
                   UnitFontFamily="Georgia"
                   UnitColor="DarkOrange" />

Custom padding

<nice:LabeledEntry Label="Extra padding"
                   Text="{Binding Value}"
                   ContentPadding="24,20" />

Validation errors

Bind Error to an IReadOnlyCollection<string> — when non-empty, the border turns red and messages display below the control:

<nice:LabeledEntry Label="Email"
                   Text="{Binding Email}"
                   Error="{Binding EmailErrors}" />

Picker

<nice:LabeledPicker Label="Country"
                    ItemsSource="{Binding Countries}"
                    SelectedItem="{Binding SelectedCountry}" />

Date and time pickers

<nice:LabeledDatePicker Label="Select a date"
                        Date="{Binding SelectedDate}" />

<nice:LabeledTimePicker Label="Select a time"
                        Time="{Binding SelectedTime}"
                        IsRequired="True" />

Auto-complete entry

Filter a list of suggestions as the user types. Tap a row to commit it back into the entry.

<nice:LabeledAutoCompleteEntry Label="ICAO code"
                               Placeholder="e.g. ESGG"
                               Text="{Binding IcaoText}"
                               Suggestions="{Binding IcaoSuggestions}"
                               MaxSuggestions="6"
                               CommitOnUpperCase="True" />

Common Properties (LabelBase)

LabeledEntry Properties

NiceButton

NiceButton is a standalone tappable button that combines an optional icon (from Material Design Icons) with optional text. It is not part of the labeled-input family — it has no floating label or validation display.

The same buttons in light and dark mode — icon/text layouts, circle/rounded/rectangle shapes, shadow, and theme-aware colors:

<p align="center"> <img src="images/nicebutton-light.png" alt="NiceButton variants in light mode" width="300" />    <img src="images/nicebutton-dark.png" alt="NiceButton variants in dark mode" width="300" /> </p>

Setup

NiceButton uses the Material Design Icons font, which must be registered before glyphs render correctly. Call .UseNiceEntry() in your MauiProgram.cs:

builder.UseMauiApp<App>()
       .UseNiceEntry();   // registers the Material Design Icons font

Without this call, Icon glyphs render as empty boxes.

Basic example

<nice:NiceButton Text="Buy now"
                 Icon="Cart"
                 BackgroundColor="#3B49DF"
                 TextColor="White"
                 Command="{Binding BuyCommand}" />

Properties

Enums and constants

• ButtonShape — Rectangle, Rounded, Circle
• ButtonContentOrientation — Horizontal, Vertical (set via the Orientation property)
• IconPlacement — Start, End
• MaterialIcon — generated enum with codepoint values for every MDI glyph
• NiceButton.DefaultFontSize — constant 14.0

Icon source

Icons come from Material Design Icons. Browse the library to find an icon name, then pass it as the Icon property value using the MaterialIcon enum (e.g. Icon="Cart", Icon="Account", Icon="ArrowRight").

Third-party licenses

NiceEntry bundles the Material Design Icons webfont (v7.4.47, from Templarian/MaterialDesign-Webfont) as an embedded resource used by NiceButton to render icons.

The font is distributed under the Apache License, Version 2.0 by the Pictogrammers icon group. Full license text and required attribution notices are in THIRD-PARTY-NOTICES.md.

License

MIT