syncfusion-maui-date-time-range-slider

$npx mdskill add syncfusion/maui-ui-components-skills/syncfusion-maui-date-time-range-slider

Implement Syncfusion .NET MAUI DateTime Range Slider with dual thumbs.

  • Select date/time ranges using dual-thumb slider in .NET MAUI apps.
  • Requires Syncfusion .NET MAUI NuGet package and SfDateTimeRangeSlider control.
  • Configures track, thumbs, labels, ticks, dividers, tooltips based on user needs.
  • Generates XAML and C# code for the slider with optional Liquid Glass Effect.

SKILL.md

.github/skills/syncfusion-maui-date-time-range-sliderView on GitHub ↗
---
name: syncfusion-maui-date-time-range-slider
description: Implements Syncfusion .NET MAUI DateTime Range Slider (SfDateTimeRangeSlider) control. Use when implementing range sliders, date range pickers, time range selectors, dual-thumb sliders, or interactive range selection controls in .NET MAUI applications. This skill covers installation, configuration, track styling, labels, ticks, dividers, tooltips, thumb customization, and the Liquid Glass Effect.
metadata:
  author: "Syncfusion Inc"
  version: "34.1.29"
---

# Implementing .NET MAUI Date Time Range Slider

This skill provides comprehensive guidance for implementing the Syncfusion .NET MAUI DateTime Range Slider (`SfDateTimeRangeSlider`) control, a highly interactive UI component that enables users to select a range of DateTime values with dual thumbs.

## When to Use This Skill

Use this skill when the user needs to:

- Implement a **range slider** for selecting DateTime ranges in .NET MAUI apps
- Create **date range pickers** with visual track, thumbs, and labels
- Build **time range selectors** with hour/minute/second granularity
- Add **dual-thumb sliders** for min-max date/time selection
- Implement **interactive calendars** with range selection via slider
- Customize **track, thumb, tick, label, divider, or tooltip** appearance
- Configure **discrete stepping** through DateTime values
- Handle **value change events** or implement **MVVM commands**
- Apply the modern **Liquid Glass Effect** on iOS 26+/macOS 26+ platforms
- Support **horizontal and vertical orientations** with RTL
- Style **active/inactive regions** separately for selected ranges

This skill covers the complete API surface including installation, configuration, styling, events, commands, and advanced features like deferred updates and interval selection.

## Component Overview

**Control:** `SfDateTimeRangeSlider` (Syncfusion .NET MAUI Range Slider)  
**Namespace:** `Syncfusion.Maui.Sliders`  
**Package:** `Syncfusion.Maui.Sliders` (NuGet)  
**Platform Support:** .NET MAUI (iOS, Android, macOS, Windows)

### Key Features

- **DateTime Support** - Select DateTime ranges with built-in date/time formatting
- **Dual Thumbs** - Start and end thumbs for range selection
- **Flexible Intervals** - Years, Months, Days, Hours, Minutes, Seconds
- **Labels & Ticks** - Customizable labels, major/minor ticks, and dividers
- **Tooltips** - Interactive tooltips showing selected values
- **Orientation** - Horizontal and vertical layouts with inverse support
- **Discrete Mode** - Step through values at specific intervals
- **Drag Behaviors** - OnThumb, BetweenThumbs, or Both modes
- **Rich Styling** - Separate active/inactive styling for all elements
- **Events & Commands** - Complete lifecycle events with MVVM support
- **Liquid Glass Effect** - Modern translucent design (iOS 26+/macOS 26+/.NET 10+)
- **Visual State Manager** - Enabled/Disabled state customization

## Documentation and Navigation Guide

### Getting Started

📄 **Read:** [references/getting-started.md](references/getting-started.md)

