frint-react
Advanced tools
React package for Frint
With npm:
$ npm install --save react react-dom prop-types frint-react
Via unpkg CDN:
<script src="https://cdnjs.cloudflare.com/ajax/libs/lodash.js/4.17.4/lodash.min.js"></script>
<script src="https://cdnjs.cloudflare.com/ajax/libs/rxjs/5.5.0/Rx.min.js"></script>
<script src="https://cdnjs.cloudflare.com/ajax/libs/react/15.5.4/react.min.js"></script>
<script src="https://cdnjs.cloudflare.com/ajax/libs/react/15.5.4/react-dom.min.js"></script>
<script src="https://unpkg.com/prop-types@15.5.10/prop-types.js"></script>
<script src="https://unpkg.com/frint@latest/dist/frint.min.js"></script>
<script src="https://unpkg.com/frint-react@latest/dist/frint-react.min.js"></script>
<script>
// available as `window.FrintReact`
</script>
React:
JSX: Syntatic sugar for writing JS in XML-like syntax.
HyperScript: The function used in transpiled JSX code.Component: React Components.Container: Higher-Order Component, to pass down props to dumb components.Reactive programming:
Frint:
Region: Component that can be embedded anywhereWe start by importing the necessary functions from the library:
import React from 'react';
import { createApp } from 'frint';
import { render } from 'frint-react';
Now let's create our first Component:
function Root() {
return (
<div>
<p>Hello World</p>
</div>
);
}
Now we need to create our Root App, and assign the previously defined Component as our root component for the App:
const RootApp = createApp({
name: 'MyRootApp',
providers: [
{
name: 'component',
useValue: Root
}
]
});
Now that we have everything ready, we can instantiate our app, and render it:
window.app = new RootApp();
render(window.app, document.getElementById('root'));
The code above asumes your page has an element with an id root:
<!DOCTYPE html>
<html>
<body>
<div id="root"></div>
</body>
</html>
The library already ships with a Region component, and a RegionService.
We use the concept of regions for defining areas in our Components, where other Apps can load themselves in.
For example, imagine the Root component of our Root App above, we can define a Region named sidebar as follows:
import React from 'react';
import { Region } from 'frint-react';
function Root() {
return (
<div>
<p>Hello World from Root App!</p>
<Region name="sidebar" />
</div>
);
}
That's just defining the Region only. Let's now create an App, and assign it to the sidebar region:
import { createApp } from 'frint';
function AppComponent() {
return (
<p>I am App</p>
);
}
const App = createApp({
name: 'MyApp',
providers: [
{
name: 'component',
useValue: AppComponent,
}
],
});
Now that we have our App defined, we can register it to our Root App:
window.app.registerApp(App, {
regions: ['sidebar'], // name of regions to target
weight: 10, // the lower the number, the higher they would appear
});
Now when you refresh your browser, you would notice your App being rendered inside the Region sidebar.
It is possible that when defining the Region with a name, you would also want to pass some data to it, so that whenever an App gets rendered inside it, the App would be able to access that data.
From the above example of sidebar Region, imagine us passing some data too via props:
function Root() {
const data = {
foo: 'bar'
};
return (
<div>
<p>Hello World from Root App!</p>
<Region name="sidebar" data={data} />
</div>
);
}
That's only the Region component's implementation part. How do we access it from our App now?
Enter RegionService. This is a Service that we can pass in our App's providers list, allowing us to later have access to Region's props.
import { RegionService } from 'frint-react';
const App = createApp({
name: 'MyApp',
providers: [
{
name: 'component',
useValue: AppComponent,
},
{
name: 'region',
useClass: RegionService, // `useClass` because `RegionService` will be instantiated
},
],
});
Once your App is registered and rendered, you can get access to your App instance, which can then allow you to deal with Region's props:
const myApp = window.app.getAppInstance('MyApp');
const region = myApp.get('region');
// Region's data as an Observable
const regionData$ = region.getData$();
regionData$.subscribe((data) => {
console.log(data); // { foo: 'bar' }
});
We will discuss more in details how to get Region's props in your App's components via observe in the next section.
You can also use take data or other props passed to the Region as render prop:
function Root() {
const data = {
foo: 'bar'
};
return (
<div>
<p>Hello World from Root App!</p>
<Region data={data} name="sidebar">
{(list, props) => list.map(({ Component }) => (
<Component foo={props.data.foo} />
))}
</Region>
</div>
);
}
We encourage everyone to write their components in as dumb way as possible. Meaning, we just pass the props, and Components just render them. Nothing more.
But real-world applications are complex, and data can come from anywhere, at any time, asynchronously.
Enter observe. This is a function that we ship with the library for making your Components reactive.
A very simple example would be:
function MyComponent(props) {
return (
<p>Interval: {props.interval}</p>
);
}
We just created a component, that prints out a prop called interval. Nothing fancy there. But we wish the interval to update itself every second. Instead of handling it from within the Component, we can do it with observe as follows:
import { interval } from 'rxjs/observable/interval';
import { map } from 'rxjs/operators/map';
import { observe } from 'frint-react';
const MyObservedComponent = observe(function () {
const interval$ = interval(1000); // emits an integer every 1 second
return interval$
.pipe(
map(x => ({ interval: x })) // map the integer to a props-compatible object
);
})(MyComponent);
We have just made our simple Component reactive, by wrapping it with observe. Now it will continue to update the interval prop every second until the Component has unmounted itself.
In previous example, we showed you how to access Region's data via RegionService. Now let's see how we can pass it to your App's component too.
All Region props but children and className are forwarded to the App's component by default. However, if you prefer a reactive approach:
import { map } from 'rxjs/operators/map';
import { merge } from 'rxjs/operators/merge';
import { scan } from 'rxjs/operators/scan';
const ObservedAppComponent = observe(function (app, props$) {
// `app` is your App instance
// `props$` is an Observable of props being passed by parent Component (if any)
// let's keep our first interval Observable too
const interval$ = interval(1000)
.pipe(
map(x => ({ interval: x }))
);
const region = app.get('region'); // the RegionService instance
const regionData$ = region.getData$()
.pipe(
map(regionData => ({ regionData: regionData }))
);
// now we have two observables, `interval$` and `regionData$`.
// we need to merge them both into a single props-compatible object:
return interval$
.pipe(
merge(regionData$),
scan((props, emitted) => {
return {
...props,
...emitted,
};
}, {})
);
})(AppComponent);
When your App's component renders, latest props will be passed to it in this structure:
{
// will keep updating every second,
interval: 1,
// will update whenever sidebar Region's props change
regionData: {
foo: 'bar'
}
}
As the number of observables grow, it might be difficult to maintain your observe implementation. That's why we are also shipping a streamProps function in the library to make it easier for you:
import { interval } from 'rxjs/observable/interval';
import { streamProps } from 'frint-react';
const MyObservedComponent = observe(function (app) {
return streamProps({}) // start streaming with a default plain object
// interval
.set(
interval(1000),
x => ({ interval: x }),
)
// region data
.set(
app.get('region').getData$(),
regionData => ({ regionData })
)
// plain object
.set({
key: 'value'
})
// key/value pairs
.set('myKey', 'myValue')
// return everything as a single merged Observable
.get$();
})(AppComponent);
The props available inside your Component would then be in this format:
{
interval: 1,
regionData: { foo: 'bar' },
key: 'value',
myKey: 'myValue'
}
This is a use case where you have multiple instances of Region with the same name mounted in the DOM. And the apps rendered in them should have their own independent scoped instances too.
Think of a scenario where you have a TodoList, and you want a Region defined for each Todo item:
function MyComponent() {
const todos = [
{ id: '1', title: 'First todo' },
{ id: '2', title: 'Second todo' },
{ id: '3', title: 'Third todo' },
];
return (
<ul>
{todos.map((todo) => {
return (
<li>
<h3>{todo.title}</h3>
<Region
name="todo-item"
data={{ todo }}
uniqueKey={`todo-item-${todo.id}`}
/>
</li>
);
})}
</ul>
);
}
Now we may have an App that we want to be rendered in todo-item Regions.
Let's create an App, that will receive the todo object, and render the title in UPPERCASE format.
import React from 'react';
import { createApp } from 'frint';
import { observe, RegionService } from 'frint-react';
function AppComponent(props) {
const { todo } = props;
return (
<p>Todo in upper case: {todo.title.toUpperCase()}</p>
);
}
const ObservedAppComponent = observe(function (app) {
return streamProps()
.set(
app.get('region').getData$(),
data => ({ todo: data.todo })
)
.get$();
})(AppComponent);
const App = createApp({
name: 'MyApp',
providers: [
{
name: 'component',
useValue: ObservedAppComponent
},
{
name: 'region',
useClass: RegionService
}
]
});
Now comes the part of registering our App as a multi-instance app:
window.app.registerApp(App, {
regions: ['todo-item'],
// this tells Root App to treat this app as a multi-instance one
multi: true,
});
render(app, node)
Renders a Root App in target DOM node.
app (App): The Root App instance.node (Element): The DOM Element where you want your App to render.hydrate(app, node)
Hydrates a Root App in target DOM node.
observe(fn)(MyComponent)
fn (Function): The function returning an Observable.
fn accepts two arguments:
app: the instance of your Root App or the App in scopeprops$: an Observable of props being passed by parent component (if any)Observable or ObjectFunction: that can be called with a Component to return an observed Component ready for embedding and rendering anywhere.
Region
The Region component.
name (String): The name of the Regiondata (Object): Data to be made available to rendered Appchildren (Function [optional]): Render prop function to render region component with passed props.uniqueKey (String [optional]): Used when there are multiple Regions of the same name. It prop must be unique and fixed throughout the whole app.className (String [optional]): The className used by Region wrapper elementExported from frint-component-handlers.
Exported from frint-component-utils.
ReactHandler
Handler for React, according to the spec defined in frint-component-utils.
FAQs
React package for Frint
The npm package frint-react receives a total of 93 weekly downloads. As such, frint-react popularity was classified as not popular.
We found that frint-react demonstrated a not healthy version release cadence and project activity because the last version was released a year ago. It has 9 open source maintainers collaborating on the project.
Did you know?
Socket for GitHub automatically highlights issues in each pull request and monitors the health of all your open source dependencies. Discover the contents of your packages and block harmful activity before you install or update your dependencies.
Security News
Research
Socket researchers have discovered malicious npm packages targeting crypto developers, stealing credentials and wallet data using spyware delivered through typosquats of popular cryptographic libraries.
Security News
Socket's package search now displays weekly downloads for npm packages, helping developers quickly assess popularity and make more informed decisions.
Security News
A Stanford study reveals 9.5% of engineers contribute almost nothing, costing tech $90B annually, with remote work fueling the rise of "ghost engineers."