From 52ce9929a1423844e7af7a47574b7495c8429673 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Bj=C3=B6rn=20Ritzl?= Date: Thu, 28 Sep 2017 08:34:29 +0200 Subject: [PATCH] More documentation improvements --- README.md | 24 +++++++++++++----------- docs/setup.png | Bin 0 -> 54690 bytes 2 files changed, 13 insertions(+), 11 deletions(-) create mode 100644 docs/setup.png diff --git a/README.md b/README.md index 741801a..52bf235 100644 --- a/README.md +++ b/README.md @@ -16,38 +16,40 @@ Monarch screens are created in individual collections and loaded through collect * **Screen Id (hash)** - A unique id that can be used to reference the screen when navigating your app * **Popup (boolean)** - Check this if the screen should be treated as a [popup](#popups) * **Transition Url (url)** - Optional URL to call when the screen is about to be shown/hidden. Use this to trigger a transition (see the section on [transitions](#transitions)) -* **Controller Url (url)** - Optional URL to call when the screen gains or loses focus. +* **Focus Url (url)** - Optional URL to call when the screen gains or loses focus. + +![](docs/setup.png) ## Navigating between screens The navigation in Monarch is based around a stack of screens. When a screen is shown it is pushed to the top of the stack. When going back to a previous screen the topmost screen on the stack is removed. Example: * Showing screen A -* Stack is [A] +* Stack is ````[A]```` * Showing screen B -* Stack is [A, B] - (B is on top) +* Stack is ````[A, B]```` - (B is on top) * Going back -* Stack is [A] +* Stack is ````[A]```` ### Showing a new screen You show a screen in one of two ways: 1. Post a ````show```` message to the ````screen.script```` -2. Call ````monarch.show(screen_id, [options], [data], [callback])```` +2. Call ````monarch.show()```` (see below) Showing a screen will push it to the top of the stack and trigger an optional transition. The previous screen will be hidden (with an optional transition) unless the screen to be shown is a [popup](#popups). #### Preventing duplicates in the stack You can pass an optional ````clear```` flag when showing a screen (either as a key value pair in the options table when calling ````monarch.show()```` or in the message). If the clear flag is set Monarch will search the stack for the screen in question. If the screen already exists in the stack and the clear flag is set Monarch will remove all screens between the current top and the screen in question. Example: -* Stack is [A, B, C, D] - (D is on top) +* Stack is ````[A, B, C, D]```` - (D is on top) * A call to ````monarch.show(B, { clear = true })```` is made -* Stack is [A, B] +* Stack is ````[A, B]```` ### Going back to a previous screen You navigate back in the screen hierarchy in one of two ways: 1. Post a ````back```` message to the ````screen.script```` -2. Call ````monarch.back()```` +2. Call ````monarch.back()```` (see below) ## Input focus @@ -56,11 +58,11 @@ Monarch will acquire and release input focus on the game objects containing the ## Popups A screen that is flagged as a popup (see list of screen properties above) will be treated slightly differently when it comes to navigation. If a popup is at the top of the stack (ie currently shown) and another screen or popup is shown then the current popup will be removed from the stack. This means that it is not possible to have a popup anywhere in the stack but the top. This also means that you cannot navigate back to a popup since popups can only exist on the top of the stack. Another important difference between normal screens and popups is that when a popup is shown on top of a non-popup the current top screen will not be unloaded and instead remain visible in the background. -* Stack is [A, B] +* Stack is ````[A, B]```` * A call to ````monarch.show(C)```` is made and C is a popup -* Stack is [A, B, C] +* Stack is ````[A, B, C]```` * A call to ````monarch.show(D)```` -* Stack is [A, B, D] +* Stack is ````[A, B, D]```` ## Transitions You can add optional transitions when navigating between screens. The default behavior is that screen navigation is instant but if you have defined a transition for a screen Monarch will wait until the transition is completed before proceeding. The Transition Show In/Out and Transition Back In/Out properties described above should be URLs to one or more scripts with on_message handlers for the following messages: diff --git a/docs/setup.png b/docs/setup.png new file mode 100644 index 0000000000000000000000000000000000000000..d7598f5386b49cb38b8d8222a94cb154ec510d47 GIT binary patch literal 54690 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
    !Zk1R5k7O? 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 CZz-Vw literal 0 HcmV?d00001