Skip to content
Open
Changes from 1 commit
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
80 changes: 76 additions & 4 deletions api/Document.json
Original file line number Diff line number Diff line change
Expand Up @@ -8380,10 +8380,10 @@
"deprecated": false
}
},
"callbackOptions_parameter": {
"options_parameter": {
"__compat": {
"description": "`callbackOptions` parameter",
"spec_url": "https://drafts.csswg.org/css-view-transitions-2/#dom-document-startviewtransition-callbackoptions-callbackoptions",
"description": "`options` parameter",
"spec_url": "https://drafts.csswg.org/css-view-transitions-2/#dictdef-startviewtransitionoptions",
"tags": [
"web-features:view-transitions"
],
Expand Down Expand Up @@ -8414,12 +8414,84 @@
"standard_track": true,
"deprecated": false
}
},
"types_property": {
"__compat": {
"description": "`types` property",
Comment on lines +8417 to +8419
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

BCD guidelines suggest to not nest these:

Suggested change
"types_property": {
"__compat": {
"description": "`types` property",
"options_types_parameter": {
"__compat": {
"description": "`options.types` parameter",

Copy link
Contributor

@caugner caugner Dec 5, 2025

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

/cc @ddbeck Is this a special case warranting an exception? (I don't remember understanding why we don't nest these.)

Edit: Nesting has the benefit of linting the child support data against the parent support data.

Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Yeah, not nesting them seems a little odd to me.

Copy link
Contributor

@ddbeck ddbeck Dec 9, 2025

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Honestly, I think the reason we had that guideline was that deeply-nested keys didn't get rendered on compat tables because of recursion limit on MDN. I'm not sure what the limit is today or if it still matters.

I agree that having the linting on nested data is a real gain. I'm fine with deviating from the guideline for this PR. And we ought to consider formally revising the existing guideline. @caugner would you mind putting it on the agenda for the first BCD call in January?

Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

the reason we had that guideline was that deeply-nested keys didn't get rendered on compat tables because of recursion limit on MDN. I'm not sure what the limit is today or if it still matters.

Nowadays, the BCD table hides nested features only there would be too many features otherwise: https://github.com/mdn/fred/blob/7d1da1e38e4394f5fd04b4d8c5c90073ee4b0134/components/compat-table/element.js#L345-L348

So I agree with deviating from the guideline for this PR, and discuss updating it in January.

Copy link
Contributor

@caugner caugner Dec 10, 2025

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

That said, I think the description should still reflect the full path (and use the term "parameter", not "property"):

Suggested change
"types_property": {
"__compat": {
"description": "`types` property",
"types_parameter": {
"__compat": {
"description": "`options.types` parameter",

"spec_url": "https://drafts.csswg.org/css-view-transitions-2/#dom-startviewtransitionoptions-types",
"tags": [
"web-features:view-transitions"
],
"support": {
"chrome": {
"version_added": "125"
},
"chrome_android": "mirror",
"edge": "mirror",
"firefox": {
"version_added": false,
"impl_url": "https://bugzil.la/1860854"
},
"firefox_android": "mirror",
"oculus": "mirror",
"opera": "mirror",
"opera_android": "mirror",
"safari": {
"version_added": "18.2"
},
"safari_ios": "mirror",
"samsunginternet_android": "mirror",
"webview_android": "mirror",
"webview_ios": "mirror"
},
"status": {
"experimental": false,
"standard_track": true,
"deprecated": false
}
}
},
"update_property": {
"__compat": {
"description": "`update` property",
Comment on lines +8452 to +8454
Copy link
Contributor

@caugner caugner Dec 5, 2025

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
"update_property": {
"__compat": {
"description": "`update` property",
"update_parameter": {
"__compat": {
"description": "`options.update` parameter",

Edit: Updated following #28541 (comment).

"spec_url": "https://drafts.csswg.org/css-view-transitions-2/#dom-startviewtransitionoptions-update",
"tags": [
"web-features:view-transitions"
],
"support": {
"chrome": {
"version_added": "125"
},
"chrome_android": "mirror",
"edge": "mirror",
"firefox": {
"version_added": false,
"impl_url": "https://bugzil.la/1860854"
},
"firefox_android": "mirror",
"oculus": "mirror",
"opera": "mirror",
"opera_android": "mirror",
"safari": {
"version_added": "18.2"
},
"safari_ios": "mirror",
"samsunginternet_android": "mirror",
"webview_android": "mirror",
"webview_ios": "mirror"
},
"status": {
"experimental": false,
"standard_track": true,
"deprecated": false
}
}
}
},
"updateCallback_parameter": {
"__compat": {
"description": "`updateCallback` parameter",
"spec_url": "https://drafts.csswg.org/css-view-transitions-1/#dom-document-startviewtransition-updatecallback-updatecallback",
"spec_url": "https://drafts.csswg.org/css-view-transitions-2/#callbackdef-viewtransitionupdatecallback",
"tags": [
"web-features:view-transitions"
],
Expand Down