Essential Studio for Blazor Release Notes

v20.1.47
April 4, 2022
Starting with 2022 Volume 1 v20.1.0.47, all Syncfusion customers (evaluators and paid customers) who use Syncfusion installers or nuget packages from nuget.org must generate and register the corresponding platform and version license key in your projects. For more information, see this help topic

Common

Features

  • Support added for Fluent theme with light and dark variants for Syncfusion Blazor components.

  • Removed all the obsolete APIs that are marked on or before 2021 Volume 1 release.

Breaking changes

  • Syncfusion.Blazor.Themes is removed from dependencies of Syncfusion.Blazor.Core. Since, it is not needed when themes are referenced from CDN. If you have referenced themes from static web assets, ensure to refer Syncfusion.Blazor.Themes NuGet explicitly from this release.

  • Built-in JavaScript isolation feature is marked as obsolete and disabled by default, since loading scripts externally provides better performance over JavaScript isolation approach. If you used the JavaScript isolation feature, you have to make one of the following changes.

    Way 1: Load scripts externally via CDN or Static Web Assets.

    Way 2: Enable JavaScript isolation by setting IgnoreScriptIsolation as false while adding Syncfusion Blazor service using AddSyncfusionBlazor().

    JavaScript isolation is marked as obsolete. So, way 1 can be used to resolve the breaking change.

      builder.Services.AddSyncfusionBlazor(options => { options.IgnoreScriptIsolation = false; });

  • The un-versioned CDN links (refer below table) which always maintains latest version scripts are deprecated from 2022 Vol1 - 20.1 version. These links are available with 19.4 version scripts to avoid breaking in sites and apps that uses un-versioned links.

    Component CDN Script Reference
    All components except PDF Viewer & Document Editor https://cdn.syncfusion.com/blazor/syncfusion-blazor.min.js
    PDF Viewer https://cdn.syncfusion.com/blazor/syncfusion-blazor-pdfviewer.min.js
    Document Editor https://cdn.syncfusion.com/blazor/syncfusion-blazor-documenteditor.min.js

Bug Fixes

  • #I370516 - Issue with “Exception throws on number formatting when system region setting formats are changed” has been fixed.

Accordion

Bug Fixes

  • #I368215 - An issue with the “e-nested class removed from the accordion panel after the expand collapse action” has been fixed.

AutoComplete

Bug fixes

-#I369542 - Issue with “exception is throws while adding items to the data source using AddItemAsync method” has been resolved.

Barcode

Bug fixes

  • #F170695 - Now, the OnValidationEvent triggers properly when providing invalid characters to the value property of the barcode.

BulletChart

Bug fixes

  • #I370167 - Range color is now applying properly when specifying size for bulletchart.

Features

The Carousel component allows users to display images with content, links, etc., like a slide show. Typical uses of carousels include scrolling news headlines, featured articles on home pages, and image galleries.

  • Rendering - The Carousel component can be rendered based on the items.
  • Animation - Supports animation effects for moving previous/next item of Carousel.
  • Template Support - The Carousel component items and buttons can also be rendered with custom templates.
  • Keyboard Support - By default, the Carousel allows interaction with commands by using keyboard shortcuts.
  • Accessibility - The Carousel provides built-in compliance with the WAI-ARIA specifications and it is achieved through attributes.

Chart

Features

  • #F169837 - Provided keyboard navigation support for interactive elements on the chart.
  • #I358576 - Provided support to place the pie and doughnut chart title based on radius.
  • Provided support to customize the space between the legend items.
  • Provided border support for chart types like Area, Spline area, Step area, Range area, and Stacked area.
  • Improved the appearance of the tooltip and added animation for smooth transition when moving from one point to another in a chart.

Bug fixes

  • #I368081 - Fixed the issue with cursor for the legend when the toggle visibility is turned off.

ComboBox

Bug fixes

  • #I370469- Issue with “items are not displayed in the popup list while binding the enum type data source” has been resolved.

Context Menu

Breaking Changes

Properties

The following property names in SfContextMenu have been changed,

