You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@royale.apache.org by an...@apache.org on 2020/09/26 22:01:53 UTC

[royale-docs] branch master updated: Update jewel-group.md

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

andreww 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 0a95927  Update jewel-group.md
0a95927 is described below

commit 0a95927f0b6fd84c80f14e04df51c5f541b2015f
Author: Andrew Wetmore <an...@cottage14.com>
AuthorDate: Sat Sep 26 19:01:44 2020 -0300

    Update jewel-group.md
    
    Minor text edits.
---
 component-sets/jewel/jewel-group.md | 16 ++++++----------
 1 file changed, 6 insertions(+), 10 deletions(-)

diff --git a/component-sets/jewel/jewel-group.md b/component-sets/jewel/jewel-group.md
index 9fc9eba..8de9ddb 100644
--- a/component-sets/jewel/jewel-group.md
+++ b/component-sets/jewel/jewel-group.md
@@ -32,17 +32,15 @@ Available since version __0.9.4__.
 |------------------------------	|----------------------------------	|---------------------------------  |
 | [org.apache.royale.jewel.Group](https://royale.apache.org/asdoc/index.html#!org.apache.royale.jewel/Group){:target='_blank'} | [Jewel GroupBase](https://royale.apache.org/asdoc/index.html#!org.apache.royale.jewel.supportClasses.group/GroupBase){:target='_blank'} | [org.apache.royale.core.IMXMLDocument](https://royale.apache.org/asdoc/index.html#!org.apache.royale.core/IMXMLDocument){:target='_blank'} 	|
 
-<sup>_Note: This component is currently only available for JavaScript._</sup>
+<sup>_Note: This component is currently only available for applications compiled into JavaScript._</sup>
 
 ## Overview
 
-The Jewel Group class provides a light-weight container for visual elements. By default the Group does not have a layout, allowing its children to be sized and positioned allowing its children to be sized and positioned using absolute positioning. You can swap the layout for any other one available making children arrange in different ways (i.e: horizontal, vertical,...)
+The Jewel Group class provides a light-weight container for visual elements. By default the group has a Basic Layout, so you can size and position its children with absolute positioning (the Basic layout groups the children, but does not provide layout information). You can swap the layout for any other one available (for instance horizontal or vertical) to arrange the children in different ways. The group doesn't clip content, so elements inside the group aren't hidden if they extend be [...]
 
-The Jewel Group class provides a light-weight container for visual elements. By default Group have a Basiclayout, allowing its children to be positioned using absolute values (Notice Basic version doesn't provide any layout at all). Group doesn't clip content so elements inside the group aren't hidden far beyond group boundaries. Group doesn't have any chrome or visuals just position inner childs. 
+Also, the group has no scrolling support. For scrolling and clipping you can use [Jewel Container](component-sets/jewel/container).
 
-Also, no scrolling support is built in Group. For scrolling and clipping you can use [Jewel Container](component-sets/jewel/container).
-
-While the container is relatively lightweight, it should generally not be used as the base class for other controls, even if those controls are composed of children.  That's because the fundamental API of Container is to support an arbitrary set of children, and most controls only support a specific set of children.
+While the container is relatively lightweight, you should generally not use it as the base class for other controls, even if those controls are composed of children.  That's because the fundamental API of Container is to support an arbitrary set of children, and most controls only support a specific set of children.
 
 ## Example of use
 
@@ -95,9 +93,7 @@ where `parent` is the container where the control will be added.
 
 ## Relevant Events
 
-The most important event is `initComplete`, which indicates that the initialization of the group is complete.
-
-Is needed when some action coded in a callback function need to be triggered as the group is ready to use after initialization.
+The most important event is `initComplete`, which indicates that the initialization of the group is complete. You can use this when some action coded in a callback functions need to be triggered when the group has initialized and is ready to use.
 
 You can attach callback listeners to the _initComplete_ event in __MXML__ as follows:
 
@@ -158,4 +154,4 @@ Other useful Jewel group components are:
 * [VGroup](component-sets/jewel/vgroup)
 * [Container](component-sets/jewel/container)
 * [HContainer](component-sets/jewel/hcontainer)
-* [VContainer](component-sets/jewel/vcontainer)
\ No newline at end of file
+* [VContainer](component-sets/jewel/vcontainer)