1.0.4 • Public • Published


Dizzle - ~ Simple Fast CSS Selector Engine ~ | Product Hunt


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>
  var divs = dizzle('div');

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";


Finding Elements

 * 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');

IS / Match Element Pseudo

 * Fetches All H2 Elements in document
 * and loops into results and find span element in each h2 element
var $h2 = dizzle('h2');
        // your code if h2 is visible 

Element Filter

 * Filter All Visible H2 tags
var visibleH2 = dizzle.filter(':visible',dizzle('h2'));

Custom Adapter Support

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)

Custom Adapter Functions

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 )

Supported Selectors

Combinators Attributes Pseudo
> Child = :empty
+ Adjacent != :disabled
~ General Sibling \|= :enabled
Descendant *= :lang
~= :visible
$= :hidden
^= :contains


Child >

The child selector selects all elements that are the children of a specified element.

dizzle('div > p > span');

Adjacent +

The adjacent sibling selector selects all elements that are the adjacent siblings of a specified element.

dizzle('div.copyright > p.content + span.year');

Sibling ~

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');

📝 Changelog

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.

Checkout CHANGELOG.md

🤝 Contributing

If you would like to help, please take a look at the list of issues.

💰 Sponsor

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 ?

📜 License & Conduct

📣 Feedback

  • ⭐ This repository if this project helped you! 😉
  • Create An 🔧 Issue if you need help / found a bug

Connect & Say 👋

Built With ♥ By Varun Sridharan 🇮🇳




Package Sidebar


npm i dizzle

Weekly Downloads






Unpacked Size

357 kB

Total Files


Last publish


  • varunsridharan