From 9ebc0be4e7d3bc6811ba3e86bc6a2da270bdcb76 Mon Sep 17 00:00:00 2001
From: Erik Lumme <erik@vaadin.com>
Date: Wed, 13 Sep 2017 15:07:25 +0300
Subject: Migrate AddingASplashScreen and CreatingMultiTabApplications

---
 .../articles/CreatingMultiTabApplications.asciidoc | 29 ++++++++++++++++++++++
 1 file changed, 29 insertions(+)
 create mode 100644 documentation/articles/CreatingMultiTabApplications.asciidoc

(limited to 'documentation/articles/CreatingMultiTabApplications.asciidoc')

diff --git a/documentation/articles/CreatingMultiTabApplications.asciidoc b/documentation/articles/CreatingMultiTabApplications.asciidoc
new file mode 100644
index 0000000000..1c04f77d81
--- /dev/null
+++ b/documentation/articles/CreatingMultiTabApplications.asciidoc
@@ -0,0 +1,29 @@
+[[creating-multi-tab-applications]]
+Creating multi-tab applications
+-------------------------------
+
+Every new request to the server gets a new session and UI instance.
+Having the application open in separate tabs or windows means that the
+instances are totally separate from each others, and thus won't conflict
+and cause any out of sync or similar issues.
+
+Opening the new tab will open the application into it's start page. Use
+URI fragments if you want to open a specific view into the secondary
+tab. You can read the URI fragments in the `UI.init()` and decide if you
+want to show the main view or a specialized view:
+
+[source,java]
+....
+public void init(VaadinRequest request) {
+  String person = request.getParameter("editPerson");
+  if (person == null) {
+    setContent(new MainView());
+  } else {
+    setContent(new EditPersonView(person));
+  }
+}
+....
+
+More examples on URI fragments and parameters can be found at:
+
+* link:UsingURIFragments.asciidoc[Using URI fragments]
-- 
cgit v1.2.3

