Skip to content

a-axton/box-model-inspector

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

22 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Box Model Inspector

Devtools style dom node inspector. Highlights the CSS box model just like chrome devtools. Draws a box around a given element highlighting width, height, margin, border & padding.

Demo: http://a-axton.github.io/box-model-inspector/

Caveats
  • Expects box-sizing border-box
  • Doesn't work well with fixed position elements. It highlights properly but won't stay in the proper position when scrolling.

Installation

npm

npm install box-model-inspector --save

inline

<script type="text/javascript" src="/path/dist/box-model-inspector.js"></script>

Theming

* { box-sizing: border-box; }

/* CONTENT */
.box-model .content {
  background: rgba(109, 238, 245, 0.5);
}

/* MARGIN */
.box-model .margin {}
.box-model .marginTop {}
.box-model .marginRight {}
.box-model .marginBottom {}
.box-model .marginLeft {}
.box-model .margin div {
  background: rgba(251, 176, 91, 0.65);
}

/* PADDING */
.box-model .padding {}
.box-model .paddingTop {}
.box-model .paddingRight {}
.box-model .paddingBottom {}
.box-model .paddingLeft {}
.box-model .padding div {
  background: rgba(139, 234, 127, 0.65);
}

/* BORDER */
.box-model .border {}
.box-model .borderTop {}
.box-model .borderRight {}
.box-model .borderBottom {}
.box-model .borderLeft {}
.box-model .border div {
  background-color: rgba(234, 228, 105, .8);
}

Sample Usage

var BoxModelInspector = require('box-model-inspector');

// all options are optional
var boxModelInspector = new BoxModelInspector({
  // initial element to highlight
  el: document.querySelectorAll('.example')[0],
  // custom class, defaults to 'box-model'
  className: 'box-model',
  // will append to element, uses body as default
  appendTo: document.body
});

// set new element to be highlighted
document.body.addEventListener('mousemove', function(e) {
  boxModelInspector.setElement(e.target);
  e.stopPropagation();
});

// refresh dimensions
window.addEventListener('resize', function() {
  boxModelInspector.refresh();
});

Methods

setElement


Set new element to highlight

Example
var el = document.getElementById('el');
boxModelInspector.setElement(el);

refresh


Refresh current element's box model

Example
window.addEventListener('resize', function() {
  boxModelInspector.refresh();
});

hide


Hide it

Example
boxModelInspector.hide();

show


Show it

Example
boxModelInspector.show();

About

View an element's box model dimensions similar to chrome and firefox inspect element tool

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published