在同构React应用程序中呈现HTML字符串

Question

存在非SPA场景，其中使用已清理但随机的HTML字符串作为输入：

<p>...</p>
<p>...</p>
<gallery image-ids=""/>
<player video-id="..."/>
<p>...</p>

该字符串源自WYSIWYG编辑器，包含嵌套的常规HTML标记和应呈现给窗口小部件的有限数量的自定义元素（组件）。

目前像这样的HTML片段应该分别在服务器端（Express）上呈现，但最终也将作为同构应用程序的一部分在客户端呈现。

我打算使用React（或类似React的框架）来实现组件，因为它可能适合这种情况 - 它是同构的并且很好地呈现部分。

问题是子串就像

<gallery image-ids="[1, 3]"/>

应该成为

<Gallery imageIds={[1, 3]}/>

JSX / TSX组件在某些时候，我不确定什么是正确的方法，但我希望它是一个常见的任务。

如何在React中解决这个问题？

Answer 1

通过解析html字符串并将结果节点转换为React元素，可以将已清理的HTML转换为可在服务器和客户端上运行的React组件。

const React = require('react');
const ReactDOMServer = require('react-dom/server');

const str = `<div>divContent<p> para 1</p><p> para 2</p><gallery image-ids="" /><player video-id="" /><p> para 3</p><gallery image-ids="[1, 3]"/></div>`;


var parse = require('xml-parser');

const Gallery = () => React.createElement('div', null, 'Gallery comp');
const Player = () => React.createElement('div', null, 'Player comp');

const componentMap = {
  gallery: Gallery,
  player: Player
};


const traverse = (cur, props) => {
  return React.createElement(
    componentMap[cur.name] || cur.name,
    props,
    cur.children.length === 0 ? cur.content: Array.prototype.map.call(cur.children, (c, i) => traverse(c, { key: i }))
  );
};

const domTree = parse(str).root;
const App = traverse(
   domTree
);

console.log(
  ReactDOMServer.renderToString(
    App
  )
);

但是请注意，正如您所提到的，您真正需要的不是JSX / TSX，而是React渲染器的React Nodes树（在本例中为ReactDOM）。 JSX只是语法糖，除非你想在你的代码库中维护React输出，否则不需要来回转换它。

请原谅简化的html解析。 它仅用于说明目的。 您可能希望使用更符合规范的库来解析输入html或适合您的用例的内容。

确保客户端软件包获得完全相同的App组件，否则您可能React的客户端脚本将重新创建DOM树，您将失去服务器端呈现的所有好处。

使用上述方法，您也可以利用React 16的流式传输。

解决道具问题

您可以从树中获取道具作为属性，并且可以作为道具传递（仔细考虑您的使用案例）。

const React = require('react');
const ReactDOMServer = require('react-dom/server');

const str = `<div>divContent<p> para 1</p><p> para 2</p><gallery image-ids="" /><player video-id="" /><p> para 3</p><gallery image-ids="[1, 3]"/></div>`;


var parse = require('xml-parser');

const Gallery = props => React.createElement('div', null, `Gallery comp: Props ${JSON.stringify(props)}`);
const Player = () => React.createElement('div', null, 'Player comp');

const componentMap = {
  gallery: Gallery,
  player: Player
};

const attrsToProps = attributes => {
  return Object.keys(attributes).reduce((acc, k) => {

    let val;
    try {
      val = JSON.parse(attributes[k])
    } catch(e) {
      val = null;
    }

    return Object.assign(
      {},
      acc,
      { [ k.replace(/\-/g, '') ]: val }
    );
  }, {});
};


const traverse = (cur, props) => {

  const propsFromAttrs = attrsToProps(cur.attributes);
  const childrenNodes = Array.prototype.map.call(cur.children, (c, i) => {

    return traverse(
      c,
      Object.assign(
        {},
        {
          key: i
        }
      )
    );
  });

  return React.createElement(
    componentMap[cur.name] || cur.name,
      Object.assign(
        {},
        props,
        propsFromAttrs
      ),
    cur.children.length === 0 ? cur.content: childrenNodes
  );
};

const domTree = parse(str).root;
const App = traverse(
  domTree
);

console.log(
  ReactDOMServer.renderToString(
    App
  )
);

但是要注意自定义属性 - 您可能想要遵循此rfc 。 如果可能的话坚持使用camelCase。

Answer 2

您可以使用Babel的API将字符串转换为可执行的JavaScript。

如果你<lovercase>自定义组件约定，你可以让你的生活变得更轻松 ，因为在JSX中它们被视为DOM标签，所以如果你可以让你的用户使用<Gallery>而不是<gallery>你将从很麻烦。

我为你创建了一个工作（但很难看）的CodeSandbox 。 我的想法是使用Babel将JSX编译为代码，然后评估该代码。 但要小心，如果用户可以编辑它，他们肯定会注入恶意代码！

JS代码：

import React from 'react'
import * as Babel from 'babel-standalone'
import { render } from 'react-dom'

console.clear()

const state = {
  code: `
  Hey!
  <Gallery hello="world" />
  Awesome!
`
}


const changeCode = (e) => {
  state.code = e.target.value
  compileCode()
  renderApp()
}

const compileCode = () => {
  const template = `
function _render (React, Gallery) {
  return (
    <div>
    ${state.code}
    </div>
  )
}
`
  state.error = ''
  try {
    const t = Babel.transform(template, {
      presets: ['react']
    })

    state.compiled = new Function(`return (${t.code}).apply(null, arguments);`)(React, Gallery)  
  } catch (err) {
    state.error = err.message
  }
}

const Gallery = ({ hello }) =>
  <div>Here be a gallery: {hello}</div>

const App = () => (
  <div>
    <textarea style={{ width: '100%', display: 'block' }} onChange={changeCode} rows={10} value={state.code}></textarea>
    <div style={{ backgroundColor: '#e0e9ef', padding: 10 }}>
    {state.error ? state.error : state.compiled}
    </div>
  </div>
)


const renderApp = () =>
  render(<App />, document.getElementById('root'));

compileCode()
renderApp()