Package Exports
- visual-dom-diff
This package does not declare an exports field, so the exports above have been automatically detected and optimized by JSPM instead. If any package subpath is missing, it is recommended to post an issue to the original package (visual-dom-diff) to support the "exports" field. If that is not possible, create a JSPM override to customize the exports field for this package.
Readme
visual-dom-diff
Highlight differences between two DOM trees.
Installation
npm i visual-dom-diff
Usage
import { visualDomDiff } from 'visual-dom-diff'
const diffNode = visualDomDiff(originalNode, changedNode, options)
API
visualDomDiff(originalNode: Node, changedNode: Node, options?: Options): DocumentFragment
Returns a new document fragment with the content from the two input nodes and annotations indicating if the given fragment was removed, modified or added in the changedNode
, ralative to the originalNode
.
Changes to text or document structure are represented as deletions (<del class="vdd-removed">
) followed by insertions (<ins class="vdd-added">
). Changes to formatting are treated as content modifications (<ins class="vdd-modified">
) and only the new formatting is carried over to the returned document fragment.
Options
addedClass: string = 'vdd-added'
The class used for annotating content additions.modifiedClass: string = 'vdd-modified'
The class used for annotating content modifications.removedClass: string = 'vdd-removed'
The class used for annotating content removals.skipModified: boolean = false
Iftrue
, the modified content (text formatting changes) will not be marked.skipChildren: (node: Node): boolean | undefined
Indicates if the child nodes of the specifiednode
should be ignored. It is useful for ignoring child nodes of an element representing some embedded content, which should not be compared. Returnundefined
for the default behaviour.skipSelf: (node: Node): boolean | undefined
Indicates if the specifiednode
should be ignored. Even if thenode
is ignored, its child nodes will still be processed, unlessskipChildNodes
says they should also be ignored. Ignored elements whose child nodes are processed are treated as formatting elements. Returnundefined
for the default behaviour.