package
React hooks and other bindings for messages
npm install @messageformat/reactGitHub-flavored package documentation.
Across all versions, last 30 days.
916 in 30 days
Runtime metadata.
Tagged topics.
Estimated unpacked size across 1 packages.
37.4 kB
Includes dependencies.
An efficient React front-end for message formatting libraries. Designed in particular for use with messageformat, but will work with any messages. Provides the best possible API for a front-end developer, without making the back end any more difficult than it needs to be either. Should add at most about 1kB to your compiled & minified bundle size.
This package was previously named react-message-context.
npm install @messageformat/reactThe library is published as an ES module only, which should work directly with almost all tools and environments that support modern development targeting browser environments.
For tools such as Jest that define their own import methods, you may need to add something like transformIgnorePatterns: ['node_modules/(?!@messageformat/react)'] to your configuration.
<MessageProvider messages [locale] [onError] [pathSep]><Message id [locale] [props] [...msgProps]>useLocales()useMessage(id, [params], [locale])In addition to the examples included below and in the API documentation, see the example for a simple, but fully functional example of using this library along with @messageformat/loader to handle localized messages, with dynamic loading of non-default locales.
Within a MessageProvider, access to the messages is possible using either the Message component, or via custom hooks such as useMessageGetter:
import React from 'react';
import {
Message,
MessageProvider,
useMessageGetter
} from '@messageformat/react';
const messages = {
message: 'Your message is important',
answers: {
sixByNine: ({ base }) => (6 * 9).toString(base),
universe: 42
}
};
function Equality() {
const getAnswer = useMessageGetter('answers');
const foo = getAnswer('sixByNine'
Using MessageProviders within each other allows for multiple simultaneous locales and namespaces, with the outermost acting as a fallback for the inner one:
import React from 'react';
import { Message, MessageProvider } from '@messageformat/react';
export const Example = () => (
<MessageProvider locale="en" messages={{ foo: 'FOO', qux: 'QUX' }}>
<MessageProvider locale="fi" messages={{ foo: 'FÖÖ', bar: 'BÄR' }}>
<ul>
<li>
<Message id="foo" />
</li>
<li>
<
Messageformat is an OpenJS Foundation project, and we follow its Code of Conduct.
useMessageGetter(rootId, [{ baseParams, locale }])