Component Old Property Name Old Property Type New Property Name New Property Type Comments
SfContextMenu ShowOn string OpenActionEvents string Old property is deprecated.
SfContextMenu CloseOn enum CloseActionEvents string Old property is removed, since it was introduced only in 19.4.53 weekly NuGet release

Dashboard Layout

Bug Fixes

  • #I367569 - The issue with “CssClass property in the DashboardLayoutPanel tag is not working properly” has been resolved.

DiagramComponent Preview

Features

  • Provided the support for rendering the text node either programmatically or interactively.
  • Provided the support to bring the specified bounds into view/center of the diagram viewport by using the BringIntoView and BringIntoCenter methods of the diagram.
  • Provided the support to clear all nodes, connectors, and groups by using the Clear method of the diagram.
  • Provided the support to fit the entire diagram into the current viewport by using the FitToPage method of the diagram.

Bug fixes

  • #F172891 - The Null reference exception will no longer be thrown while saving and loading the SVG node.
  • #I367144 - The Null reference will no longer be thrown when adding connectors along with annotations using the AddDiagramElements method.
  • #I366861 - The Annotations are now positioned properly for German culture.
  • #I366441 - The OnClick event method argument now returns the proper value when clicking the mouse right and middle buttons in the diagram.
  • #I361106 - The position change event will now be triggered while nudging the diagram element.

Diagram(Classic)

Bug fixes

  • #F172891 – The Null reference exception will no longer be thrown when dragging and dropping node over another node in the diagram.

Dialog

Bug fixes

  • #F172890, #I367130 - Now, the GetDimension public method in the dialog returns the correct values properly.

DocIO

Features

  • #I131175, #I195343, #I199221, #I323836, #I333914, #I343475, #I358626 - Provided support for preserving picture fill in DOCX to PDF conversion.
  • #I341225 - Provided an API to link paragraph and character styles in a Word document.
  • Word to PDF conversion is now supported in Blazor WebAssembly apps through native dependencies. [Experimental feature]

Breaking Changes

  • The default XHTML validation type is changed from XHTMLValidation.Transitional to XHTMLValidation.None while importing a HTML file.

Document Editor

Bug Fixes

  • #I367457 - Resolved the nested table content positioning issue.
  • #I365347 - Copied content is now pasted properly in between the paragraph.
  • #I361140 - Resolved the script error in inserting footnote content.
  • #I366968 - Newly added table row border is now exported properly in server-side word export.
  • #I366806 - Resolved the content overlapping issue with wrapped shape.
  • #I363360 - Resolved the new window sample dialog height issue.

Features

  • #I348441 - Added support for adding SVG image in a Word document.
  • #I348727 - Added support for setting automatic space before and after a paragraph in a Word document.
  • #I268209 - Added support for restricting documents with comments only protection type.
  • #I363489 - Improved the performance of the server-side spell check library.
  • Replaced Newtonsoft.Json dependency with System.Text.Json in Syncfusion Blazor Word Processor NuGet.
  • #I370448 - Issue with “SfDropDownButton is considering Separator as DropDownMenuItem in accessibility Support” has been resolved.

Bug fixes

  • #I370784 - The issue with “items are not displayed in the popup list while binding the enum type data source” has been resolved.

  • #F172970 - The issue with “popup is not displayed full page while rendering the component in the mobile mode with filtering” has been resolved.

Gantt Chart

Features

  • Performance is improved by 3x times for component initial loading.
  • #I335146 - Provided support to select multiple rows or cells by mouse or touch dragging.
  • #I319460 - Provided support for ScrollIntoViewAsync method.
  • #I336344 - Provided method support for ScrollToTimelineAsync and ScrollToTaskbarAsync to scroll the Chart view to the timeline and taskbar respectively.
  • #I326828 - Provided AA compliance Web Accessibility support for Gantt chart.

Bug fixes

  • #I370470 - Issue on taskbar editing when IncludeWeekend is disabled has been fixed.
  • #I365014 - Left style will not be properly updated in custom baseline has been fixed.
  • #I368982 - Gannt is not loaded properly when set ProjectStart / ProjectEnd with Day TimelineMode issue has been resolved.

Grid

