Präsentation: Receiver-Eigenschaft
Limited availability
This feature is not Baseline because it does not work in some of the most widely-used browsers.
Experimentell: Dies ist eine experimentelle Technologie
Überprüfen Sie die Browser-Kompatibilitätstabelle sorgfältig, bevor Sie diese produktiv verwenden.
Sicherer Kontext: Diese Funktion ist nur in sicheren Kontexten (HTTPS) in einigen oder allen unterstützenden Browsern verfügbar.
Das schreibgeschützte Presentation
-Attribut
receiver
, das nur in Browser-Kontexten verfügbar ist, die eine Präsentation empfangen, gibt das
PresentationReceiver
-Objekt zurück, das verwendet werden kann, um auf den Browser-Kontext zuzugreifen und mit diesem zu kommunizieren, der die Präsentation kontrolliert. Diese Eigenschaft ist immer null
, wenn sie von außerhalb eines Browser-Kontextes zugegriffen wird, der eine Präsentation empfängt.
Wert
Wenn der Code in einem Kontext ausgeführt wird, der eine Präsentation empfängt, ist der zurückgegebene
Wert ein PresentationReceiver
, der dann verwendet werden kann, um mit dem Kontext zu kommunizieren, der die Quelle der Präsentation ist.
Wenn der aktuelle Kontext keine Präsentation empfängt, ist receiver
null
.
Beispiele
Bestimmen, ob der Kontext eine Präsentation empfängt oder nicht
Sie können leicht feststellen, ob der Kontext der Empfänger einer Präsentation ist, indem Sie den Wert von navigator.receiver
überprüfen. Wenn es ein nicht-null-Wert ist, empfängt der Kontext tatsächlich eine Präsentation. Wenn es null
ist, gibt es keine eingehende Präsentation.
footer.textContent = navigator.receiver ? "Receiving presentation" : "(idle)";
Zugriff auf die Verbindungs-Liste
Dieses Beispiel nutzt receiver
, um auf die Liste der eingehenden Verbindungen zuzugreifen und eine Liste der ID-Strings dieser Verbindungen zu erstellen und anzuzeigen.
const listElem = document.getElementById("connection-view");
navigator.presentation.receiver.connectionList.then((connections) => {
connections.forEach((aConnection) => {
listElem.appendChild(document.createElement("li")).textContent =
aConnection.id;
});
});
Nachdem der Zugriff auf das Ausgabelisten-Element in der Variablen
connectionView
hergestellt wurde, wird navigator.receiver
verwendet, um eine
Referenz auf das PresentationReceiver
-Objekt für diesen Kontext zu erhalten, und dessen
connectionList
wird verwendet, um ein
Promise
zu erhalten, das aufgerufen wird, wenn die Liste verfügbar ist.
Der Promise-Handler erhält als Eingabeparameter ein Array der eingehenden
Verbindungen. Wir iterieren über diese mit Hilfe von forEach()
,
indem wir ein neues Element zur connectionView
-Listenkomponente für jede
Verbindung hinzufügen.
Spezifikationen
Specification |
---|
Presentation API # dom-presentation-receiver |
Browser-Kompatibilität
BCD tables only load in the browser
Siehe auch
- Presentation API
Presentation
PresentationReceiver