There's currently no clear explanation of what the value of the autoPictureInPicture attribute means, which makes it difficult to accurately implement compatibly (or document what it does). Please add a definitive explanation of what this attribute means.
I am guessing that it means that in addition to allowing PiP, a value of true for autoPictureInPicture causes PiP mode to automatically engage when the element is presented. If so, however, what if disablePictureInPicture is true? Can it still be autodeployed even if the user can't manually toggle it (I know, it sounds crazy, but worth being clear on this)?
If it's an autodeploy enable/disable toggle, it should be named autoPictureInPictureDisabled (I've filed issue #160 separately to suggest that disablePictureInPicture be changed to pictureInPictureDisabled, to align better with the other attributes throughout HTML that use "disabled" rather than "disable" when naming attributes.
Or does it reflect that PiP is currently in its automatically deployed state, rather than that autodeploy is enabled?
When document becomes hidden, the video element whose autopictureinpicture attribute was set most recently automatically enters Picture-in-Picture, if allowed.
When document becomes visible, the video element in Picture-in-Picture automatically leaves it.
There's currently no clear explanation of what the value of the
autoPictureInPicture
attribute means, which makes it difficult to accurately implement compatibly (or document what it does). Please add a definitive explanation of what this attribute means.I am guessing that it means that in addition to allowing PiP, a value of
true
forautoPictureInPicture
causes PiP mode to automatically engage when the element is presented. If so, however, what ifdisablePictureInPicture
istrue
? Can it still be autodeployed even if the user can't manually toggle it (I know, it sounds crazy, but worth being clear on this)?If it's an autodeploy enable/disable toggle, it should be named
autoPictureInPictureDisabled
(I've filed issue #160 separately to suggest thatdisablePictureInPicture
be changed topictureInPictureDisabled
, to align better with the other attributes throughout HTML that use "disabled" rather than "disable" when naming attributes.Or does it reflect that PiP is currently in its automatically deployed state, rather than that autodeploy is enabled?