docs(document.hidden): clarify hidden tab versus hidden styling

[hchiam]

Description/Motivation

• added clarification to disambiguate between "hidden" in the sense of styling the page you're looking at, versus "hidden" in the sense of the entire tab being not currnetly being viewed by the user
• added example using polling so beginners can trust/understand it more readily - more likely to know polling and not be familiar with the lesser-known event listener visibilitychange (speaking for myself i guess haha, although i can understand if polling is a reason for not wanting to include the polling example to begin with)

Additional details

• https://developer.mozilla.org/en-US/docs/Web/API/Document/visibilityState has the clarification "It can be used to check whether the document is in the background or in a minimized window, or is otherwise not visible to the user." and the visibilityState page is linked in https://developer.mozilla.org/en-US/docs/Web/API/Document/hidden, but that requires the reader to think to go there first and back to the document.hidden page to read it in the correct sense

[github-actions]

Preview URLs (1 page)

• /en-US/docs/Web/API/Document/hidden

(comment last updated: 2026-07-02 23:34:13)

[hchiam]

ready for review

[hamishwillee]

Thank you. I agree it doesn't hurt to claify that this is about the page and not a specific visual element.
I've modified to adopt the simple wording of the visibility changed and to remove the example (which doesn't IMO particularly add anything.). It is more clear to say what the property shows that that it is "not styling".

Much appreciated!

[hchiam]

thanks @hamishwillee !