Navigation

Gérer la navigation entre les différents écrans


FlowerDocs s’appuie sur un mécanisme de place permettant de définir dans l’URL l’activité (ou écran) sur laquelle se trouve l’utilisateur. Le fait que cette place soit portée par l’URL permet aux utilisateurs de pouvoir :

  • rafraîchir leur navigateur tout en restant dans le même contexte
  • de naviguer à travers l’historique du navigateur (boutons Précédent et Suivant)

Pour piloter ces fonctionnalités à travers l’API JavaScript, une API de navigation est mise à disposition :

JSAPI.get().getNavigationAPI();
Fonctions Description
reload() Permet de recharger la place courante sans confirmation
goBack() Permet de revenir à la place précédente (équivalent au bouton précédent)
getWhereId() Permet d’obtenir l’identifiant de la place courante
getWhere() Permet d’obtenir le type de la place courante
goToComponentPlace(category, identifiant, confirmation) Permet de rediriger l’utilisateur vers l’écran de modification d’un composant en fournissant :
-category : DOCUMENT, FOLDER, TASK, VIRTUAL_FOLDER
-identifiant : identifiant du composant à ouvrir
-confirmation : booléen permettant de désactiver la confirmation au changement de place
goTo(place, confirmation) Permet de rediriger l’utilisateur vers une place avec possibilité ou non de désactivation de confirmation de changement de place

L’API de navigation permet également de surcharger la place défaut (définie au niveau du profile). Pour cela, il est possible de s’abonner à son ouverture via la fonction registerForPlaceChange(callback)

Exemple : Surcharger la place par défaut par le formulaire de recherche pliSearch

var api = JSAPI.get().getNavigationAPI();
api.registerForPlaceChange(function(placeToken, callback){
   callback.go(flower.docs.PlaceBuilder.build("search(pliSearch)"));
});