Page Comparison

Der Navigator ist ein wichtiger Bestandteil der MainUI. Er ermöglicht es zwischen den verschiedenen Views einer Anwendung zu navigieren und kümmert sich automatisch um den korrekten Aufruf von Views bei Browser Vor- und Zurück Aktionen. Dazu müssen Sie die einzelnen Views initial beim Navigator registrieren und festlegen, wo genau die Views angezeigt werden sollen, z.B. in einem Layout, in einer UI-Komponente oder direkt in der MainUI. Sämtliche Einstellungen lassen sich über Properties vornehmen.  Anschließend lässt sich jede View mit der einfachen Methode navigateTo() aufrufen. Der Navigator ist keine UI-Komponenten, wird jedoch unter Structure angezeigt, um diesen selektieren und via Properties konfigurieren zu können.

...

 Um eine View aufrufen zu können, braucht diese einen Pfad, welcher auch als Route bezeichnet wird.

1. Zuerst müssen Sie das Root-Element der View auswählen
2. Danach unter Routing > Route einen beliebigen Pfad angeben. (Kann auch ein leerer String sein)

Image Added

Hinweis:

• Jede Route muss unique sein. Es können nie gleichzeitig mehrere Views mit der gleichen Route existieren

Navigieren zu einer anderen View

Um zu einer anderen View zu navigieren, gibt es mehrere Möglichkeiten.

Navigation mit RouterLinks

1. Ziehen Sie einen RouterLink auf die View
2. Klicken Sie in den Properties auf NavigationTarget
   Image Added
3. Im folgenden Dialog können Sie nach Ihrer View suchen, zu der dieser Link navigieren soll

Serverseitige Navigation

Der Server kann auch eine Navigation auslösen. Um das zu erreichen können Sie folgendes machen:

1. Ziehen Sie einen Button auf die View
2. Doppelklicken Sie den Button

3. Geben Sie danach folgenden Code ein:

   Code Block
   language java theme Confluence
   UI.getCurrent().navigate(OtherView.class)

   
   

Complexe Navigation

Manchmal müssen auch verschiedene Information an die aufzurufende View weitergegeben werden. Dazu können die folgenden Code-Snippets benutzt werden:

// Es können Datentypen wie z.B. String übergeben werden
UI.getCurrent().navigate(OtherView.class, "Hallo Welt");

In OtherView.class muss das HasUrlParameter<String> Interface implementiert werden
Um dort jetzt den Parameter zu bekommen, muss folgende Methode implementiert werden:

@Override
public void setParameter(final BeforeEvent event, final String parameter)
{
	System.out.println("Parameter was " + parameter);
}

Es können unter anderen auch Query Parameter übergeben werden. Mehr dazu kann hier nachgelesen werden: https://vaadin.com/docs/v14/flow/routing/tutorial-router-url-parameters

Es können aber auch mit Hilfe des RapidClipse Frameworks ganze Objekte übergeben werden.

Navigation.To(OtherView.class)
			.withParameter("myData", myData)
			.navigate();

Dazu muss in OtherView.java folgendes implementiert werden:

@NavigationParameter
private MyDataType myData;

@Override
public void navigationParametersUpdated()
{
	System.out.println("myData is now available!");
}

Hinweis:

• navigationParametersUpdated() muss nicht implementiert werden.
• Mit .withParameter() kann ein beliebiger Datentyp übergeben werden.