WICG / WICG/container-timing

Clarify what should happen when a container timing root has the ignore attribute

Open
#26 1 comment 0 reactions 0 assignees View on GitHub

Nobody has claimed this yet.

Dominant language
Bikeshed
Stars
72
Forks
10
Avg merge
9d 15h
Merged PRs (30d)
3

Description

Is your feature request related to a problem? Please describe.
Some times, how nesting and containertiming-ignore works is confusing. Ignore is expected to block propagation upwards, but it is not working like that.

Describe the solution you'd like
Make it explicit in the specification what happens when an element has both containertiming and containertiming-ignore attributes.

To make the specification more useful, the proposal is that in this case, the container timing root should get events from descendants and itself, as expected, but it would not propagate upwards to any other container timing root.

This is useful for allowing to have parts of the DOM where their paints are independent from ancestors, as dialogs or overlays. Setting a container timing root to the top node allows to measure its paints, and making it ignore, allows to avoid sending paint information to other parts.

Describe alternatives you've considered
This is in the context of https://github.com/bloomberg/container-timing/blob/main/docs/container-definitions.md where we see different ways to delcare the tree. The analysis of alternatives are there.

This makes the attributes option API easier to work with, as it allows to isolate parts of the tree even while getting container timing information from that same tree.

As initially we are moving to use attributes, we need to ensure those cases are covered.

Contributor guide

Open the contributing guide

First steps

  1. Read the whole issue, then the project's contributing guide.
  2. Comment on the issue to say you are picking it up — it saves two people doing the same work.
  3. Fork the repository and make your change on a branch.
  4. Open a pull request that references the issue number.

Research direction

Start with docs/container-definitions.md and trace the attribute-tree alternatives described there. Clarify in the specification that an element with both containertiming and containertiming-ignore receives events from itself and descendants but does not propagate them to ancestor timing roots; ensure the documented nesting cases reflect that behavior.

Written by the indexing model from the issue text.

Assessment

Tech stack
html
Domain
documentation
Issue type
Feature
Difficulty
2/5
Estimated time
1-3 hours
Activity status
Quiet
Clarity
Mostly clear
Newbie friendliness
58/100

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.