unique-selector
Version:
Given a DOM node, return a unique CSS selector matching only that element
124 lines (76 loc) • 2.88 kB
Markdown
unique-selector
===============
[](https://travis-ci.org/ericclemmons/unique-selector)
[]()
[]()
Given a DOM node, return a unique CSS selector matching only that element.
This is particularly useful when tracking in custom variables in analytics:
document.addEventListener('click', function(event) {
var selector = unique(event.target);
_gaq.push(['_trackEvent', 'Engagement', 'Click', selector]);
}, false);
Installation
------------
[](https://nodei.co/npm/unique-selector/)
Options
------------
e.g.1 DomElement = `<span id="test"></span>`
```
import unique from 'unique-selector';
// Optional Options
options = {
// Array of selector types based on which the unique selector will generate
selectorTypes : [ 'ID', 'Class', 'Tag', 'NthChild' ]
}
unique( DomElement, options ); // #test
```
e.g.2 DomElement = `<span test="2"></span>`
```
import unique from 'unique-selector';
// Optional Options
options = {
// Array of selector types based on which the unique selector will be generate
selectorTypes : [ 'Attributes' ]
}
unique( DomElement, options ); // [test="2"]
```
e.g.3 DomElement = `<div id="xyz" class="abc test"></div>`
```
import unique from 'unique-selector';
// Optional Options
options = {
// Regular expression of ID and class names to ignore
excludeRegex : RegExp( 'xyz|abc' )
}
unique( DomElement, options ); // .test
```
Tests
-----
$ npm run test
Contributing
-----
Feel free to open issues, make suggestions or send PRs.
This project adheres to the Contributor Covenant [code of conduct](http://contributor-covenant.org/). By participating, you are expected to uphold this code.
Contact
-----
Avraam Mavridis : [@avraamakis](https://twitter.com/avraamakis)
Eric Clemmons : [@ericclemmons](https://twitter.com/ericclemmons)
Releases
--------
- v0.1.0
- Big refactor/rewrite using es6
- More test + Change the test script
- Script to compile es6 to es5 using babel
- Ability to pass options for the **selectorTypes** based on which the unique selector will be generated, see the options
- v0.0.4
- Handle extra whitespace in `className` ([#9](https://github.com/ericclemmons/unique-selector/pull/9))
- v0.0.3
- Add support for various `<form>` elements ([#2](https://github.com/ericclemmons/unique-selector/issues/2))
- v0.0.2
- Fix bug with `nth-child` calculation
- v0.0.1
- Initial release
License
-------
MIT
[](https://bitdeli.com/free "Bitdeli Badge")