DxReportDesignerCallbacks.CustomizeLocalization Property

Specifies the JavaScript function that handles the Web Report Designer’s CustomizeLocalization client-side event.

Namespace: DevExpress.Blazor.Reporting

Assembly: DevExpress.Blazor.Reporting.v24.1.JSBasedControls.Common.dll

NuGet Package: DevExpress.Blazor.Reporting.JSBasedControls.Common

Declaration

C#

[Parameter]
public string CustomizeLocalization { get; set; }

VB.NET

<Parameter>
Public Property CustomizeLocalization As String

Property Value

Type	Description
String	The name of a JavaScript function used to handle the CustomizeLocalization event.

Remarks

The CustomizeLocalization event enables you to localize the Web Report Designer. Use the event argument’s LoadMessages method to load JSON files obtained from the DevExpress Localization Service.

The code below applies the German localized resources from JSON files. Localization files are in the wwwroot/js/localization folder.

For information on how to obtain the JSON localization files, refer to the following help topic: Localize ASP.NET Core Reporting Components.

reporting_DesignerCustomization.js

window.ReportingDesignerCustomization = {
    //Apply German localization.
    onCustomizeLocalization: function(s, e) {
        $.get("/js/localization/de.json").done(result => {
            e.WidgetLocalization.loadMessages(result);
        }).always(() => {
            e.WidgetLocalization.locale("de");
        })

        e.LoadMessages($.get("/js/localization/dx-analytics-core.de.json"));
        e.LoadMessages($.get("/js/localization/dx-reporting.de.json"));
    }

_Host.cshtml

<script src="~/js/jquery.min.js"></script>
<script src="~/js/reporting_DesignerCustomization.js"></script>

Designer.razor

<DxReportDesigner ReportName="SampleReport" Height="1000px" Width="100%">
       <DxReportDesignerClientSideModelSettings IncludeLocalization="false" />
    <DxReportDesignerCallbacks CustomizeLocalization="ReportingDesignerCustomization.onCustomizeLocalization" />
</DxReportDesigner>