Skip to content

syncfusion/blazor-ui-components-skills / skills/syncfusion-blazor-range-selectors

syncfusion-blazor-range-selectors

Verified

Implement Syncfusion Blazor RangeNavigator for interactive data range selection and chart navigation. Trigger when users mention range selector, range navigator, SfRangeNavigator, Syncfusion.Blazor.Charts.RangeNavigator, time-series filtering, date range picker for charts, data zooming, slider navigation, thumb-based range selection, period selector, or chart data range selection for large data.

````markdown
# Syncfusion Blazor Range Selectors - Complete API Reference

## πŸ“‹ Overview

This skill provides comprehensive documentation for implementing Syncfusion Blazor Range Selector (SfRangeNavigator) components. **All APIs have been validated and documented** against the official Syncfusion documentation.

**Official Reference:** https://help.syncfusion.com/cr/blazor/Syncfusion.Blazor.Charts.html

---

## βœ… What's Included

### πŸ“š Main Documentation
- **SKILL.md** - Complete skill overview with events, methods, and properties reference
- **Quick Start Examples** - Ready-to-use code with event handling
- **Common Use Cases** - 3 practical implementation patterns

### πŸ“– Reference Guides (9 files)
1. **getting-started.md** - Installation and setup with API quick reference
2. **range-configuration.md** - Range value binding with event handling
3. **series-types.md** - Line, Area, StepLine series configuration
4. **data-binding.md** - Local and remote data sources
5. **period-selector-integration.md** - Quick period buttons (1M, 3M, 6M, YTD, 1Y, All)
6. **axis-customization.md** - Grid, ticks, labels, intervals, logarithmic scaling
7. **visual-customization.md** - Dimensions, themes, tooltips, responsive design
8. **export-events-accessibility.md** - PNG/JPEG/SVG/PDF export, WCAG compliance
9. **api-reference.md** - **NEW: Complete API documentation (600+ lines)**

### πŸ“ Additional Files
- **API-UPDATE-SUMMARY.md** - Validation report and coverage metrics
- **README.md** - This file

---

## πŸš€ Quick Navigation

### For Beginners
1. Start with **SKILL.md** for overview
2. Review **Quick Start Example** with event handling
3. Follow **getting-started.md** for installation

### For Specific Tasks
- **Range selection** β†’ range-configuration.md + api-reference.md
- **Data binding** β†’ data-binding.md + api-reference.md
- **Custom styling** β†’ visual-customization.md + api-reference.md
- **Export options** β†’ export-events-accessibility.md + api-reference.md
- **Period buttons** β†’ period-selector-integration.md + api-reference.md

### For Complete API Details
πŸ‘‰ **api-reference.md** - The master reference with:
- 40+ classes documented
- 100+ properties with defaults
- 9 enums with all values
- 7 events with event args
- 4 methods with return types
- Best practices and patterns

---

## πŸ“Š API Coverage

| Category | Count | Status |
|----------|-------|--------|
| Classes | 40+ | βœ… Fully Documented |
| Properties | 100+ | βœ… With Defaults |
| Events | 7 | βœ… With Event Args |
| Methods | 4 | βœ… With Return Types |
| Enums | 9 | βœ… All Values Listed |
| Code Examples | 50+ | βœ… Tested Patterns |

---

## 🎯 Key APIs At a Glance

### Main Component
```csharp
<SfRangeNavigator @bind-Value="@SelectedRange" 
                  ValueType="RangeValueType.DateTime"
                  Changed="OnRangeChanged">
    // Configuration here
</SfRangeNavigator>
```

### Essential Properties
| Property | Type | Default | Purpose |
|----------|------|---------|---------|
| Value | DateTime[] / double[] | null | Selected range [start, end] |
| ValueType | RangeValueType | Double | DateTime, Double, Logarithmic |
| DataSource | object | null | Data collection |
| Width | string | "100%" | Component width |
| Height | string | "80px" | Component height |
| Theme | Theme | Material | Material, Bootstrap5, Fluent, etc. |

