You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@royale.apache.org by ca...@apache.org on 2019/08/25 09:46:00 UTC

[royale-docs] branch master updated: strand-beads: adding some images

This is an automated email from the ASF dual-hosted git repository.

carlosrovira pushed a commit to branch master
in repository https://gitbox.apache.org/repos/asf/royale-docs.git


The following commit(s) were added to refs/heads/master by this push:
     new 8b023c3  strand-beads: adding some images
8b023c3 is described below

commit 8b023c369450eb46b8d8910122854101fe214b85
Author: Carlos Rovira <ca...@apache.org>
AuthorDate: Sun Aug 25 11:45:52 2019 +0200

    strand-beads: adding some images
---
 assets/images/strand-beads/strand-bead-1.jpg | Bin 0 -> 11910 bytes
 assets/images/strand-beads/strand-bead-2.jpg | Bin 0 -> 8991 bytes
 features/strands-and-beads.md                |  12 +++++++++++-
 3 files changed, 11 insertions(+), 1 deletion(-)

diff --git a/assets/images/strand-beads/strand-bead-1.jpg b/assets/images/strand-beads/strand-bead-1.jpg
new file mode 100644
index 0000000..0c16ef0
Binary files /dev/null and b/assets/images/strand-beads/strand-bead-1.jpg differ
diff --git a/assets/images/strand-beads/strand-bead-2.jpg b/assets/images/strand-beads/strand-bead-2.jpg
new file mode 100644
index 0000000..dc3c123
Binary files /dev/null and b/assets/images/strand-beads/strand-bead-2.jpg differ
diff --git a/features/strands-and-beads.md b/features/strands-and-beads.md
index 4841844..7af4e8b 100644
--- a/features/strands-and-beads.md
+++ b/features/strands-and-beads.md
@@ -25,9 +25,19 @@ Adding functionality to a component through composition
 
 Strands and beads are key concepts in Royale, related to the [PAYG](features/payg.html)  (pay as you go) concept. The idea is to keep component code as lightweight as possible, and to add functionality and complexity only to the components that need it.
 
+{:align="center"}
+![Fig 1: MVC with Strands and Beads](assets/images/strand-beads/strand-bead-1.jpg)
+
+In the image, a [TextInput](https://royale.apache.org/asdoc/index.html#!org.apache.royale.html/TextInput){:target='_blank'} is composed by a model ([TextModel](https://royale.apache.org/asdoc/index.html#!org.apache.royale.html.beads.models/TextModel){:target='_blank'}), a view ([TextInputWithBorderView](https://royale.apache.org/asdoc/index.html#!org.apache.royale.html.beads/TextInputWithBorderView){:target='_blank'}) and a controller ([EditableTextKeyboardController](https://royale.apac [...]
+
 > For example, you may use a lot of text input fields in your application, but only one or two need to be able to protect passwords by converting the display of text the user provides into dots. You may want to disable or enable some instances of the text input component, but not all of them, while an end user is working with your application. There is no reason to have that extra functionality (and added weight of code) available everywhere _"just in case"_, as was the rule in Apache Flex.
 
-Every Royale component contains the minimum code necessary to perform its basic functions, and has _"strands"_ onto which you can string _"beads"_ of functionality that let an instance of the component do what you want it to do in a particular place in your application. 
+{:align="center"}
+![Fig 1: Adding optional Beads to the Strand](assets/images/strand-beads/strand-bead-2.jpg)
+
+In the image we are composing (adding) two optional beads to the strand.
+
+Every Royale component contains the minimum code necessary to perform its basic functions, and has _"strands"_ onto which you can string _"beads"_ of functionality that let an instance of the component do what you want it to do in a particular place in your application.
 
 ## Finding the beads you need