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.35

Common

Features

• New PDF Viewer and Signature Pad widgets have been added.
• New XlsIO library has been added.
• Barcodes and Slider widgets are now ready for production.

Breaking Changes

• The license key is not required now to run the application with our widgets. However, you need to still have either Syncfusion commercial license or community license to use our widgets and libraries.

Calendar

Features

• Timeline month view support
• Resource view support
• Internal view navigation support
• Blackout dates support
• Hide leading and trailing dates support
• The custom builder support for the month cells and the month header of the schedule view
• Agenda appointment time format support
• The todayTextStyle property from the MonthCellStyle class has been deprecated, use the same property from the SfCalendar class instead.
• The timeIntervalHeight property will not work for timeline views, use the timeIntervalWidth property instead for the timeline views alone.
• The default value for the timeIntervalWidth is changed from 40 to 60.
• The appointment UI width is reduced in the day, week, and workweek views.
• #293466 - Now, the appointment will render on the correct timeslot, when the local set as French, Canada, and in Eastern Standard Time.
• #294974 - Now, the appointments will render on the correct timeslot, when the start time of the time slot is set as a different value.

Chart

Bug fixes

• #284084 - Now, onSelectionChanged event will return the proper index value.
• Series visibility is working properly with FutureBuilder.
• Now, panning is working properly with LayoutBuilder and FutureBuilder.
• #286621 - Annotations are rendering properly with plot offset.
• #156158 - The onTrackballPositionChanging event is firing properly.
• #286612 - Now, crosshair label is showing at the correct position with the public method.
• #156431 - Now, the onZooming event will not be triggered while handling the onTrackballPositionChanging event.
• Animation for dynamic updates, works now even in a zoomed state.
• The data label builder can now return proper index value with visibleMinimum and visibleMaximum properties.
• The onZooming event returns proper previousZoomFactor and previousZoomPosition values.

Features

• Provided support to render waterfall chart type.
• #272882 - Provided support to render box and whisker chart type.
• #282483, #282502 - Now, the rendered chart can be exported and saved as a png image or pdf document for future use.
• Provided support to display the markers at data point positions when moving the trackball.
• #153291 - Provided support to position the trackball tooltips without intersecting each other.
• Now, the data labels can be rearranged by moving it vertically or horizontally.
• #284082 - Provided support for onDataLabelTapped event to get the information of tapped data label.
• #155753 - Now, the data points of the chart can be selected programmatically using the selectDataPoints public method.
• #251513 - The rendered series can be animated using the animate method of the series.
• Provided support to calculate the value axis auto-range based on the visible data point or overall data points.

Breaking changes

• The selectionSettings property and the SelectionSettings class have been deprecated. Now, you can use the selectionBehavior property * and SelectionBehavior class, respectively.

Date Range Picker

• Now, the endDate of PickerDateRange will not prior to the startDate in the DateRangePickerSelectionChangedArgs.

Maps

Features

• Tile layer - An interactive tile layer allows you to load map tiles from web map tile services such as Bing Maps, OpenStreetMaps, Google Maps, TomTom, etc. Use markers to denote the specific latitude and longitude in the tile layer as required. Zoom and pan the tile layer to navigate across the regions and take a closer look.
• Zooming and panning in shape layer - Zoom in the shape layer for a closer look at a specific region by pinching the map, scrolling the mouse wheel or track pad, or using the toolbar on the web. Pan the map to navigate across the regions. You can also customize the zoom level and the center point of the initial rendering.
• Custom widget for tooltips - Customize the shape and bubble tooltips with the entirely customized widgets.
• Legend for bubbles - In addition to the legend for the shapes, now render legends for the bubbles, too. Use legends to provide clear information on the data plotted in the map. You can use the legend toggling feature to visualize only the data of the required region.
  Improvement in interaction animations and web platform hovering - Smooth animations have been added for the shape interactions like legend toggling and selection. Also, use hover support for the web platform to include animations when hovering over bubbles and shapes to improve the UI experience.