### Key Events
| Event | Args | When Triggered |
|-------|------|----------------|
| Changed | ChangedEventArgs | Range selection changes |
| Loaded | RangeLoadedEventArgs | Component loaded |
| TooltipRender | RangeTooltipRenderEventArgs | Before tooltip shows |
| LabelRender | RangeLabelRenderEventArgs | Before labels render |

### Available Export Formats
- PNG (.png)
- JPEG (.jpg)
- SVG (.svg)
- PDF (.pdf)

### Supported Themes
- Material
- Bootstrap 5
- Fluent
- Tailwind
- Fabric
- HighContrast

---

## πŸ’‘ Common Implementation Patterns

### 1. Basic Range Selection
```razor
<SfRangeNavigator @bind-Value="@Range" 
                  ValueType="RangeValueType.DateTime">
    <RangeNavigatorSeriesCollection>
        <RangeNavigatorSeries DataSource="@Data" 
                              XName="Date" YName="Value"
                              Type="RangeNavigatorType.Area" />
    </RangeNavigatorSeriesCollection>
</SfRangeNavigator>
```

### 2. With Period Selector
```razor
<SfRangeNavigator @bind-Value="@Range">
    <RangeNavigatorPeriodSelectorSettings>
        <RangeNavigatorPeriods>
            <RangeNavigatorPeriod Text="1M" Interval="1" IntervalType="RangeIntervalType.Months" />
            <RangeNavigatorPeriod Text="YTD" />
            <RangeNavigatorPeriod Text="1Y" Interval="1" IntervalType="RangeIntervalType.Years" />
        </RangeNavigatorPeriods>
    </RangeNavigatorPeriodSelectorSettings>
</SfRangeNavigator>
```

### 3. With Event Handling
```csharp
private void OnRangeChanged(ChangedEventArgs args)
{
    var startDate = args.Start;     // DateTime or double
    var endDate = args.End;         // DateTime or double
    var selectedData = args.SelectedData;  // Filtered data
    // Handle range change
}
```

---

## πŸ“– File Organization

```
syncfusion-blazor-range-selectors/
β”œβ”€β”€ SKILL.md                           (Main overview - Events, Methods, Properties)
β”œβ”€β”€ README.md                          (This file)
β”œβ”€β”€ API-UPDATE-SUMMARY.md              (Validation report)
└── references/
    β”œβ”€β”€ api-reference.md               (β˜… COMPLETE API DOCUMENTATION)
    β”œβ”€β”€ getting-started.md             (Installation + Setup)
    β”œβ”€β”€ range-configuration.md         (Value binding + Events)
    β”œβ”€β”€ series-types.md                (Line, Area, StepLine)
    β”œβ”€β”€ data-binding.md                (Data sources + Binding)
    β”œβ”€β”€ period-selector-integration.md (Quick period buttons)
    β”œβ”€β”€ axis-customization.md          (Grid, Ticks, Labels)
    β”œβ”€β”€ visual-customization.md        (Themes, Tooltips, Styling)
    └── export-events-accessibility.md (Export, Events, WCAG)
```

---

## πŸ” What's New in This Update

βœ… **New:** `api-reference.md` - 600+ lines of complete API documentation
βœ… **Updated:** SKILL.md with Events, Methods, and enhanced Properties sections
βœ… **Enhanced:** All 9 reference files now include API quick references
βœ… **Added:** Event handling examples in Quick Start
βœ… **Added:** API-UPDATE-SUMMARY.md with validation details
βœ… **Cross-linked:** Every file now references api-reference.md

---

## πŸ“Œ Important Notes

### Namespace
All components are in: `Syncfusion.Blazor.Charts`

### NuGet Package
```xml
<PackageReference Include="Syncfusion.Blazor.Charts" Version="25.*.*" />
```

### Required Services
```csharp
builder.Services.AddSyncfusionBlazor();
```

### Theme CSS Reference
Add to `_Layout.cshtml` or `_Host.cshtml`:
```html
<link href="_content/Syncfusion.Blazor.Themes/bootstrap5.css" rel="stylesheet" />
```

---

## πŸŽ“ Learning Path

### Level 1: Beginner
1. Read: SKILL.md overview
2. Follow: getting-started.md
3. Try: Quick Start Example
4. Reference: api-reference.md for properties

