react-interpolate-component
v0.12.0
Published
A component for React that renders elements into a format string containing replacement fields
Downloads
17,083
Maintainers
Readme
React Interpolate Component
A component for React that renders elements into a format string containing replacement fields. It comes in handy when working with dynamic text elements like localized strings of a translation library.
Installation
Install via npm:
% npm install react-interpolate-component
Usage
The Interpolate component expects as only child a format string containing the placeholders to be interpolated. Like the format syntax of sprintf
with named arguments, a placeholder is depicted as '%(' + placeholder_name + ')s'
.
The actual substitution elements are provided via the with
prop. Values can be strings, numbers, dates, and even React components.
Here is a small exemplification:
var React = require('react');
var Interpolate = require('react-interpolate-component');
class MyApp extends React.Component {
render() {
const props = {
with: {
firstName: <strong>Paul</strong>,
age: 13,
unit: 'years'
},
component: 'p', // default is a <span>
className: 'foo'
};
return (
<div>
<Interpolate {...props}>
%(firstName)s is %(age)s %(unit)s old.
</Interpolate>
</div>
);
}
}
The MyApp component shown above renders the following (simplified) HTML:
<div>
<p class="foo">
<strong>Paul</strong> is 13 years old.
</p>
</div>
All props that are not interpolation arguments get transferred to Interpolate's container component (which is a <span>
by default).
Alternatively to providing the format string as child, you can also set the format
prop to the desired format:
<Interpolate with={{ name: "Martin" }} format="Hello, %(name)s!" />
For security reasons, all HTML markup present in the format string will be escaped. You can undermine this by providing a prop named "unsafe" which is set to true
. There's one caveat when allowing unsafe format strings: You cannot use other React components as interpolation values.
Example
The examples code is located at example
directory. You can clone this repository and run make install example
and point your web browser to
http://localhost:3000
.
Contributing
Here's a quick guide:
Fork the repo and
make install
.Run the tests. We only take pull requests with passing tests, and it's great to know that you have a clean slate:
make test
.Add a test for your change. Only refactoring and documentation changes require no new tests. If you are adding functionality or are fixing a bug, we need a test!
Make the test pass.
Push to your fork and submit a pull request.
Licence
Released under The MIT License.