README
ng2react-builder
This module will help you to migrate Angular 1 project to React.js
Examples
Check my test components to see how this module works. There are:
- Samples of Angular1 templates and controllers
- Generated React components in Typescript (.tsx)
Usage
npm i -D ng2react-builder
via API
import {transform} from 'ng2react-builder';
transform({
directivesToTags: {
/*
Transform <my-icon="card" class="..."/>, <i my-icon="card" class="..."/>, <i data-my-icon="card" class="..."/>
to <MyReactIcon type="card" class="..."/>
*/
'my-icon': {
tagName: 'MyReactIcon',
valueProp: 'type'
}
},
directivesToTextNodes: {
/*
Transform <div i18n="key">...</div>, <div data-i18n="key">...</div>
to <div>{localize(store, 'key')}...</div>
*/
i18n: {
callee: 'localize',
calleeArguments: ['store']
}
},
react: {
typescript: true
},
components: [
{
componentType: 'pure',
componentName: 'TodoComponent',
controller: {
name: 'TodoCtrl',
code: `
export default function TodoCtrl($scope, $routeParams, $filter, store) {
'use strict';
var todos = $scope.todos = store.todos;
$scope.newTodo = '';
$scope.editedTodo = null;
}
`
},
template: {
code: `
<div ng-app="todomvc">
<ng-view></ng-view>
<section class="todoapp">
<header class="header">
<h1>todos</h1>
<form class="todo-form" ng-submit="addTodo()">
<input class="new-todo" placeholder="What needs to be done?" ng-model="newTodo" ng-disabled="saving" autofocus>
</form>
</header>
<section class="main" ng-show="todos.length" ng-cloak>
<input id="toggle-all" class="toggle-all" type="checkbox" ng-model="allChecked"
ng-click="markAll(allChecked)">
<label for="toggle-all">Mark all as complete</label>
<ul class="todo-list">
<li ng-repeat="todo in todos | filter:statusFilter track by $index" ng-class="{completed:
todo.completed, editing: todo == editedTodo}">
<div class="view">
<input class="toggle" type="checkbox" ng-model="todo.completed"
ng-change="toggleCompleted(todo)">
<label ng-dblclick="editTodo(todo)">{{todo.title}}</label>
<button class="destroy" ng-click="removeTodo(todo)"></button>
</div>
<form ng-submit="saveEdits(todo, 'submit')">
<input class="edit" ng-trim="false" ng-model="todo.title" todo-escape="revertEdits(todo)"
ng-blur="saveEdits(todo, 'blur')" todo-focus="todo == editedTodo">
</form>
</li>
</ul>
</section>
<footer class="footer" ng-show="todos.length" ng-cloak>
<span class="todo-count"><strong>{{remainingCount}}</strong>
<ng-pluralize count="remainingCount" when="{ one: 'item left', other: 'items left' }">
</ng-pluralize>
</span>
<ul class="filters">
<li>
<a ng-class="{selected: status == ''} " href="#/">All</a>
</li>
<li>
<a ng-class="{selected: status == 'active'}" href="#/active">Active</a>
</li>
<li>
<a ng-class="{selected: status == 'completed'}" href="#/completed">Completed</a>
</li>
</ul>
<button class="clear-completed" ng-click="clearCompletedTodos()" ng-show="completedCount">
Clear completed
</button>
</footer>
</section>
<footer class="info">
<p>Double-click to edit a todo</p>
<p>Credits:
<a href="http://twitter.com/cburgdorf">Christoph Burgdorf</a>,
<a href="http://ericbidelman.com">Eric Bidelman</a>,
<a href="http://jacobmumm.com">Jacob Mumm</a> and
<a href="http://blog.igorminar.com">Igor Minar</a>
</p>
<p>Part of <a href="http://todomvc.com">TodoMVC</a></p>
</footer>
</div>
`
}
}
]
});
// Result:
[{
code: `
import * as React from 'react';
export interface TodoComponentProps {
[key: string]: any;
}
export interface TodoComponentState {
[key: string]: any;
}
export default class TodoComponent extends React.PureComponent<TodoComponentProps, TodoComponentState> {
constructor(
props: TodoComponentProps,
context?: any /* $scope, $routeParams, $filter, store */
) {
super(props, context);
'use strict';
var todos = $scope.todos = store.todos;
$scope.newTodo = '';
$scope.editedTodo = null;
}
render() {
return (
<div ng-app="todomvc">
<Switch />
<section className="todoapp">
<header className="header">
<h1>todos</h1>
<form className="todo-form" onSubmit={addTodo}>
<input
className="new-todo"
placeholder="What needs to be done?"
ng-model="newTodo"
disabled="saving"
autoFocus=""
/>
</form>
</header>
{todos.length ? (
<section className="main">
<input
id="toggle-all"
className="toggle-all"
type="checkbox"
ng-model="allChecked"
onClick={markAll.bind(this, allChecked)}
/>
<label htmlFor="toggle-all">Mark all as complete</label>
<ul className="todo-list">
{todos.filter(statusFilter).map((todo, index: number) => {
return (
<li
key={\`item-${index}\`}
className="{completed: todo.completed, editing: todo == editedTodo}">
<div className="view">
<input
className="toggle"
type="checkbox"
ng-model="todo.completed"
onChange={toggleCompleted.bind(this, todo)}
/>
<label onDoubleClick={editTodo.bind(this, todo)}>{todo.title}</label>
<button className="destroy" onClick={removeTodo.bind(this, todo)} />
</div>
<form onSubmit={saveEdits.bind(this, todo, 'submit')}>
<input
className="edit"
ng-trim="false"
ng-model="todo.title"
todo-escape="revertEdits(todo)"
onBlur={saveEdits.bind(this, todo, 'blur')}
todo-focus="todo == editedTodo"
/>
</form>
</li>
);
})}
</ul>
</section>
) : null}
{todos.length ? (
<footer className="footer">
<span className="todo-count">
<strong>{remainingCount}</strong>
<ng-pluralize count="remainingCount" when="{ one: 'item left', other: 'items left' }" />
</span>
<ul className="filters">
<li>
<a className="{selected: status == ''} " href="#/">
All
</a>
</li>
<li>
<a className="{selected: status == 'active'}" href="#/active">
Active
</a>
</li>
<li>
<a className="{selected: status == 'completed'}" href="#/completed">
Completed
</a>
</li>
</ul>
{completedCount ? (
<button className="clear-completed" onClick={clearCompletedTodos}>
Clear completed
</button>
) : null}
</footer>
) : null}
</section>
<footer className="info">
<p>Double-click to edit a todo</p>
<p>
Credits:
<a href="http://twitter.com/cburgdorf">Christoph Burgdorf</a>,
<a href="http://ericbidelman.com">Eric Bidelman</a>,
<a href="http://jacobmumm.com">Jacob Mumm</a> and
<a href="http://blog.igorminar.com">Igor Minar</a>
</p>
<p>
Part of <a href="http://todomvc.com">TodoMVC</a>
</p>
</footer>
</div>
);
}
}
`
}]
transform
Method transform takes the next options:
components[required] - list of components options[ { componentName: string, // React component name componentType?: 'pure' | 'stateless' | 'stateful', // Default is 'pure' // Angular template options template?: { code: string // template's code }, // Angular Controller options controller?: { name: string, // controller's name code: string // controller's code } } ]directivesToTags[optional] - directives (custom tag names and attributes) that you want to transform to JSX tags.directivesToTextNodes[optional] - directives (** only attributes**) that you want to transform to child text nodes tags.react[optional] - React component options{ typescript?: boolean; // output should be in Typescript. Default is false prettier?: string; // Prettier config - https://prettier.io/docs/en/options.html }