Clarification for the SVG relative length normalized diagonal may be helpful

[herrstrietzel]

MDN URL

https://developer.mozilla.org/en-US/docs/Web/SVG/Attribute/r

What specific section or headline is this issue about?

"When the value is set as a percentage, it refers to the normalized diagonal of the current SVG viewport."

What information was incorrect, unhelpful, or incomplete?

I think it's helpful what "normalized diagonal" actually means and how it's calculated.

To my own surprise the W3C SVG (2 draft) spec (albeit containing suggested enhancements which may probably never be implemented) provides a very concise explanation:

For any other length value expressed as a percentage of the SVG viewport, the percentage must be calculated as a percentage of the normalized diagonal of the ‘viewBox’ applied to that viewport. If no ‘viewBox’ is specified, then the normalized diagonal of the SVG viewport must be used. The normalized diagonal length must be calculated with sqrt((width)**2 + (height)**2)/sqrt(2)

So including the calculation sqrt((width)**2 + (height)**2)/sqrt(2) might be a good idea.

What did you expect to see?

The revised paragraph may look something like this:

When the value is set as a percentage, it refers to the normalized diagonal of the current SVG viewport. The normalized diagonal is calculated like this sqrt((width)**2 + (height)**2)/sqrt(2)

Do you have any supporting links, references, or citations?

https://svgwg.org/svg2-draft/coords.html#Units

Do you have anything more you want to share?

No response

MDN metadata

Page report details

• Folder: en-us/web/svg/attribute/r
• MDN URL: https://developer.mozilla.org/en-US/docs/Web/SVG/Attribute/r
• GitHub URL: https://github.com/mdn/content/blob/main/files/en-us/web/svg/attribute/r/index.md
• Last commit: 29a5380
• Document last modified: 2024-08-10T06:14:47.000Z

[herrstrietzel]

A simple solution may also to link to the respective spec https://svgwg.org/svg2-draft/coords.html#Units in the specs footer.