srcset description for <source> element is incorrect and misleading.

[romainmenke]

MDN URL

https://developer.mozilla.org/en-US/docs/Web/HTML/Element/source

What specific section or headline is this issue about?

https://developer.mozilla.org/en-US/docs/Web/HTML/Element/source#attr-srcset

What information was incorrect, unhelpful, or incomplete?

A list of one or more strings, separated by commas, indicating a set of possible images represented by the source for the browser to use. Each string is composed of:

• One URL specifying an image.
• A width descriptor, which consists of a string containing a positive integer directly followed by "w", such as 300w. The default value, if missing, is the infinity.
• A pixel density descriptor, that is a positive floating number directly followed by "x". The default value, if missing, is 1x.

Each string in the list must have at least a width descriptor or a pixel density descriptor to be valid. Among the list, there must be only one string containing the same tuple of width descriptor and pixel density descriptor. The browser chooses the most adequate image to display at a given point of time. If width descriptors are used, the sizes attribute must also be present, or the srcset value will be ignored.

This reads as if this would be valid :

<picture>
  <source srcset="
    mdn-logo-wide.png 400w 1x,
    mdn-logo-wide-2x.png 400w 2x,
    mdn-logo-extra-wide.png 800w 1x,
    mdn-logo-extra-wide-2x.png 800w 2x
  " media="(min-width: 800px)" />

  <img src="mdn-logo-narrow.png" alt="MDN Web Docs" />
</picture>

What did you expect to see?

Documentation that matches the specification : https://html.spec.whatwg.org/multipage/images.html#image-candidate-string

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

No response

Do you have anything more you want to share?

No response

MDN metadata

Page report details

• Folder: en-us/web/html/element/source
• MDN URL: https://developer.mozilla.org/en-US/docs/Web/HTML/Element/source
• GitHub URL: https://github.com/mdn/content/blob/main/files/en-us/web/html/element/source/index.md
• Last commit: 7d86bc5
• Document last modified: 2022-11-02T05:33:58.000Z