Localization
The localization dependency is a main entry point to provide human-readable strings to the DXcharts React app.
Localization Configuration
The Localization interface structure:
Localization crossTool Cross-tool (crosshair) labels for OHLC (Open, High, Low, Close) values and volume. Localization_crossTool open string high string low string close string volume string drawings All localization strings for the drawings feature including sidebar, dropdown menus,
context menus, and individual drawing tool names. Localization_drawings recentDrawings string noRecentDrawings string hideDrawings string unhideDrawings string clearDrawings string types DrawingNames line any rectangle any horizontal_line any horizontal_ray any vertical_line any extended_line any ellipse any pitchfork any ray any curve any arc any info_line any brush any path any date_price_range any date_range any price_range any highlighter any icon any gann_box any gann_square any fibonacci_ark any fibonacci_circles any fibonacci_rays any gann_fan any trend_channel any fibonacci_retracements any text any callout any price_label any vertical_arrow_up any vertical_arrow_down any arrow any elliott_wave any elliott_correction_wave any fibonacci_projection any fibonacci_channel any fibonacci_time_zones any regression_trend any fibonacci_spiral any cycle_brackets any fibonacci_time_extension any fibonacci_time_ratios any range_volume_by_price any anchored_volume_by_price any trend any extended any multichannel any base_isolation_tool any magnifying_tool_rectangle any magnifying_tool_time_range any magnifying_tool_time_range_wheel any default any dropdown DrawingsDictionary_dropdown calendar DrawingsDictionary_calendar colorPicker DrawingsDictionary_colorPicker confirmationPopup DrawingsDictionary_confirmationPopup popup DrawingsDictionary_popup textNote DrawingsDictionary_textNote regressionTrend DrawingsDictionary_regressionTrend fibonacciSpiral DrawingsDictionary_fibonacciSpiral volumeByPrice DrawingsDictionary_volumeByPrice contextMenu DrawingsDictionary_contextMenu legend Legend labels for OHLC values, volume, comparison mode, and chart type selector. Localization_legend open string high string low string close string fullOHLCNames LegendDictionary_fullOHLCNames volume string compare string a11y_zoomIn string a11y_zoomOut string a11y_legendSwitcher string a11y_chartType string chartType LegendDictionary_chartType timeZone Timezone selector strings including UTC, exchange timezone, and accessibility labels. Localization_timeZone utc string exchange string input_placeholder string input_no_data string a11y_timezoneMenu string a11y_timezoneList string studies All study/indicator related strings including names, parameters, settings,
and right-click menu options for all available studies. Localization_studies rightClickMenu StudiesDictionary_rightClickMenu td_sequential StudiesDictionary_td_sequential adx StudiesDictionary_adx wave_trend StudiesDictionary_wave_trend adxr StudiesDictionary_adxr acceleration_deceleration StudiesDictionary_acceleration_deceleration accumulation_swing_index StudiesDictionary_accumulation_swing_index accumulation_distribution StudiesDictionary_accumulation_distribution aroon_indicator StudiesDictionary_aroon_indicator aroon_oscillator StudiesDictionary_aroon_oscillator average_true_range StudiesDictionary_average_true_range awesome_oscillator StudiesDictionary_awesome_oscillator bollinger_bands StudiesDictionary_bollinger_bands bollinger_bands_percent StudiesDictionary_bollinger_bands_percent cci StudiesDictionary_cci csi StudiesDictionary_csi center_of_gravity_oscillator StudiesDictionary_center_of_gravity_oscillator chaikin_oscillator StudiesDictionary_chaikin_oscillator chaikin_volatility StudiesDictionary_chaikin_volatility chande_momentum_oscillator StudiesDictionary_chande_momentum_oscillator kama StudiesDictionary_kama dema StudiesDictionary_dema dmi StudiesDictionary_dmi day_open_close StudiesDictionary_day_open_close demarker StudiesDictionary_demarker detrended_price_osc StudiesDictionary_detrended_price_osc dynamic_momentum_index StudiesDictionary_dynamic_momentum_index ema StudiesDictionary_ema ema_envelope StudiesDictionary_ema_envelope elder_ray StudiesDictionary_elder_ray fast_stochastic StudiesDictionary_fast_stochastic fibonacci_bb StudiesDictionary_fibonacci_bb force_index StudiesDictionary_force_index forecast_oscillator StudiesDictionary_forecast_oscillator full_stochastic StudiesDictionary_full_stochastic gator_oscillator StudiesDictionary_gator_oscillator hl_volatility StudiesDictionary_hl_volatility hma StudiesDictionary_hma ichimoku StudiesDictionary_ichimoku inertia StudiesDictionary_inertia intraday_momentum_index StudiesDictionary_intraday_momentum_index kairi_relative_index StudiesDictionary_kairi_relative_index keltner_channels StudiesDictionary_keltner_channels linear_regression_channel StudiesDictionary_linear_regression_channel linear_regression_curve StudiesDictionary_linear_regression_curve linear_regression_slope StudiesDictionary_linear_regression_slope macd StudiesDictionary_macd market_facilitation_index StudiesDictionary_market_facilitation_index mass_index StudiesDictionary_mass_index median_price StudiesDictionary_median_price momentum StudiesDictionary_momentum money_flow_index StudiesDictionary_money_flow_index negative_volume_index StudiesDictionary_negative_volume_index on_balance_volume StudiesDictionary_on_balance_volume parabolic_sar StudiesDictionary_parabolic_sar percent_change StudiesDictionary_percent_change percent_of_resistance StudiesDictionary_percent_of_resistance percentage_price_oscillator StudiesDictionary_percentage_price_oscillator pivot_points StudiesDictionary_pivot_points price_channel StudiesDictionary_price_channel price_oscillator StudiesDictionary_price_oscillator price_and_volume_trend StudiesDictionary_price_and_volume_trend roc StudiesDictionary_roc relative_strength_index StudiesDictionary_relative_strength_index relative_vigor_index StudiesDictionary_relative_vigor_index relative_vigor_index_sma StudiesDictionary_relative_vigor_index_sma relative_volatility_index StudiesDictionary_relative_volatility_index sma StudiesDictionary_sma sma_envelope StudiesDictionary_sma_envelope smma StudiesDictionary_smma smma_envelope StudiesDictionary_smma_envelope starc_bands StudiesDictionary_starc_bands schaff_trend_cycle StudiesDictionary_schaff_trend_cycle slow_stochastic StudiesDictionary_slow_stochastic smoothed_rate_of_change StudiesDictionary_smoothed_rate_of_change spearman StudiesDictionary_spearman standard_deviation StudiesDictionary_standard_deviation standard_deviation_channel StudiesDictionary_standard_deviation_channel standard_error_bands StudiesDictionary_standard_error_bands std_dev_volatility StudiesDictionary_std_dev_volatility swing_index StudiesDictionary_swing_index tema StudiesDictionary_tema tma StudiesDictionary_tma trix StudiesDictionary_trix time_series_forecast StudiesDictionary_time_series_forecast true_strength_index StudiesDictionary_true_strength_index typical_price StudiesDictionary_typical_price ultimate_oscillator StudiesDictionary_ultimate_oscillator vertical_horizontal_filter StudiesDictionary_vertical_horizontal_filter volume_weighted_average_price StudiesDictionary_volume_weighted_average_price wma StudiesDictionary_wma wma_envelope StudiesDictionary_wma_envelope weighted_close StudiesDictionary_weighted_close wilders_smoothing StudiesDictionary_wilders_smoothing williams_ad StudiesDictionary_williams_ad williams_alligator StudiesDictionary_williams_alligator williams_fractal StudiesDictionary_williams_fractal williams_percent_range StudiesDictionary_williams_percent_range wtwc StudiesDictionary_wtwc zigzag StudiesDictionary_zigzag supertrend StudiesDictionary_supertrend historical_volatility StudiesDictionary_historical_volatility ema_clouds StudiesDictionary_ema_clouds stochastic_rsi StudiesDictionary_stochastic_rsi acceleration_bands StudiesDictionary_acceleration_bands elder_force_index StudiesDictionary_elder_force_index donchian_channel StudiesDictionary_donchian_channel ttm_squeeze StudiesDictionary_ttm_squeeze chaikin_money_flow StudiesDictionary_chaikin_money_flow implied_volatility StudiesDictionary_implied_volatility volume_average StudiesDictionary_volume_average aggregationPeriod Aggregation period selector strings including period names, custom period input,
and validation messages. Localization_aggregationPeriod periods PeriodsDictionary tick string | { long: string; short: string; } range string | { long: string; short: string; } second string | { long: string; short: string; } minute string | { long: string; short: string; } hour string | { long: string; short: string; } day string | { long: string; short: string; } week string | { long: string; short: string; } month string | { long: string; short: string; } year string | { long: string; short: string; } volume string | { long: string; short: string; } customPeriodsMap CustomPeriodsMap CustomPeriodsMap interface defines how to parse custom timeframes. types To add new type, please provide object with key as type and value as array of valid strings for this type.
Example:
{
types: {
y: ['y', 'Y', 'year'] // would parse strings like '1 year' or '1Y' or 'year' into 'y' type
}
} AggregationPeriodDurationTypeMap y any t any r any s any m any h any d any w any mo any v any numberWords string[] pluralPostfix (count: number) => string custom string customInputPlaceHolder string a11y_customInputConfirmButton string a11y_aggregationPeriodDescription string a11y_deleteAggregationPeriod string validation_nonexistentCustomPeriod string yAxis Y-axis configuration strings including scale type labels (regular, percent, logarithmic),
axis alignment options, and fit settings. YAxisDictionary auto string lockPrice string fit FitDictionary studies string orders string positions string axisType AxisTypeDictionary regular string percent string logarithmic string axisAlign AxisAlignDictionary title string settingsRight string settingsLeft string right string left string labelsAndLines string labels LabelsDictionary lastPrice string studies string bidAsk string highLow string prevDayClose string prePostMarket string scale ScaleDictionary inverse string lock string descriptions string countDownToBarClose string fullChartSettings string buttons ButtonsDictionary a11y_percent string a11y_logarithmic string a11y_regular string a11y_scaleType string a11y_sideAlign string events Economic events labels for earnings, dividends, stock splits, conference calls, and news. Localization_events earnings EventsDictionary_earnings dividends EventsDictionary_dividends splits EventsDictionary_splits conference-calls EventsDictionary_conference-calls codeEditor Code editor UI strings for creating custom studies including button labels,
status messages, and error messages. Localization_codeEditor pending string addToChartBtn string updateBtn string duplicateBtn string docsBtn string fiveStudiesMax string saved string close string saving string errors CodeEditorDictionary_errors studiesPopup Studies configuration popup strings including available studies list, filters,
study settings, inputs, plots, and style options. Localization_studiesPopup editStudies string availableStudies string filter string studiesMax string addedStudies string deleteAll string emptyResult string restoreToDefault string inputs string plots string overlaying string settings string close string holdToDelete string learnMoreLink string studyLineTypeList StudiesPopupDictionary_studyLineTypeList studyParamAggregationType StudiesPopupDictionary_studyParamAggregationType studyParamAverageType StudiesPopupDictionary_studyParamAverageType studyParamBasisType StudiesPopupDictionary_studyParamBasisType studyParamPriceType StudiesPopupDictionary_studyParamPriceType studyParamMoveToScale StudiesPopupDictionary_studyParamMoveToScale overlayingCheckboxDisabled string a11y_openScript string a11y_editScript string a11y_deleteScript string a11y_close string newScript string a11y_labelForEditAndDelScript string a11y_labelForEditScript string a11y_availableStudes string a11y_availableStudiesList string a11y_addedStudiesList string a11y_plotVisibility string a11y_plotLineThickness string a11y_plotLineColor string a11y_plotLineType string a11y_overlayStudy string a11y_dragHandleInstructions string trading Trading-related strings for order entry, order types, protection orders (TP/SL),
and executed orders display. Localization_trading orderEntry TradingDictionary_orderEntry executedOrders TradingDictionary_executedOrders orderTypes TradingDictionary_orderTypes protectionOrders TradingDictionary_protectionOrders chartSnapshot Chart snapshot feature strings for downloading, copying, and sharing chart images
via social media platforms. Localization_chartSnapshot downloadImage string copyImage string copyLink string tweet string telegram string shareTwitterText string shareTelegramText string notifications Notification messages displayed to users for various actions like copying images,
magnet mode toggle, drawing mode changes, etc. Localization_notifications notificationImageCopy string notificationLinkCopy string notificationFallback string notificationSidebarMagnetOn string notificationSidebarMagnetOff string notificationSidebarDrawingOn string notificationSidebarDrawingOff string notificationSidebarDelete string notificationDataTypeChanged string notificationInstrumentNoData string notificationResetChart string notificationDrawingCopied string notificationDrawingPasted string notificationDrawingCut string notificationSyncedDrawingsSameChartOnly string layout Chart layout management strings for creating, editing, and deleting custom layouts,
including validation messages. Localization_layout newLayout string a11y_layoutTemplateDescription string a11y_deleteLayoutTemplate string a11y_editLayoutTemplate string a11y_customInputConfirmButton string validation_nameAlreadyExists string validation_cannotFindLayoutToUpdate string sidebar Sidebar strings including header text, accessibility labels, and button tooltips
for magnet mode, drawing mode, and drawing visibility controls. Localization_sidebar a11y_toolbar string header string a11y_favoriteList string a11y_drawingsList string a11y_footerList string a11y_collapseSidebar string a11y_expandSidebar string a11y_sidebarButtonDescription string buttons SidebarDictionary_buttons indicatorTemplates Indicator template management strings for saving, editing, and deleting custom
indicator configurations. Localization_indicatorTemplates saveIndicatorTemplate string a11y_indicatorTemplateDescription string a11y_deleteIndicatorTemplate string a11y_editIndicatorTemplate string a11y_customInputConfirmButton string validation_nameAlreadyExists string validation_cannotFindTemplateToUpdate string themes Theme selector strings including theme names (dark, light, cloudDancer, oud, still, solar). Localization_themes title string types ThemesDictionary_types toolbar Top toolbar strings including button tooltips, dropdown labels, accessibility labels,
and market state indicators. Localization_toolbar a11y_toolbar string a11y_buttons ToolbarDictionary_a11y_buttons a11y_synchronize ToolbarDictionary_a11y_synchronize a11y_studies ToolbarDictionary_a11y_studies compareChart ToolbarDictionary_compareChart chartType ToolbarDictionary_chartType multichart ToolbarDictionary_multichart instrumentSelector ToolbarDictionary_instrumentSelector tooltip ToolbarDictionary_tooltip marketState ToolbarDictionary_marketState settingsPopup Settings popup strings for all configuration tabs including general settings,
appearance, scale, data, events, and trading options. Localization_settingsPopup a11y_radioButton string priceTypes SettingsPopupDictionary_priceTypes chartSettings string resetChart string tabs SettingsPopupDictionary_tabs appearance SettingsPopupDictionary_appearance paddings SettingsPopupDictionary_paddings restoreDefaultsBtn string resetToDefaultsBtn string closeBtn string components Common component strings used across multiple features including popup close buttons,
color picker, line style picker, and numeric stepper. Localization_components chart ComponentsDictionary_chart lineStylePicker ComponentsDictionary_lineStylePicker popup ComponentsDictionary_popup simpleNumericStepper ComponentsDictionary_simpleNumericStepper aggregationTimeframe ComponentsDictionary_aggregationTimeframe axisTypeButtons ComponentsDictionary_axisTypeButtons yAxisScalesLabels ComponentsDictionary_yAxisScalesLabels colorPicker ComponentsDictionary_colorPicker symbolSuggest ComponentsDictionary_symbolSuggest chartLayers Chart layers management strings for locking, unlocking, hiding, and organizing
drawing layers and groups. Localization_chartLayers a11y_lockLayerItem string a11y_unlockLayerItem string a11y_hideLayerItem string a11y_unhideLayerItem string headerTitle string closeButton string createGroupButton string deleteButton string newGroupName string drawingGroups Drawing groups management strings for creating, editing, and deleting custom
drawing groups with group selector labels. Localization_drawingGroups defaultGroup string addNewGroup string addNewGroupPlaceholder string a11y_deleteGroup string a11y_editGroup string a11y_drawingGroupsMenu string a11y_drawingGroupsAnchor string timeframePresets Timeframe presets strings for quick time range selection (1D, 1W, 1M, 1Y, etc.)
and custom timeframe input. Localization_timeframePresets a11y_presets_list string a11y_toggle_custom_preset string a11y_toggle_edit string a11y_preset string a11y_remove_preset string timeframeLabelTypes TimeframePresetsDictionary_timeframeLabelTypes systemMessages System messages displayed when no data is available, instrument is not available,
or no instrument is selected. Localization_systemMessages noDataAvailable string instrumentIsNotAvailable string instrumentIsNotSelected string dynamicObjects Dynamic objects (drawings and studies) layer management strings for bringing forward,
sending backward, and moving between layers. Localization_dynamicObjects bringToFront string sendToBack string bringForward string sendBackward string moveTo string navigationMap Navigation map component strings including accessibility labels for left/right
navigation arrows and slider controls. Localization_navigationMap a11y_navMapLeft string a11y_navMapRight string a11y_navMapLeftArrow string a11y_navMapRightArrow string formatter Number and date formatting strings for displaying values in different formats
and locales. Localization_formatter decimalSeparator string thousandsSeparator string returnToNow Return to now button strings for navigating back to the most recent time. Localization_returnToNow a11y_returnToNow string
Custom localization
We highly recommend using
TypeScript, because IDE will help with suggestions and it will be a lot easier to escape missing locale strings.
To provide your own localization object you should do the following:
import React from 'react';import { ChartReactApp } from '@dx-private/dxchart5-react/dist/chart/chart-react-app';import { DEFAULT_LOCALIZATION, Localization } from '@dx-private/dxchart5-react/dist/config/localization/localization';import { CREATE_MOCK_PROVIDERS } from '@dx-private/dxchart5-react-mock-providers/dist';const userLocalization: Localization = {...DEFAULT_LOCALIZATION,sidebar: {...DEFAULT_LOCALIZATION.sidebar,header: 'Drawings',buttons: {magnetMode: 'Magnet Mode',drawingMode: 'Drawing Mode',syncDrawings: 'Synchronize drawings',hideDrawings: 'Hide all drawings',showDrawings: 'Unhide all drawings',deleteDrawings: 'Delete all drawings',},},//...overrides,};export const UserApp = () => {return (<ChartReactAppdependencies={{...CREATE_MOCK_PROVIDERS(),//...rest_dependencies,localization: userLocalization,}}/>);};