Specificity Graph (for CSS)

Idea by Harry Roberts

Generate an interactive line graph showing the specificity in your stylesheet. Uses d3, css-parser, and specificity.

Installation

npm install specificity-graph

Usage

specifity-graph can be used in different ways:

• CLI
• Node module
• Via JavaScript
• Online

CLI

specificity-graph <cssFile> [options]

Creates a directory containing

• json file with specificity data for your CSS
• html file with interactive specificity graph for CSS
• necessary JS files to run graph

Options

Flag	Description
-o --output	name for generated directory (default: specificity-graph)
-b --browser	auto launch browser to view generated chart
-h --help	Help

Node module

var specificityGraph = require('specificity-graph');

specificityGraph(directory, css, function(directory){
  console.log('specificity-graph files created in ' + directory);
});

Via JavaScript

First get the specificityGraph accessible in your code:

Using Browserify (or similar)

Just require('specificity-graph').

Standalone (no module loader)

Add <script src="specificity-graph-standalone.js"></script>, this will expose specificityGraph as a global variable.

Methods

• specificityGraph.create(css, options)
• specificityGraph.createFromData(specificityData, options),
• specificityGraph.update(css)

Options

Name	Description
css	String with css to generate specificity graph for
specificityData	JSON object with css specificity data. CLI write a JSON in this format, as does the lib/lineChart's create function'

Create options

Create option name	Description
svgSelector	Selector for svg element to draw specificity graph inside. Defaults to .js-graph.
width	default 1000. You should set a viewBox value on the SVG element to match width and height, f.e. viewbox='0 0 1000 4000'.
height	default 400
showTicks	Boolean. Show scale and ticks. Default false.
xProp	(possible values: 'selectorIndex', 'line'). What to base the x dimension, 'location in stylesheet' in graph on: index of selector in CSS, or line number for selector in CSS. Default 'selectorIndex'.
yProp	default 'specificity'