@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.3.0] - 2017-06-12

Deprecated

• moonstone/Scroller props horizontal and vertical. Deprecated props are replaced with direction prop. horizontal and vertical will be removed in 2.0.0.
• moonstone/Panel prop noAutoFocus in favor of autoFocus="none"

Added

• core/platform to support platform detection across multiple browsers
• moonstone/Image support for children prop inside images
• moonstone/Scroller prop direction which replaces horizontal and vertical props
• moonstone/VideoPlayer property tooltipHideDelay to hide tooltip with a given amount of time
• moonstone/VideoPlayer methods fastForward, getMediaState, jump, pause, play, rewind, and seek to allow external interaction with the player. See docs for example usage.
• spotlight/styles/mixins.less mixins which allow state-selector-rules (muted, spottable, focus, disabled) to be applied to the parent instead of the component's self. This provides much more flexibility without extra mixins to memorize.
• ui/ViewManager prop childProps to pass static props to each child

Changed

• moonstone/Skinnable to support context and allow it to be added to any component to be individually skinned. This includes a further optimization in skinning which consolidates all color assignments into a single block, so non-color rules aren't unnecessarily duplicated.
• moonstone/Skinnable light and dark skin names ("moonstone-light" and "moonstone") to "light" and "dark", respectively
• moonstone/VideoPlayer to set play/pause icon to display "play" when rewinding or fast forwarding
• moonstone/VideoPlayer to rewind or fast forward when previous command is slow-forward or slow-rewind respectively
• moonstone/VideoPlayer to fast forward when previous command is slow-forward and it reaches the last of its play rate
• moonstone/VideoPlayer to not play video on reload when noAutoPlay is true
• moonstone/VideoPlayer property feedbackHideDelay's default value to 3000
• moonstone/Notification to break line in characters in ja and zh locale
• moonstone/Notification to align texts left in LTR locale and right in RTL locale
• moonstone/VideoPlayer to simulate rewind functionality on non-webOS platforms only
• spotlight submodules to significantly improve testability

Fixed

• moonstone/ExpandableItem to correct the titleIcon when using open and disabled
• moonstone/GridListImageItem to center its selection icon on the image instead of the item
• moonstone/Input to have correct Tooltip position in RTL
• moonstone/SwitchItem to not unintentionally overflow Scroller containers, causing them to jump to the side when focusing
• moonstone/VideoPlayer to fast forward properly when video is at paused state
• moonstone/VideoPlayer to correctly change sources
• moonstone/VideoPlayer to show or hide feedback tooltip properly
• moonstone/DateTimeDecorator to work properly with RadioControllerDecorator
• moonstone/Picker in joined, large text mode so the arrows are properly aligned and sized
• moonstone/Icon to reflect the same proportion in relation to its size in large-text mode
• spotlight submodules to significantly improve testability
• ui/ViewManager to have a view count of 0 specifically for noAnimation cases. This helps things like spotlight restore focus properly.
• ui/Cancelable to run modal handlers on window object and correctly store handlers in LIFO order