New Features

  • #F156413,#I313839,#I314233,#F165575,#F167078,#F167211 - Provided Reactive Aggregation support for DataGrid while Batch editing.
  • #I330834 - Provided support for customizing the Pdf Grid cell while exporting the PDF document.

Bug Fixes

  • #I366507 - The Cancel and Update buttons do not revert back to their state(disabled) after deleting the added record in batch edit mode is fixed.
  • #F172567 - Grid displaying unnecessary tooltip with ClipMode.EllipsisWithTooltip and WrapMode.Header is fixed.
  • #I366174 - Wrong OData request sent while applying custom filter for complex field is fixed.
  • #F172737 - Excel export not working with other cultures after column resizing is resolved.
  • #I366393 - Filtered icon applies for columns with same ForeignKeyValue names when filtering either one of the columns is fixed.
  • #I365312 - Sorting does not work when using with dynamic columns is resolved.
  • #F172718 - Aggregate TextAlign is incorrect when exporting Grid with group caption is fixed.
  • #I362107 - Problem with filtering when having non-stacked column between two stacked column is resolved.
  • #I366118 - Exception throws while performing Excel and Csv export with AllowExcelExport as false is fixed.
  • #I365953 - Export buttons are not shown while enabling AdaptiveUI is fixed.
  • #I369021, #F173362 - While grouping the expand/collapse operations are not working with Virtualization is resolved.

Kanban

Bug fixes

  • #I370137 - Now, sorting in the Kanban within the same column works properly when using the SortBy Index property.

Linear Gauge

Features

  • Pointers can now be animated, resulting in smooth transitions when pointer value is updated.

Maps

Features

  • The shape layers can now be animated, resulting in smooth transitions when zooming and panning.
  • Improve pinch zooming in Maps on mobile devices.
  • #F168112 - The Loaded, OnZoomComplete, and OnPanComplete events will now provide the minimum and maximum latitude and longitude values in the Maps visible area.

PDF

Features

  • #I259782, #I308276 - Added support for importing and exporting annotations with appearance.
  • #F169363 – Added Support for embedding the non-embedded font in an existing pdf document.
  • #I361251 - Added support for converting the PDF/A conformance document to a normal PDF document.
  • #I362189 - Added support to get annotation type and creation date directly from PdfLoadedAnnotation instance.
  • #I358952 - Improved the performance of Annotation flattening by 30 times faster.
  • Added support for setting base URL for PDF document.

Breaking Changes

  • Starting with v20.1.0.x, if you reference Syncfusion HTML converter assemblies from trial setup or from the NuGet feed, include a license key in your projects. Refer to this link for generating and registering a Syncfusion license key in your application to use the components without a trail message.

PDF Viewer

Features

  • Provided the support to deploy the PDF Viewer service in the server-side for .NET 6.0 by migrating it from Syncfusion.Drawing.Common to SkiaSharp packages.

Breaking changes

  • #I363524, #I364998, #I369010, #F170362 - In .NET 6.0, the System.Dawing.Common NuGet package is now attributed as a Windows-specific library. So, the PDF rendering with the Syncfusion PDF Viewer on Linux and Mac platforms had to migrate from System.Drawing.Common to the SkiaSharp package. This migration resulted in the below API breaking changes for .NET 6.0.
