Office Web Widgets – Experimentelle Übersicht
Warnung
Die Office Web Widgets – Experimental werden nur zu Forschungs- und Feedback-Zwecken bereitgestellt. Verwenden Sie diese Widgets nicht in Produktionsszenarien. Das Verhalten der Office Web Widgets kann sich in zukünftigen Versionen signifikant ändern. Lesen und prüfen Sie die Lizenzbedingungen für Office Web Widgets – Experimental.
Clientsteuerelemente wie die Office Web Widgets – Experimental können den Arbeitsaufwand zur Erstellung von Add-Ins deutlich reduzieren und gleichzeitig die Qualität der Add-Ins steigern. Damit dies zutrifft, müssen die Widgets bestimmte Kriterien erfüllen.
Widgets müssen
auf die Verwendung auf jeder Webseite ausgelegt sein, auch wenn die Seite nicht auf SharePoint gehostet wird.
innerhalb der Office-Steuerelementlaufzeit funktionieren. Dadurch können wir einen allgemeinen Satz von Anforderungen und eine einheitliche Syntax zur Verwendung der Widgets bereitstellen.
über die domänenübergreifende Bibliothek mit SharePoint kommunizieren. Widgets weisen keine Abhängigkeit von einer bestimmten serverseitigen Plattform oder Technologie auf. Sie können die Widgets unabhängig von der von Ihnen gewählten Servertechnologie verwenden.
mit anderen Elementen auf der Seite zusammen verwendet werden können. Das Einfügen des Widgets auf einer Seite sollte keine anderen Elemente auf der Seite ändern.
Widgets müssen mit vorhandenen Frameworks kompatibel sein. Es sollte sichergestellt sein, dass Sie Ihre vertrauten Tools und Technologien weiterhin verwenden können.
Ein Add-In- das Office Web Widgets – Experimental verwendet
Sie können die Widgets verwenden, indem Sie das NuGet-Paket für Office Web Widgets – Experimental aus Visual Studio installieren. Weitere Informationen finden Sie unter NuGet-Paket-Manager-Benutzeroberfläche. Sie können auch die NuGet-Katalogseite durchsuchen.
Ihr Feedback und Ihre Kommentare haben uns bei der Auswahl bereitgestellter Widgets geholfen. Wie Sie in der Abbildung oben sehen, können Sie jetzt das (1) Personenauswahl- und das (2) Desktoplistenansichts-Widget ausprobieren und damit experimentieren. Bitte erhalten Sie das Feedback auf der UserVoice-Website der Office Developer Platform.
Sie können außerdem im Codebeispiel Demo zu Office Web Widgets – Experimental sehen, wie die Widgets eingesetzt werden.
Personenauswahl-Widget
Sie können das experimentelle Personenauswahl-Widget in Add-Ins verwenden, um Ihren Benutzern zu helfen, Personen und Gruppen in einem Mandanten zu suchen und auszuwählen. Benutzer können beginnen, etwas in das Textfeld einzugeben, und das Widget ruft die Personen ab, deren Name oder E-Mail-Adresse mit dem Text übereinstimmt.
Personenauswahl-Widget beim Auflösen einer Abfrage
Sie können das Widget im HTML-Markup oder programmgesteuert mithilfe von JavaScript deklarieren. In beiden Fällen können Sie ein div-Element als Platzhalter für das Widget festlegen. Sie können auch Eigenschaften und Ereignishandler für das Personenauswahl-Widget festlegen. Die folgende Tabelle zeigt die im Personenauswahl-Widget verfügbaren Eigenschaften und Ereignisse.
| Eigenschaft/Ereignis | Typ | Beschreibung |
|---|---|---|
| objectType | JSON-Objekt (Liste mit Zeichenfolgen) | Art von Elementen, die das Widget auflöst. Optionen: Die Standardeinstellung für Benutzergruppe ist nur benutzer. |
| allowMultipleSelections | Boolesch | Wahr/Falsch. Wahr/Falsch. Wenn falsch, sollte das Widget die Auswahl von jeweils nur einem Element zulassen. Standard=Falsch. |
| rootGroupName | Zeichenfolge | Wenn angegeben, beschränkt das Widget die Auswahl auf Elemente in dieser Gruppe. Wenn nicht angegeben, fragt das Widget Objekte vom gesamten Mandanten ab. |
| selectedItems | JSON-Array | Liste ausgewählter Elemente. Jedes Element gibt ein Objekt zurück, das einen Benutzer oder eine Gruppe darstellt. |
| onAdded | Funktion | Ereignis, das ausgelöst wird, wenn der Auswahl ein neues Objekt hinzugefügt wird. Die Handlerfunktion hat das hinzugefügte Objekt erhalten. |
| onRemoved | Funktion | Ereignis, das ausgelöst wird, wenn aus der Auswahl ein neues Objekt entfernt wird. Die Handlerfunktion hat das entfernte Objekt erhalten. |
| onChange | Funktion | Das Hinzufügen oder Entfernen von Objekten löst dieses Ereignis aus. An die Handlerfunktion werden keine Parameter übergeben. |
| validationErrors | Bereich | Bereich möglicher Validierungsfehler: leer, unresolvedItem, tooManyItems |
| autoShowValidationMessage | Boolesch | Wahr=Anzeigen Falsch=Nicht anzeigen |
| hasErrors | Boolesch | Wahr= Es liegen 1 oder mehrere Validierungsfehler vor. Falsch= Es liegen keine Validierungsfehler vor. |
| errors | Bereich | Bereich möglicher Validierungsfehler: leer, unresolvedItem, tooManyItems |
| displayErrors | Boolesch | Wahr=Fehler anzeigen Falsch=Fehler nicht anzeigen |
Die CSS-Klassen für das Personenauswahl-Widget sind im Stylesheet Office.Controls.css definiert. Sie können die Klassen überschreiben und das Widget für Ihr Add-In anpassen.
Weitere Informationen finden Sie unter Verwenden des experimentellen Personen Picker-Widgets in SharePoint-Add-Ins und Verwenden des experimentellen Personen Picker-Widgets in einem Add-In-Codebeispiel.
Desktoplistenansichts-Widget
Ihre Benutzer können vom Desktoplistenansichts-Widget profitieren und die Daten wie mit dem regulären Listenansichts-Widget in einer Liste anzeigen. Sie können es aber in Add-Ins verwenden, die nicht unbedingt in SharePoint gehostet werden.
Desktoplistenansichts-Widget, das die Daten in einer Liste anzeigt
Sie können eine vorhandene Ansicht für die Liste festlegen. Das Widget gibt die Felder in der Reihenfolge wieder, in der sie in der Ansicht angezeigt werden.
Hinweis
Aktuell zeigt das Desktoplistenansichts-Widget nur die Daten an. Es bietet keine Funktionen zur Bearbeitung.
Sie können mit einem div -Element einen Platzhalter für das Widget angeben. Sie können das Widget programmgesteuert oder deklarativ verwenden.
Sie können außerdem Eigenschaften oder Ereignishandler für das Desktoplistenansichts-Widget festlegen. Die folgende Tabelle zeigt die im Desktoplistenansichts-Widget verfügbaren Eigenschaften und Ereignisse.
| Eigenschaft/Ereignis | Typ | Beschreibung |
|---|---|---|
| listUrl | URL | URL der Listenansicht, aus der Elemente abgerufen werden. Es kann sich um eine relative URL handeln, wobei dann davon ausgegangen wird, dass sie sich im Add-In-Web selbst oder unter einer absoluten URL befindet. |
| viewName | Zeichenfolge | Name der angezeigten Ansicht. Dies ist der Programmname der Ansicht (nicht der Anzeigename). |
| onItemSelected | Funktion | Ereignis, das ausgelöst wird, wenn ein Element in der Liste ausgewählt wird. |
| onItemAdded | Funktion | Ereignis, das ausgelöst wird, wenn der Liste ein neues Objekt hinzugefügt wird. |
| onItemRemoved | Funktion | Ereignis, das ausgelöst wird, wenn ein Element aus der Liste entfernt wird. |
| selectedItems | Bereich | Liste ausgewählter Elemente im JSON-Format. |
Das Widget erfordert das SharePoint-Website-Stylesheet. Sie können direkt auf das SharePoint-Stylesheet verweisen oder das Chrome-Widget verwenden. Weitere Informationen zum Stylesheet finden Sie unter Verwenden des Stylesheets einer SharePoint-Website in SharePoint-Add-Ins und Verwenden des Client-Chromsteuerelements in SharePoint-Add-Ins.
Erfahren Sie im Codebeispiel Use the Desktop List View experimental widget in an add-in, wie das Listenansichts-Widget eingesetzt wird. Lesen Sie außerdem Verwenden des experimentellen Desktoplistenansichts-Widgets in Add-Ins für SharePoint.
Widgets können Ihnen helfen, den Entwicklungsprozess zu beschleunigen, die Kosten zu reduzieren und die Markteinführung Ihrer Add-Ins zu verkürzen. Office Web Widgets - Experimental bietet Widgets, die Sie in Nicht-Produktions-Add-Ins verwenden können. Wir freuen uns auf Ihr Feedback und Ihre Kommentare auf der Office Developer Platform UserVoice-Website.