content icon indicating copy to clipboard operation
content copied to clipboard

contain-intrinsic-size - improve docs

Open hamishwillee opened this issue 3 years ago • 2 comments

contain-intrinsic-size docs are incomplete and inaccurate.

More work to be done:

  • Need to update https://github.com/mdn/data/blob/main/css/properties.json
  • Need docs for
    • contain-intrinsic-width
    • contain-intrinsic-height
  • Perhaps some examples
  • Update CSS containment with
    • Information about contains-intrinsic-size in the appropriate section on size containment.
    • information about content-visibility as this also triggers CSS containment.

This is related to #20876

hamishwillee avatar Sep 20 '22 06:09 hamishwillee

Preview URLs

(this comment was updated 2022-09-23 12:30:11.748288)

github-actions[bot] avatar Sep 20 '22 06:09 github-actions[bot]

Can we ease the reading level down? i.e. intrinsic, mitigated, and computational may not be understood by native English speakers and we have a large ESL audience.

https://developer.mozilla.org/en-US/docs/Web/CSS/CSS_Containment mentions:

The specification defines a single CSS property contain ....

we should likely add this to that page.

estelle avatar Sep 20 '22 16:09 estelle

Thanks all. I'm going to merge this in the current state 👍🏻 it looks like we can revisit the auto value if there's an outcome from the separate discussion on the benefits there :)

bsmth avatar Sep 23 '22 12:09 bsmth