docs(navigation): notes for navigation components behavior

Author: marin-bratanov

_contentTemplates/common/navigation-components.md

@@ -0,0 +1,11 @@
+#navman-used
+* The `UrlField` has a default value (`Url`) and that will be used if present in the model even if you do not define it explicitly.
+
+#end
+
+#double-navigation
+* The component uses the `NavigationManager` from the framework to perform the navigation based on the value from the `UrlField`.
+
+    * If you have a template that adds anchors, or use a click event to navigate the user yourself, this may lead to double navigation and errors, especially if your model has a field called `Url`. To avoid such problems, either let the Telerik component do the navigation and remove the application-specific code that does it as well, or remove the URL setting (either rename the model field, or point the `UrlField` to a non-existing field).
+
+#end

components/contextmenu/navigation.md

@@ -83,6 +83,11 @@ To use the Context Menu for navigating between pages:
 }
 ````
 
+## Notes
+
+@[template](/_contentTemplates/common/navigation-components.md#navman-used)
+@[template](/_contentTemplates/common/navigation-components.md#double-navigation)
+
 ## See Also
 
 * [Context Menu Overview]({%slug contextmenu-overview%})

components/drawer/navigation.md

@@ -59,6 +59,12 @@ To use the Drawer for navigating between pages:
 ````
 
 
+## Notes
+
+@[template](/_contentTemplates/common/navigation-components.md#navman-used)
+@[template](/_contentTemplates/common/navigation-components.md#double-navigation)
+
+
 ## See Also
 
 * [Drawer Overview]({% slug drawer-overview%})

components/menu/navigation.md

@@ -79,6 +79,11 @@ To use the Menu for navigating between pages:
 }
 ````
 
+## Notes
+
+@[template](/_contentTemplates/common/navigation-components.md#navman-used)
+@[template](/_contentTemplates/common/navigation-components.md#double-navigation)
+
 ## See Also
 
 * [Menu Overview]({%slug components/menu/overview%})

components/treeview/navigation.md

@@ -121,6 +121,13 @@ To use the TreeView for navigating between pages:
 }
 ````
 
+
+## Notes
+
+@[template](/_contentTemplates/common/navigation-components.md#navman-used)
+@[template](/_contentTemplates/common/navigation-components.md#double-navigation)
+
+
 ## See Also
 
 * [TreeView Overview]({%slug components/treeview/overview%})