Files
radzen-blazor/Radzen.Blazor/Spreadsheet/FormatCellsDialog.razor.cs
Atanas Korchev 609622692e Add culture-aware editing, display, and formula entry to RadzenSpreadsheet
The spreadsheet engine parsed typed input with the invariant culture while
displaying values with the current culture, breaking the edit round-trip on
non-en-US hosts and making comma-decimal entry (10,50) impossible.

Workbook gains a Culture property (defaults to CurrentCulture) which the
component stamps from its inherited Culture parameter. It drives:

- Cell input parsing (CellData type inference), including day-month date
  handling for cultures where the group and date separators collide (de-DE)
- Edit text and display rendering (GetValue, GetValueAsString, GetDisplayText)
- Number format rendering - format codes stay canonical invariant tokens while
  separators, month names, and AM/PM designators follow the culture
- Formula entry and display via the new FormulaLocalizer (Excel FormulaLocal
  semantics: ';' argument separators and ',' decimals in comma-decimal
  cultures, lenient comma acceptance where unambiguous, canonical invariant
  storage)
- Dialog input (data validation, conditional format, filter) via shared
  conversion helpers on SpreadsheetDialogBase

XLSX and CSV files read and write canonical invariant values regardless of
the workbook culture, including autofit column widths. Malformed formulas now
surface as error trees instead of an unhandled lexer exception. Number format
parsing is cached (hard-bounded) since CellView reparsed per render.

Includes localization demos for the Spreadsheet and Document Processing
sections and culture test suites.

Note: headless code on non-en-US hosts now parses string values with the
host culture; set Workbook.Culture explicitly (or to InvariantCulture) for
host-independent processing.
2026-07-08 14:54:55 +03:00

146 lines
4.0 KiB
C#

using System;
using System.Collections.Generic;
using System.Linq;
using Microsoft.AspNetCore.Components;
using Radzen.Blazor;
using Radzen.Documents.Spreadsheet;
namespace Radzen.Blazor.Spreadsheet;
#nullable enable
/// <summary>
/// Dialog for formatting cells in a spreadsheet.
/// </summary>
public partial class FormatCellsDialog : SpreadsheetDialogBase
{
/// <summary>
/// The current format of the selected cell.
/// </summary>
[Parameter]
public string? CurrentFormat { get; set; }
/// <summary>
/// A sample value to preview formatting.
/// </summary>
[Parameter]
public object? SampleValue { get; set; }
/// <summary>
/// The data type of the sample value.
/// </summary>
[Parameter]
public CellDataType ValueType { get; set; }
private NumberFormatCategory selectedCategory = NumberFormatCategory.General;
private string customFormatCode = "General";
private int decimalPlaces = 2;
private bool useThousandsSeparator = true;
private string currencySymbol = "$";
private string? selectedPreset;
private string preview = "";
private static readonly NumberFormatCategory[] categories =
[
NumberFormatCategory.General,
NumberFormatCategory.Number,
NumberFormatCategory.Currency,
NumberFormatCategory.Accounting,
NumberFormatCategory.Percentage,
NumberFormatCategory.Scientific,
NumberFormatCategory.Date,
NumberFormatCategory.Time,
NumberFormatCategory.Text
];
private IReadOnlyList<(string, string)> presets = [];
private bool ShowDecimalPlaces => selectedCategory is NumberFormatCategory.Number
or NumberFormatCategory.Currency or NumberFormatCategory.Accounting
or NumberFormatCategory.Percentage or NumberFormatCategory.Scientific;
private bool ShowThousandsSeparator => selectedCategory == NumberFormatCategory.Number;
private bool ShowCurrencySymbol => selectedCategory is NumberFormatCategory.Currency
or NumberFormatCategory.Accounting;
private bool ShowPresetList => selectedCategory is NumberFormatCategory.Date
or NumberFormatCategory.Time;
/// <inheritdoc />
protected override void OnInitialized()
{
if (!string.IsNullOrEmpty(CurrentFormat) &&
!string.Equals(CurrentFormat, "General", StringComparison.OrdinalIgnoreCase))
{
customFormatCode = CurrentFormat;
selectedCategory = NumberFormatPresets.GetCategory(CurrentFormat);
}
LoadPresetsForCategory();
UpdatePreview();
}
private void OnCategoryChanged()
{
LoadPresetsForCategory();
RebuildFormatCode();
UpdatePreview();
}
private void OnOptionChanged()
{
RebuildFormatCode();
UpdatePreview();
}
private void OnPresetChanged()
{
customFormatCode = selectedPreset ?? customFormatCode;
UpdatePreview();
}
private void OnFormatCodeChanged()
{
UpdatePreview();
}
private void LoadPresetsForCategory()
{
if (selectedCategory is NumberFormatCategory.Date or NumberFormatCategory.Time)
{
presets = NumberFormatPresets.GetPresets(selectedCategory);
selectedPreset = presets.Count > 0 ? presets[0].Item2 : null;
}
else
{
presets = [];
selectedPreset = null;
}
}
private void RebuildFormatCode()
{
customFormatCode = FormatCodeBuilder.Build(
selectedCategory, decimalPlaces, useThousandsSeparator,
currencySymbol, selectedPreset);
}
private void UpdatePreview()
{
if (SampleValue is null)
{
preview = "";
return;
}
var result = NumberFormat.Apply(customFormatCode, SampleValue, ValueType, Culture);
preview = result ?? SampleValue.ToString() ?? "";
}
private void OnOk()
{
DialogService.Close(customFormatCode);
}
}