npm package discovery and stats viewer.

Discover Tips

  • General search

    [free text search, go nuts!]

  • Package details

    pkg:[package-name]

  • User packages

    @[username]

Sponsor

Optimize Toolset

I’ve always been into building performant and accessible sites, but lately I’ve been taking it extremely seriously. So much so that I’ve been building a tool to help me optimize and monitor the sites that I build to make sure that I’m making an attempt to offer the best experience to those who visit them. If you’re into performant, accessible and SEO friendly sites, you might like it too! You can check it out at Optimize Toolset.

About

Hi, 👋, I’m Ryan Hefner  and I built this site for me, and you! The goal of this site was to provide an easy way for me to check the stats on my npm packages, both for prioritizing issues and updates, and to give me a little kick in the pants to keep up on stuff.

As I was building it, I realized that I was actually using the tool to build the tool, and figured I might as well put this out there and hopefully others will find it to be a fast and useful way to search and browse npm packages as I have.

If you’re interested in other things I’m working on, follow me on Twitter or check out the open source projects I’ve been publishing on GitHub.

I am also working on a Twitter bot for this site to tweet the most popular, newest, random packages from npm. Please follow that account now and it will start sending out packages soon–ish.

Open Software & Tools

This site wouldn’t be possible without the immense generosity and tireless efforts from the people who make contributions to the world and share their work via open source initiatives. Thank you 🙏

© 2024 – Pkg Stats / Ryan Hefner

dizzle

v1.0.4

Published

~ Simple Fast CSS Selector Engine ~

Downloads

20

Readme

https://cdn.svarun.dev/gh/varunsridharan/dizzle/banner.jpg

What?

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.

Features:

  • Full implementation of CSS3 & CSS4 selectors
  • Partial implementation of jQuery extensions
  • Pretty good performance

Usage

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

Documentation

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');
$h2.forEach(function(element){
    console.log(dizzle('span',element));
});

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');
$h2.forEach(function(element){
   
    if(dizzle.is(':visible',element)){
        // 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 | | | | :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 |

Combinators

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

Descendant

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! :wink:
  • Create An 🔧 Issue if you need help / found a bug

Connect & Say 👋