@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-2017 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

[1.12.2] - 2017-11-15

Fixed

• moonstone/VirtualList to scroll and focus properly by pageUp and pageDown when disabled items are in it
• moonstone/Button to correctly specify minimum width when in large text mode
• moonstone/Scroller.Scrollable to restore last focused index when panel is changed
• moonstone/VideoPlayer to display time correctly in RTL locale
• moonstone/VirtualList to scroll correctly using page down key with disabled items
• moonstone/Scrollable to not cause a script error when scrollbar is not rendered
• moonstone/Picker incrementer and decrementer to not change size when focused
• moonstone/Panels.Header to use a slightly smaller font size for title in non-latin locales and a line-height for titleBelow and subTitleBelow that better meets the needs of tall-glyph languages like Tamil and Thai, as well as latin locales
• moonstone/Scroller and moonstone/VirtualList to keep spotlight when pressing a 5-way control while scrolling
• moonstone/Panels to prevent user interaction with panel contents during transition
• moonstone/Slider and related components to correctly position knob for detachedKnob on mouse down and fire value where mouse was positioned on mouse up
• moonstone/DayPicker to update day names when changing locale
• moonstone/ExpandableItem and all other Expandable components to revert 1.12.1 change to pull down from the top
• spotlight to handle non-5-way keys correctly to focus on next 5-way keys
• spotlight/Spottable to forward onMouseEnter and onMouseLeave
• ui/Remeasurable to update on every trigger change
• ui/Transition to revert 1.12.1 change to support clip transition-type directions and rendering optimizations