v19.1.0.54

Calendar

Bug fixes

• Now, the localization is working properly for the spanned appointment count text in Flutter event calendar.

Features

• Provided the LoadMore support for the event calendar.
• Provided the negative values support for BYSETPOS in recurrence to display the appointment in the last and second last week of a month.
• Provided the support for the header date format in the Flutter event calendar.
• Provided the support for getting appointments between the start and end date range by using the getVisibleAppointments method in the Flutter event calendar.
• Provided the current time indicator support for timeslot views.
• Provided the support for enabling and disabling the swiping interaction in the Flutter event calendar.
• Provided the support for the selected date changed callback in the Flutter event calendar.
• Improved the timeslot views disabled slots appearance in the Flutter event calendar.

Breaking changes

• The startTime and endTime properties of the Appointment class are now marked as required.
• The startTime property of the RecurrenceProperties class is now marked as required.
• The startTime and endTime properties of the TimeRegion class are now marked as required.

Chart

Bug fixes

• The annotation will not flicker on zooming or panning and will get positioned properly in the plot area of the chart.
  Features
• #309715 - Provided on-demand data loading support to load more data lazily.
• #271236 – Provided auto-scrolling support to display a fixed number of data points in the visible range and can view the remaining data by panning.
• #275707 - Implemented a new x-axis type named DateTimeCategory axis, which is a mixture of date-time and category axis.
• #245176 - Provided support to fill the circular charts with gradient and image shader.
• Provided support to switch the circular charts rendering mode as gradient instead of solid colors.
• Now, the trackball tooltip can be rendered along with markers alike the series tooltip.
• The swiping gesture has been added to the chart to achieve pagination functionality.
• Provided support to change the trackball/crosshair position even after the touch interaction leaves the chart area.

Breaking Changes

• onAxisLabelRender callback has been deprecated, instead use labelFormatter callback to customize the axis labels.
• Hereafter initialize the chart behaviors in the initState method instead of build method.
• Now, the marker will be displayed in the trackball tooltip by default.

DataGrid (Beta)

Bug fixes

• Now, in Flutter 2.0, text can be typed in TextField widget when you load it in cells in web platform.

Features

• Provided the support to refresh the data when the datagrid is pulled down.
• Provided the support to swipe a row “right to left” or “left to right” for custom actions such as deleting, editing, and so on. When the user swipes a row, the row will be moved, and swipe view will be shown for custom actions.
• Provided the support to scroll to a specific row, column, or cell. Also, users can scroll a row or column based on offset values.

Breaking Changes

• We have documented all the API breaking details in this document.

Date Range Picker (Beta)

Features

• Implemented the free scroll support in the date range picker.
• Implemented action buttons to confirm and cancel the selection in the date range picker.
• Provided the support for enabling and disable the swiping interaction in the date range picker.

Breaking changes

• Now, the header text will align to the left instead of center when the multiview is enabled in the date range picker.

LinearGauge (Beta)

The Flutter Linear Gauge is a data visualization widget that can be used to display data on a linear scale in either horizontal or vertical orientation.

Key Features

• Orientation - The Linear Gauge can be set to vertical or horizontal orientation.

• Axis - The Linear Gauge axis is a scale where a set of values can be plotted. An axis can be customized by changing the thickness and edge styles. Users can also inverse the axis.

• Labels and Ticks -The Linear Gauge axis elements, such as labels, major ticks, and minor ticks, can be customized to different styles.

• Ranges - A range is a visual element that helps visualize where a range falls on the axis track quickly. Multiple ranges with different styles can be added to a linear gauge.

• Pointers - A pointer is used to indicate a specific value on an axis. The widget has three types of pointers: shape marker, widget marker, and bar. All the pointers can be customized as needed and multiple pointers can added to a linear gauge.

• Animation - All linear gauge elements can be animated in a visually appealing way. It is possible to animate the gauge elements when they are loading or when their values change.

• Pointer interaction - The shape and widget marker pointers in a Linear Gauge can be moved from one value to another with swipe or drag gestures.

