@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 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.0.0-beta.1] - 2016-12-30

Added

• core/factory which provides the means to support design-time customization of components
• Moonstone/VideoPlayer and moonstone/TooltipDecorator components
• moonstone/Panels.Panels property onBack to support ui/Cancelable
• moonstone/VirtualFlexList Work-In-Progress component (with sample) to support variably sized rows or columns
• moonstone/ExpandableItem properties autoClose and lockBottom
• moonstone/ExpandableList properties noAutoClose and noLockBottom
• moonstone/ContextualPopup property noAutoDismiss
• moonstone/Dialog property scrimType
• moonstone/Popup property spotlightRestrict
• spotlight.Spotlight methods isPaused(), isSpottable(), getCurrent(), and isMuted()
• spotlight.SpotlightContainerDecorator property spotlightMuted
• spotlight.spotlightDirections export
• ui/RadioDecorator and ui/RadioControllerDecorator to support radio group-style management of components
• ui/Holdable Higher-order Component
• ui/ViewManager events onAppear, onEnter, onLeave, onStay, onTransition, and onWillTransition
• ui/FloatingLayer scrimType prop value none
• ui/Pressable config option onMouseLeave

Changed

• moonstone/Panels.Routable to require a navigate configuration property indicating the event callback for back or cancel actions
• moonstone/MarqueeController focus/blur handling to start and stop synchronized moonstone/Marquee components
• moonstone/ExpandableList property autoClose to closeOnSelect to disambiguate it from the added autoClose on 5-way up
• moonstone/ContextualPopupDecorator.ContextualPopupDecorator component's onCloseButtonClick property to onClose
• moonstone/Spinner component's center and middle properties to a single centered property that applies both horizontal and vertical centering
• moonstone/Popup.PopupBase component's onCloseButtonClicked property to onCloseButtonClick
• moonstone/Item.ItemOverlay component's autoHide property to remove the 'no' option. The same effect can be achieved by omitting the property or passing null.
• moonstone/VirtualGridList to be scrolled by page when navigating with a 5-way direction key
• moonstone/Scroller, moonstone/VirtualList, moonstone/VirtualGridList, and moonstone/Scrollable to no longer respond to mouse down/move/up events
• all Expandables to include a state arrow UI element
• moonstone/LabeledItem to support a titleIcon property which positions just after the title text
• moonstone/Button to include moonstone/TooltipDecorator
• moonstone/Expandable to support being managed, radio group-style, by a component wrapped with RadioControllerDecorator from ui/RadioDecorator
• moonstone/Picker to animate moonstone/Marquee children when any part of the moonstone/Picker is focused
• moonstone/VirtualList to mute its container instead of disabling it during scroll events
• moonstone/VirtualList, moonstone/VirtualGridList, and moonstone/Scroller to continue scrolling when holding down the paging controls
• moonstone/VirtualList to require a component prop and not have a default value
• moonstone/Picker to continuously change when a button is held down by adding ui/Holdable.
• ui/FloatingLayer property autoDismiss to handle both ESC key and click events

Removed

• ui/Transition prop fit in favor of using className

Fixed

• i18n/I18nDecorator issue causing multiple requests for ilibmanifest.
• moonstone/Popup and moonstone/ContextualPopup 5-way navigation behavior using spotlight.
• Bug where a synchronized marquee whose content fit the available space would prevent restarting of the marquees
• moonstone/Input to show an ellipsis on the correct side based on the text directionality of the value or placeholder content.
• moonstone/VirtualList and moonstone/VirtualGridList to prevent unwanted scrolling when focused with the pointer
• moonstone/Picker to remove fingernail when a the pointer is held down, but the pointer is moved off the joined picker.
• moonstone/LabeledItem to include marquee on both title and label, and be synchronized