You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
* 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]>
@@ -256,6 +256,59 @@ Embedded navigation elements can appear in a page's content. Unlike other naviga
256
256
:::column-end:::
257
257
:::row-end:::
258
258
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
+
<divclass="mx-responsive-img">
264
+
<table>
265
+
<thead>
266
+
<trclass="header">
267
+
<thalign="left">Navigation action</th>
268
+
<thalign="left">Add to navigation history?</th>
269
+
</tr>
270
+
</thead>
271
+
<tbody>
272
+
<trclass="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><imgsrc="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><imgsrc="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
+
<trclass="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 <ahref="/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><imgsrc="images/back-nav/nav-pagetopage-samepeer-noosnavelement.png"alt="Navigation within a peer group" /></p></td>
286
+
</tr>
287
+
<trclass="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 <ahref="/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><imgsrc="images/back-nav/nav-pagetopage-samepeer-yesosnavelement.png"alt="Navigation across peer groups when a navigation element is present" /></p></td>
293
+
</tr>
294
+
<trclass="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><imgsrc="images/back-nav/back-transui.png"alt="Showing a transient UI" /></p></td>
300
+
</tr>
301
+
<trclass="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>
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