Maps (Beta)

Features

• Inverted circle - Support has been provided for applying color to the inverted circle with the inner circle being transparent and the outer portion covered by an overlay color.

• Inverted polygon - Support has been provided for applying color to the inverted polygon with the inner polygon being transparent and the outer portion covered by an overlay color.

• The legend title support has been provided.

• Double tap zooming support has been provided in the shape layer and tile layer.

Breaking changes

• The title property has been removed from SfMaps.

PDF (Beta)

Bug fixes

• #313708 - The unhandled exception when adding the watermarks to the PDF document is resolved now.
• #311654 - The bookmark Unicode text preservation issue is resolved now.
• #160361 – The Wrong header row index retrieved from the PDF grid begin cell callback has been resolved now.
• The text rendering issue while using the PdfTextElement is resolved now.
• The Page size is not updated properly when adding margins issue resolved now.

Breaking Changes

• The property flatten has been removed from the PdfAnnotation and PdfAnnotationCollection. And added a new method called flatten and flattenAllAnnotations instead.

Features

• #305280 - Provided the support to add image position in the PDF grid cell.
• #161224 - Provided the support to set clip using the path data on the PDF graphics.
• Provided the support to add encryption options when protecting the PDF files.
• Provided the support to create, read, modify, fill, and flatten PDF form fields.
• Provided the support to digitally sign the PDF document.

PDF Viewer (Beta)

Breaking changes

• Now, the text selection color and handle color can be customized using selectionColor and selectionHandleColor properties of TextSelectionTheme respectively.

Features

• The Web platform support has been provided.
• Support to view the rotated PDF documents in the iOS platform has been provided.
• Now, the computeDryLayout has been implemented and SfPdfViewer widget will be compatible in all channels of Flutter SDK.
• Now, the highlighted search instance in the zoomed document will be navigated properly.

RadialGauge

Features

• Provided support to use any custom widget as a pointer.
• Provided elevation support for pointers.
• Provided overlay support for marker pointer.

Breaking changes

• If dragging is enabled and while touching the marker pointer in mobile and on hovering/clicking the marker pointer in web, the overlay will be displayed in the marker’s color by default with reduced opacity.

Range Selector (Beta)

Enhancements

• Accessibility has been improved further to easily use thumbs and control the value changes using volume buttons.

Breaking changes

• Now, the SfRangeSelectorSemanticFormatterCallback typedef has been changed into RangeSelectorSemanticFormatterCallback and the parameter has been changed from SfRangeValues to value which denotes the value of the current thumb. A new parameter named SfThumb has also been added to indicate which thumb is changed currently.

Range Slider

Features

• Support has been provided for vertical orientation.

Enhancements

• Accessibility has been improved further to easily use thumbs and control the value changes using volume buttons.

Breaking changes

• Now, the SfRangeSliderSemanticFormatterCallback typedef has been changed into RangeSliderSemanticFormatterCallback and the parameter has been changed from SfRangeValues to value which denotes the value of the current thumb. A new parameter named SfThumb has also been added to indicate which thumb is changed currently.

Slider

Features

• Support has been provided for vertical orientation.

Treemap (Beta)

Features

The Treemap is a data visualization widget that provides an effective way to visualize flat and hierarchical data as rectangles that are sized and colored based on quantitative variables.

• Labels - Add any type of widgets (like text widget) to improve the readability of the individual tiles by providing brief descriptions on labels.

• Layouts - Use different layouts based on the algorithms such as squarified, slice, and dice to represent flat and hierarchically structured data.

• Hierarchical support - Along with the flat level, treemap supports hierarchical structure too. Each tile of the treemap is a rectangle which is filled with smaller rectangles representing sub-data.

• Colors - Categorize the tiles on the treemap by customizing their color based on the levels. It is possible to set the tile color for a specific value or for a range of values.

• Tooltip - Display additional information about the tile using a completely customizable tooltip on the treemap.

• Legend - Use different legend styles to provide information on the treemap data clearly.

• Selection - Allows you to select the tiles to highlight it and do a...

