Skip to content

Commit

Permalink
Fix a claim that disconnecting an iframe causes it to load a document. (
Browse files Browse the repository at this point in the history
#165)

Also link to the definition of "disconnected".
  • Loading branch information
jyasskin authored Sep 6, 2024
1 parent 611a3ac commit 2d28f21
Showing 1 changed file with 3 additions and 3 deletions.
6 changes: 3 additions & 3 deletions index.bs
Original file line number Diff line number Diff line change
Expand Up @@ -811,7 +811,7 @@ For more detailed guidance on how to handle BFCached documents,
see [[DESIGN-PRINCIPLES#non-fully-active]] and the [Supporting BFCached Documents](https://w3ctag.github.io/bfcache-guide/) guide.

Note: It is possible for a document to become non-[=Document/fully active=] for other reasons not related to BFcaching,
such as when the iframe holding the document gets disconnected.
such as when the iframe holding the document [=becomes disconnected=].
Our advice is that all non-[=Document/fully active=] documents should be treated the same way.
The only difference is that BFCached documents might become [=Document/fully active=] again,
whereas documents in detached iframes will stay inactive forever.
Expand Down Expand Up @@ -863,10 +863,10 @@ users at risk include:
<h3 class=question id="non-fully-active">
What happens when a document that uses your feature gets disconnected?
</h3>
If the iframe element containing a document gets disconnected,
If the iframe element containing a document [=becomes disconnected=],
the document will no longer be [=Document/fully active=].
The document will never become fully active again,
because if the iframe element gets disconnected, it will load a new document.
because if the iframe element [=becomes connected=] again, it will load a new document.
The document is gone from the user's perspective,
and should be treated as such by your feature as well.
You may follow the guidelines for <a href="bfcache">BFCache</a> mentioned above,
Expand Down

0 comments on commit 2d28f21

Please sign in to comment.