dime

cross-browser JavaScript module to measure dimensions

$ npm install dime

API (3.0)

Static methods

Fast simple top-level methods

dime.width(object) // get width
dime.height(object) // get height
dime.width(element, px) // set width
dime.height(element, px) // set height

Measurable objects

• window
• DOM node: document or element
• object with .width/.height properties or methods

dime.width(screen) // => screen.width
dime.width({width:10, height:10}) // => 10

Chain methods

jQueryish methods for compatible libs (such as ender)

.width() // get the width of the 1st elem in the set
.width(value) // set the width of all elems in the set
.height() // get the width of the 1st elem in the set
.height(value) // set the width of all elems in the set

Integrated usage

$(window).width()
$(document).width()
$(element).width()
$(element).width(100)

Standalone usage

dime.fn.width.call(stack)
dime.fn.width.call(stack, px)

Standalone examples

It is only sensible to use these for setting dimensions—the statics are faster for gets.

dime.fn.width.call([document]) // same as dime.width(document)
dime.fn.width.call(document.querySelectorAll('.example'), 100)

Version notes

3.x is leaner than previous releases

• 2.x device methods were removed because the native screen provides these.
• 2.x viewport methods were removed in favor of dime.width(window) although those methods
  are available in verge.
• In 3.x dime is a plain object—not a wrapper function.

Related modules

• verge: viewport utilities

Resources

• Lab: dimensions

License: MIT

Copyright (C) 2012 by Ryan Van Etten