v18.4.0.30

Common

Features

• A new Spark Charts widget has been added.

Calendar

Features

• The custom builder support is provided for the time region and the appointment views in the calendar.
• Provided the interaction support for the resource header.
• Support is provided to the right end padding for the cell touch region when the cell has an appointment in the calendar.

Enhancements

• The animation for view switching, selection ripple effect, and header picker pop-up animation is improved.

Breaking changes

• Now, the display date that does not contain an appointment, will show the text as 'No events' in schedule view.

Chart

Bug fixes

• #159199 - The trackball is showing properly with public methods.
• Now, the zooming will reset properly on the zoom out.
• The tooltip builder will not throw any exceptions in Circular charts.
• The selection is working properly with initialSelectedDataIndexes property.
• The trackball tooltip will not throw an exception when the tooltip is hidden using the onTrackballPositionChanging event.

Features

• #298637 - Support for defining the maximum width of the axis labels is provided.
• #274008, #293025 - Provided template support for the trackball.
• #281645 - Support for converting a logical pixel value to a chart data point and vice versa has been provided.
• Now, you can get the viewportPointIndex from onDataLabelTapped, onSelectionChanged and other applicable events.
• Provided maximumZoomLevel support for pinch-zooming in the Cartesian chart.

DataGrid Preview

Features

• #285683 -Provided the support to show stacked headers i.e. unbound header rows. Unbound header rows span stacked header columns across multiple rows and columns.
• Provided the support to display an interactive view when the grid reaches its maximum offset while scrolling down. Tapping the interactive view triggers a callback to add more data from the data source of the grid at run time.
• Provided the support to highlight the header cells on mouse hover.
• Provided the callbacks support in SfDataPager to listen when page navigation is started and ended.
• Provided the support to set grid lines for header and stacked header cells.
• Provided the support to improve the compactness of the datagrid based on the visual density.

Breaking Changes

• All the properties in GridTextColumn, GridNumericColumn, GridDateTimeColumn and GridWidgetColumn classes are marked as final. So, these classes are immutable.

Date Range Picker

Features

• Hijri date picker support is provided.
• The custom builder support is provided for the month cells and year cells in the date range picker.
• #287657 - Vertical date picker support provided.

Maps Preview

Features

• #297066, #297225, Shape sublayer - Provides option to add a shape sublayer with GeoJSON data in another shape layer or tile layer to show more details about a particular region.
• Load JSON from different sources - Load GeoJSON data in the shape layer from different sources such as files in network, assets, and data in memory.
• Tooltip for markers - Provides support to add a tooltip for both the built-in markers and custom markers to show additional information about them.
• Bar legend with gradient support - In addition to the existing legend style, you can use a bar-style legend. You can render this bar legend with a gradient background.
• Vector shapes - Add shapes such as polylines, lines, polygons, circles, and arcs as a sublayer in the shape and tile layers.
• Animation improvements - Animation is included for zooming and panning functionalities for both shape and tile layers during toolbar interactions and property changes.
• Diagnostics support - Provided Diagnostics support in the SfMaps, SfSlider, SfRangeSlider, and SfRangeSelector widgets to identify the current state of the widget while debugging.

Breaking changes

• The palette property has been removed from MapShapeLayer.

• The enableShapeTooltip property has been removed and the tooltip can be enabled by setting the shapeTooltipBuilder property.

• The shapeTooltipTextMapper property has been removed and the same behavior can be achieved by returning a custom widget from the shapeTooltipBuilder property.

• The showBubbles property has been removed and the same behavior can be achieved by setting the bubbleSizeMapper property.

• The enableBubbleTooltip property has been removed and the tooltip can be enabled by setting the bubbleTooltipBuilder property.

• The bubbleTooltipTextMapper property has been removed and the same behavior can be achieved by returning a custom widget from the bubbleTooltipBuilder property.

• The enableSelection property has been removed and the same behavior can be achieved by setting the onSelectionChanged property.

• The initialSelectedIndex property has been changed to selectedIndex. To observe the changes in the UI, the user must call setState().

