An Angular integration library for rendering React components inside Angular applications. Provides a bridge component, script loader, and debugging tools for embedding React-based UI within the MemberJunction Angular ecosystem.
npm install @memberjunction/ng-react
This package provides a seamless bridge between Angular and React, allowing React components to be loaded and rendered within Angular templates. It handles React and ReactDOM script loading, Babel transpilation of JSX, component lifecycle management, and two-way communication between the Angular host and React guest.
flowchart TD
subgraph Angular["Angular Host"]
A["MJReactComponent"] -->|Props| B["ReactBridgeService"]
end
subgraph Bridge["Bridge Layer"]
B --> C["ScriptLoaderService"]
C --> D["Load React + ReactDOM + Babel"]
B --> E["AngularAdapterService"]
end
subgraph React["React Guest"]
D --> F["React Component"]
F -->|Events| E
E -->|Callbacks| A
end
style Angular fill:#2d6a9f,stroke:#1a4971,color:#fff
style Bridge fill:#7c5295,stroke:#563a6b,color:#fff
style React fill:#2d8659,stroke:#1a5c3a,color:#fff
import { ReactModule } from '@memberjunction/ng-react';
@NgModule({
imports: [ReactModule]
})
export class YourModule {}
<mj-react-component
[ComponentCode]="reactComponentCode"
[Props]="componentProps"
(ComponentEvent)="handleReactEvent($event)"
(StateChange)="handleStateChange($event)"
(ComponentError)="handleError($event)">
</mj-react-component>
reactComponentCode = `
function MyComponent({ title, onAction }) {
const [count, setCount] = React.useState(0);
return (
<div>
<h2>{title}</h2>
<p>Count: {count}</p>
<button onClick={() => setCount(c => c + 1)}>Increment</button>
<button onClick={() => onAction('submit')}>Submit</button>
</div>
);
}
`;
componentProps = {
title: 'My React Widget',
onAction: (action: string) => console.log('React action:', action)
};
| Component | Selector | Purpose |
|---|---|---|
MJReactComponent |
mj-react-component |
Renders a React component inside Angular |
| Property | Type | Default | Description |
|---|---|---|---|
ComponentCode |
string |
'' |
JSX/React code to transpile and render |
Props |
Record<string, unknown> |
{} |
Props passed to the React component |
EnableDebug |
boolean |
false |
Enable debug logging |
| Event | Type | Description |
|---|---|---|
ComponentEvent |
EventEmitter<ReactComponentEvent> |
Custom events from the React component |
StateChange |
EventEmitter<StateChangeEvent> |
React component state changes |
ComponentError |
EventEmitter<Error> |
Errors during rendering or transpilation |
ComponentReady |
EventEmitter<void> |
React component has mounted |
Hosts that drive a component from outside (an agent operating it through a realtime channel, a toolbar) call the standard component methods on the MJReactComponent instance: InvokeMethod(name, ...args), HasMethod(name), GetCurrentDataState(), Refresh() (the component's own refresh() when it registered one, otherwise a re-render), Print(), validate(), IsDirty(), Reset(), ScrollTo(target) and Focus(target?). Each is a no-op (or undefined/false) until the component has initialized (Initialized fires). A new Component input is a new version: the component reinitializes in place and Initialized fires again.
CapturePDF(orientation = 'portrait', title?) downloads the rendered component as an A4 PDF named <title>_<date>.pdf (the title defaults to the spec's title or name). The artifact viewer offers it from its header as PDF – Portrait / PDF – Landscape.
data-export-control="true" elements (export buttons) are left out.The pieces are exported for reuse: ExportComponentToPDF(element, title, orientation), PlanPdfPages, EnterPrintMode, and BuildImagePdf (a minimal JPEG-per-page PDF writer).
| Service | Purpose |
|---|---|
ScriptLoaderService |
Loads React, ReactDOM, and Babel from CDN with caching |
ReactBridgeService |
Manages React component lifecycle and prop synchronization |
AngularAdapterService |
Provides Angular context (router, DI) to React components |
import { ReactDebugConfig } from '@memberjunction/ng-react';
// Enable verbose logging for development
ReactDebugConfig.enabled = true;
ReactDebugConfig.logLevel = 'verbose';
ScriptLoaderService loads React, ReactDOM, and Babel scripts if not already presentReactBridgeService creates a React root and renders the component into a DOM container