Modification de la barre de navigation fournie par l'application
Actuellement, la barre de navigation de l'application inclut des options de menu de recherche globale et d'alertes. Vous pouvez étendre la barre de navigation en fonction des besoins de votre entreprise et afficher les options de menu d'alerte ou de recherche globale personnalisée. Vous pouvez également masquer les options de menu globales ou d'alerte dans la barre de navigation ou ajouter une option de menu.
La barre de navigation prend en charge à la fois la substitution et l'extensibilité différentielle. En fonction de votre cas d'utilisation métier, vous pouvez choisir l'une de ces approches.
Dans l'approche d'extensibilité de substitution, vous pouvez être propriétaire du code source de la barre de navigation. Utilisez l'approche d'extensibilité de substitution comme point d'extension pour intégrer des fonctions qui ne peuvent pas être obtenues à l'aide de l'approche d'extensibilité différentielle dans la page d'accueil ou la barre de navigation. Pour plus d'informations, voir Personnaliser la barre de navigation grâce à l'extensibilité de l'override.
Extension des options de menu avec extensibilité différentielle
- Le composant de navigation Alertes s'affiche dans la barre de navigation, qui affiche les alertes entrantes. Ce composant se trouve dans le répertoire <store-temp>/packages/libs/functional-components/src/lib/alert et se développe ou se réduit lorsque vous cliquez sur l'icône en forme de cloche.
- Le composant de navigation Recherche globale s'affiche dans la barre de navigation. Vous pouvez effectuer une recherche globale pour ouvrir rapidement une commande. Ce composant se trouve dans le répertoire <store-temp>/packages/libs/functional-components/src/lib/global-search et se développe ou se réduit lorsque vous cliquez sur l'icône de recherche.
- Vous pouvez remplacer les options de menu de recherche globale et d'alerte fournies par l'application par des composants personnalisés.
- Vous pouvez masquer les options de menu de recherche globale et d'alerte fournies par l'application.
- Vous pouvez ajouter une option de menu. Pour plus d'informations, voir Ajouter une option de menu.
Pour mapper les options de menu de la barre de navigation fournie par l'application avec le composant personnalisé, utilisez le fichier <store-temp>/extensions/features/override-component/src/assets/override-component/config/isf-navbar-extn-config.json . Dans le fichier JSON, veillez à mapper les identificateurs uniques des composants fournis par l'application avec les composants remplacés.
isf-navbar-extn-config.json :| Nom d'attribut | Descriptif |
|---|---|
| menuTID | Indique l'identificateur unique de l'option de menu affichée dans la barre de navigation. Les valeurs valides sont |
| componentName | Indique le nom du composant chargé dans la barre de navigation. Par exemple, AlertsExtnComponent ou GlobalSearchExtnComponent. |
| affichage | Indique si l'option de menu doit être affichée ou masquée dans la barre de navigation. Les valeurs valides sont true ou false. La valeur par défaut est true. |
Lorsque vous remplacez un composant de navigation fourni par l'application, mettez à jour <store-temp>/extensions/features/override-component/src/assets/override-component/config/isf-navbar-extn-config.json avec les attributs décrits dans le tableau.
L'exemple de fichier isf-navbar-extn-config.json suivant montre comment masquer le menu de recherche globale et remplacer l'option de menu d'alerte fournie par l'application par le composant personnalisé AlertsExtensionComponent .
[
{
"menuTID": "navBarMenuWidget_1",
"display": false
},
{
"menuTID": "navBarMenuWidget_2",
"componentName": "AlertsExtensionComponent"
}
]
Procédure
- Créez un composant personnalisé.Accédez au répertoire <store-temp>/extensions/features/override-component/src/app/components et exécutez la commande suivante:
ng g c <componentName> --prefix=isf - Ajoutez la variable de chaîne statique
overrideComponentavec la valeur comme nom de classe de composant, comme illustré..... public static overrideComponent = 'AlertsExtensionComponent'; .... - Mettez à jour le nom de classe de composant personnalisé.
Accédez au répertoire <store-temp>/extensions/features/override-component/src/app . Ouvrez le fichier
app.module.tset mettez à jour le nom de classe de composant personnalisé dans l'objetcustomComponentDeclarations. - Mettez à jour le fichier <store-temp>/extensions/features/override-component/src/assets/override-component/config/isf-navbar-extn-config.json avec les détails appropriés. Par exemple, pour remplacer le composant d'alerte fourni par l'application par le
AlertsExtensionComponentpersonnalisé, procédez à la mise à jour comme suit:[ { "menuTID": "navBarMenuWidget_2", "componentName": "AlertsExtensionComponent" } ] - Vérifiez que vos modifications sont reflétées dans la barre de navigation.Pour vérifier localement la barre de navigation fournie par l'application étendue, démarrez l'application en exécutant la commande suivante:
yarn start-app
Etape suivante
Pour vérifier les modifications dans le kit d'outils de développement, extrayez et déployez les personnalisations. Pour plus d'informations sur l'extraction et le déploiement des personnalisations, voir Extraction des personnalisations.