Dizzle turns CSS selectors into functions that tests if elements match them. When searching for elements, testing is executed "from the top", similar to how browsers execute CSS selectors.
- Full implementation of CSS3 & CSS4 selectors
- Partial implementation of jQuery extensions
- Pretty good performance
Get Dizzle From jsDelivr and use it like this:
<script src="https://cdn.jsdelivr.net/npm/dizzle/dist/dizzle.umd.min.js"></script>
<script>
var divs = dizzle('div');
console.log(divs);
</script>
Dizzle is also available through npm as the dizzle
package:
npm install --save dizzle
That you can then use like this:
import dizzle from "dizzle";
dizzle.find('div.myelement');
/**
* Search For h2 elements inside div in whole document
*/
console.log(dizzle('div > h2'));
/**
* Fetches All H2 Elements in document
* and loops into results and find span element in each h2 element
*/
var $h2 = dizzle('h2');
$h2.forEach(function(element){
console.log(dizzle('span',element));
});
/**
* Fetches All H2 Elements in document
* and loops into results and find span element in each h2 element
*/
var $h2 = dizzle('h2');
$h2.forEach(function(element){
if(dizzle.is(':visible',element)){
// your code if h2 is visible
}
});
/**
* Filter All Visible H2 tags
*/
var visibleH2 = dizzle.filter(':visible',dizzle('h2'));
const customAdapter = {
attr: function( elem, attrName ) {
if( 'custom-Name' === attrName ) {
return elem.getAttribute('customName');
}
return elem.getAttribute( attrName );
}
};
const attr = dizzle('[custom-Name="Yes"]',null,customAdapter)
A custom adapter must implement the following functions:
isTag, getChildren, getParent, attr, getSiblings, getTagName
Please check src/adapter.js for more information Custom adapters can be passed for all the below functions
/**
* @param selector String
* @param context Parent Element / Root
* @param adapter Custom Adapter Function
*/
dizzle( selector, context, adapter );
/**
* @param selector String
* @param elem Single Element Object
* @param adapter Custom Adapter Function
*/
dizzle.is( selector, elem, adapter )
/**
* @param selector String
* @param elems Array of elements
* @param adapter Custom Adapter Function
*/
dizzle.filter( selector, elems, adapter )
Combinators | Attributes | Pseudo |
---|---|---|
> Child |
= |
:empty |
+ Adjacent |
!= |
:disabled |
~ General Sibling |
|= |
:enabled |
Descendant |
*= |
:lang |
~= |
:visible |
|
$= |
:hidden |
|
^= |
:contains |
|
:first-child |
||
:last-child |
||
:first-of-type |
||
:last-of-type |
||
:even |
||
:odd |
||
:gt |
||
:lt |
||
:eq |
||
:first |
||
:last |
||
:nth-of-type |
||
:nth-last-of-type |
||
:nth-last-child |
||
:checked |
||
:input |
||
:button |
||
:parent |
||
:selected |
||
:text |
||
:only-child |
||
:only-of-type |
||
:has |
||
:not |
||
:radio |
||
:checkbox |
||
:file |
||
:password |
||
:image |
||
:submit |
||
:reset |
The child selector selects all elements that are the children of a specified element.
dizzle('div > p > span');
The adjacent sibling selector selects all elements that are the adjacent siblings of a specified element.
dizzle('div.copyright > p.content + span.year');
The general sibling selector selects all elements that are siblings of a specified element.
dizzle('p ~ span');
The descendant selector matches all elements that are descendants of a specified element.
dizzle('div p span');
All notable changes to this project will be documented in this file.
The format is based on Keep a Changelog, and this project adheres to Semantic Versioning.
If you would like to help, please take a look at the list of issues.
I fell in love with open-source in 2013 and there has been no looking back since! You can read more about me here. If you, or your company, use any of my projects or like what Iโm doing, kindly consider backing me. I'm in this for the long run.
- โ How about we get to know each other over coffee? Buy me a cup for just $9.99
- โ๏ธโ๏ธ How about buying me just 2 cups of coffee each month? You can do that for as little as $9.99
- ๐ฐ We love bettering open-source projects. Support 1-hour of open-source maintenance for $24.99 one-time?
- ๐ Love open-source tools? Me too! How about supporting one hour of open-source development for just $49.99 one-time ?
- โญ This repository if this project helped you! ๐
- Create An ๐ง Issue if you need help / found a bug
- Follow me on ๐จโ๐ป Github and stay updated on free and open-source software
- Follow me on ๐ฆ Twitter to get updates on my latest open source projects
- Message me on ๐ Telegram
- Follow my pet on Instagram for some dog-tastic updates!
Built With โฅ By Varun Sridharan ๐ฎ๐ณ