Skip to content

Commit

Permalink
Link Action block documentation: Adds links to other blocks, whitespa…
Browse files Browse the repository at this point in the history
…ce improvment
  • Loading branch information
lukestanley committed Jul 9, 2024
1 parent d13f9bf commit 3f310cc
Showing 1 changed file with 12 additions and 3 deletions.
15 changes: 12 additions & 3 deletions docs/workflow/blocks/link_action_block.rst
Original file line number Diff line number Diff line change
@@ -1,10 +1,19 @@
Link Action block
===========
The Link Action block provides a user-friendly button that links to other Flows. Like a normal link, the user can choose how Flows are opened, according to their browser configuration.
Existing Flows that use a combination of an Action block and a Launch block to open a Flow, can be replaced by the Link Action block to provide the user with more control.
Often when browsers present buttons to navigate to new screens, (such as when a Flow uses an Action block with a Launch block), the user is not given control over where the browser will open the new screen. Instead of allowing users to open the new screen in a new tab or window, the user may be forced to navigate away from their current screen, which unfortunately could cause context from the current tab to be lost! To provide the user with more control, the Link Action block can be used instead to produce buttons that allow opening a specified Flow in a new tab or window, or even the same browser context.
The Link Action block provides a user-friendly button that links to other Flows.
Like a normal link, the user can choose how Flows are opened, according to their browser configuration.

Existing Flows that use a combination of an :doc:`Actions block <actions>` and a :doc:`Launch Block <launch_block>` to open a Flow, can be replaced by the Link Action block to provide the user with more control.

What problem does it solve?
---------------------------
Often when browsers present buttons to navigate to new screens, (such as when a Flow uses an Actions block with a Launch Block), the user is not given control over where the browser will open the new screen. Instead of allowing users to open the new screen in a new tab or window, the user may be forced to navigate away from their current screen, which unfortunately could cause context from the current tab to be lost!


To provide the user with more control, the Link Action block can be used instead to produce buttons that allow opening a specified Flow in a new tab or window, or even the same browser context.

For example, when a laptop user right-clicks a button generated by the Link Action block, their browser will typically present a context menu, then the user may choose to open the specified Flow in a new tab, allowing them to keep the existing Flow they have been using, as it is - without needing to navigate away from it.

To perform the same behavior without using a right mouse button users typically hold the Cmd or Ctrl button and then click (Ctrl+click for Windows/Linux, and Cmd+click for macOS).

Without relying on browser pop-ups, the Link Action block links to Flows in the browser's chosen context by using a browser anchor tag, as normally used for web page links, with the link styled as a button for a consistent user experience.
Expand Down

0 comments on commit 3f310cc

Please sign in to comment.