@enact/i18n

@enact/i18n

Enact library for internationalization

@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.4] - 2018-02-13

Removed

• moonstone/Button and moonstone/IconButton prop noAnimation

Added

• ui/BodyText, ui/Image, ui/Item, ui/ProgressBar, ui/SlotItem, ui/Spinner, ui/ToggleIcon components as unstyled base components to support UI libraries

Changed

• core/kind to always return a component rather than either a component or an SFC depending upon the configuration
• moonstone/Marquee to do less-costly calculations during measurement and optimized the applied styles
• moonstone/ExpandableList to require a unique key for each object type data
• samples to be organized by library and removed background selector
• ui/Repeater and ui/Group to require a unique key for each object type data
• ui/Toggleable to use 'selected' as its default prop, rather than 'active', since 'selected' is by far the most common use case
• ui/Touchable to use global gesture configuration with instance override rather than component-level configuration via HOC configs with instance override

Fixed

• moonstone/VirtualList to render properly with fiber reconciler
• moonstone/VirtualList focus option in scrollTo api
• moonstone/ExpandableSpotlightDecorator to not spot the title upon collapse when in pointerMode
• moonstone/Spinner to not unpause Spotlight unless it was the one to pause it
• moonstone/Marquee to stop when becoming disabled
• spotlight/Spottable to not remove tabindex from unspottable components to allow blur events to propagate as expected when a component becomes disabled