Localization: big docs update#8961
Open
vladaskorohodova wants to merge 7 commits into
Open
Conversation
There was a problem hiding this comment.
Pull request overview
This PR reorganizes DevExtreme documentation related to localization and formatting by consolidating content under a new “Localization and Globalization” concept area and updating inbound links across the docs and API reference to point to the new structure.
Changes:
- Restructured/migrated Localization + Value Formatting guides into
concepts/Common/Localization and Globalization/...and removed legacy pages underconcepts/Common/Localization/...andconcepts/Common/Value Formatting/.... - Added updated samples for RTL support, UI text localization, and value formatting (Intl/Globalize, predefined formats, custom functions).
- Updated many cross-references from UI component docs and API reference pages to the new “Value Formatting” / “Localization and Globalization” locations.
Reviewed changes
Copilot reviewed 109 out of 111 changed files in this pull request and generated 7 comments.
Show a summary per file
| File | Description |
|---|---|
| MenuConfig.xml | Updates menu routing for the new “Localization and Globalization” section. |
| concepts/Common/Value Formatting/Value Formatting.md | Removes legacy Value Formatting landing page. |
| concepts/Common/Value Formatting/40 Format Custom Values.md | Removes legacy “Format Custom Values” article. |
| concepts/Common/Value Formatting/10 Format UI Component Values/30 Custom Function.md | Removes legacy “Custom Function” article. |
| concepts/Common/Value Formatting/10 Format UI Component Values/15 Intl Formats.md | Removes legacy “Intl Formats” article. |
| concepts/Common/Value Formatting/10 Format UI Component Values/10 Predefined Formats.md | Removes legacy “Predefined Formats” article. |
| concepts/Common/Localization/Localization.md | Removes legacy Localization landing page. |
| concepts/Common/Localization/20 Right-to-Left Support.md | Removes legacy RTL support article. |
| concepts/Common/Localization/15 Localize Custom Values.md | Removes legacy “Localize Custom Values” article. |
| concepts/Common/Localization/05 Localize Dates, Numbers, and Currencies/Localize Dates, Numbers, and Currencies.md | Removes legacy “Localize Dates, Numbers, and Currencies” landing page. |
| concepts/Common/Localization/05 Localize Dates, Numbers, and Currencies/10 Using Globalize.md | Removes legacy “Using Globalize” article. |
| concepts/Common/Localization/05 Localize Dates, Numbers, and Currencies/05 Using Intl.md | Removes legacy “Using Intl” article. |
| concepts/Common/Localization/01 Dictionaries/02 Create a New Dictionary.md | Removes legacy “Create a New Dictionary” article. |
| concepts/Common/Localization and Globalization/00 Overview.md | Adds new section overview frontmatter. |
| concepts/Common/Localization and Globalization/20 Right-to-Left (RTL) Support.md | Adds new RTL support article with updated samples. |
| concepts/Common/Localization and Globalization/10 Value Formatting/00 Value Formatting.md | Adds new Value Formatting landing page. |
| concepts/Common/Localization and Globalization/10 Value Formatting/04 Using Intl.md | Adds new Intl formatting article. |
| concepts/Common/Localization and Globalization/10 Value Formatting/08 Using Globalize.md | Adds new Globalize formatting article and guidance. |
| concepts/Common/Localization and Globalization/10 Value Formatting/40 Format and Parse Dates and Numbers.md | Adds new localization API formatting/parsing article. |
| concepts/Common/Localization and Globalization/10 Value Formatting/10 Format UI Component Values/00 Format UI Component Values.md | Adds/moves the “Format UI Component Values” landing node. |
| concepts/Common/Localization and Globalization/10 Value Formatting/10 Format UI Component Values/10 Predefined Formats.md | Adds new predefined formats article with updated samples. |
| concepts/Common/Localization and Globalization/10 Value Formatting/10 Format UI Component Values/15 Intl Formats.md | Adds new Intl formats article with updated samples. |
| concepts/Common/Localization and Globalization/10 Value Formatting/10 Format UI Component Values/20 Custom Format String.md | Updates the custom format string article (tables/notes/wording). |
| concepts/Common/Localization and Globalization/10 Value Formatting/10 Format UI Component Values/30 Custom Function.md | Adds new “Custom Function” article with updated samples. |
| concepts/Common/Localization and Globalization/05 UI Text Localization/00 UI Text Localization.md | Updates UI text localization overview and links. |
| concepts/Common/Localization and Globalization/05 UI Text Localization/02 Create a New Dictionary.md | Adds new “Create a New Dictionary” article under the new structure. |
| concepts/Common/Localization and Globalization/05 UI Text Localization/05 Add Strings to a Dictionary.md | Adds new “Add Strings…” article with multi-framework examples. |
| concepts/Common/Localization and Globalization/05 UI Text Localization/07 Override Strings in a Dictionary.md | Removes trailing “See Also” block. |
| concepts/80 Troubleshooting/10 Date String Handling Issues/05 Supported Formats, Exceptions, and Settings.md | Updates Value Formatting link to the new location. |
| concepts/55 Vue Components/05 Add DevExtreme to a Vue Application/63 Register 3rd-Party Dependencies/2 Globalize Registration.md | Updates links to the new Globalize/Intl docs. |
| concepts/50 React Components/05 Add DevExtreme to a React Application/65 Additional Configuration for Webpack.md | Updates Globalize link to the new docs location. |
| concepts/40 Angular Components/10 Getting Started/03 Add DevExtreme to an Angular CLI Application/08 Register 3rd-Party Dependencies/02 Globalize Registration.md | Updates links to the new Globalize/Intl docs. |
| concepts/05 UI Components/PolarChart/10 Visual Elements/070 Axis Labels.md | Updates Value Formatting link to the new location. |
| concepts/05 UI Components/PolarChart/10 Visual Elements/040 Tooltips.md | Updates Value Formatting link to the new location. |
| concepts/05 UI Components/PolarChart/10 Visual Elements/030 Series Point Labels.md | Updates Value Formatting link to the new location. |
| concepts/05 UI Components/List/50 Localization.md | Removes legacy List localization article. |
| concepts/05 UI Components/LinearGauge/10 Visual Elements/70 Tooltips.md | Updates Value Formatting link to the new location. |
| concepts/05 UI Components/CircularGauge/10 Visual Elements/70 Tooltips.md | Updates Value Formatting link to the new location. |
| concepts/05 UI Components/BarGauge/10 Visual Elements/40 Tooltips.md | Updates Value Formatting link to the new location. |
| concepts/05 UI Components/DateRangeBox/10 Value Formatting and Masked Input.md | Updates formatting doc links. |
| concepts/05 UI Components/DateBox/04 Value Formatting and Masked Input.md | Updates formatting doc links. |
| concepts/05 UI Components/DateBox/01 Overview/10 Key Features.md | Updates formatting doc links. |
| api-reference/50 Common/utils/localization/localization.md | Updates Value Formatting “See Also” link. |
| api-reference/50 Common/utils/localization/parseDate(text_format).md | Updates “Format Custom Values” link to new location. |
| api-reference/50 Common/utils/localization/formatDate(value_format).md | Updates “Format Custom Values” link to new location. |
| api-reference/50 Common/utils/localization/formatNumber(value_format).md | Updates “Format Custom Values” link to new location. |
| api-reference/50 Common/utils/localization/loadMessages(messages).md | Updates “Add Strings…” link target. |
| api-reference/50 Common/utils/localization/formatMessage(key_value).md | Updates “Add Strings…” link target. |
| api-reference/50 Common/Object Structures/GlobalConfig/timeFormat.md | Updates links to custom format string/function docs. |
| api-reference/50 Common/Object Structures/GlobalConfig/numberFormat.md | Updates links to custom format string/function docs. |
| api-reference/50 Common/Object Structures/GlobalConfig/dateFormat.md | Updates links to custom format string/function docs. |
| api-reference/50 Common/Object Structures/GlobalConfig/dateTimeFormat.md | Updates links to custom format string/function docs. |
| api-reference/50 Common/Object Structures/GlobalConfig/dateTimeFormatPresets.md | Updates links to custom format string/function docs. |
| api-reference/50 Common/Object Structures/GlobalConfig/decimalSeparator.md | Updates localization guide link to new location. |
| api-reference/50 Common/Object Structures/GlobalConfig/thousandsSeparator.md | Updates localization guide link to new location. |
| api-reference/50 Common/Object Structures/format/type.md | Updates Value Formatting/custom format string links. |
| api-reference/50 Common/Object Structures/format/format.md | Updates Globalize link to new location. |
| api-reference/40 Common Types/BaseWidgetTooltip/format.md | Updates Value Formatting link to new location. |
| api-reference/40 Common Types/05 charts/BaseChartTooltip/argumentFormat.md | Updates Value Formatting link to new location. |
| api-reference/30 Data Layer/PivotGridDataSource/1 Configuration/fields/format.md | Updates custom format string link to new location. |
| api-reference/10 UI Components/dxRangeSelector/1 Configuration/sliderMarker/format.md | Updates Value Formatting link to new location. |
| api-reference/10 UI Components/dxRangeSelector/1 Configuration/scale/label/customizeText.md | Updates Value Formatting link to new location. |
| api-reference/10 UI Components/dxPolarChart/5 Series Types/CommonPolarChartSeries/label/customizeText.md | Updates Value Formatting link to new location. |
| api-reference/10 UI Components/dxPolarChart/5 Series Types/CommonPolarChartSeries/label/argumentFormat.md | Updates Value Formatting link to new location. |
| api-reference/10 UI Components/dxPolarChart/1 Configuration/valueAxis/label/customizeText.md | Updates Value Formatting link to new location. |
| api-reference/10 UI Components/dxPolarChart/1 Configuration/argumentAxis/label/customizeText.md | Updates Value Formatting link to new location. |
| api-reference/10 UI Components/dxPieChart/5 Series Types/CommonPieChartSeries/label/customizeText.md | Updates Value Formatting link to new location. |
| api-reference/10 UI Components/dxPieChart/5 Series Types/CommonPieChartSeries/label/argumentFormat.md | Updates Value Formatting link to new location. |
| api-reference/10 UI Components/dxNumberBox/1 Configuration/format.md | Updates “Custom Function” link to new location. |
| api-reference/10 UI Components/dxFunnel/1 Configuration/label/format.md | Updates Value Formatting link to new location. |
| api-reference/10 UI Components/dxDateBox/1 Configuration/displayFormat.md | Updates “Format Widget Values” link to new location. |
| api-reference/10 UI Components/dxChart/9 Types/ArgumentAxisLabel/format.md | Updates Value Formatting link to new location. |
| api-reference/10 UI Components/dxChart/1 Configuration/tooltip/contentTemplate.md | Updates Value Formatting link to new location. |
| api-reference/10 UI Components/dxChart/1 Configuration/argumentAxis/label/format.md | Updates Value Formatting link to new location. |
| api-reference/10 UI Components/dxChart/5 Series Types/CommonSeries/label/format.md | Updates Value Formatting link to new location. |
| api-reference/10 UI Components/dxChart/5 Series Types/CommonSeries/label/customizeText.md | Updates Value Formatting link to new location. |
| api-reference/10 UI Components/dxChart/5 Series Types/CommonSeries/label/argumentFormat.md | Updates Value Formatting link to new location. |
| api-reference/10 UI Components/dxChart/5 Series Types/StockSeries/label/customizeText.md | Updates Value Formatting link to new location. |
| api-reference/10 UI Components/dxChart/5 Series Types/StepLineSeries/label/customizeText.md | Updates Value Formatting link to new location. |
| api-reference/10 UI Components/dxChart/5 Series Types/StepAreaSeries/label/customizeText.md | Updates Value Formatting link to new location. |
| api-reference/10 UI Components/dxChart/5 Series Types/StackedSplineSeries/label/customizeText.md | Updates Value Formatting link to new location. |
| api-reference/10 UI Components/dxChart/5 Series Types/StackedSplineAreaSeries/label/customizeText.md | Updates Value Formatting link to new location. |
| api-reference/10 UI Components/dxChart/5 Series Types/StackedLineSeries/label/customizeText.md | Updates Value Formatting link to new location. |
| api-reference/10 UI Components/dxChart/5 Series Types/StackedBarSeries/label/customizeText.md | Updates Value Formatting link to new location. |
| api-reference/10 UI Components/dxChart/5 Series Types/StackedAreaSeries/label/customizeText.md | Updates Value Formatting link to new location. |
| api-reference/10 UI Components/dxChart/5 Series Types/SplineSeries/label/customizeText.md | Updates Value Formatting link to new location. |
| api-reference/10 UI Components/dxChart/5 Series Types/SplineAreaSeries/label/customizeText.md | Updates Value Formatting link to new location. |
| api-reference/10 UI Components/dxChart/5 Series Types/ScatterSeries/label/customizeText.md | Updates Value Formatting link to new location. |
| api-reference/10 UI Components/dxChart/5 Series Types/RangeBarSeries/label/customizeText.md | Updates Value Formatting link to new location. |
| api-reference/10 UI Components/dxChart/5 Series Types/RangeAreaSeries/label/customizeText.md | Updates Value Formatting link to new location. |
| api-reference/10 UI Components/dxChart/5 Series Types/LineSeries/label/customizeText.md | Updates Value Formatting link to new location. |
| api-reference/10 UI Components/dxChart/5 Series Types/CandleStickSeries/label/customizeText.md | Updates Value Formatting link to new location. |
| api-reference/10 UI Components/dxChart/5 Series Types/BubbleSeries/label/customizeText.md | Updates Value Formatting link to new location. |
| api-reference/10 UI Components/dxChart/5 Series Types/BarSeries/label/customizeText.md | Updates Value Formatting link to new location. |
| api-reference/10 UI Components/dxChart/5 Series Types/AreaSeries/label/customizeText.md | Updates Value Formatting link to new location. |
| api-reference/10 UI Components/dxChart/5 Series Types/FullStackedSplineSeries/label/customizeText.md | Updates Value Formatting link to new location. |
| api-reference/10 UI Components/dxChart/5 Series Types/FullStackedSplineAreaSeries/label/customizeText.md | Updates Value Formatting link to new location. |
| api-reference/10 UI Components/dxChart/5 Series Types/FullStackedLineSeries/label/customizeText.md | Updates Value Formatting link to new location. |
| api-reference/10 UI Components/dxChart/5 Series Types/FullStackedBarSeries/label/customizeText.md | Updates Value Formatting link to new location. |
| api-reference/10 UI Components/dxChart/5 Series Types/FullStackedAreaSeries/label/customizeText.md | Updates Value Formatting link to new location. |
| api-reference/10 UI Components/BaseWidget/1 Configuration/tooltip/format.md | Updates Value Formatting link to new location. |
| api-reference/10 UI Components/BaseGauge/1 Configuration/tooltip/customizeTooltip.md | Updates Value Formatting link to new location. |
| api-reference/10 UI Components/BaseGauge/1 Configuration/scale/label/customizeText.md | Updates Value Formatting link to new location. |
| api-reference/10 UI Components/BaseChart/1 Configuration/tooltip/contentTemplate.md | Updates Value Formatting link to new location. |
| api-reference/10 UI Components/BaseChart/1 Configuration/tooltip/argumentFormat.md | Updates Value Formatting link to new location. |
| api-reference/10 UI Components/dxCalendar/1 Configuration/dateSerializationFormat.md | Updates custom format string link to new location. |
| api-reference/10 UI Components/dxBarGauge/1 Configuration/label/format.md | Updates Value Formatting link to new location. |
| api-reference/10 UI Components/DateBoxBase/1 Configuration/displayFormat.md | Updates “Format Widget Values” link to new location. |
| api-reference/10 UI Components/DateBoxBase/1 Configuration/dateSerializationFormat.md | Updates custom format string link to new location. |
| api-reference/_hidden/dxFilterBuilderField/format.md | Updates Value Formatting link to new location. |
| api-reference/_hidden/dxDataGridColumn/format.md | Updates Value Formatting/custom format string links to new location. |
Comments suppressed due to low confidence (3)
concepts/Common/Localization and Globalization/10 Value Formatting/10 Format UI Component Values/20 Custom Format String.md:172
- This note links to a non-existent "55 Using Globalize" page. The Globalize topic in this folder is "08 Using Globalize", so the current link will 404.
concepts/Common/Localization and Globalization/10 Value Formatting/10 Format UI Component Values/20 Custom Format String.md:124 - "week day" should be "weekday" (one word).
concepts/Common/Localization and Globalization/05 UI Text Localization/00 UI Text Localization.md:5 - This link points to
/01 Dictionaries/..., but that directory does not exist underLocalization and Globalization. It should link to the actual "Override Strings in a Dictionary" article in this section.
| - Set a UI component's `format` property to display formatted values in editors, grids, and other components. | ||
| - Use the [localization API](/api-reference/50%20Common/utils/localization '/Documentation/ApiReference/Common/utils/localization/') to format and parse values programmatically in code. | ||
|
|
||
| Format patterns are locale-independent initially. To apply locale-aware formatting rules, use [Intl](/concepts/Common/Localization%20and%20Globalization/10%20Value%20Formatting/50%20Using%20Intl.md '/Documentation/Guide/Common/Localization/#Localize_Dates_Numbers_and_Currencies/Using_Intl') or [Globalize](/concepts/Common/Localization%20and%20Globalization/10%20Value%20Formatting/55%20Using%20Globalize.md '/Documentation/Guide/Common/Localization/#Localize_Dates_Numbers_and_Currencies/Using_Globalize'). |
Comment on lines
+8
to
+10
| #include btn-open-demo with { | ||
| href: "https://js.devexpress.com/React/Demos/WidgetsGallery/Demo/Localization/UsingIntl/FluentBlueLight/" | ||
| } No newline at end of file |
| @@ -0,0 +1,5 @@ | |||
| To make a dictionary for a new locale: | |||
|
|
|||
| 1. Copy one of the available [dictionaries](/concepts/Common/Localization%20and%20Globalization/01%20Dictionaries '/Documentation/Guide/Common/Localization/#Dictionaries'). | |||
| --- | ||
| ##### jQuery | ||
|
|
||
| Specify the Globalize and CLDR libraries using `<script>` tags as shown below. In this example, the German [dictionary](/concepts/Common/Localization%20and%20Globalization/01%20Dictionaries '/Documentation/Guide/Common/Localization/#Dictionaries') is included. Include libraries in the order shown. Then, set the locale using the `Globalize.locale()` method: |
|
|
||
| --- | ||
| Refer to the following help topic for a code example: [Add Strings to a Dictionary](/concepts/Common/Localization/01%20Dictionaries/05%20Add%20Strings%20to%20a%20Dictionary.md '/Documentation/Guide/Common/Localization/#Dictionaries/Add_Strings_to_a_Dictionary'). No newline at end of file | ||
| Refer to the following help topic for a code example: [Add Strings to a Dictionary](/concepts/Common/Localization%20and%20Globalization/01%20Dictionaries/05%20Add%20Strings%20to%20a%20Dictionary.md '/Documentation/Guide/Common/Localization/#Dictionaries/Add_Strings_to_a_Dictionary'). No newline at end of file |
|
|
||
| --- | ||
| Refer to the following help topic for a code example: [Add Strings to a Dictionary](/concepts/Common/Localization/01%20Dictionaries/05%20Add%20Strings%20to%20a%20Dictionary.md '/Documentation/Guide/Common/Localization/#Dictionaries/Add_Strings_to_a_Dictionary'). | ||
| Refer to the following help topic for a code example: [Add Strings to a Dictionary](/concepts/Common/Localization%20and%20Globalization/01%20Dictionaries/05%20Add%20Strings%20to%20a%20Dictionary.md '/Documentation/Guide/Common/Localization/#Dictionaries/Add_Strings_to_a_Dictionary'). |
| DateRangeBox displays values according to the application's [locale](/api-reference/50%20Common/utils/localization/locale().md '/Documentation/ApiReference/Common/utils/localization/#locale'). You can specify a custom date format. Use the [displayFormat](/api-reference/10%20UI%20Components/DateBoxBase/1%20Configuration/displayFormat.md '/Documentation/ApiReference/UI_Components/dxDateRangeBox/Configuration/#displayFormat') property that accepts [predefined](/concepts/Common/Value%20Formatting/10%20Format%20UI%20Component%20Values/10%20Predefined%20Formats.md '/Documentation/Guide/Common/Value_Formatting/#Format_UI_Component_Values/Predefined_Formats') and [custom formats](/concepts/Common/Value%20Formatting/10%20Format%20UI%20Component%20Values/20%20Custom%20Format%20String.md '/Documentation/Guide/Common/Value_Formatting/#Format_UI_Component_Values/Custom_Format_String'). | ||
| DateRangeBox displays values according to the application's [locale](/api-reference/50%20Common/utils/localization/locale().md '/Documentation/ApiReference/Common/utils/localization/#locale'). You can specify a custom date format. Use the [displayFormat](/api-reference/10%20UI%20Components/DateBoxBase/1%20Configuration/displayFormat.md '/Documentation/ApiReference/UI_Components/dxDateRangeBox/Configuration/#displayFormat') property that accepts [predefined](/concepts/Common/Localization%20and%20Globalization/10%20Value%20Formatting/10%20Format%20UI%20Component%20Values/10%20Predefined%20Formats.md '/Documentation/Guide/Common/Value_Formatting/#Format_UI_Component_Values/Predefined_Formats') and [custom formats](/concepts/Common/Localization%20and%20Globalization/10%20Value%20Formatting/10%20Format%20UI%20Component%20Values/20%20Custom%20Format%20String.md '/Documentation/Guide/Common/Value_Formatting/#Format_UI_Component_Values/Custom_Format_String'). | ||
|
|
||
| If [useMaskBehavior](/api-reference/10%20UI%20Components/DateBoxBase/1%20Configuration/useMaskBehavior.md '/Documentation/ApiReference/UI_Components/dxDateRangeBox/Configuration/#useMaskBehavior'') is **true**, the **displayFormat** property also specifies a mask that restricts user input: |
There was a problem hiding this comment.
Pull request overview
Copilot reviewed 124 out of 125 changed files in this pull request and generated 16 comments.
Comments suppressed due to low confidence (1)
concepts/Common/Localization and Globalization/10 Value Formatting/10 Format UI Component Values/20 Custom Format String.md:172
- This note links to
55 Using Globalize.md, but the Globalize article in this section is08 Using Globalize.md. The current link is broken.
| - Set a UI component's `format` property to display formatted values in editors, grids, and other components. | ||
| - Use the [localization API](/api-reference/50%20Common/utils/localization '/Documentation/ApiReference/Common/utils/localization/') to format and parse values programmatically in code. | ||
|
|
||
| Format patterns are locale-independent initially. To apply locale-aware formatting rules, use [Intl](/concepts/Common/Localization%20and%20Globalization/10%20Value%20Formatting/50%20Using%20Intl.md '/Documentation/Guide/Common/Localization/#Localize_Dates_Numbers_and_Currencies/Using_Intl') or [Globalize](/concepts/Common/Localization%20and%20Globalization/10%20Value%20Formatting/55%20Using%20Globalize.md '/Documentation/Guide/Common/Localization/#Localize_Dates_Numbers_and_Currencies/Using_Globalize'). |
Comment on lines
+5
to
+9
| Use Globalize at your own risk. We recommend switching to [Intl](/concepts/Common/Localization%20and%20Globalization/05%20Localize%20Dates%2C%20Numbers%2C%20and%20Currencies/05%20Using%20Intl.md '/Documentation/Guide/Common/Localization/#Localize_Dates_Numbers_and_Currencies/Using_Intl') for a more secure solution. | ||
|
|
||
| [/important] | ||
|
|
||
| [note]We recommend against using Globalize if you apply [CSP rules](/concepts/Common/Security%20Considerations/40%20Content%20Security%20Policy/00%20Content%20Security%20Policy.md '/Documentation/Guide/Common/Security_Considerations/#Content_Security_Policy'). Use [Intl](/concepts/Common/Localization%20and%20Globalization/05%20Localize%20Dates%2C%20Numbers%2C%20and%20Currencies/05%20Using%20Intl.md '/Documentation/Guide/Common/Localization/#Localize_Dates_Numbers_and_Currencies/Using_Intl') instead. |
Comment on lines
+44
to
+46
| Refer to the [Using Globalize](/concepts/Common/Localization%20and%20Globalization/05%20Localize%20Dates%2C%20Numbers%2C%20and%20Currencies/10%20Using%20Globalize.md '/Documentation/Guide/Common/Localization/#Localize_Dates_Numbers_and_Currencies/Using_Globalize') article for usage examples. | ||
|
|
||
| Alternatively, you can [use Intl](/concepts/Common/Localization/05%20Localize%20Dates%2C%20Numbers%2C%20and%20Currencies/05%20Using%20Intl.md '/Documentation/Guide/Common/Localization/#Localize_Dates_Numbers_and_Currencies/Using_Intl') as a more lightweight localization solution. | ||
| Alternatively, you can [use Intl](/concepts/Common/Localization%20and%20Globalization/05%20Localize%20Dates%2C%20Numbers%2C%20and%20Currencies/05%20Using%20Intl.md '/Documentation/Guide/Common/Localization/#Localize_Dates_Numbers_and_Currencies/Using_Intl') as a more lightweight localization solution. |
Comment on lines
+55
to
+57
| Refer to the [Using Globalize](/concepts/Common/Localization%20and%20Globalization/05%20Localize%20Dates%2C%20Numbers%2C%20and%20Currencies/10%20Using%20Globalize.md '/Documentation/Guide/Common/Localization/#Localize_Dates_Numbers_and_Currencies/Using_Globalize') article for usage examples. | ||
|
|
||
| Alternatively, you can [use Intl](/concepts/Common/Localization/05%20Localize%20Dates%2C%20Numbers%2C%20and%20Currencies/05%20Using%20Intl.md '/Documentation/Guide/Common/Localization/#Localize_Dates_Numbers_and_Currencies/Using_Intl') as a more lightweight localization solution. | ||
| Alternatively, you can [use Intl](/concepts/Common/Localization%20and%20Globalization/05%20Localize%20Dates%2C%20Numbers%2C%20and%20Currencies/05%20Using%20Intl.md '/Documentation/Guide/Common/Localization/#Localize_Dates_Numbers_and_Currencies/Using_Intl') as a more lightweight localization solution. |
| [note] If you do not use Webpack in your application, skip this step. | ||
|
|
||
| Open the `webpack.config.js` file and configure <a href="https://webpack.js.org/concepts#loaders" target="_blank">loaders</a> to process CSS and fonts. You should also specify Globalize and CLDR aliases if you want to [use Globalize for localization](/concepts/Common/Localization/05%20Localize%20Dates%2C%20Numbers%2C%20and%20Currencies/10%20Using%20Globalize.md '/Documentation/Guide/Common/Localization/#Localize_Dates_Numbers_and_Currencies/Using_Globalize'): | ||
| Open the `webpack.config.js` file and configure <a href="https://webpack.js.org/concepts#loaders" target="_blank">loaders</a> to process CSS and fonts. You should also specify Globalize and CLDR aliases if you want to [use Globalize for localization](/concepts/Common/Localization%20and%20Globalization/05%20Localize%20Dates%2C%20Numbers%2C%20and%20Currencies/10%20Using%20Globalize.md '/Documentation/Guide/Common/Localization/#Localize_Dates_Numbers_and_Currencies/Using_Globalize'): |
| --- | ||
| #####See Also##### | ||
| - [List - Localization](/concepts/05%20UI%20Components/List/50%20Localization.md '/Documentation/Guide/UI_Components/List/Localization/') No newline at end of file | ||
| - [List - Localization](/Documentation/Guide/UI_Components/List/Localization/) No newline at end of file |
| --- | ||
| #####See Also##### | ||
| - [List - Localization](/concepts/05%20UI%20Components/List/50%20Localization.md '/Documentation/Guide/UI_Components/List/Localization/') No newline at end of file | ||
| - [List - Localization](/Documentation/Guide/UI_Components/List/Localization/) No newline at end of file |
| --- | ||
| #####See Also##### | ||
| - [List - Localization](/concepts/05%20UI%20Components/List/50%20Localization.md '/Documentation/Guide/UI_Components/List/Localization/') No newline at end of file | ||
| - [List - Localization](/Documentation/Guide/UI_Components/List/Localization/) No newline at end of file |
| --- | ||
| #####See Also##### | ||
| - [List - Localization](/concepts/05%20UI%20Components/List/50%20Localization.md '/Documentation/Guide/UI_Components/List/Localization/') No newline at end of file | ||
| - [List - Localization](/Documentation/Guide/UI_Components/List/Localization/) No newline at end of file |
| --- | ||
| #####See Also##### | ||
| - [List - Localization](/concepts/05%20UI%20Components/List/50%20Localization.md '/Documentation/Guide/UI_Components/List/Localization/') No newline at end of file | ||
| - [List - Localization](/Documentation/Guide/UI_Components/List/Localization/) No newline at end of file |
There was a problem hiding this comment.
Pull request overview
Copilot reviewed 129 out of 130 changed files in this pull request and generated 14 comments.
Comments suppressed due to low confidence (1)
concepts/Common/Localization and Globalization/10 Value Formatting/10 Format UI Component Values/20 Custom Format String.md:124
- Use "weekday" (one word) in American English.
| </table> | ||
|
|
||
| Chat localizes these texts following your application locale. For more information about DevExtreme localization, refer to the following topic: [Localization](/concepts/Common/Localization '/Documentation/Guide/Common/Localization/'). | ||
| Chat localizes these texts following your application locale. For more information about DevExtreme localization, refer to the following topic: [Localization](/concepts/Common/Localization '/concepts/Common/Localization%20and%20Globalization/00%20Overview.md'). |
Contributor
There was a problem hiding this comment.
Customize the Chat when the Empty View is displayed
| Cannot be converted automatically. Assign this function to the [customizeText](/api-reference/_hidden/GridBaseColumn/customizeText.md '/Documentation/ApiReference/UI_Components/dxDataGrid/Configuration/columns/#customizeText') property instead of the **format** property. | ||
|
|
||
| - [Custom format string](/concepts/Common/Value%20Formatting/10%20Format%20Widget%20Values/20%20Custom%20Format%20String.md '/Documentation/Guide/Common/Value_Formatting/#Format_UI_Component_Values/Custom_Format_String') | ||
| - [Custom format string](/concepts/Common/Localization%20and%20Globalization/10%20Value%20Formatting/10%20Format%20Widget%20Values/20%20Custom%20Format%20String.md '/concepts/Common/Localization%20and%20Globalization/10%20Value%20Formatting/10%20Format%20UI%20Component%20Values/20%20Custom%20Format%20String.md') |
Contributor
There was a problem hiding this comment.
Cannot be converted: the cell value is exported without formatting. To export this format, return the formatted string from the customizeText callback as follows:
Comment on lines
59
to
+60
| #####See Also##### | ||
| - [Format Custom Values](/concepts/Common/Value%20Formatting/40%20Format%20Custom%20Values.md '/Documentation/Guide/Common/Value_Formatting/#Format_Custom_Values') No newline at end of file | ||
| - [Format Custom Values](/concepts/Common/Localization%20and%20Globalization/10%20Value%20Formatting/10%20Format%20UI%20Component%20Values/30%20Custom%20Function.md) |
|
|
||
| --- | ||
| Refer to the following help topic for a code example: [Format Custom Values](/concepts/Common/Value%20Formatting/40%20Format%20Custom%20Values.md '/Documentation/Guide/Common/Value_Formatting/#Format_Custom_Values'). | ||
| Refer to the following help topic for a code example: [Format Custom Values](/concepts/Common/Localization%20and%20Globalization/10%20Value%20Formatting/10%20Format%20UI%20Component%20Values/30%20Custom%20Function.md). |
Comment on lines
59
to
+60
| #####See Also##### | ||
| - [Format Custom Values](/concepts/Common/Value%20Formatting/40%20Format%20Custom%20Values.md '/Documentation/Guide/Common/Value_Formatting/#Format_Custom_Values') No newline at end of file | ||
| - [Format Custom Values](/concepts/Common/Localization%20and%20Globalization/10%20Value%20Formatting/10%20Format%20UI%20Component%20Values/30%20Custom%20Function.md) |
| --- | ||
| #####See Also##### | ||
| - [List - Localization](/concepts/05%20UI%20Components/List/50%20Localization.md '/Documentation/Guide/UI_Components/List/Localization/') | ||
| - [List - Localization](/concepts/05%20UI%20Components/List/50%20Localization.md) |
| --- | ||
| #####See Also##### | ||
| - [List - Localization](/concepts/05%20UI%20Components/List/50%20Localization.md '/Documentation/Guide/UI_Components/List/Localization/') | ||
| - [List - Localization](/concepts/05%20UI%20Components/List/50%20Localization.md) |
| --- | ||
| #####See Also##### | ||
| - [List - Localization](/concepts/05%20UI%20Components/List/50%20Localization.md '/Documentation/Guide/UI_Components/List/Localization/') | ||
| - [List - Localization](/concepts/05%20UI%20Components/List/50%20Localization.md) |
| --- | ||
| #####See Also##### | ||
| - [List - Localization](/concepts/05%20UI%20Components/List/50%20Localization.md '/Documentation/Guide/UI_Components/List/Localization/') | ||
| - [List - Localization](/concepts/05%20UI%20Components/List/50%20Localization.md) |
| --- | ||
| #####See Also##### | ||
| - [List - Localization](/concepts/05%20UI%20Components/List/50%20Localization.md '/Documentation/Guide/UI_Components/List/Localization/') | ||
| - [List - Localization](/concepts/05%20UI%20Components/List/50%20Localization.md) |
| Refer to the [Using Globalize](/concepts/Common/Localization/05%20Localize%20Dates%2C%20Numbers%2C%20and%20Currencies/10%20Using%20Globalize.md '/Documentation/Guide/Common/Localization/#Localize_Dates_Numbers_and_Currencies/Using_Globalize') article for usage examples. | ||
| Refer to the [Using Globalize](/concepts/Common/Localization%20and%20Globalization/10%20Value%20Formatting/08%20Using%20Globalize.md '/concepts/Common/Localization%20and%20Globalization/10%20Value%20Formatting/08%20Using%20Globalize.md') article for usage examples. | ||
|
|
||
| Alternatively, you can [use Intl](/concepts/Common/Localization%20and%20Globalization/10%20Value%20Formatting/04%20Using%20Intl.md '/concepts/Common/Localization%20and%20Globalization/10%20Value%20Formatting/04%20Using%20Intl.md') as a more lightweight localization solution. |
There was a problem hiding this comment.
Wherever these libraries are mentioned, Intl should always be listed first and clearly identified as the recommended option. When mentioning Globalize, we should ideally include a note such as: "The Globalize package is outdated and potentially unsafe." Alternatively, we can link to the note explaining this.
|
|
||
| --- | ||
|
|
||
| Use [formatNumber()](/api-reference/50%20Common/utils/localization/formatNumber(value_format).md '/Documentation/ApiReference/Common/utils/localization/#formatNumbervalue_format') and [parseNumber()](/api-reference/50%20Common/utils/localization/parseNumber(text_format).md '/Documentation/ApiReference/Common/utils/localization/#parseNumbertext_format') to format and parse numbers and currency values. |
There was a problem hiding this comment.
We can add an example for number formatting here as well
| @@ -0,0 +1,15 @@ | |||
| DevExtreme ships one message dictionary per language. To create a regional variant (for example `fr-CA`, `en-GB`, or `de-CH`), follow these steps: | |||
There was a problem hiding this comment.
This topic should cover not only a case when user creates a new dictionary for a new regional version based on existing one but also a case when user creates a completely new dictionary for a new language.
Meaning this is no actually difference but we should highlight both scenarios.
|
|
||
| --- | ||
|
|
||
| The previous example assigns an object to the **format** property, which allows you to specify `precision`. You can assign a string literal to **format** if additional options are not required. |
There was a problem hiding this comment.
Do you think it would be appropriate to include a link to the demo here?
https://js.devexpress.com/React/Demos/WidgetsGallery/Demo/NumberBox/Formatting/FluentBlueLight/
I think yes
| ); | ||
| } | ||
|
|
||
|
|
There was a problem hiding this comment.
We can try to find some suitable demo to get link to
examples for Date
examples for Number
helen-dikareva
approved these changes
Jul 10, 2026
arminal
reviewed
Jul 14, 2026
| The [formatted](/api-reference/10%20UI%20Components/BaseWidget/1%20Configuration/tooltip/format.md '{basewidgetpath}/Configuration/tooltip/#format') value converted to a string. | ||
|
|
||
| ##### return: Object | ||
| The tooltip's configuration. |
Contributor
There was a problem hiding this comment.
Suggested change
| Tooltip configuration. |
| --- | ||
| See the [format](/api-reference/50%20Common/Object%20Structures/format '/Documentation/ApiReference/Common/Object_Structures/format/') section for information on accepted values. | ||
|
|
||
| When this property value is `undefined`, the date-time axes display larger date range boundaries in labels. For example, if an axis displays months, it also displays a year near each instance of January. If an axis displays days, it also displays a month name near each first visible day mark. |
Contributor
There was a problem hiding this comment.
Suggested change
| When this property value is `undefined`, the date-time axes display larger date range boundaries in labels. For example, if an axis displays months, it also displays a year near each instance of January. If an axis displays days, it also displays the month near each first visible day mark. |
| --- | ||
| --- | ||
| ##### shortDescription | ||
| Customizes the text displayed by point labels. |
Contributor
There was a problem hiding this comment.
Suggested change
| Customizes text displayed by point labels. |
| --- | ||
| --- | ||
| ##### shortDescription | ||
| Customizes the text displayed by point labels. |
Contributor
There was a problem hiding this comment.
Suggested change
| Customizes text displayed by point labels. |
| --- | ||
| --- | ||
| ##### shortDescription | ||
| Customizes the text displayed by point labels. |
Contributor
There was a problem hiding this comment.
Suggested change
| Customizes text displayed by point labels. |
| format: ",##0.###" // 123,456.789 | ||
|
|
||
| The examples below show different ways to apply percentage formatting to decimals. Use caution if your format string starts with a zero ('0'), because the formatted number may lose leading digits. | ||
| The examples below show different ways to apply percentage formatting to decimals. Use caution if your format string starts with `0` because the formatted number may lose leading digits. |
Contributor
There was a problem hiding this comment.
Suggested change
| The examples below show different ways to apply percentage formatting to decimals. Use caution if your format string starts with `0` because the formatted number may lose leading digits. | |
| The examples below demonstrate different options used to apply percentage formatting to decimals. Use caution if your format string starts with `0` because the formatted number may lose leading digits. |
|
|
||
| ##### Angular | ||
|
|
||
| Install the `devextreme-cldr-data` and `globalize` packages: |
Contributor
There was a problem hiding this comment.
Suggested change
| Install the `devextreme-cldr-data` and `globalize` packages: | |
| Install `devextreme-cldr-data` and `globalize` packages: |
|
|
||
| ##### Vue | ||
|
|
||
| Install the `devextreme-cldr-data` and `globalize` packages: |
Contributor
There was a problem hiding this comment.
Suggested change
| Install the `devextreme-cldr-data` and `globalize` packages: | |
| Install `devextreme-cldr-data` and `globalize` packages: |
|
|
||
| ##### React | ||
|
|
||
| Install the `devextreme-cldr-data` and `globalize` packages: |
Contributor
There was a problem hiding this comment.
Suggested change
| Install the `devextreme-cldr-data` and `globalize` packages: | |
| Install `devextreme-cldr-data` and `globalize` packages: |
|
|
||
| ### Demos | ||
|
|
||
| The following demo includes both text localization and value formatting scenarios: |
Contributor
There was a problem hiding this comment.
Suggested change
| The following demo includes both text localization and value formatting scenarios: | |
| The following demo includes text localization and value formatting scenarios: |
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
https://github.com/DevExpress/dxvcs/issues/37152