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 <[email protected]>
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"}
+
+
+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"}
+
+
+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
