@csstools/selector-specificity
TypeScript icon, indicating that this package has built-in type declarations

5.0.0 • Public • Published

Selector Specificity

npm version Build Status Discord

Usage

Add Selector Specificity to your project:

npm install @csstools/selector-specificity --save-dev
import parser from 'postcss-selector-parser';
import { selectorSpecificity } from '@csstools/selector-specificity';

const selectorAST = parser().astSync('#foo:has(> .foo)');
const specificity = selectorSpecificity(selectorAST);

console.log(specificity.a); // 1
console.log(specificity.b); // 1
console.log(specificity.c); // 0

selectorSpecificity takes a single selector, not a list of selectors (not : a, b, c). To compare or otherwise manipulate lists of selectors you need to call selectorSpecificity on each part.

Comparing

The package exports a utility function to compare two specificities.

import { selectorSpecificity, compare } from '@csstools/selector-specificity';

const s1 = selectorSpecificity(ast1);
const s2 = selectorSpecificity(ast2);
compare(s1, s2); // -1 | 0 | 1
  • if s1 < s2 then compare(s1, s2) returns a negative number (< 0)
  • if s1 > s2 then compare(s1, s2) returns a positive number (> 0)
  • if s1 === s2 then compare(s1, s2) returns zero (=== 0)

Prior Art

For CSSTools we always use postcss-selector-parser and want to calculate specificity from this AST.

Dependencies (0)

    Dev Dependencies (0)

      Package Sidebar

      Install

      npm i @csstools/selector-specificity

      Weekly Downloads

      8,435,311

      Version

      5.0.0

      License

      MIT-0

      Unpacked Size

      11.4 kB

      Total Files

      7

      Last publish

      Collaborators

      • romainmenke
      • alaguna
      • jonathantneal