Replace children

[aknuds1]

Fixes #2.

From Jason English:

Hi, I would like to propose the ability to replace all children of an element with a given React component.

Problem

Given this HTML template

<div class="row">
    <div class="col-sm-6">
        <div data-container="wysiwyg">
            <h1>Sample Heading</h1>
            <p>Sample Text</p>
        </div>
    </div>
</div>

I would like to

• a) Preserve the data-container element.
• b) Replace the inner html of data-container with my custom React component.

The current solution is to check the child node's parent. This breaks down as soon as you start having multiple children

Solution

Given a Processing Instruction, you can now set a new property called {boolean} replaceChildren.

This property will tell the parser to add the returned component from processNode as a child of the created React element. The template shown above would become:

<div class="row">
    <div class="col-sm-6">
        <div data-container="wysiwyg">
            <RichTextEditor html={"<h1>Sample heading</h1><p>Sample Text</p>"} />
        </div>
    </div>
</div>

We would love to hear thoughts on this.

[coveralls]

Coverage remained the same at 100.0% when pulling 48bc04b on replace_children into 859415b on master.

[coveralls]

Coverage remained the same at 100.0% when pulling 48bc04b on replace_children into 859415b on master.

[coveralls]

Coverage remained the same at 100.0% when pulling c0b5fd4 on replace_children into 859415b on master.