Contrôles utilisateur et contrôles Web dans le modèle SharePoint de recherche
L’approche que vous appliquez pour implémenter des contrôles personnalisés dans votre code est différente dans le nouveau modèle de SharePoint par rapport au code de confiance totale. Dans un scénario classique de code de confiance totale/solution de batterie de serveurs, les contrôles personnalisés étaient créés en tant que contrôles utilisateur ou contrôles web et déployés via SharePoint Solutions.
Dans un SharePoint de modèle de SharePoint, javaScript est incorporé pour implémenter des contrôles personnalisés.
Conseils généraux
En règle générale, nous voulons fournir les instructions générales suivantes pour la création de contrôles personnalisés dans le nouveau modèle de SharePoint de gestion.
- Utilisez JavaScript incorporé pour créer des contrôles personnalisés.
- Utilisez le modèle objet côté client SharePoint ECMA (CSOM) et/ou les API REST SharePoint/Office 365 pour interagir avec SharePoint données et services.
Options d’incorporation de JavaScript dans SharePoint pages
Vous avez plusieurs options pour incorporer JavaScript dans SharePoint pages.
- Utiliser des actions utilisateur personnalisées
- Incorporer JavaScript directement dans les mises en page
- Incorporer JavaScript directement dans les pages maîtres personnalisées (non recommandé)
Utiliser des actions utilisateur personnalisées
Dans ce modèle, les actions utilisateur personnalisées sont utilisées pour incorporer JavaScript dans une page au moment de l’utilisation.
- Cette approche est absolument prise en charge et est une approche valide.
Quand est-elle adaptée ?
Lorsque vous devez incorporer JavaScript dans toutes vos pages SharePoint, cette option est adaptée.
Prise en main
L’article suivant et la vidéo qui l’accompagne montrent comment utiliser des actions utilisateur personnalisées pour incorporer JavaScript dans SharePoint pages.
- Core.EmbedJavaScript (exemple PnP O365)
- OD4B. NavLinksInjection (exemple PnP O365)
- Navigation entre collections de sites (vidéo PnP O365)
Incorporer JavaScript directement dans les mises en page
Dans ce modèle, JavaScript est incorporé directement dans les mises en page dans les sites de publication.
- Cette approche est absolument prise en charge et est une approche valide.
- Cette approche fonctionne avec les sites de publication.
Quand est-elle adaptée ?
Lorsque vous devez incorporer JavaScript dans des mises en SharePoint de page spécifiques dans les sites de publication dans un scénario WCM, cette option convient parfaitement.
Incorporer JavaScript directement dans les pages maîtres personnalisées
Dans ce modèle, JavaScript est incorporé directement dans les pages maîtres personnalisées.
- Cette approche n’est pas recommandée.
- Cette approche est valide.
- Vous pouvez incorporer JavaScript directement dans les pages maîtres personnalisées, mais gardez à l’esprit que cela vous entraîne des coûts supplémentaires à long terme et des défis avec les mises à jour futures.
- Si vous avez choisi d'utiliser des pages de base personnalisées, soyez prêt à appliquer des changements aux pages de base personnalisées lorsque des mises à jour fonctionnelles majeures sont appliquées à Office 365.
Quand est-elle adaptée ?
Lorsque vous devez incorporer JavaScript par page maître, il s’agit d’une bonne option, car elle vous permet de contrôler les pages maîtres dans lesquelles javaScript est incorporé.
Liens connexes
- Navigation entre collections de sites (vidéo PnP O365)
- Articles de référence sur la page https://aka.ms/OfficeDevPnPGuidance
- Références dans MSDN sur la page https://aka.ms/OfficeDevPnPMSDN
- Vidéos sur la page https://aka.ms/OfficeDevPnPVideos
Exemples PnP
- Core.EmbedJavaScript (exemple PnP O365)
- OD4B. NavLinksInjection (exemple PnP O365)
- Core.EmbedJavaScript.WeekNumbers (exemple PnP O365)
- Core.EmbedJavaScriptJSOM (exemple PnP O365)
- Core.JavaScriptCustomization (scénario PnP O365 à l’aide du composant principal PnP)
- Exemples et contenu dans Microsoft 365 et pratiques PnP (Patterns and Practices)
S’applique à
- Office 365 multi-locataire (MT).
- Office 365 dédiés (D)
- SharePoint 2013 en local