component-trace-element-finder
Simple functions that help finding DOM elements through "component trace".
React - babel plugin
To get it working you can simply use https://github.com/x-kom/babel-plugin-react-component-trace-data-attr with default separator
and attribute
options.
Manual usage
You can also manually add data-component-trace
attributes to your dom elements and separate the component names using single space.
API
Method name | Description |
---|---|
findAllComponentsByTrace (name: string, parent?: Element | Document) |
Returns all elements that have name in their trace. Use parent to search only within the given element. |
findTopComponentsByTrace (name: string, parent?: Element | Document) |
Returns all elements that have name in their trace but are not contained within elements that have name in their trace too. Use parent to search only within the given element. |
Example
Consider the following HTML markup
🌠 Witness me 💥 What a day, what a lovely day!
If you call
you will get a set with all shown elements: h1
, div
and two span
s. However when you change the function to
you will get only h1
and div
, since span
s are inside the h1
/div
and thus are not considered a "top" component here.
You can use parent to search for an element iside any other given element
const header = ;const iconInHeader = ;