Widgets Office web - Vue d’ensemble expérimentale
Avertissement
Les widgets web Office expérimentaux sont proposés pour simplifier les recherches et le partage de commentaires. Ne les utilisez pas en phase de production. Le comportement des widgets web Office peut considérablement changer dans les prochaines versions. Lisez les termes du contrat de licence des widgets web Office expérimentaux.
Les contrôles clients, tels que les widgets web Office expérimentaux, peuvent nettement réduire la durée de développement des compléments, et simultanément, améliorer leur qualité. Pour cela, les widgets doivent répondre à certains critères.
Ils doivent :
être conçus pour être utilisés dans n’importe quelle page web, même si la page n’est pas hébergée sur SharePoint.
fonctionner dans le runtime des contrôles Office. Ainsi, nous pouvons respecter un ensemble d’exigences communes et fournir une syntaxe cohérente nécessaires à l’utilisation des widgets.
communiquer avec SharePoint via la bibliothèque inter-domaines. Les widgets ne dépendent pas d’une plateforme ou technologie côté serveur particulière. Ainsi, vous pouvez utiliser les widgets quelle que soit la technologie de serveur choisie.
coexister avec d’autres éléments de la page. L’inclusion d’un widget sur une page ne doit pas modifier les autres éléments qu’elle contient.
Ne malmenez pas les infrastructures existantes. Nous voulons être sûrs que vous pouvez toujours utiliser les outils et technologies auxquels vous êtes habitué.
Complément utilisant les widgets web Office expérimentaux
Vous pouvez utiliser les widgets en installant le package NuGet Office Web Widgets - Experimental de Visual Studio. Pour en savoir plus, consultez l’article Interface utilisateur du Gestionnaire de Package NuGet. Vous pouvez également parcourir la page de la galerie NuGet.
Grâce à vos commentaires, nous avons pu sélectionner les widgets à fournir. Comme vous pouvez le voir dans la figure précédente, vous pouvez désormais tester les widgets Sélecteur de personnes (1) et Affichage de liste de bureau (2). Veuillez conserver les commentaires à venir sur le site UserVoice de la plateforme de développement Office.
Vous pouvez également afficher les widgets en action dans l’exemple de code Office Web Widgets - Experimental Demo.
Widget Sélecteur de personnes
Vous pouvez utiliser le widget Sélecteur de personnes expérimental dans les compléments pour faciliter la recherche et la sélection de personnes et de groupes sur un client. Les utilisateurs commencent la saisie dans la zone de texte et le widget récupère les personnes dont le nom ou l'adresse de messagerie correspond au texte entré.
Widget Sélecteur de personnes résolvant une requête
Vous pouvez déclarer le widget dans les balises HTML ou via un programme à l’aide de JavaScript. Dans les deux cas, utilisez un élément div comme espace réservé du widget. Vous pouvez également définir des propriétés et des gestionnaires d'événements pour le widget Sélecteur de personnes. Le tableau suivant présente les propriétés et événements disponibles pour le widget Sélecteur de personnes.
| Propriété/Événement | Type | Description |
|---|---|---|
| objectType | Objet JSON (liste de chaînes) | Type des éléments résolus par le widget. Options : Groupe d’utilisateurs Par défaut, utilisateur uniquement. |
| allowMultipleSelections | Valeur booléenne | True/False. Avec False, le widget autorise la sélection d’un seul élément à la fois. Valeur par défaut : False. |
| rootGroupName | String | S’il est renseigné, le widget limite la sélection à des éléments de ce groupe. Sinon, il envoie une requête aux objets de l’ensemble de la location. |
| selectedItems | Tableau JSON | Liste des éléments sélectionnés. Chaque élément renvoie un objet représentant un utilisateur ou un groupe. |
| onAdded | Fonction | Événement qui se déclenche quand un nouvel objet est ajouté à la sélection. L'objet ajouté est reçu par la fonction de gestionnaire. |
| onRemoved | Fonction | Événement qui se déclenche quand un nouvel objet est supprimé de la sélection. L'objet supprimé est reçu par la fonction de gestionnaire. |
| onChange | Fonction | Événement qui se déclenche en cas d'ajout ou de suppression d'objets. Aucun paramètre n'est transmis à la fonction de gestionnaire. |
| validationErrors | Tableau | Tableau des erreurs de validation possibles : empty, unresolvedItem, tooManyItems. |
| autoShowValidationMessage | Booléen | True : afficher. False : ne pas afficher. |
| hasErrors | Booléen | True : une ou plusieurs erreurs de validation. False : aucune erreur de validation. |
| erreurs | Tableau | Tableau des erreurs de validation possibles : empty, unresolvedItem, tooManyItems. |
| displayErrors | Booléen | True : afficher les erreurs. False : ne pas afficher les erreurs. |
Les classes CSS du widget Sélecteur de personnes sont définies dans la feuille de style Office.Controls.css. Vous pouvez remplacer les classes et choisir le style du widget pour votre complément.
Pour plus d’informations, voir Utiliser le widget de sélecteur de Personnes expérimental dans les compléments SharePoint et Utiliser le widget expérimental sélecteur de Personnes dans un exemple de code de complément.
Widget Affichage de liste du bureau
Comme le widget d'affichage de liste standard, le widget d'affichage de liste permet à vos utilisateurs d'afficher les données dans une liste. Il n'est en outre pas limité aux compléments hébergés par SharePoint.
Widget Affichage de liste du bureau affichant les données dans une liste
Vous pouvez spécifier un affichage existant dans la liste. Le widget affiche les champs selon leur ordre d’apparition dans l’affichage.
Remarque
Pour le moment, le widget Affichage de liste de bureau affiche uniquement les données. Il ne propose pas de fonctionnalités de modification.
Vous pouvez fournir un espace réservé au widget à l'aide d'un élément div. Vous pouvez utiliser le widget par programmation ou de façon déclarative.
Vous pouvez également définir des propriétés ou des gestionnaires d'événements pour le widget d'affichage de liste de bureau. Le tableau suivant présente les propriétés et événements disponibles pour le widget d'affichage de liste de bureau.
| Propriété/Événement | Type | Description |
|---|---|---|
| listUrl | URL | URL de l’affichage de liste où les éléments sont récupérés. Il peut s’agir d’une URL relative (dans ce cas, elle se trouve sur le site web de complément) ou d’une URL absolue. |
| viewName | String | Nom de l’affichage à afficher. Il s'agit du nom de programmation de l'affichage (pas de son nom complet). |
| onItemSelected | Fonction | Événement qui se déclenche quand un élément est sélectionné dans la liste. |
| onItemAdded | Fonction | Événement qui se déclenche quand un nouvel élément est ajouté à la liste. |
| onItemRemoved | Fonction | Événement qui se déclenche quand un élément est supprimé de la liste. |
| selectedItems | Tableau | Liste des éléments au format JSON sélectionnés. |
Le widget requiert la feuille de style du site web SharePoint. Vous pouvez référencer la feuille de style SharePoint directement ou utiliser le widget de chrome. Pour plus d’informations sur la feuille de style, voir Utiliser la feuille de style d’un site web SharePoint dans les compléments SharePoint et Utiliser le contrôle chrome client dans les compléments SharePoint.
Pour afficher le widget Affichage de liste en action, consultez l’exemple de code Utiliser le widget d’affichage de liste de bureau expérimental dans un complément. Consultez également Utiliser le widget Affichage de liste du bureau expérimental dans les compléments SharePoint.
Les widgets peuvent vous aider à accélérer le processus de développement et la publication de vos compléments, et à en réduire le coût. Vous pouvez utiliser les widgets web Office expérimentaux dans vos compléments hors environnement de production. N’hésitez pas à nous faire part de vos commentaires sur le site Office Developer Platform UserVoice.