• The delegate property has been changed to source property and the type of the delegate property MapShapeLayerDelegate has been changed into MapShapeSource with named constructors such as MapShapeSource.asset, MapShapeSource.network, and MapShapeSource.memory to load json data from various sources.

• The legendSettings property has been renamed as legend and the MapLegendSettings has been renamed as the MapLegend.

• The legendSource property has been renamed as source and is now moved to the MapLegend.

• The MapLegend.none enum has been removed and the same behavior can be achieved by setting the legend property as null

• The showIcon property has been removed and the same behavior can be achieved by setting iconSize property of the MapLegend class as Size.empty.

• The opacity property has been removed from MapBubbleSettings and MapSelectionSettings classes and the same behavior can be achieved by setting opacity value in color property of the MapBubbleSettings and MapSelectionSettings.

• The MapIconType.square enum has been changed to MapIconType.rectangle.

• The MapLabelOverflowMode has been renamed as the MapLabelOverflow. The MapLabelOverflowMode.trim and MapLabelOverflowMode.none enum values have been renamed to MapLabelOverflow.ellipsis and MapLabelOverflow.visible respectively. The MapLabelOverflow enum values are visible, ellipsis, and hide.

• The textStyle and tooltipTextStyle property has been removed from MapTooltipSettings and SfMapsThemeData classes respectively since the built-in tooltip shape is removed.

PDF Preview

Breaking Changes

• The method extractTextWithLine has been removed and add new method extractTextLines instead.

Features

• Support provided to encrypt or decrypt a PDF document.
• Support provided to create, read, and edit layers in a PDF documents.
• Support provided to create PDF conformance document.
• Support provided to extract text with layout.
• Support provided to draw image with pagination.
• Support provided to add attachment to the PDF document.
• Support provided to add document information in a PDF document.

Bugs

• #301560 - The bookmark parsing issue has been resolved now.

PDF Viewer Preview

Features

• Text Search - Support for searching text in a PDF document has been provided. All occurrences of the searched text can be navigated.
• Text Selection - Support to select the text presented in a PDF document has been provided. The selection can be changed by dragging the selection handler.
• Document Link Annotation - Document link annotation in the TOC (Table Of Content) of a PDF document will now navigate to its respective positions.
• #I299691 - The Page storage support has been provided, which preserves the scroll offset and zoom level.
• #F159581 - Support to adjust the space between the pages has been provided.
• Provided the initialScrollOffset and initialZoomLevel properties to display the PDF document loaded with the specified scroll offset and zoom level respectively.

Range Selector Preview

Breaking changes

• The showTooltip property has been changed into enableTooltip property.

Range Slider

Breaking changes

• The showTooltip property has been changed into enableTooltip property.

Slider

Breaking changes

• The showTooltip property has been changed into enableTooltip property.

Spark Charts Preview

Spark charts (micro charts) are lightweight charts that fit in a very small area. They display the trend of the data and convey quick information to the user.

Features

• Provided support for Line, Area, Column, and Win-loss chart types.
• Provided support for Numeric, Category, and Date-time axis types.
• Provided marker and data label supports.
• Provided trackball support to display additional information about the data points.
• Provided plot band support to highlight a particular vertical range.

XlsIO Preview

Breaking Changes

• The property showGridLines in the Worksheet class is replace with a new property showGridlines.
• The method saveStream in the Workbook class is replaced with a new method saveAsStream.
• save method is removed from the Workbook class.
• addFile method is removed from the PicturesCollection class.

Features

• Provided the support to add hyperlinks to texts and images.
• Provided the support to insert and delete rows/columns.
• Provided the support to autofit rows and columns.
• Provided the support to create Excel documents with logical functions, string functions, and nested formulas.
• Provided the support to add chart types: Area, AreaStacked, AreaStacked100, ColumnStacked100, BarStacked100, LineStacked100.
• Provided...

v18.3.38

Chart

Bug fixes

• Now the spline area series will animate properly on adding new data points dynamically.