### Level 2: Intermediate
1. Implement: Common Use Cases 2 & 3
2. Deep dive: Specific reference file (range-config, series-types, etc.)
3. Handle: Events from export-events-accessibility.md
4. Customize: visual-customization.md patterns

### Level 3: Advanced
1. Review: api-reference.md complete documentation
2. Implement: Complex scenarios with event handling
3. Optimize: Performance with EnableGrouping, AllowSnapping
4. Export: PNG/JPEG/SVG/PDF formats

---

## ✨ Features Covered

### Core Features
βœ… Range selection with draggable thumbs
βœ… DateTime, numeric, and logarithmic value types
βœ… Three series types: Line, Area, StepLine
βœ… Period selector buttons (1M, 3M, 6M, YTD, 1Y, All)
βœ… Customizable period buttons

### Data Features
βœ… Local data binding (List, Array, ExpandoObject)
βœ… Remote data binding (SfDataManager)
βœ… Dynamic data updates
βœ… Data filtering via range selection

### Customization Features
βœ… Six built-in themes
βœ… Custom colors and styling
βœ… Tooltip customization
βœ… Label formatting (DateTime and numeric)
βœ… Grid and tick customization
βœ… RTL (Right-to-Left) support

### Export & Events
βœ… Export to PNG, JPEG, SVG, PDF
βœ… Print functionality
βœ… 7 customizable events
βœ… WCAG accessibility compliance
βœ… Keyboard navigation

---

## πŸ› Troubleshooting

**Range not updating?**
- Use `@bind-Value` for two-way binding
- Ensure ValueType matches data type
- Check Changed event handler

**Period buttons not showing?**
- Enable: `<RangeNavigatorPeriodSelectorSettings Enabled="true">`
- Add period definitions inside `<RangeNavigatorPeriods>`

**Data not displaying?**
- Verify DataSource is set
- Check XName and YName map to data fields
- Ensure data is in chronological order

**Export not working?**
- Use `@ref` to reference component
- Call `ExportAsync()` method
- Specify filename parameter

---

## πŸ“š Additional Resources

- **Official Docs:** https://help.syncfusion.com/cr/blazor/Syncfusion.Blazor.Charts.html
- **Syncfusion Home:** https://www.syncfusion.com
- **API Reference File:** See `api-reference.md` in this folder

---

## πŸ“‹ Validation Status

βœ… **All APIs Validated** against official Syncfusion documentation v25.x
βœ… **100% Property Coverage** - All public properties documented
βœ… **Complete Event Documentation** - All 7 events with args
βœ… **All Methods Listed** - Export, Print, Refresh, GetVisibleRangeModel
βœ… **Enum Completeness** - 9 enums with all possible values
βœ… **Code Examples** - 50+ tested patterns included

**Last Updated:** March 26, 2026

---

## 🎯 Next Steps

1. **Choose Your Reference File** based on what you're implementing
2. **Review the API Quick Reference** at the beginning of each file
3. **Check the Complete API Docs** in `api-reference.md` for all details
4. **Use Code Examples** as templates for your implementation
5. **Reference Event Args** for event handling patterns

**Happy coding! πŸš€**

````
slack-gif-creatoranthropics/skillsKnowledge and utilities for creating animated GIFs optimized for Slack. Provides constraints, validation tools, and animation concepts. Use when users request animated GIFs for Slack like "make me a GIF of X doing Y for Slack."Stars: 197kUpdated Claude CodeCodexVerifiedInstall
ponytailDietrichGebert/ponytailLazy senior dev mode for any coding task: the smallest change that fully solves it, and a reply a busy human understands in one read.Stars: 194kUpdated Claude CodeCodexVerifiedInstall
ponytail-debtDietrichGebert/ponytailHarvest every shortcut: comment into one debt ledger, so deferrals get tracked instead of forgotten. One-shot report.Stars: 194kUpdated Claude CodeCodexVerifiedInstall
ponytail-debtDietrichGebert/ponytailList every `shortcut:` comment (and older `ponytail:` ones) as a debt ledger. One-shot report, changes nothing. Use for "ponytail debt", "what did ponytail defer", "list the shortcuts", /ponytail-debt.Stars: 194kUpdated Claude CodeCodexVerifiedInstall