Ticket #6981 (closed bug: duplicate)
misleading documentation for .width() and .height() doesn't take box-sizing into account
| Reported by: | davidflanagan | Owned by: | |
|---|---|---|---|
| Priority: | Milestone: | 1.4.3 | |
| Component: | dimensions | Version: | 1.4.2 |
| Keywords: | Cc: | ||
| Blocking: | Blocked by: |
Description
The docs for the .width() and .height() methods compare these methods to css('width') and css('height') and say that the only difference is that css() returns a string with the units suffix.
That was true when there was only one CSS box model, but now when the new box-sizing property is set to border-box instead of the default content-box, I think that the css() method will return an entirely different value.
Since browser vendors are starting to implement the border-box style property, I think the documentation needs to be updated.
Change History
Please follow the bug reporting guidlines and use jsFiddle when providing test cases and demonstrations instead of pasting the code in the ticket.

I've filed another ticket about this same basic issue, but focusing more on this as a software bug than a documentation bug.
See http://dev.jquery.com/ticket/6982 instead.
This ticket should probably be closed, but I can't do that myself.