Add an entry for $.cssNumber to the API docs

[BillyRayPreachersSon]

I think it would be worthwhile adding an entry for $.cssNumber to the API docs, alongside the existing entry for $.cssHooks.

At present, the only mention of it is right at the bottom of the entry for $.cssHooks, and so it's very easy to miss.

The main reason I think it might be a useful addition is for anyone wondering why setting the line-height style without a value does not give the same results as setting the font-size style without a value, e.g.:

        var size = 10;
        el.css({ fontSize:size, lineHeight:size });

Personally, I'd add it to both the "CSS" and "Mainpulation -> Style Properties" categories, as those would be the places I'd be looking if I had the aforementioned issue.

[BillyRayPreachersSon]

A small typo crept in there: "without a value" should read "without a unit".

Unfortunately, there appears to be no way to edit a ticket, even as the reporter.

[dmethvin]

So are you asking that we expose jQuery.cssNumber as part of the API so that users can change it? Or just that the information contained there be included in the pages for .css() at api.jquery.com?

[mikesherov]

dmethvin, I'm personally torn on this one. While it may be nice for plugin developers to be able to rely on $.cssNumber and $.cssProps, if we expose it, we're locked in. Perhaps just adding it to .css() and mentioning them as unstable hooks for plugin devs is good enough?

[dmethvin]

Let's keep these internal for now, we can revisit in 1.9.

[BillyRayPreachersSon]

Replying to dmethvin:

So are you asking that we expose jQuery.cssNumber as part of the API so that users can change it? Or just that the information contained there be included in the pages for .css() at api.jquery.com?

Just that the information contained be included in the docs, really.

[dmethvin]

Bulk change from enhancement to feature.

[gibson042]

+1 to documenting the properties; -1 to documenting the API.

[mikesherov]

+1, knowledge is power

[gibson042]

+1

[mikesherov]

ported to: ​https://github.com/jquery/api.jquery.com/issues/164