Note: This is a sub-task of #2131 [Task] Clarify the overlap in the functionalities of vf-embed, vf-video and vf-video-teaser.
Description
vf-video-container renders nothing of its own: it is a layout that arranges a section header, a vf-video and a vf-video-teaser. #2131 found no on-pattern use of it. The single instance kept the container shell and replaced its entire internal structure, and the "video with adjacent content" layouts on the reviewed sites were built by hand with vf-embed plus vf-grid instead. Both benchmarks keep layout outside the video component.
We recommend to keep this component, but update the documentation to reframe it as what it is: one specific section layout among many a page may need. Authors who need that exact arrangement can use it; authors who need a different layout should build it themselves with vf-grid or embl-grid. This is framed as a recommendation rather than prescribing one grid over the other.
Independently of that framing, #2131 identified two defects that hold as long as the component exists, which the documentation should note and which need matching code changes raised separately:
- The declared
section-title is not passed through to vf-section-header, so the author's configured value has no effect on the output.
- The section heading level is fixed and cannot be matched to the surrounding page hierarchy (WCAG 1.3.1 A).
Success criteria
Definition of Done
Description
vf-video-containerrenders nothing of its own: it is a layout that arranges a section header, avf-videoand avf-video-teaser. #2131 found no on-pattern use of it. The single instance kept the container shell and replaced its entire internal structure, and the "video with adjacent content" layouts on the reviewed sites were built by hand withvf-embedplusvf-gridinstead. Both benchmarks keep layout outside the video component.We recommend to keep this component, but update the documentation to reframe it as what it is: one specific section layout among many a page may need. Authors who need that exact arrangement can use it; authors who need a different layout should build it themselves with
vf-gridorembl-grid. This is framed as a recommendation rather than prescribing one grid over the other.Independently of that framing, #2131 identified two defects that hold as long as the component exists, which the documentation should note and which need matching code changes raised separately:
section-titleis not passed through tovf-section-header, so the author's configured value has no effect on the output.Success criteria
vf-gridorembl-gridembl-gridandvf-grid, not as prescribing one over the othersection-titleand fixed-heading-level defects, and raise the corresponding code changes as a technical follow-upDefinition of Done