html-react-parser 4.0.0 → 4.1.0

package/README.md

@@ -38,6 +38,7 @@ parse('<p>Hello, World!</p>'); // React.createElement('p', {}, 'Hello, World!')
     - [replace element and children](#replace-element-and-children)
     - [replace element attributes](#replace-element-attributes)
     - [replace and remove element](#replace-and-remove-element)
+  - [transform](#transform)
   - [library](#library)
   - [htmlparser2](#htmlparser2)
   - [trim](#trim)
@@ -303,6 +304,21 @@ HTML output:
 <p></p>
 ```
 
+### transform
+
+The `transform` option allows you to transform each element individually after it's parsed.
+
+The `transform` callback's first argument is the React element:
+
+```jsx
+parse('<br>', {
+  transform: (reactNode, domNode, index) => {
+    // this will wrap every element in a div
+    return <div>{reactNode}</div>;
+  }
+});
+```
+
 ### library
 
 The `library` option specifies the UI library. The default library is **React**.

package/dist/html-react-parser.js

@@ -2398,13 +2398,18 @@
 	  return !elementsWithNoTextChildren.has(node.name);
 	}
 
+	function returnFirstArg(arg) {
+	  return arg;
+	}
+
 	var utilities$2 = {
 	  PRESERVE_CUSTOM_ATTRIBUTES: PRESERVE_CUSTOM_ATTRIBUTES,
 	  invertObject: invertObject,
 	  isCustomComponent: isCustomComponent,
 	  setStyleProp: setStyleProp$1,
 	  canTextBeChildOfNode: canTextBeChildOfNode$1,
-	  elementsWithNoTextChildren: elementsWithNoTextChildren
+	  elementsWithNoTextChildren: elementsWithNoTextChildren,
+	  returnFirstArg: returnFirstArg
 	};
 
 	var reactProperty = lib;
@@ -2513,6 +2518,7 @@
 	 * @param {DomElement[]} nodes - DOM nodes.
 	 * @param {object} [options={}] - Options.
 	 * @param {Function} [options.replace] - Replacer.
+	 * @param {Function} [options.transform] - Transform.
 	 * @param {object} [options.library] - Library (React, Preact, etc.).
 	 * @returns - String or JSX element(s).
 	 */
@@ -2528,6 +2534,7 @@
 	  var node;
 	  var isWhitespace;
 	  var hasReplace = typeof options.replace === 'function';
+	  var transform = options.transform || utilities.returnFirstArg;
 	  var replaceElement;
 	  var props;
 	  var children;
@@ -2548,7 +2555,7 @@
 	            key: replaceElement.key || i
 	          });
 	        }
-	        result.push(replaceElement);
+	        result.push(transform(replaceElement, node, i));
 	        continue;
 	      }
 	    }
@@ -2570,7 +2577,7 @@
 
 	      // We have a text node that's not whitespace and it can be nested
 	      // in its parent so add it to the results
-	      result.push(node.data);
+	      result.push(transform(node.data, node, i));
 	      continue;
 	    }
 
@@ -2617,7 +2624,7 @@
 	      props.key = i;
 	    }
 
-	    result.push(createElement(node.name, props, children));
+	    result.push(transform(createElement(node.name, props, children), node, i));
 	  }
 
 	  return result.length === 1 ? result[0] : result;