When you need:
- Installation and package setup
- Handler registration (ConfigureSyncfusionCore)
- Basic DateTime Range Slider implementation
- Minimal working example
- Quick start code (XAML and C#)
- Initial configuration troubleshooting

### Track and Range Configuration

📄 **Read:** [references/track-and-range.md](references/track-and-range.md)

When you need:
- Set Minimum and Maximum DateTime values
- Configure RangeStart and RangeEnd (selected range)
- Change orientation (Horizontal/Vertical)
- Inverse slider direction
- Customize track colors (ActiveFill/InactiveFill)
- Adjust track height/size
- Extend track at edges (TrackExtent)
- Style disabled states with Visual State Manager

### Labels, Intervals, and Formatting

📄 **Read:** [references/interval-and-labels.md](references/interval-and-labels.md)

When you need:
- Configure interval values and types (Years, Months, Days, etc.)
- Enable auto-interval calculation
- Format DateTime labels (DateFormat strings)
- Show/hide labels
- Position labels (OnTicks vs BetweenTicks)
- Place edge labels (Default vs Inside)
- Style active/inactive labels separately
- Customize label colors, fonts, and sizes
- Adjust label offset from ticks
- Create custom label text via LabelCreated event

### Ticks and Dividers

📄 **Read:** [references/ticks-and-dividers.md](references/ticks-and-dividers.md)

When you need:
- Show/hide major and minor ticks
- Configure ticks per interval
- Customize tick colors (active/inactive)
- Adjust tick sizes
- Set tick offset from track
- Enable dividers on the track
- Style divider radius, colors, and strokes
- Apply Visual State Manager for disabled states

### Tooltips and Thumbs

📄 **Read:** [references/tooltip-and-thumb.md](references/tooltip-and-thumb.md)

When you need:
- Enable and configure tooltips
- Show tooltips always (without interaction)
- Style tooltip appearance (fill, stroke, text)
- Format tooltip DateTime values
- Customize tooltip text via TooltipLabelCreated event
- Configure thumb size, colors, and stroke
- Style thumb overlap behavior
- Customize thumb overlay (interaction halo)
- Apply disabled states

### Selection and Interaction

📄 **Read:** [references/selection-and-interaction.md](references/selection-and-interaction.md)

When you need:
- Enable discrete selection (StepDuration)
- Configure interval selection mode
- Set drag behavior (OnThumb, BetweenThumbs, Both)
- Enable deferred updates for performance
- Adjust deferred update delay
- Handle touch and gesture interactions
- Understand different selection patterns

### Events and Commands

📄 **Read:** [references/events-and-commands.md](references/events-and-commands.md)

When you need:
- Handle value change lifecycle events
- Listen to ValueChangeStart, ValueChanging, ValueChanged, ValueChangeEnd
- Access event arguments (OldStart, OldEnd, NewStart, NewEnd)
- Cancel value changes
- Customize labels via LabelCreated event
- Customize tooltips via TooltipLabelCreated event
- Implement MVVM with DragStartedCommand/DragCompletedCommand
- Use command parameters
- Enable Liquid Glass Effect (platform-specific)

More from syncfusion/maui-ui-components-skills

SkillDescription
syncfusion-maui-accordionImplements Syncfusion .NET MAUI Accordion (SfAccordion) - a vertically collapsible panel with stacked headers for expanding/collapsing content. Use when working with accordions, collapsible panels, expandable lists, employee lists with details, or FAQ sections in .NET MAUI applications. Covers AccordionItem configuration, expand modes, and grouped content display.
syncfusion-maui-ai-assistviewImplements Syncfusion .NET MAUI AI AssistView (SfAIAssistView) for AI-powered interactive chat interfaces. Use when working with AI chat interfaces, AI AssistView, SfAIAssistView, conversational UI, or chat with AI responses. Covers integrating AI services, creating chat UIs, implementing conversation flows, managing AI requests/responses, and displaying AI suggestions.
syncfusion-maui-autocompleteImplements and configure Syncfusion .NET MAUI Autocomplete (SfAutocomplete) control for intelligent text input with suggestions. Use when implementing autocomplete, autosuggest, type-ahead search, smart search, or filtered dropdowns in .NET MAUI applications. Covers data binding, filtering modes, custom search logic, AI-powered search, multi-selection with tokens, and UI customization.
syncfusion-maui-avatar-viewImplements Syncfusion .NET MAUI Avatar View (SfAvatarView) for displaying user profile pictures, initials, or group avatars. Use when working with avatar views, profile pictures, user images, initials display, profile icons, or contact images. Ideal for implementing user profile displays, contact lists, chat interfaces, or social feeds.
syncfusion-maui-backdropImplements Syncfusion .NET MAUI Backdrop Page (SfBackdropPage) with back layer and front layer surfaces. Use when working with backdrop pages, SfBackdropPage, back layer, front layer, or reveal/conceal animations. Covers backdrop navigation patterns, header icons, corner shapes, reveal height, layer state events, and liquid glass effect.
syncfusion-maui-badge-viewImplements Syncfusion .NET MAUI Badge View (SfBadgeView) control. Use when adding badge notifications, status indicators, unread counts, or notification overlays to MAUI applications. Covers SfBadgeView setup, badge text customization, position adjustments, animations, predefined symbols, and accessibility features.
syncfusion-maui-barcode-generatorImplements Syncfusion .NET MAUI Barcode Generator (SfBarcodeGenerator) for generating machine-readable barcodes. Use when working with barcodes, barcode generation, QR codes, data matrix, EAN codes, UPC codes, Code128, or Code39. This skill covers both one-dimensional (linear) and two-dimensional (matrix) barcode symbologies with extensive customization options.
syncfusion-maui-busy-indicatorImplements Syncfusion .NET MAUI Busy Indicator (SfBusyIndicator) for showing loading states, data processing, and app activity indicators. Use when displaying loading indicators, busy animations, activity spinners, or processing feedback in .NET MAUI apps. Covers busy indicator setup, animations, and visual feedback during long-running operations.
syncfusion-maui-buttonImplements and customize Syncfusion .NET MAUI Button (SfButton) control. Use when working with MAUI buttons, SfButton implementation, button customization, or visual states. Covers button icons, background images, RTL support, Liquid Glass effects, custom button views, button styling, events, and checkable buttons.
syncfusion-maui-calendarImplements and customize Syncfusion .NET MAUI Calendar (SfCalendar) control. Use when implementing calendar functionality, date selection (single, multiple, range), or calendar views (month, year, decade, century). Covers date restrictions (min/max dates, EnablePastDates, SelectableDayPredicate), calendar customization, events (ViewChanged, SelectionChanged, Tapped), and header/footer customization.