@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.1.0] - 2017-04-21

Note: We have updated Enact to support React 15.5. This version of React has deprecated accessing PropTypes from the react import. Existing apps should update to import from the prop-types module. enact-dev has also been updated to the new release.

Deprecated

• moonstone/ExpandableInput property onInputChange

Added

• core/util documentation
• i18n/Uppercase prop casing to control how the component should be uppercased
• i18n/util methods toCapitalized and toWordCase to locale-aware uppercase strings
• moonstone/Panels.Panel prop and moonstone/MoonstoneDecorator config option: noAutoFocus to support prevention of setting automatic focus after render
• moonstone/VideoPlayer props: backwardIcon, forwardIcon, jumpBackwardIcon, jumpForwardIcon, pauseIcon, and playIcon to support icon customization of the player
• moonstone/VideoPlayer props jumpButtonsDisabled and rateButtonsDisabled for disabling the pairs of buttons when it's inappropriate for the playing media
• moonstone/VideoPlayer property playbackRateHash to support custom playback rates
• moonstone/VideoPlayer callback prop onControlsAvailable which fires when the players controls show or hide
• moonstone/Image support for onLoad and onError events
• moonstone/VirtualList.GridListImageItem prop placeholder
• moonstone/Divider property preserveCase to display text without capitalizing it
• spotlight/SpotlightRootDecorator config option: noAutoFocus to support prevention of setting automatic focus after render
• spotlight/Spotlight method getSpottableDescendants()

Changed

• moonstone/Slider colors and sizing to match the latest designs
• moonstone/ProgressBar to position correctly with other components nearby
• moonstone/Panels breadcrumb to no longer have a horizontal line above it
• moonstone/Transition to measure itself when the CPU is idle
• style for disabled opacity from 0.4 to 0.3
• moonstone/Button colors for transparent and translucent background opacity when disabled
• moonstone/ExpandableInput property onInputChange to fire along with onChange. onInputChange is deprecated and will be removed in a future update.
• Moonstone.ttf font to include new icons
• moonstone/Icon to reference additional icons
• spotlight/SpotlightContainerDecorator to have no default for spotlightRestrict
• ui/Slottable to support slot-candidate tags that have multiple props, which are now forwarded directly instead of just their children

Fixed

• core/util.childrenEquals to work with mixed components and text
• moonstone/Popup and moonstone/ContextualPopupDecorator 5-way navigation behavior
• moonstone/Input to not spot its own input decorator on 5-way out
• moonstone/VideoPlayer to no longer render its children in multiple places
• moonstone/Button text color when used on a neutral (light) background in some cases
• moonstone/Popup background opacity
• moonstone/Marquee to recalculate properly when its contents change
• moonstone/TimePicker to display time in correct order
• moonstone/Scroller to prefer spotlight navigation to its internal components
• spotlight/Spotlight to consider nested containers when adjusting focus
• ui/Cancelable to run modal handlers in the right order