Breaking changes

• The showLegend property has been removed and the same behavior can be achieved by setting the legendSource property to MapElement.none.
• The toggledShapeColor has been changed to toggledItemColor in SfMapsThemeData and MapLegendSettings.
• The toggledShapeStrokeColor has been changed to toggledItemStrokeColor in SfMapsThemeData and MapLegendSettings.
• The toggledShapeStrokeWidth has been changed to toggledItemStrokeWidth in SfMapsThemeData and MapLegendSettings.
• The toggledShapeOpacity has been changed to toggledItemOpacity in MapLegendSettings.

PDF Preview

Features

• Support provided to parse the existing PDF document.
• Support provided to add or remove the PDF pages in an existing PDF document.
• Support provided to add the graphical content to the existing PDF document page.
• Provided the incremental update support for the existing PDF document.
• Support provided to create and load the annotations in a new or existing PDF document.
• Support provided to load the existing PDF document bookmarks with its destination.
• Support provided to extract the text in an existing PDF document along with its bounds.
• Support provided to find the text in an existing PDF document along with its bounds and page index.
• Support provided to flatten the supported annotations in an existing PDF document.
• Support provided to save the PDF document with a cross-reference stream.

PDF Viewer (Preview)

The Syncfusion Flutter PDF Viewer widget lets you view PDF documents seamlessly and efficiently in Android and iOS platforms. It has highly interactive and customizable features such as magnification, virtual scrolling, page navigation, and bookmark navigation.

Features

• Virtual Scrolling - Easily scroll through the pages in the document with a fluent experience. The pages are rendered only when required to increase the loading and scrolling performance.
• Magnification - The content of the document can be efficiently zoomed in and out.
• Page navigation - Navigate to the desired pages instantly.
• Bookmark navigation - Bookmarks saved in the document are loaded and made ready for easy navigation. This feature helps navigate the topics bookmarked already within the PDF document.
• Themes - Easily switch between light and dark themes.
• Localization - All static text within the PDF Viewer can be localized to any supported language.

Radial Gauge

Bug fixes

• #291218 - Now, with minimum axis value, the radial gauge widget will not throw any exceptions.
• Now, the axis renders up to the maximum value even when the maximum value does not fall under the calculated interval.

Features

• Now, the rendered gauge can be exported and saved as a png image or pdf document for future use.

Breaking changes

• Changed the name of the property from needRotateLabels to canRotateLabels.

Range Selector

Features

Material design improvements - The following UI improvements have been made based on the latest Material design guidelines:

• Difference in default active and inactive track height.
• Shadow support for the thumbs.
• Overlapping stroke for thumb and tooltip.
• Changes in default divider radius.

Range Slider

Features

Material design improvements - The following UI improvements have been made based on the latest Material design guidelines:

• Difference in default active and inactive track height.
• Shadow support for the thumbs.
• Overlapping stroke for thumb and tooltip.
• Changes in default divider radius.

SignaturePad (Preview)

The SignaturePad widget allows you to capture smooth and more realistic signatures through drawing gestures. The widget allows you to save the signature as an image, which can be further synchronized with your devices and documents that need the signature.

Features

• Signature stroke color customization - The widget allows you to choose the stroke color for the signature.
• Signature stroke width customization - The widget allows you to set the minimum and maximum stroke widths for the signature.
• SignaturePad background color customization - The widget allows you to set the background color for the SignaturePad.
• Save as image - The widget provides option to save the drawn signature as an image. This converted image can be embedded in documents, PDFs, and anything else that supports using images to denote a signature.
• More realistic handwritten look and feel - The unique stroke rendering algorithm draws the signature based on the speed of the drawn gestures along minimum and maximum stroke thicknesses, which brings a more realistic hand-written look and feel to the signature.

Slider

Features

Material design improvements - The following UI improvements have been made based on the latest Material design guidelines:

• Difference in active and inactive track height.
• Shadow support for the thumbs.
• Thumb and tooltip overlap stroke.
• Changes in default divider radius.