.NET 3.X and .NET 5 .NET 6
Bitmap ExportAsImage(int pageIndex) SKBitmap ExportAsImage(int pageIndex)
Bitmap ExportAsImage(int pageIndex, bool isSkipAnnotations) SKBitmap ExportAsImage(int pageIndex, bool isSkipAnnotations)
Bitmap ExportAsImage(int pageIndex, SizeF customSize, bool keepAspectRatio) SKBitmap ExportAsImage(int pageIndex, SizeF customSize, bool keepAspectRatio)
Bitmap ExportAsImage(int pageIndex, SizeF customSize, bool keepAspectRatio, bool isSkipAnnotations) SKBitmap ExportAsImage(int pageIndex, SizeF customSize, bool keepAspectRatio, bool isSkipAnnotations)
Bitmap ExportAsImage(int pageIndex, SizeF customSize, float dpiX, float dpiY, bool keepAspectRatio) Not supported.
Bitmap ExportAsImage(int pageIndex, SizeF customSize, float dpiX, float dpiY, bool keepAspectRatio, bool isSkipAnnotations) Not supported.
Bitmap[] ExportAsImage(int startIndex, int endIndex) SKBitmap[] ExportAsImage(int startIndex, int endIndex)
Bitmap[] ExportAsImage(int startIndex, int endIndex, bool isSkipAnnotations) SKBitmap[] ExportAsImage(int startIndex, int endIndex, bool isSkipAnnotations)
Bitmap[] ExportAsImage(int startIndex, int endIndex, SizeF customSize, bool keepAspectRatio) SKBitmap[] ExportAsImage(int startIndex, int endIndex, SizeF customSize, bool keepAspectRatio)
Bitmap[] ExportAsImage(int startIndex, int endIndex, SizeF customSize, bool keepAspectRatio, bool isSkipAnnotations) SKBitmap[] ExportAsImage(int startIndex, int endIndex, SizeF customSize, bool keepAspectRatio, bool isSkipAnnotations)
Bitmap[] ExportAsImage(int startIndex, int endIndex, SizeF customSize, float dpiX, float dpiY, bool keepAspectRatio) Not supported.
Bitmap[] ExportAsImage(int startIndex, int endIndex, SizeF customSize, float dpiX, float dpiY, bool keepAspectRatio, bool isSkipAnnotations) Not supported.
Bitmap[] ExportAsImage(int startIndex, int endIndex, float dpiX, float dpiY) Not supported.
Bitmap[] ExportAsImage(int startIndex, int endIndex, float dpiX, float dpiY, bool isSkipAnnotations) Not supported.
Bitmap ExportAsImage(int pageIndex, float zoomFactor, int tileXCount, int tileYCount, int tileX, int tileY) SKBitmap ExportAsImage(int pageIndex, float zoomFactor, int tileXCount, int tileYCount, int tileX, int tileY)
Bitmap ExportAsImage(int pageIndex, float dpiX, float dpiY) Not supported.
Bitmap ExportAsImage(int pageIndex, float dpiX, float dpiY, bool isSkipAnnotations) Not supported.

Pivot Table

Bug fixes

  • The pivot chart now works properly with height as a percentage.
  • The pivot table is now properly refreshed with live data when performing drill operations.

Presentation

Features

  • PPTX to PDF conversion is now supported in Blazor WebAssembly apps through native dependencies. [Experimental feature]

Query Builder

Bug Fixes

  • The issue with “Script error thrown while using trigger event with date between value in the query builder” has been resolved.

Scheduler

Features

  • The initial rendering and CRUD operation performance improved ~3x when loading a large number of resources and appointments in the WASM Scheduler.
  • Virtual scrolling support provided for vertical timeline year view of the Scheduler.

Bug fixes

  • #I370558 - An issue with “the scroll bar appears when EnableRowAutoHeight is set without events in month view” has been fixed.
  • #F173439 - An issue with “appointments of short duration render in the wrong position” has been fixed.
  • #I371570 - An issue with “Keyboard navigation is wrong for read-only appointments quick popup” has been fixed.
  • #FB33218 - An issue with “ResizeEventArgs return wrong datetime values” has been fixed.
  • #I371484 - An issue with “Appointments are misaligned when performs expand/collapse resources” has been fixed.

Tab

Bug Fixes

  • #I371204 - Tab performance issue occurred when adding the selected event has been fixed.

Tree Grid

Features

  • #I335146 - Provided support to select multiple rows or cells by mouse or touch dragging.

Visual Studio Extensions

New Feature

  • Provide fluent theme support to the Blazor template studio, conversion, and migration.

Bug Fixes

  • #T32352 - Fix the model class and DB context empty value issue in Blazor Scaffolding.

XlsIO

Features

  • Provided support for new functions such as XLOOKUP, VALUETOTEXT, ARRAYTOTEXT, XMATCH, and LET.

  • Excel to PDF conversion is now supported in Blazor WebAssembly apps through native dependencies [Experimental feature].

Bug Fixes

  • #I366365 - The default space maintained between cell border and cell text is now rendered properly in Excel to PDF conversion.