Skip to content

Commit d2c6eda

Browse files
Karl-Bridge-Microsoftthomasclaudiushuberlearn-build-service-prod[bot]desigritjwmsft
authored
Administrative overhead for PR 5339 (#5342)
* Update release-channels.md and put Stable, Preview, Exp in correct order Table should have the rows sorted by channel in the order Stable, Preview, Experimental, as this is the logical order that is also used for the navigation in the docs. * Update support.md and include 1.7 SDK in table with supported Windows versions As 1.7 SDK was released, it should be included in the table with supported Windows client/server versions * This PR lists out an option for enterprise admins to block the Microsoft Store Web Installer on domain managed devices. * update back navigation (#5333) * add navigation articles for UWP * remove UWP content * add back nav guidelines moved from nav history doc * update for WinUI 3 * fix yaml header * fix links * Update release date in documentation * Kbridge/main/1.7 stable/rich edit box mathmode (#5338) * snapshot * added math mode detail * Move cross device people API topic in TOC * Kbridge/main/multilingula app toolkit deprecation (#5339) * added deprecation notices * email link * feedback revs --------- Co-authored-by: Thomas Claudius Huber <[email protected]> Co-authored-by: learn-build-service-prod[bot] <113403604+learn-build-service-prod[bot]@users.noreply.github.com> Co-authored-by: Raunak Oberoi <[email protected]> Co-authored-by: Jim Walker <[email protected]> Co-authored-by: Learn Build Service GitHub App <Learn Build Service [email protected]> Co-authored-by: John Kennedy <[email protected]> Co-authored-by: Alvin Ashcraft <[email protected]> Co-authored-by: Alvin Ashcraft <[email protected]>
1 parent 17c841a commit d2c6eda

19 files changed

+1466
-1130
lines changed

Diff for: hub/apps/design/basics/navigate-between-two-pages.md

+7-414
Large diffs are not rendered by default.

Diff for: hub/apps/design/basics/navigation-basics.md

+54-1
Original file line numberDiff line numberDiff line change
@@ -5,7 +5,7 @@ ms.assetid: B65D33BA-AAFE-434D-B6D5-1A0C49F59664
55
label: Navigation design basics
66
template: detail.hbs
77
op-migration-status: ready
8-
ms.date: 09/24/2020
8+
ms.date: 04/03/2025
99
ms.topic: article
1010
keywords: windows 10, uwp
1111
ms.localizationpriority: medium
@@ -256,6 +256,59 @@ Embedded navigation elements can appear in a page's content. Unlike other naviga
256256
:::column-end:::
257257
:::row-end:::
258258

259+
## Guidelines for custom back navigation behavior
260+
261+
If you choose to provide your own back stack navigation, the experience should be consistent with other apps. We recommend that you follow the following patterns for navigation actions:
262+
263+
<div class="mx-responsive-img">
264+
<table>
265+
<thead>
266+
<tr class="header">
267+
<th align="left">Navigation action</th>
268+
<th align="left">Add to navigation history?</th>
269+
</tr>
270+
</thead>
271+
<tbody>
272+
<tr class="odd">
273+
<td><strong>Page to page, different peer groups</strong></td>
274+
<td><strong>Yes</strong>
275+
<p>In this illustration, the user navigates from level 1 of the app to level 2, crossing peer groups, so the navigation is added to the navigation history.</p>
276+
<p><img src="images/back-nav/nav-pagetopage-diffpeers-imageonly1.png" alt="Diagram of navigation across peer groups showing the user navigating from group one to group two and the back to group one." /></p>
277+
<p>In the next illustration, the user navigates between two peer groups at the same level, again crossing peer groups, so the navigation is added to the navigation history.</p>
278+
<p><img src="images/back-nav/nav-pagetopage-diffpeers-imageonly2.png" alt="Diagram of navigation across peer groups showing the user navigating from group one to group two then on to group three and back to group two." /></p></td>
279+
</tr>
280+
<tr class="even">
281+
<td><strong>Page to page, same peer group, no on-screen navigation element</strong>
282+
<p>The user navigates from one page to another with the same peer group. There is no on-screen navigation element (such as <a href="/windows/apps/design/controls/navigationview">NavigationView</a>) that provides direct navigation to both pages.</p></td>
283+
<td><strong>Yes</strong>
284+
<p>In the following illustration, the user navigates between two pages in the same peer group, and the navigation should be added to the navigation history.</p>
285+
<p><img src="images/back-nav/nav-pagetopage-samepeer-noosnavelement.png" alt="Navigation within a peer group" /></p></td>
286+
</tr>
287+
<tr class="odd">
288+
<td><strong>Page to page, same peer group, with an on-screen navigation element</strong>
289+
<p>The user navigates from one page to another in the same peer group. Both pages are shown in the same navigation element, such as <a href="/windows/apps/design/controls/navigationview">NavigationView</a>.</p></td>
290+
<td><strong>It depends</strong>
291+
<p>Yes, add to the navigation history, with two notable exceptions. If you expect users of your app to switch between pages in the peer group frequently, or if you wish to preserve the navigational hierarchy, then do not add to the navigation history. In this case, when the user presses back, go back to the last page before the user navigated to the current peer group. </p>
292+
<p><img src="images/back-nav/nav-pagetopage-samepeer-yesosnavelement.png" alt="Navigation across peer groups when a navigation element is present" /></p></td>
293+
</tr>
294+
<tr class="even">
295+
<td><strong>Show a transient UI</strong>
296+
<p>The app displays a pop-up or child window, such as a dialog, splash screen, or on-screen keyboard, or the app enters a special mode, such as multiple selection mode.</p></td>
297+
<td><strong>No</strong>
298+
<p>When the user presses the back button, dismiss the transient UI (hide the on-screen keyboard, cancel the dialog, etc) and return to the page that spawned the transient UI.</p>
299+
<p><img src="images/back-nav/back-transui.png" alt="Showing a transient UI" /></p></td>
300+
</tr>
301+
<tr class="odd">
302+
<td><strong>Enumerate items</strong>
303+
<p>The app displays content for an on-screen item, such as the details for the selected item in list/details list.</p></td>
304+
<td><strong>No</strong>
305+
<p>Enumerating items is similar to navigating within a peer group. When the user presses back, navigate to the page that preceded the current page that has the item enumeration.</p>
306+
<p><img src="images/back-nav/nav-enumerate.png" alt="Iterm enumeration" /></p></td>
307+
</tr>
308+
</tbody>
309+
</table>
310+
</div>
311+
259312
## Next: Add navigation code to your app
260313

261314
The next article, [Implement basic navigation](navigate-between-two-pages.md), shows the code required to use a `Frame` control to enable basic navigation between two pages in your app.

0 commit comments

Comments
 (0)