mirror of
https://github.com/bobwen-dev/react-templates
synced 2025-04-12 00:56:39 +02:00
440 lines
18 KiB
JavaScript
440 lines
18 KiB
JavaScript
/**
|
|
* Created by avim on 11/9/2014.
|
|
*/
|
|
'use strict';
|
|
var cheerio = require('cheerio');
|
|
var _ = require('lodash');
|
|
var esprima = require('esprima');
|
|
var escodegen = require('escodegen');
|
|
var reactDOMSupport = require('./reactDOMSupport');
|
|
var stringUtils = require('./stringUtils');
|
|
var rtError = require('./RTCodeError');
|
|
var RTCodeError = rtError.RTCodeError;
|
|
|
|
var repeatTemplate = _.template('_.map(<%= collection %>,<%= repeatFunction %>.bind(<%= repeatBinds %>))');
|
|
var ifTemplate = _.template('((<%= condition %>)?(<%= body %>):null)');
|
|
var propsTemplate = _.template('_.merge({}, <%= generatedProps %>, <%= rtProps %>)');
|
|
var classSetTemplate = _.template('React.addons.classSet(<%= classSet %>)');
|
|
var simpleTagTemplate = _.template('<%= name %>(<%= props %><%= children %>)');
|
|
var tagTemplate = _.template('<%= name %>.apply(this,_.flatten([<%= props %><%= children %>]))');
|
|
var simpleTagTemplateCreateElement = _.template('React.createElement(<%= name %>,<%= props %><%= children %>)');
|
|
var tagTemplateCreateElement = _.template('React.createElement.apply(this,_.flatten([<%= name %>,<%= props %><%= children %>]))');
|
|
var commentTemplate = _.template(' /* <%= data %> */ ');
|
|
var templateAMDTemplate = _.template("define(<%= name ? '\"'+name + '\", ' : '' %>[<%= requirePaths %>], function (<%= requireNames %>) {\n'use strict';\n <%= injectedFunctions %>\nreturn function(){ return <%= body %>};\n});");
|
|
var templateCommonJSTemplate = _.template("'use strict';\n<%= vars %>\n\n<%= injectedFunctions %>\nmodule.exports = function(){ return <%= body %>};\n");
|
|
var templatePJSTemplate = _.template('var <%= name %> = function () {\n' +
|
|
'<%= injectedFunctions %>\n' +
|
|
'return <%= body %>\n' +
|
|
'};\n');
|
|
var templateTypescriptTemplate = _.template("<%= vars %>\n\n<%= injectedFunctions %>\nvar fn = function() { return <%= body %> };\nexport = fn\n");
|
|
var htmlSelfClosingTags = ['area', 'base', 'br', 'col', 'command', 'embed', 'hr', 'img', 'input', 'keygen', 'link', 'meta', 'param', 'source', 'track', 'wbr'];
|
|
|
|
var templateProp = 'rt-repeat';
|
|
var ifProp = 'rt-if';
|
|
var classSetProp = 'rt-class';
|
|
var scopeProp = 'rt-scope';
|
|
var propsProp = 'rt-props';
|
|
|
|
var defaultOptions = {modules: 'amd', version: false, force: false, format: 'stylish', targetVersion: '0.12.2'};
|
|
|
|
/**
|
|
* @param context
|
|
* @return {boolean}
|
|
*/
|
|
function shouldUseCreateElement(context) {
|
|
switch (context.options.targetVersion) {
|
|
case '0.11.2':
|
|
case '0.11.1':
|
|
case '0.11.0':
|
|
case '0.10.0':
|
|
return false;
|
|
default:
|
|
return true;
|
|
}
|
|
}
|
|
|
|
var reactSupportedAttributes = ['accept', 'acceptCharset', 'accessKey', 'action', 'allowFullScreen', 'allowTransparency', 'alt', 'async', 'autoComplete', 'autoPlay', 'cellPadding', 'cellSpacing', 'charSet', 'checked', 'classID', 'className', 'cols', 'colSpan', 'content', 'contentEditable', 'contextMenu', 'controls', 'coords', 'crossOrigin', 'data', 'dateTime', 'defer', 'dir', 'disabled', 'download', 'draggable', 'encType', 'form', 'formNoValidate', 'frameBorder', 'height', 'hidden', 'href', 'hrefLang', 'htmlFor', 'httpEquiv', 'icon', 'id', 'label', 'lang', 'list', 'loop', 'manifest', 'max', 'maxLength', 'media', 'mediaGroup', 'method', 'min', 'multiple', 'muted', 'name', 'noValidate', 'open', 'pattern', 'placeholder', 'poster', 'preload', 'radioGroup', 'readOnly', 'rel', 'required', 'role', 'rows', 'rowSpan', 'sandbox', 'scope', 'scrolling', 'seamless', 'selected', 'shape', 'size', 'sizes', 'span', 'spellCheck', 'src', 'srcDoc', 'srcSet', 'start', 'step', 'style', 'tabIndex', 'target', 'title', 'type', 'useMap', 'value', 'width', 'wmode'];
|
|
var attributesMapping = {'class': 'className', 'rt-class': 'className'};
|
|
_.forEach(reactSupportedAttributes, function (attributeReactName) {
|
|
if (attributeReactName !== attributeReactName.toLowerCase()) {
|
|
attributesMapping[attributeReactName.toLowerCase()] = attributeReactName;
|
|
}
|
|
});
|
|
|
|
/**
|
|
* @param children
|
|
* @return {string}
|
|
*/
|
|
function concatChildren(children) {
|
|
var res = '';
|
|
_.forEach(children, function (child) {
|
|
if (child && child.indexOf(' /*') !== 0 ) {
|
|
res += ',' + child;
|
|
} else {
|
|
res += child;
|
|
}
|
|
}, this);
|
|
return res;
|
|
}
|
|
|
|
/**
|
|
* @const
|
|
*/
|
|
var curlyMap = {'{': 1, '}': -1};
|
|
|
|
/**
|
|
* @param node
|
|
* @param context
|
|
* @param {string} txt
|
|
* @return {string}
|
|
*/
|
|
function convertText(node, context, txt) {
|
|
var res = '';
|
|
var first = true;
|
|
var concatChar = node.type === 'text' ? ',' : '+';
|
|
while (txt.indexOf('{') !== -1) {
|
|
var start = txt.indexOf('{');
|
|
var pre = txt.substr(0, start);
|
|
if (pre) {
|
|
res += (first ? '' : concatChar) + JSON.stringify(pre);
|
|
first = false;
|
|
}
|
|
var curlyCounter = 1;
|
|
var end;
|
|
for (end = start + 1; end < txt.length && curlyCounter > 0; end++) {
|
|
curlyCounter += curlyMap[txt.charAt(end)] || 0;
|
|
}
|
|
if (curlyCounter !== 0) {
|
|
throw RTCodeError.build("Failed to parse text '" + txt + "'", context, node);
|
|
} else {
|
|
var needsParens = start !== 0 || end !== txt.length - 1;
|
|
res += (first ? '' : concatChar) + (needsParens ? '(' : '') + txt.substr(start + 1, end - start - 2) + (needsParens ? ')' : '');
|
|
first = false;
|
|
txt = txt.substr(end);
|
|
}
|
|
}
|
|
if (txt) {
|
|
res += (first ? '' : concatChar) + JSON.stringify(txt);
|
|
}
|
|
if (res === '') {
|
|
res = 'true';
|
|
}
|
|
|
|
//validateJS(res, node, context);
|
|
return res;
|
|
}
|
|
|
|
/**
|
|
* @param {string} txt
|
|
* @return {boolean}
|
|
*/
|
|
function isStringOnlyCode(txt) {
|
|
txt = txt.trim();
|
|
return txt.length && txt.charAt(0) === '{' && txt.charAt(txt.length - 1) === '}';
|
|
}
|
|
|
|
function generateInjectedFunc(context, namePrefix, body, params) {
|
|
params = params || context.boundParams;
|
|
var generatedFuncName = namePrefix.replace(',', '') + (context.injectedFunctions.length + 1);
|
|
var funcText = 'function ' + generatedFuncName + '(' + params.join(',');
|
|
funcText += ') {\n' + body + '\n}\n';
|
|
context.injectedFunctions.push(funcText);
|
|
return generatedFuncName;
|
|
}
|
|
|
|
function generateProps(node, context) {
|
|
// console.log(node);
|
|
var props = {};
|
|
_.forOwn(node.attribs, function (val, key) {
|
|
var propKey = attributesMapping[key.toLowerCase()] || key;
|
|
if (props.hasOwnProperty(propKey)) {
|
|
throw RTCodeError.build('duplicate definition of ' + propKey + ' ' + JSON.stringify(node.attribs), context, node);
|
|
}
|
|
if (key.indexOf('on') === 0 && !isStringOnlyCode(val)) {
|
|
var funcParts = val.split('=>');
|
|
if (funcParts.length !== 2) {
|
|
throw RTCodeError.build("when using 'on' events, use lambda '(p1,p2)=>body' notation or use {} to return a callback function. error: [" + key + "='" + val + "']", context, node);
|
|
}
|
|
var evtParams = funcParts[0].replace('(', '').replace(')', '').trim();
|
|
var funcBody = funcParts[1].trim();
|
|
var params = context.boundParams;
|
|
if (evtParams.trim() !== '') {
|
|
params = params.concat([evtParams.trim()]);
|
|
}
|
|
var generatedFuncName = generateInjectedFunc(context, key, funcBody, params);
|
|
props[propKey] = generatedFuncName + '.bind(' + (['this'].concat(context.boundParams)).join(',') + ')';
|
|
} else if (key === 'style' && !isStringOnlyCode(val)) {
|
|
var styleParts = val.trim().split(';');
|
|
styleParts = _.compact(_.map(styleParts, function (str) {
|
|
str = str.trim();
|
|
if (!str || str.indexOf(':') === -1) {
|
|
return null;
|
|
}
|
|
var res = str.split(':');
|
|
res[0] = res[0].trim();
|
|
res[1] = res.slice(1).join(':').trim();
|
|
return res;
|
|
}));
|
|
var styleArray = [];
|
|
_.forEach(styleParts, function (stylePart) {
|
|
styleArray.push(stringUtils.convertToCamelCase(stylePart[0]) + ' : ' + convertText(node, context, stylePart[1].trim()));
|
|
});
|
|
props[propKey] = '{' + styleArray.join(',') + '}';
|
|
} else if (key === classSetProp) {
|
|
props[propKey] = classSetTemplate({classSet: val});
|
|
} else if (key.indexOf('rt-') !== 0) {
|
|
props[propKey] = convertText(node, context, val.trim());
|
|
}
|
|
});
|
|
|
|
return '{' + _.map(props, function (val, key) {
|
|
return JSON.stringify(key) + ' : ' + val;
|
|
}).join(',') + '}';
|
|
}
|
|
|
|
function convertTagNameToConstructor(tagName, context) {
|
|
var isHtmlTag = _.contains(reactDOMSupport[context.options.targetVersion], tagName);
|
|
if (shouldUseCreateElement(context)) {
|
|
isHtmlTag = isHtmlTag || tagName.match(/^\w+(-\w+)$/);
|
|
return isHtmlTag ? "'" + tagName + "'" : tagName;
|
|
}
|
|
return isHtmlTag ? 'React.DOM.' + tagName : tagName;
|
|
}
|
|
|
|
function defaultContext(html, options) {
|
|
return {
|
|
boundParams: [],
|
|
injectedFunctions: [],
|
|
html: html,
|
|
options: options
|
|
};
|
|
}
|
|
|
|
function hasNonSimpleChildren(node) {
|
|
return _.any(node.children, function (child) {
|
|
return child.type === 'tag' && child.attribs[templateProp];
|
|
});
|
|
}
|
|
|
|
function convertHtmlToReact(node, context) {
|
|
if (node.type === 'tag' || node.type === 'style') {
|
|
context = {
|
|
boundParams: _.clone(context.boundParams),
|
|
injectedFunctions: context.injectedFunctions,
|
|
html: context.html,
|
|
options: context.options
|
|
};
|
|
|
|
var data = {name: convertTagNameToConstructor(node.name, context)};
|
|
if (node.attribs[scopeProp]) {
|
|
data.scopeMapping = {};
|
|
data.scopeName = '';
|
|
_.each(context.boundParams, function (boundParam) {
|
|
data.scopeMapping[boundParam] = boundParam;
|
|
});
|
|
_.each(node.attribs[scopeProp].split(';'), function (scopePart) {
|
|
var scopeSubParts = scopePart.split(' as ');
|
|
if (scopeSubParts.length < 2) {
|
|
throw RTCodeError.build("invalid scope part '" + scopePart + "'", context, node);
|
|
}
|
|
var scopeName = scopeSubParts[1].trim();
|
|
validateJS(scopeName, node, context);
|
|
stringUtils.addIfNotThere(context.boundParams, scopeName);
|
|
data.scopeName += stringUtils.capitalize(scopeName);
|
|
data.scopeMapping[scopeName] = scopeSubParts[0].trim();
|
|
validateJS(data.scopeMapping[scopeName], node, context);
|
|
});
|
|
}
|
|
|
|
if (node.attribs[templateProp]) {
|
|
var arr = node.attribs[templateProp].split(' in ');
|
|
if (arr.length !== 2) {
|
|
throw RTCodeError.build("rt-repeat invalid 'in' expression '" + node.attribs[templateProp] + "'", context, node);
|
|
}
|
|
data.item = arr[0].trim();
|
|
data.collection = arr[1].trim();
|
|
validateJS(data.item, node, context);
|
|
validateJS(data.collection, node, context);
|
|
stringUtils.addIfNotThere(context.boundParams, data.item);
|
|
stringUtils.addIfNotThere(context.boundParams, data.item + 'Index');
|
|
}
|
|
data.props = generateProps(node, context);
|
|
if (node.attribs[propsProp]) {
|
|
data.props = propsTemplate({generatedProps: data.props, rtProps: node.attribs[propsProp]});
|
|
}
|
|
if (node.attribs[ifProp]) {
|
|
data.condition = node.attribs[ifProp].trim();
|
|
}
|
|
data.children = node.children ? concatChildren(_.map(node.children, function (child) {
|
|
var code = convertHtmlToReact(child, context);
|
|
validateJS(code, child, context);
|
|
return code;
|
|
})) : '';
|
|
|
|
if (hasNonSimpleChildren(node)) {
|
|
data.body = shouldUseCreateElement(context) ? tagTemplateCreateElement(data) : tagTemplate(data);
|
|
} else {
|
|
data.body = shouldUseCreateElement(context) ? simpleTagTemplateCreateElement(data) : simpleTagTemplate(data);
|
|
}
|
|
|
|
if (node.attribs[templateProp]) {
|
|
data.repeatFunction = generateInjectedFunc(context, 'repeat' + stringUtils.capitalize(data.item), 'return ' + data.body);
|
|
data.repeatBinds = ['this'].concat(_.reject(context.boundParams, function (param) {
|
|
return (param === data.item || param === data.item + 'Index');
|
|
}));
|
|
data.body = repeatTemplate(data);
|
|
}
|
|
if (node.attribs[ifProp]) {
|
|
data.body = ifTemplate(data);
|
|
}
|
|
if (node.attribs[scopeProp]) {
|
|
var generatedFuncName = generateInjectedFunc(context, 'scope' + data.scopeName, 'return ' + data.body, _.keys(data.scopeMapping));
|
|
data.body = generatedFuncName + '.apply(this, [' + _.values(data.scopeMapping).join(',') + '])';
|
|
}
|
|
return data.body;
|
|
} else if (node.type === 'comment') {
|
|
return (commentTemplate(node));
|
|
} else if (node.type === 'text') {
|
|
if (node.data.trim()) {
|
|
return convertText(node, context, node.data);
|
|
}
|
|
return '';
|
|
}
|
|
}
|
|
|
|
//function removeDocType(html) {
|
|
// html = html.replace(/^\s*\<\!doctype\s+rt\s*>/mi, function () {
|
|
// return '';
|
|
// });
|
|
// return html;
|
|
//}
|
|
function isTag(node) {
|
|
return node.type === 'tag';
|
|
}
|
|
|
|
function handleSelfClosingHtmlTags(nodes) {
|
|
return _(nodes)
|
|
.map(function (node) {
|
|
var externalNodes = [];
|
|
node.children = handleSelfClosingHtmlTags(node.children);
|
|
if (node.type === 'tag' && _.contains(htmlSelfClosingTags, node.name)) {
|
|
externalNodes = _.filter(node.children, isTag);
|
|
_.forEach(externalNodes, function (child) {
|
|
child.parent = node;
|
|
});
|
|
node.children = _.reject(node.children, isTag);
|
|
}
|
|
return [node].concat(externalNodes);
|
|
})
|
|
.flatten()
|
|
.value();
|
|
}
|
|
|
|
/**
|
|
* @param {string} html
|
|
* @param {{modules:string}?} options
|
|
* @return {string}
|
|
*/
|
|
function convertTemplateToReact(html, options) {
|
|
var rootNode = cheerio.load(html, {lowerCaseTags: false, lowerCaseAttributeNames: false, xmlMode: true, withStartIndices: true});
|
|
options = _.defaults({}, options, defaultOptions);
|
|
var defines = {'react/addons': 'React', lodash: '_'};
|
|
var context = defaultContext(html, options);
|
|
var rootTags = _.filter(rootNode.root()[0].children, {type: 'tag'});
|
|
rootTags = handleSelfClosingHtmlTags(rootTags);
|
|
if (!rootTags || rootTags.length === 0) {
|
|
throw new RTCodeError('Document should have a root element');
|
|
}
|
|
var firstTag = null;
|
|
_.forEach(rootTags, function (tag) {
|
|
if (tag.name === 'rt-require') {
|
|
if (!tag.attribs.dependency || !tag.attribs.as) {
|
|
throw RTCodeError.build("rt-require needs 'dependency' and 'as' attributes", context, tag);
|
|
} else if (tag.children.length) {
|
|
throw RTCodeError.build('rt-require may have no children', context, tag);
|
|
} else {
|
|
if (options.modules !== 'typescript') {
|
|
defines[tag.attribs.dependency] = tag.attribs.as;
|
|
}
|
|
else {
|
|
defines['./'+tag.attribs.dependency] = tag.attribs.as;
|
|
}
|
|
}
|
|
} else if (firstTag === null) {
|
|
firstTag = tag;
|
|
} else {
|
|
throw RTCodeError.build('Document should have no more than a single root element', context, tag);
|
|
}
|
|
});
|
|
if (firstTag === null) {
|
|
throw RTCodeError.build('Document should have a single root element', context, rootNode.root()[0]);
|
|
}
|
|
var body = convertHtmlToReact(firstTag, context);
|
|
var requirePaths = _(defines).keys().map(function (reqName) { return '"' + reqName + '"'; }).value().join(',');
|
|
var requireVars = _(defines).values().value().join(',');
|
|
var vars;
|
|
if (options.modules !== 'typescript') {
|
|
vars = _(defines).map(function (reqVar, reqPath) { return 'var ' + reqVar + " = require('" + reqPath + "');"; }).join('\n');
|
|
}
|
|
else {
|
|
vars = _(defines).map(function (reqVar, reqPath) { return 'import ' + reqVar + " = require('" + reqPath + "');"; }).join('\n');
|
|
}
|
|
var data = {body: body, injectedFunctions: '', requireNames: requireVars, requirePaths: requirePaths, vars: vars, name: options.name};
|
|
data.injectedFunctions = context.injectedFunctions.join('\n');
|
|
var code = generate(data, options);
|
|
if (options.modules !== 'typescript') {
|
|
try {
|
|
var tree = esprima.parse( code, {range: true, tokens: true, comment: true} );
|
|
tree = escodegen.attachComments( tree, tree.comments, tree.tokens );
|
|
code = escodegen.generate( tree, {comment: true} );
|
|
}
|
|
catch ( e ) {
|
|
throw new RTCodeError( e.message, e.index, -1 );
|
|
}
|
|
}
|
|
return code;
|
|
}
|
|
|
|
function generate(data, options) {
|
|
if (options.modules === 'amd') {
|
|
return templateAMDTemplate(data);
|
|
}
|
|
if (options.modules === 'commonjs') {
|
|
return templateCommonJSTemplate(data);
|
|
}
|
|
if (options.modules === 'typescript') {
|
|
return templateTypescriptTemplate(data);
|
|
}
|
|
return templatePJSTemplate(data);
|
|
}
|
|
|
|
/**
|
|
* @param {string} code
|
|
* @param node
|
|
* @param context
|
|
*/
|
|
function validateJS(code, node, context) {
|
|
try {
|
|
esprima.parse(code);
|
|
} catch (e) {
|
|
throw RTCodeError.build(e.description, context, node);
|
|
}
|
|
}
|
|
|
|
/**
|
|
* @param {string} name
|
|
* @return {string}
|
|
*/
|
|
function normalizeName(name) {
|
|
return name.replace(/-/g, '_');
|
|
}
|
|
|
|
module.exports = {
|
|
convertTemplateToReact: convertTemplateToReact,
|
|
RTCodeError: RTCodeError,
|
|
normalizeName: normalizeName,
|
|
_test: {
|
|
convertText: convertText
|
|
}
|
|
};
|