@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 {I18nDecorator, contextTypes} from `@enact/i18n/I18nDecorator`;

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

// Without contextTypes, your component will not receive context!
MyComponent.contextTypes = contextTypes;

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-alpha.7] - 2018-04-03

Removed

• moonstone/VirtualList.VirtualList and moonstone/VirtualList.VirtualGridList property data
• ui/VirtualList.VirtualList and ui/VirtualList.VirtualGridList prop data

Added

• moonstone/VideoPlayer property noSpinner to allow apps to show/hide spinner while loading video
• webos/LS2Request send() parameters onTimeout and timeout
• webos/LS2Request send() default onFailure and onTimeout handlers

Changed

• moonstone/VideoPlayer to disable play/pause button when media controls are disabled
• moonstone/VideoPlayer property moreButtonColor to allow setting underline colors for more button
• moonstone/VirtualList.VirtualList and moonstone/VirtualList.VirtualGridList prop isItemDisabled, which accepts a function that checks if the item at the supplied index is disabled
• moonstone/Panels.Header support for headerInput so the Header can be used as an Input. See documentation for usage examples.
• moonstone/ProgressBar property tooltipSide to configure tooltip position relative to the progress bar
• moonstone/ProgressBar colors (affecting moonstone/Slider as well) for light and dark theme to match the latest designs and make them more visible when drawn over arbitrary background colors

Fixed

• moonstone/VideoPlayer to correctly adjust spaces when the number of components changes in leftComponents and rightComponents
• moonstone/VideoPlayer to read out audio guidance every time source changes
• moonstone/VideoPlayer to display custom thumbnail node
• moonstone/VideoPlayer to hide more icon when right components are removed
• moonstone/Picker to correctly update pressed state when dragging off buttons
• moonstone/Notification to display when it's opened
• moonstone/VirtualList and moonstone/VirtualGridList to show Spotlight properly while navigating with page up and down keys
• moonstone/Input to allow navigating via left or right to other components when the input is active and the selection is at start or end of the text, respectively
• moonstone/Panels.ActivityPanels to correctly lay out the existing panel after adding additional panels
• spotlight to partition and prioritize next spottable elements for more natural 5-way behavior
• ui/Scroller horizontal scrolling in RTL locales