w3c / w3c/webdriver

Better define Print "formatting hints"

Open
#1,895 3 comments 1 reaction 0 assignees View on GitHub

Nobody has claimed this yet.

Print Page
Dominant language
HTML
Stars
718
Forks
228
PR merge metrics
No merged PRs in 30d

Description

https://w3c.github.io/webdriver/#print-page has:

In addition, the following formatting hints should be applied by the UA:

If scale is not equal to 1:
Zoom the size of the content by a factor scale

If background is false:
Suppress output of background images

If shrinkToFit is true:
Resize the content to match the page width, overriding any page width specified in the content

These seem basically entirely undefined.

What does "zoom the size of the content" mean? Does this effectively just "set the zoom property on the root element"?

While "suppress output of the background images" is clear, I expect we should actually just define this by reference to https://drafts.csswg.org/css-color-adjust-1/#propdef-print-color-adjust (which is admittedly very open-ended!).

"Resize the content to match the page width" is also incredibly vague. Like, we're always setting a page width and height, thus aren't we setting the size of the page box, and thus the content won't be larger than the width?

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 the WebDriver print-page section cited in the issue and compare its definitions of scale, background, and shrinkToFit with the CSS Color Adjustment print-color-adjust definition. Clarify the intended browser behavior and specify each hint precisely enough for interoperable implementations; the issue is done when the specification text no longer relies on the noted ambiguities.

Written by the indexing model from the issue text.

Assessment

Tech stack
css, html
Domain
documentation
Issue type
Documentation
Difficulty
5/5
Estimated time
Over a week
Activity status
Stale
Clarity
Needs clarification
Newbie friendliness
25/100

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.