Für jedes client-seitige Webpart, das wir mit dem SharePoint Framework erstellen, können wir ein Symbol definieren, um es leicht von den anderen in der Toolbox sichtbaren Webparts unterscheiden zu können.
Bei der Erstellung von Webparts hilft es den Benutzern, diese unter anderen Webparts zu finden, wenn sie mit einem Symbol versehen werden. Icons von Client-Side Webparts werden im Webpart-Manifest im Abschnitt preconfiguredEntries festgelegt und es gibt zwei Möglichkeiten, das Webpart-Icon festzulegen.
Eine Möglichkeit, das Symbol eines clientseitigen Webparts festzulegen, ist die Verwendung eines benutzerdefinierten Bildes. Mit der Eigenschaft iconImageUrl sollten Sie eine absolute URL zu einem Bild von 38x38px angeben:
{ "$schema": "../../../node_modules/@microsoft/sp-module-interfaces/lib/manifestSchemas/jsonSchemas/clientSideComponentManifestSchema.json", "id": "e71c23c5-4ddb-40b6-9e52-d292a4d8300b", "componentType": "WebPart", "version": "0.0.1", "manifestVersion": 2, "preconfiguredEntries": [{ "groupId": "e71c23c5-4ddb-40b6-9e52-d292a4d8300b", "group": { "default": "Standard" }, "title": { "default": "Wetter" }, "description": { "default": "Zeigt das Wetter an dem angegebenen Ort" }, "iconImageUrl": "https://contoso.com/weather.png", "properties": { "location": "" } }] }
Eine weitere Möglichkeit, das Symbol eines Client-seitigen Webparts festzulegen, besteht darin, den Namen des Schriftartensymbols mit theofficeFabricIconFontName anzugeben.
{ "$schema": "../../../node_modules/@microsoft/sp-module-interfaces/lib/manifestSchemas/jsonSchemas/clientSideComponentManifestSchema.json", "id": "e71c23c5-4ddb-40b6-9e52-d292a4d8300b", "componentType": "WebPart", "version": "0.0.1", "manifestVersion": 2, "preconfiguredEntries": [{ "groupId": "e71c23c5-4ddb-40b6-9e52-d292a4d8300b", "group": { "default": "Standard" }, "title": { "default": "Wetter" }, "description": { "default": "Zeigt das Wetter an dem angegebenen Ort" }, "officeFabricIconFontName": "Sunny", "properties": { "location": "" } }] }
Trotz ihres Namens unterstützt die Eigenschaft officeFabricIconFontName nicht alle Symbole, die unter http://dev.office.com/fabric/styles aufgeführt sind. Hier ist die Liste aller Symbole, die Sie mit der Eigenschaft officeFabricIconFontName verwenden können.
Und so sehen sie aus:
Für den Fall, dass Sie einen genaueren Blick auf die Icons werfen möchten, habe ich ein Beispiel-Webpart erstellt, das sie anzeigt. Sie finden das Webpart auf GitHub unter https://github.com/waldekmastykarz/spfx-iconfontnames-webpart.
Das mit officeFabricIconFontName angegebene Symbol hat Vorrang vor dem Bildsymbol, das mit der Eigenschaft iconImageUrl festgelegt wurde. Falls Sie beide Werte angeben, wird das Symbol aus der Eigenschaft officeFabricIconFontName verwendet.
Merken