Giter VIP home page Giter VIP logo

debucsser's Introduction

DebuCSSer

CSS debugging tool with an unpronounceable name

Demo

https://codepen.io/lucagez/full/LMEerQ

Installation

If you are using a bundler:

npm install debucsser

Alternatively download debucsser.js in /module folder and link it in your html

Why

Debucsser is a simple CSS debugging tool made to be unobtrusive in your workflow.

I find myself often apply "outline" to a lot of elements on the page to see their dimensions.

With Debucsser I simply have to hold CTRL and move my mouse around to see the dimensions in px and apply an outline class to every element I hover.

If you hold CTRL + SHIFT you apply the outline class to all the elements on the page by adding a global class.

You can configure some parameters.

I find handy the possibility to specify a custom class I want to apply to different elements without the need to comment and uncomment the my css files.

Usage

// only if you installed via NPM
import Debucsser from 'debucsser';

// pass all the custom properties you want
const config = {
        color: 'palevioletred', // color of the outline
        width: '4px', // width of the outline
        grayscaleOnDebugAll: true, // apply grayscale filter to every element 
        customClass: 'exampleClass',  // a class existent in your stylesheet
      }

// init the debugger
const debug = new Debucsser(config).init();

When you have done this, simply hold CTRL and move the mouse around on the page or hold CTRL + SHIFT.

Props

color

outline color.

Type: string. Default: palevioletred

width

outline width.

Type: string. Default: 3px

style

outline style.

Type: string. Default: solid

grayscaleOnDebug

Apply grayscale filter on hovered element while holding CTRL.

Type: bool. Default: false

grayscaleOnDebugAll

Apply grayscale filter on all elements while holding CTRL + SHIFT.

Type: bool. Default: false

customClass

Apply custom class on hovered element while holding CTRL.

Type: string. Default: null

mainKey

Set the key to use alternatively to CTRL.

Type: number Default: 17

secondKey

Set the key to use alternatively to SHIFT.

Type: number Default: 16

Contributing

If you have any idea on how to make Debucsser better don't hesitate ๐Ÿ˜Ž

Fork โžก new branch โžก PR ๐ŸŽ‰

License

MIT

debucsser's People

Contributors

lucagez avatar

Watchers

 avatar  avatar

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    ๐Ÿ–– Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. ๐Ÿ“Š๐Ÿ“ˆ๐ŸŽ‰

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google โค๏ธ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.