Skip to content

Commit 916e00b

Browse files
committed
docs(MvuxXamlNavigation): Add linked Guide for the Mvux XamlNavigation Tutorial
1 parent 51a4885 commit 916e00b

6 files changed

Lines changed: 200 additions & 23 deletions

File tree

doc/articles/MvuxGallery/How-To-XamlNavigation.md renamed to doc/articles/Mvux.XamlNavigationApp/How-To-XamlNavigation.md

Lines changed: 2 additions & 16 deletions
Original file line numberDiff line numberDiff line change
@@ -89,20 +89,6 @@ Den Namespace, den wir in einer Xaml-basierten Navigation in einer Uno Anwendung
8989

9090
Anhand der MvuxGallery:
9191

92-
[!Video https://www.youtube.com/embed/vVvnK02r2ug?si=aa3V7HhtglLyCuXd]
92+
[!Video [Showcase Video](https://www.youtube.com/embed/vVvnK02r2ug?si=aa3V7HhtglLyCuXd)]
9393

94-
### Erstellen und Konfiguration der App mit dem Wizard
95-
96-
[!Video https://youtu.be/UGKidrvdKpQ?si=wXszYWvbK4R7FCUc]
97-
98-
(*weitere Video teile folgen!*)
99-
100-
## Weitere interessante Informationen
101-
102-
### Uno Documentation links
103-
104-
- [How-To: Navigate in Xaml](https://platform.uno/docs/articles/external/uno.extensions/doc/Learn/Navigation/HowTo-NavigateInXAML.html)
105-
- [How-To: Define Routes](https://platform.uno/docs/articles/external/uno.extensions/doc/Learn/Navigation/HowTo-DefineRoutes.html)
106-
- [How-To: Regions](https://platform.uno/docs/articles/external/uno.extensions/doc/Learn/Navigation/HowTo-Regions.html)
107-
- [How-To: Use NavigationView to Switch Views](https://platform.uno/docs/articles/external/uno.extensions/doc/Learn/Navigation/Advanced/HowTo-UseNavigationView.html)
108-
- [How-To: IRouteNotifier](https://platform.uno/docs/articles/external/uno.extensions/doc/Learn/Navigation/Advanced/HowTo-IRouteNotifier.html) (*möglicherweise fehlerhaft aktuell*)
94+
[!INCLUDE [How-To Navigation mit NavigationView in einer Mvux Xaml App](HowTo-Navigation-mit-NavigationView-in-Mvux-und-Xaml.md)]
Lines changed: 84 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,84 @@
1+
---
2+
uid: Mvux.XamlNavigationApp.HowTo-Navigation-mit-NavigationView-in-Mvux-und-Xaml
3+
---
4+
5+
# How To: Navigation mit einer `NavigationView` in einer XAML-Markup + MVUX Präsentation Uno Platform App
6+
7+
Dieses Beispiel zeigt, wie man das `NavigationView`-Steuerelement verwendet, um zwischen Seiten in einer XAML-Markup- + MVUX-Präsentations-App zu navigieren. Die App ist so strukturiert, dass sie eine einfache Navigation ermöglicht und das MVUX-Muster demonstriert – mit Fokus auf Kürze und Einfachheit.
8+
9+
**Das Beispiel enthält:**
10+
11+
- Ein `NavigationView`-Steuerelement zur Navigation.
12+
- Routen, die in der Datei `App.xaml` definiert sind.
13+
- Eine `MainPage.xaml`, die als Einstiegspunkt für die Navigation dient.
14+
- `DashboardPage` und `SecondPage` als Beispielseiten für die Navigation.
15+
- Jede Seite bindet an einen `IState<string>`-Eigenschaft im zugehörigen Model, um die Zustandsverwaltung gemäß MVUX zu demonstrieren.
16+
17+
Da diese Beispiel-App im Rahmen eines Community-Tutorial-Videos auf YouTube erstellt wurde, kannst du dem Video folgen und den Aufbau der App Schritt für Schritt nachvollziehen.
18+
19+
🔗 [Zur Playlist auf YouTube](https://youtube.com/playlist?list=PLEL6kb4Bivm_g81iKBl-f0eYPNr5h2dFX&si=qHkpAUMSW9s8GZCO)
20+
21+
Showcase-Video: [!Video [Navigation in Xaml und Mvux mit Navigation View (Showcase)](https://youtu.be/vVvnK02r2ug)]
22+
23+
---
24+
25+
## 🧰 Voraussetzungen
26+
27+
- Visual Studio 2022 oder neuer mit installierter Uno Platform-Erweiterung
28+
- Der Befehl `uno-check --tfm net9.0-desktop` im Terminal muss alle relevanten Prüfungen bestehen
29+
30+
- 📚 Weitere Informationen: [Uno Platform Dokumentation](https://platform.uno/docs/articles/external/uno.check/doc/using-uno-check.html)
31+
32+
### 📺 Videoanleitung
33+
34+
[!Video [How To: Einrichten unserer Uno Platform Entwicklungsumgebung](https://youtu.be/oI6IZVOeQBI)]]
35+
36+
---
37+
38+
## [⚙️ App-Konfiguration mit dem Visual Studio-Wizard](#tab/vs-wizard)
39+
40+
1. Erstelle eine neue Uno Platform App:
41+
42+
1. Wähle die Vorlage **`recommended`**
43+
1. Ziel-Framework: **`net9.0`**
44+
1. Markup: **`Xaml`**
45+
1. Präsentation: **`MVUX`**
46+
1. Erweiterungen: **`Regions`**, **`Dependency Injection`**
47+
1. *Optional: `Toolkit`, `Localization`, `Configuration`*
48+
49+
2. Klicke auf **`Create`**, um die App zu generieren.
50+
51+
### 📺 Video Tutorial zur Konfiguration
52+
53+
[!Video [How To: Konfigurieren unserer Uno App Visual Studio Wizard](https://youtu.be/UGKidrvdKpQ)]
54+
55+
---
56+
57+
## [🖥️ App-Konfiguration über die CLI](#tab/cli)
58+
59+
1. Öffne ein Terminal und navigiere in das gewünschte Verzeichnis.
60+
2. Führe folgenden Befehl aus, um eine neue App zu erstellen:
61+
62+
```bash
63+
dotnet new unoapp -o UnoApp2 -preset "recommended" -platforms "desktop" -config False -http "none" -loc False -dsp False -theme-service False
64+
```
65+
66+
---
67+
68+
## 📺 Tutorial Video: Navigation mit `NavigationView` in MVUX und XAML
69+
70+
Jetzt kann es auch schon loslegen mit der Navigation in deiner App! In diesem Video zeige ich dir, wie du das `NavigationView`-Steuerelement in einer XAML-Markup + MVUX-App einrichtest und verwendest. Wir werden die Navigation zwischen verschiedenen Seiten implementieren und dabei die MVUX-Prinzipien anwenden.
71+
72+
[!Video [Navigation in Xaml und Mvux mit Navigation View](https://youtu.be/knt2oOjHH30)]
73+
74+
[Hier geht's zum Source Code](../../../src/DevTKSS.Uno.XamlNavigationApp-1/)
75+
76+
## Weitere interessante Informationen
77+
78+
### Uno Documentation links
79+
80+
- [How-To: Navigate in Xaml](https://platform.uno/docs/articles/external/uno.extensions/doc/Learn/Navigation/HowTo-NavigateInXAML.html)
81+
- [How-To: Define Routes](https://platform.uno/docs/articles/external/uno.extensions/doc/Learn/Navigation/HowTo-DefineRoutes.html)
82+
- [How-To: Regions](https://platform.uno/docs/articles/external/uno.extensions/doc/Learn/Navigation/HowTo-Regions.html)
83+
- [How-To: Use NavigationView to Switch Views](https://platform.uno/docs/articles/external/uno.extensions/doc/Learn/Navigation/Advanced/HowTo-UseNavigationView.html)
84+
- [How-To: IRouteNotifier](https://platform.uno/docs/articles/external/uno.extensions/doc/Learn/Navigation/Advanced/HowTo-IRouteNotifier.html) (*möglicherweise fehlerhaft aktuell*)
Lines changed: 70 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,70 @@
1+
---
2+
uid: Mvux.XamlNavigationApp.HowTo-Navigation-with-NavigationView-in-Mvux-and-Xaml
3+
---
4+
5+
## How-To: Navigating with a NavigationView in a XAML Markup + MVUX Presentation App
6+
7+
This sample demonstrates how to use a `NavigationView` control to navigate between pages in a XAML Markup + MVUX Presentation App. The app is structured to allow for easy navigation and showcases the MVUX pattern, with focus on brevity and simplicity.
8+
9+
**The sample includes:**
10+
11+
- A `NavigationView` control for navigation.
12+
- Routes defined in the `App.xaml` file.
13+
- A `MainPage.xaml` that serves as the entry point for navigation.
14+
- `DashboardPage` and `SecondPage` as example pages to navigate to.
15+
- Each of the pages binds to a string statefull property to demonstrate state management gatered by the MVUX.
16+
17+
As this SampleApp is produces alongside a Community Tutorial Video on YouTube, you can follow along with the video to see how the app is built step-by-step.
18+
19+
- [Link to the Playlist](https://youtube.com/playlist?list=PLEL6kb4Bivm_g81iKBl-f0eYPNr5h2dFX&si=qHkpAUMSW9s8GZCO)
20+
21+
> [!NOTE]
22+
> Currently, the Videos are only available in German Language, but there are Transcriptions added to the Video Description, which should be useable through YouTube's Auto-Translate feature. There are also plans to create English Videos for this SampleApp in the future.
23+
24+
### Prerequisites
25+
26+
- Visual Studio 2022 or later with the Uno Platform extension installed.
27+
- `uno-check --tfm net9.0-desktop` command executed in the Terminal gives you green light for all applyable checks.
28+
29+
For more information on how to set up your development environment, refer to the [Uno Platform documentation](https://platform.uno/docs/articles/external/uno.check/doc/using-uno-check.html).
30+
31+
### [Configuring the App using the VS Wizard](#tab/vs-wizard)
32+
33+
To configure the app using the Visual Studio Wizard, follow these steps:
34+
35+
1. Create a new Uno Platform App:
36+
37+
1. Select the `recommended` Template.
38+
1. Select the `net9.0` target framework.
39+
1. Select `Xaml` as Markup.
40+
1. Select `MVUX` as Presentation.
41+
1. Select `Regions`, `Dependency Injection`, as Extensions.
42+
1. *Optional: `Toolkit` `Localization`, `Configuration`*
43+
44+
1. Click `Create` to generate the app.
45+
46+
### [Configuring the App using the CLI](#tab/cli)
47+
48+
To configure the app using the CLI, follow these steps:
49+
50+
1. Open a terminal and navigate to the directory where you want to create the app.
51+
1. Run the following command to create a new Uno Platform App:
52+
53+
```bash
54+
dotnet new unoapp -o UnoApp2 -preset "recommended" -platforms "desktop" -config False -http "none" -loc False -dsp False -theme-service False
55+
```
56+
57+
---
58+
<!--
59+
Here is a Video so you can follow along with the steps:
60+
61+
[!Video [Navigation in Xaml und Mvux mit Navigation View]()] // add link to the english localized video here, when available
62+
-->
63+
64+
### Tutorial Video: Navigation with `NavigationView` in MVUX and XAML
65+
66+
Now you can get started with the navigation in your app! In this video, I will show you how to set up and use the `NavigationView` control in a XAML Markup + MVUX Presentation App. We will implement navigation between different pages while applying the MVUX principles.
67+
68+
[!Video [Navigation in Xaml und Mvux mit Navigation View](https://youtu.be/knt2oOjHH30?si=PNgis0v9ZTR4LRsF)]
69+
70+
[Discover the Source Code](./)
Lines changed: 22 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,22 @@
1+
# DevTKSS.Uno.SampleApps.Mvux.XamlNavigationApp-de
2+
3+
Willkommen bei der Uno Platform und insbesondere bei diesem Community-Tutorial-Beispiel!
4+
5+
## Erste Schritte
6+
7+
Wie du mit deiner neuen App loslegst: [Link zur Uno Doku `Getting Started`](https://aka.platform.uno/get-started)
8+
9+
Weitere Informationen zur Verwendung des Uno.Sdk oder zum Aktualisieren der Uno Platform-Pakete in deiner Lösung: [Das Uno.Sdk benutzen](https://aka.platform.uno/using-uno-sdk)
10+
11+
## Tutorial zur Verwendung dieses Beispiels
12+
13+
Diese Beispiel-App ist Teil eines Community-Tutorials, das dich durch den Prozess des Aufbaus einer XAML-Navigations-App mit der Uno Platform führt.
14+
15+
Bitte wähle die Sprache deiner Wahl, um dem Tutorial zu folgen:
16+
17+
- [Deutsche Version](../../doc/articles/Mvux.XamlNavigationApp/HowTo-XamlNavigation.md)
18+
- [Englische Version](../../doc/articles/Mvux.XamlNavigationApp/HowTo-Navigation-with-NavigationView-in-Mvux-and-Xaml.md)
19+
20+
## Mitwirken
21+
22+
Wenn du zu diesem Beispiel beitragen möchtest, wirf einen Blick auf das [GitHub repository](https://github.com/DevTKSS/DevTKSS.Uno.SampleApps)
Lines changed: 22 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,22 @@
1+
# DevTKSS.Uno.SampleApps.Mvux.XamlNavigationApp-en
2+
3+
Welcome to the Uno Platform and particulary this Community Tutorial Sample!
4+
5+
## Getting Started
6+
7+
To discover how to get started with your new app: [Link to the Uno `Getting Started`](https://aka.platform.uno/get-started)
8+
9+
For more information on how to use the Uno.Sdk or upgrade Uno Platform packages in your solution: [Using the Uno.Sdk](https://aka.platform.uno/using-uno-sdk)
10+
11+
## Tutorial to follow along with this sample
12+
13+
This sample app is part of a Community Tutorial that will guide you through the process of building a XAML Navigation App using the Uno Platform.
14+
15+
Please select the language of your choice to follow along:
16+
17+
- [English](../../doc/articles/Mvux.XamlNavigationApp/HowTo-Navigation-with-NavigationView-in-Mvux-and-Xaml.md)
18+
- [German](../../doc/articles/Mvux.XamlNavigationApp/HowTo-Navigation-mit-NavigationView-in-Mvux-und-Xaml.md)
19+
20+
## Contributing
21+
22+
If you want to contribute to this sample, please check out the [GitHub repository](www.github.com/DevTKSS/DevTKSS.Uno.SampleApps)

src/DevTKSS.Uno.XamlNavigationApp-1/ReadMe.md

Lines changed: 0 additions & 7 deletions
This file was deleted.

0 commit comments

Comments
 (0)