jQuery in Action
286
CHAPTER 9
Prominent, powerful, and practical plugins
These extended commands don't interfere with the corresponding core com-
mands when passed a value as a parameter (in order to set the width or height of
elements), except when the first element is the window or document element. In
such cases, the commands act as if no parameter was passed and the width or
height of the window or document is returned. Be warned, and code accordingly.
mands when passed a value as a parameter (in order to set the width or height of
elements), except when the first element is the window or document element. In
such cases, the commands act as if no parameter was passed and the width or
height of the window or document is returned. Be warned, and code accordingly.
The
width()
and
height()
commands return the dimensions assigned to the
content of an element, but sometimes we want to account for other aspects of
the box model, such as any padding or border applied to the element. For such
occasions, the Dimensions Plugin provides two sets of commands that take these
other dimensions into account.
the box model, such as any padding or border applied to the element. For such
occasions, the Dimensions Plugin provides two sets of commands that take these
other dimensions into account.
The first of these,
innerWidth()
and
innerHeight()
, measure not only the con-
tent of the element but any padding applied to it as well. The second set,
outer-
Width()
and
outerHeight()
, include not only the padding but also any border
and, optionally, margins.
Command syntax: innerWidth and innerHeight
innerWidth()
innerHeight()
Returns the inner width or height of the first element in the wrapped set. The inner dimen-
sion includes the content and any padding applied to the element.
sion includes the content and any padding applied to the element.
Parameters
none
Returns
The inner width or height of the first element in the wrapped set.
The inner width or height of the first element in the wrapped set.
Command syntax: outerWidth and outerHeight
outerWidth()
outerHeight()
Returns the outer width or height of the first element in the wrapped set. The outer dimen-
sion includes the content, any padding, and any border applied to the element.
sion includes the content, any padding, and any border applied to the element.
Parameters
options
(Object) An object hash that accepts a single option, margin, which
specifies whether margins should be accounted for in the calculation.
The default is false.
Returns
The outer width or height of the first element in the wrapped set.
The outer width or height of the first element in the wrapped set.