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 2020/08/13 11:46:48 UTC

[royale-docs] branch master updated: add DefaultProperty docs

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 fa9c8e0  add DefaultProperty docs
fa9c8e0 is described below

commit fa9c8e0af50b26d2fcaa8fa9dd120e5fa89085da
Author: Carlos Rovira <ca...@apache.org>
AuthorDate: Thu Aug 13 13:46:39 2020 +0200

    add DefaultProperty docs
---
 component-sets/jewel/jewel-group.md |  2 +-
 features/actionscript/metadata.md   | 24 +++++++++++++++++++++---
 2 files changed, 22 insertions(+), 4 deletions(-)

diff --git a/component-sets/jewel/jewel-group.md b/component-sets/jewel/jewel-group.md
index a986be5..549553c 100644
--- a/component-sets/jewel/jewel-group.md
+++ b/component-sets/jewel/jewel-group.md
@@ -77,7 +77,7 @@ where `parent` is the container where the control will be added.
 | PROPERTY 	    | Type   	| Description                                                                   |
 |--------------	|----------	| -----------------------------------------------------------------------------	|
 | __currentState__    | _String_ 	| The name of the current state. |
-| __mxmlContent__    | _Array_ 	| The array of childs for this group. Is the `DefaultProperty`. |
+| __mxmlContent__    | _Array_ 	| The array of childs for this group. Is the [DefaultProperty](features/as3/metadata#default-property). |
 | __states__    | _Array_ 	| The array of view states. These should be instances of [org.apache.royale.states.State](https://royale.apache.org/asdoc/index.html#!org.apache.royale.states/State){:target='_blank'}|
 
 ### Methods
diff --git a/features/actionscript/metadata.md b/features/actionscript/metadata.md
index 992f58c..898bc36 100644
--- a/features/actionscript/metadata.md
+++ b/features/actionscript/metadata.md
@@ -53,13 +53,31 @@ Bindable
 
 Event
 
-### DefaultProperty
+### DefaultProperty {#default-property}
 
-DefaultProperty
+The default property used when additional MXML content appears within an element's definition in an MXML file.
+
+For example, [Jewel Group](component-sets/jewel/group) define `[DefaultProperty("mxmlContent")]` in its class code. When using this component, instead of writting:
+
+```mxml
+<j:Group>
+    <j:mxmlContent>
+        <j:Button/>
+    </j:mxmlContent>
+</j:Group>
+```
+
+we can simplify declaration removing `mxmlContent` tags saving several lines of code:
+
+```mxml
+<j:Group>
+    <j:Button/>
+</j:Group>
+```
 
 ### RemoteObject
 
-DefaultProperty
+RemoteObject
 
 ### Managed