@enact/i18n

@enact/i18n

Internationalization library based on iLib.

@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.6] - 2018-03-22

Removed

• core/factory module, replaced by the css override feature
• moonstone/Slider exports SliderFactory and SliderBaseFactory
• moonstone/IncrementSlider exports IncrementSliderFactory and IncrementSliderBaseFactory
• moonstone/ProgressBar, moonstone/Slider, moonstone/Slider.SliderTooltip, moonstone/IncrementSlider components' vertical property and replaced it with orientation
• spotlight/SpotlightContainerDecorator prop containerId, to be replaced by spotlightId
• ui/Transition property clipHeight
• ui/ProgressBar property vertical and replaced it with orientation

Added

• moonstone/VideoPlayer property component to handle custom video element
• moonstone/IncrementSlider properties incrementAriaLabel and decrementAriaLabel to configure the label set on each button
• moonstone/Input support for small prop
• moonstone/ProgressBar support for tooltip and tooltipForceSide
• moonstone/ProgressBar, moonstone/Slider, moonstone/Slider.SliderTooltip, moonstone/IncrementSlider property orientation to accept orientation strings like "vertical" and "horizontal" (replaced old vertical prop)
• spotlight/Pause module which acts as a semaphore for spotlight pause state
• spotlight/Spottable prop spotlightId to simplify focusing components
• ui/Scrollable support for scrolling by touch
• ui/ProgressBar property orientation to accept orientation strings like "vertical" and "horizontal"

Changed

• moonstone/Input input height, vertical-align, and margins. Please verify your layouts to ensure everything lines up correctly; this change may require removal of old sizing and positioning CSS which is no longer necessary.
• moonstone/FormCheckbox to have a small border around the circle, according to new GUI designs
• moonstone/RadioItem dot size and added an inner-dot to selected-focused state, according to new GUI designs
• moonstone/ContextualPopup prop popupContainerId to popupSpotlightId
• moonstone/Popup prop containerId to spotlightId
• moonstone/VideoPlayer prop containerId to spotlightId
• moonstone/VirtualList.VirtualList and moonstone/VirtualList.VirtualGridList prop component to be replaced by itemRenderer
• spotlight/Spotlight.focus to support focusing by spotlightId
• spotlight container attributes data-container-disabled and data-container-muted to be data-spotlight-container-disabled and data-spotlight-container-muted, respectively
• ui/VirtualList.VirtualList and ui/VirtualList.VirtualGridList prop component to be replaced by itemRenderer

Fixed

• moonstone/ExpandableItem to be more performant when animating
• moonstone/GridListImageItem to hide overlay checkmark icon on focus when unselected
• moonstone/GridListImageItem to use ui/GridListImageItem
• moonstone/VirtualList, moonstone/VirtualGridList and moonstone/Scroller components to use their base UI components
• moonstone/VirtualList to show the selected state on hovered paging controls properly
• moonstone/Slider to highlight knob when selected
• moonstone/Slider to handle updates to its value prop correctly
• moonstone/ToggleItem to accept HTML DOM node tag names as strings for its component property
• moonstone/Popup to properly pause and resume spotlight when animating
• ui/Transition animation for clip for "up", "left", and "right" directions. This includes a DOM addition to the Transition markup.
• ui/ComponentOverride and ui/ToggleItem to accept HTML DOM node tag names as strings for its component property