dime

3.0.0 • Public • Published

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

License: MIT

Copyright (C) 2012 by Ryan Van Etten

Readme

Keywords

none

Package Sidebar

Install

npm i dime

Weekly Downloads

1

Version

3.0.0

License

MIT

Last publish

Collaborators

  • ryanve