Skip to content

FLUT-1020062: Enhanced Flutter Range Selector UG documentation#1495

Open
Harsha-SF4223 wants to merge 1 commit into
masterfrom
FLUT-1020062-rangeselector
Open

FLUT-1020062: Enhanced Flutter Range Selector UG documentation#1495
Harsha-SF4223 wants to merge 1 commit into
masterfrom
FLUT-1020062-rangeselector

Conversation

@Harsha-SF4223

@Harsha-SF4223 Harsha-SF4223 commented Jul 14, 2026

Copy link
Copy Markdown
Contributor

Description

Enhanced the Flutter User Guide documentation for SfRangeSelector (Range Selector).

Files Updated

https://help.syncfusion.com/flutter/range-selector/overview
https://help.syncfusion.com/flutter/range-selector/getting-started
https://help.syncfusion.com/flutter/range-selector/tooltip
https://help.syncfusion.com/flutter/range-selector/shapes
https://help.syncfusion.com/flutter/range-selector/basic-features
https://help.syncfusion.com/flutter/range-selector/interval
https://help.syncfusion.com/flutter/range-selector/track
https://help.syncfusion.com/flutter/range-selector/thumb-and-overlay
https://help.syncfusion.com/flutter/range-selector/ticks
https://help.syncfusion.com/flutter/range-selector/labels-and-divider
https://help.syncfusion.com/flutter/range-selector/range-controller
https://help.syncfusion.com/flutter/range-selector/drag-mode
https://help.syncfusion.com/flutter/range-selector/enabled-and-disabled-state
https://help.syncfusion.com/flutter/range-selector/right-to-left
https://help.syncfusion.com/flutter/range-selector/accessibility
https://help.syncfusion.com/flutter/range-selector/how-to/custom-widget-on-flutterflow

Changes Made

Added

  • Added a new "Enabled state" section to the enabled-and-disabled-state page and an "Orientation" feature bullet to the overview page.
  • Added a new N> callout on RTL not being applicable for vertical orientation, and an "Enabled state" I>/example block to match the page title.
  • Added import 'package:intl/intl.dart'; to all code samples using DateFormat / NumberFormat.
  • Added import 'package:syncfusion_flutter_core/theme.dart'; to all theme-based code samples using SfRangeSelectorTheme / SfRangeSelectorThemeData.
  • Added import 'package:syncfusion_flutter_localizations/flutter_localizations.dart'; to the RTL locale-based example.
  • Added import 'dart:math' as math; to the shapes track and ticks examples.
  • Added a data-binding step to the FlutterFlow "Utilizing the custom widget" section, a selectionController explanation to the range-controller selection example, and a keyboard step-size note (stepSize / stepDuration) to the accessibility keyboard-support section.

Updated

  • Improved content clarity and consistency across all 16 pages.
  • Updated all code samples to be complete, runnable Flutter examples with imports and class wrappers (StatefulWidget / StatelessWidget).
  • Standardized code block indentation (flutter format-style) and ensured consistent {% tabs %} / {% endtabs %} formatting.
  • Consolidated repeated N> / I> callouts into a single instance per page to reduce duplication.
  • Replaced orientation-confusing "left thumb" / "right thumb" terminology with the neutral "start thumb" / "end thumb" across all pages that described active/inactive regions or RTL behavior.

Fixed

  • Fixed all platform: Flutter frontmatter entries to lowercase flutter, and removed stray leading/trailing spaces from frontmatter titles and descriptions.
  • Corrected all theme-data API links from SfSliderThemeData/SfRangeSliderThemeData to SfRangeSelectorThemeData across tooltip, labels-and-divider, enabled-and-disabled-state, and thumb-and-overlay pages.
  • Added the missing @override annotation to _TrackShape.paint in shapes.md, and added late modifiers to uninitialized RangeController / SfCartesianChart fields in range-controller.md for Dart null-safety.
  • Cast _rangeController.start / .end to DateTime before calling .isAfter() / .isBefore() in range-controller.md, and added const to Icon constructors in thumb-and-overlay.md.
  • Fixed the Month-format example's chart data in labels-and-divider.md (nine identical DateTime values corrected to distinct months), and aligned the Step duration example in interval.md with SliderStepDuration(years: 1, months: 6).
  • Added the missing chartData field to the Individual label style example in labels-and-divider.md, and print(...)debugPrint(...) in basic-features.md.
  • Corrected SelectionSettings.selectionControllerSelectionBehavior.selectionController, primaryYAxis.rangeControllerprimaryXAxis.rangeController (range-controller), and SliderDurationSliderStepDuration (interval).
  • Fixed grammar, awkward phrasing, and misused words throughout ("helps to learn about how" → "explains how to", "explains about how" → "explains how to", "need not to" → "do not need to", "was drawn" → "is drawn", "stops to interact" → "stops interacting", "We have provided" → "The range selector provides", etc.).
  • Fixed cross-reference and image-asset links (Divider #show-dividers#divider-color in accessibility.md; misspelled Adding-code-snippent.pngAdding-code-snippet.png; literal [</>] → image reference in FlutterFlow how-to).

Why This Change?

  • Improve developer onboarding and reduce confusion.
  • Make the documentation easier to follow and more accurate.
  • Ensure all code samples are copy-paste ready and reflect current API usage with proper imports and null-safety.
  • Enhance accessibility and inclusivity guidance (keyboard step size, touch targets, screen reader guidance).
  • Align terminology and link targets with the SfRangeSelector widget (not the slider/range-slider siblings).

Validation

  • Verified documentation flow
  • Verified code samples (all are runnable)
  • Verified links (all point to correct API/docs)
  • Reviewed grammar and readability
  • Verified null-safety correctness (late, casts, const)

Impact

  • No API changes.
  • No functional changes.
  • Documentation enhancement only.

Documentation Enhancement Metrics

Category Count
Missing Steps Added 4
Technical Corrections 52
Missing Information Added 9
Grammar Improvements 41
Clarity Improvements 16
Files Modified 16

Updated report

Range Selector UG enhanced report.docx

@SyncfusionBuild

Copy link
Copy Markdown
Contributor

Build Status: INPROGRESS 🔃
Build Location: FLUT-1020062-rangeselector

@SyncfusionBuild

Copy link
Copy Markdown
Contributor

CI Status: FAILURE ❌
Source Compilation: SUCCESS ✅
Failure Reason: CI Failure with violation
Build Location: FLUT-1020062-rangeselector
Technical Error(s): 0
Spelling Error(s): 2
Image Alt Text Error(s): 0
Image Size Error(s): 3
Image Name Error(s): 0
Front matter Error(s): 54
File Path Error(s): 0
CodeSnippet File Path Missing Error(s): 0
Toc Anchor Tags Validation Error(s): 0
MD Tag Validation Error(s): 1

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants