@enact/i18n

@enact/i18n

Internationalization library based on iLib.

@enact/i18n provides a decorator that can be used to wrap a root component in a React (or Enact) application. This decorator provides a context to child components that can be used to determine locale text directionality and to update the current locale. Additionally, it provides a locale-aware Uppercase higher-order component (HOC).

Usage

import {I18nContextDecorator, I18nDecorator} from '@enact/i18n/I18nDecorator';
import React from 'react';

const MyComponent = I18nContextDecorator(
    {rtlProp: 'rtl'},
    (props) => (
        <div>{props.rtl ? 'right to left' : 'left to right'}</div>
    )
);

const MyApp = () => (
    <div>
        <MyComponent />
    </div>
);

const MyI18nApp = I18nDecorator(MyApp);

Uppercase may be used independently of the app decorator. By default, it uppercases the children property of the wrapped component, provided it is a string.

import Uppercase from '@enact/i18n/Uppercase';

const MyComponent = (props) => (
    <div {...props} />
);

const MyUppercaseComponent = Uppercase(MyComponent);

Passing preserveCase in the props to MyUppercaseComponent will prevent uppercasing.

Install

npm install --save @enact/i18n

Acknowledgments

This module is built upon the iLib library.

Copyright and License Information

Unless otherwise specified, all content, including all source code files and documentation files in this repository are:

Copyright (c) 2016-2018 LG Electronics

Unless otherwise specified or set forth in the NOTICE file, all content, including all source code files and documentation files in this repository are: Licensed under the Apache License, Version 2.0 (the "License"); you may not use this content except in compliance with the License. You may obtain a copy of the License at

http://www.apache.org/licenses/LICENSE-2.0

Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.

This work is based on the Apache-2.0 licensed iLib from JEDLSoft.

Changelog

[2.0.0-rc.2] - 2018-07-16

Added

• spotlight debugging to visualize which components will be targeted as the next component for any 5-way direction

Fixed

• moonstone/Input to not focus by tab key
• moonstone/Picker to properly set focus when navigating between buttons
• moonstone/ProgressBar.ProgressBarTooltip unknown props warning
• moonstone/Scrollable to disable spotlight container during flick events only when contents can scroll
• moonstone/Scroller, moonstone/VirtualList.VirtualGridList, and moonstone/VirtualList.VirtualList to scroll properly when animate is false via scrollTo
• moonstone/Scroller, moonstone/VirtualList.VirtualGridList, and moonstone/VirtualList.VirtualList page controls to stop propagating an event when the event is handled
• moonstone/Scroller, moonstone/VirtualList.VirtualGridList, and moonstone/VirtualList.VirtualList to hide overscroll effect when focus is moved from a disabled paging control button to the opposite button
• moonstone/Scroller, moonstone/VirtualList.VirtualGridList, and moonstone/VirtualList.VirtualList to show overscroll effect when reaching the edge for the first time by wheel
• moonstone/VideoPlayer to display feedback tooltip when pointer leaves slider while playing
• moonstone/VirtualList and moonstone/VirtualGridList to restore focus on items focused by pointer