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 2018/08/01 07:51:54 UTC
[royale-asjs] branch develop updated: New Blog Example ::
BE0010_Customization_through_the_Royale_API
This is an automated email from the ASF dual-hosted git repository.
carlosrovira pushed a commit to branch develop
in repository https://gitbox.apache.org/repos/asf/royale-asjs.git
The following commit(s) were added to refs/heads/develop by this push:
new 26fc129 New Blog Example :: BE0010_Customization_through_the_Royale_API
26fc129 is described below
commit 26fc129bb32a5ab1a04baea95f795fc7975297f3
Author: Carlos Rovira <ca...@apache.org>
AuthorDate: Wed Aug 1 09:51:47 2018 +0200
New Blog Example :: BE0010_Customization_through_the_Royale_API
---
...10_Customization_through_the_Royale_API.as3proj | 95 +++++++++++++++++++
.../README.txt | 28 ++++++
.../asconfig.json | 31 +++++++
.../build.xml | 63 +++++++++++++
.../pom.xml | 84 +++++++++++++++++
.../resources/jewel-example-index-template.html | 30 ++++++
...E0010_Customization_through_the_Royale_API.mxml | 101 +++++++++++++++++++++
examples/blog/pom.xml | 1 +
.../src/main/royale/AlertPlayGround.mxml | 2 +-
9 files changed, 434 insertions(+), 1 deletion(-)
diff --git a/examples/blog/BE0010_Customization_through_the_Royale_API/BE0010_Customization_through_the_Royale_API.as3proj b/examples/blog/BE0010_Customization_through_the_Royale_API/BE0010_Customization_through_the_Royale_API.as3proj
new file mode 100644
index 0000000..f904c84
--- /dev/null
+++ b/examples/blog/BE0010_Customization_through_the_Royale_API/BE0010_Customization_through_the_Royale_API.as3proj
@@ -0,0 +1,95 @@
+<?xml version="1.0" encoding="utf-8"?>
+<!--
+
+ Licensed to the Apache Software Foundation (ASF) under one or more
+ contributor license agreements. See the NOTICE file distributed with
+ this work for additional information regarding copyright ownership.
+ The ASF licenses this file to You under the Apache License, Version 2.0
+ (the "License"); you may not use this file except in compliance with
+ the License. You may obtain a copy of the License at
+
+ http://www.apache.org/licenses/LICENSE-2.0
+
+ Unless required by applicable law or agreed to in writing, software
+ distributed under the License is distributed on an "AS IS" BASIS,
+ WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ See the License for the specific language governing permissions and
+ limitations under the License.
+
+-->
+<project>
+ <output>
+ <movie disabled="False"/>
+ <movie path="bin-debug/BE0010_Customization_through_the_Royale_API.swf"/>
+ <movie version="11"/>
+ <movie input=""/>
+ <movie width="800"/>
+ <movie height="600"/>
+ <movie fps="60"/>
+ <movie background="#FFFFFF"/>
+ <movie platform="Flash Player"/>
+ </output>
+ <!-- Other classes to be compiled into your SWF -->
+ <classpaths>
+ <class path="src/main/royale"/>
+ </classpaths>
+ <moonshineResourcePaths></moonshineResourcePaths>
+ <moonshineNativeExtensionPaths></moonshineNativeExtensionPaths>
+ <build>
+ <option useResourceBundleMetadata="True"/>
+ <option showBindingWarnings="True"/>
+ <option warnings="True"/>
+ <option es="False"/>
+ <option verboseStackTraces="False"/>
+ <option additional="-theme=${royalelib}/themes/Jewel-Light-NoFlat-Primary-Blue-Theme/src/main/resources/defaults.css -html-template=src/main/resources/jewel-example-index-template.html"/>
+ <option loadConfig=""/>
+ <option linkReport=""/>
+ <option benchmark="False"/>
+ <option optimize="False"/>
+ <option showActionScriptWarnings="True"/>
+ <option staticLinkRSL="False"/>
+ <option locale=""/>
+ <option compilerConstants=""/>
+ <option showDeprecationWarnings="True"/>
+ <option antBuildPath="build/build.xml"/>
+ <option showUnusedTypeSelectorWarnings="True"/>
+ <option customSDK=""/>
+ <option strict="True"/>
+ <option accessible="False"/>
+ <option useNetwork="True"/>
+ <option allowSourcePathOverlap="False"/>
+ </build>
+ <includeLibraries></includeLibraries>
+ <libraryPaths></libraryPaths>
+ <externalLibraryPaths></externalLibraryPaths>
+ <rslPaths></rslPaths>
+ <intrinsics>
+ <element path="Library/AS3/frameworks/Flex4"/>
+ <element path="Library\AS3\frameworks\Flex4"/>
+ </intrinsics>
+ <library></library>
+ <compileTargets>
+ <compile path="src/main/royale/BE0010_Customization_through_the_Royale_API.mxml"/>
+ </compileTargets>
+ <hiddenPaths></hiddenPaths>
+ <preBuildCommand>null</preBuildCommand>
+ <postBuildCommand alwaysRun="False">null</postBuildCommand>
+ <options>
+ <option testMovie=""/>
+ <option showHiddenPaths="False"/>
+ <option testMovieCommand=""/>
+ <option defaultBuildTargets=""/>
+ <option isPrimeFacesVisualEditor="False"/>
+ </options>
+ <moonshineRunCustomization>
+ <option deviceSimulator="null"/>
+ <option targetPlatform="2"/>
+ <option launchMethod="Simulator"/>
+ <option urlToLaunch=""/>
+ <option projectType="2"/>
+ <deviceSimulator>null</deviceSimulator>
+ <certAndroid>null</certAndroid>
+ <certIos>null</certIos>
+ <certIosProvisioning>null</certIosProvisioning>
+ </moonshineRunCustomization>
+</project>
\ No newline at end of file
diff --git a/examples/blog/BE0010_Customization_through_the_Royale_API/README.txt b/examples/blog/BE0010_Customization_through_the_Royale_API/README.txt
new file mode 100644
index 0000000..86db396
--- /dev/null
+++ b/examples/blog/BE0010_Customization_through_the_Royale_API/README.txt
@@ -0,0 +1,28 @@
+////////////////////////////////////////////////////////////////////////////////
+//
+// Licensed to the Apache Software Foundation (ASF) under one or more
+// contributor license agreements. See the NOTICE file distributed with
+// this work for additional information regarding copyright ownership.
+// The ASF licenses this file to You under the Apache License, Version 2.0
+// (the "License"); you may not use this file except in compliance with
+// the License. You may obtain a copy of the License at
+//
+// http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing, software
+// distributed under the License is distributed on an "AS IS" BASIS,
+// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+// See the License for the specific language governing permissions and
+// limitations under the License.
+//
+////////////////////////////////////////////////////////////////////////////////
+
+DESCRIPTION
+
+Using an Item Renderer with a List
+
+Learn how to use an item renderer in a Jewel List to display the items in your list in a pleasing and user-friendly way in a Royale application.
+
+Source code of the code exposed in the following Apache Royale Blog Example post:
+
+https://royale.apache.org/using-an-item-renderer-with-a-list/
diff --git a/examples/blog/BE0010_Customization_through_the_Royale_API/asconfig.json b/examples/blog/BE0010_Customization_through_the_Royale_API/asconfig.json
new file mode 100644
index 0000000..4b6259e
--- /dev/null
+++ b/examples/blog/BE0010_Customization_through_the_Royale_API/asconfig.json
@@ -0,0 +1,31 @@
+////////////////////////////////////////////////////////////////////////////////
+//
+// Licensed to the Apache Software Foundation (ASF) under one or more
+// contributor license agreements. See the NOTICE file distributed with
+// this work for additional information regarding copyright ownership.
+// The ASF licenses this file to You under the Apache License, Version 2.0
+// (the "License"); you may not use this file except in compliance with
+// the License. You may obtain a copy of the License at
+//
+// http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing, software
+// distributed under the License is distributed on an "AS IS" BASIS,
+// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+// See the License for the specific language governing permissions and
+// limitations under the License.
+//
+////////////////////////////////////////////////////////////////////////////////
+{
+ "config": "royale",
+ "compilerOptions": {
+ "debug": false,
+ "targets": ["JSRoyale","SWF"],
+ "source-map": true
+ },
+ "additionalOptions": "-remove-circulars -js-output-optimization=skipAsCoercions",
+ "files":
+ [
+ "src/main/royale/App.mxml"
+ ]
+}
diff --git a/examples/blog/BE0010_Customization_through_the_Royale_API/build.xml b/examples/blog/BE0010_Customization_through_the_Royale_API/build.xml
new file mode 100644
index 0000000..835f21a
--- /dev/null
+++ b/examples/blog/BE0010_Customization_through_the_Royale_API/build.xml
@@ -0,0 +1,63 @@
+<?xml version="1.0"?>
+<!--
+
+ Licensed to the Apache Software Foundation (ASF) under one or more
+ contributor license agreements. See the NOTICE file distributed with
+ this work for additional information regarding copyright ownership.
+ The ASF licenses this file to You under the Apache License, Version 2.0
+ (the "License"); you may not use this file except in compliance with
+ the License. You may obtain a copy of the License at
+
+ http://www.apache.org/licenses/LICENSE-2.0
+
+ Unless required by applicable law or agreed to in writing, software
+ distributed under the License is distributed on an "AS IS" BASIS,
+ WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ See the License for the specific language governing permissions and
+ limitations under the License.
+
+-->
+
+
+<project name="BE0010_Customization_through_the_Royale_API" default="main" basedir=".">
+ <property name="ROYALE_HOME" location="../../.."/>
+ <property name="example" value="App" />
+
+ <property file="${ROYALE_HOME}/env.properties"/>
+ <property environment="env"/>
+ <property file="${ROYALE_HOME}/build.properties"/>
+ <property name="ROYALE_HOME" value="${ROYALE_HOME}"/>
+
+ <include file="${basedir}/../../build_example.xml" />
+
+ <target name="main" depends="clean,build_example.compile" description="Clean build of ${example}">
+ <mkdir dir="${basedir}/bin/js-debug/assets" />
+ <copy todir="${basedir}/bin/js-debug/assets" failonerror="false">
+ <fileset dir="${basedir}/src/main/resources/assets">
+ <include name="**" />
+ </fileset>
+ </copy>
+ <mkdir dir="${basedir}/bin/js-release/assets" />
+ <copy todir="${basedir}/bin/js-release/assets" failonerror="false">
+ <fileset dir="${basedir}/src/main/resources/assets">
+ <include name="**" />
+ </fileset>
+ </copy>
+ </target>
+
+ <target name="clean">
+ <delete dir="${basedir}/bin" failonerror="false" />
+ <delete dir="${basedir}/bin-debug" failonerror="false" />
+ <delete dir="${basedir}/bin-release" failonerror="false" />
+ <delete dir="${basedir}/target" failonerror="false" />
+ </target>
+
+ <target name="examine" depends="build_example.get.browser">
+ <property name="which" value="debug" />
+ <echo message="See various team members."/>
+ <exec executable="${browser}" dir="${basedir}/bin/js-${which}" failonerror="true">
+ <arg value="${basedir}/bin/js-${which}/index.html"/>
+ </exec>
+ </target>
+
+</project>
diff --git a/examples/blog/BE0010_Customization_through_the_Royale_API/pom.xml b/examples/blog/BE0010_Customization_through_the_Royale_API/pom.xml
new file mode 100644
index 0000000..eef7a0a
--- /dev/null
+++ b/examples/blog/BE0010_Customization_through_the_Royale_API/pom.xml
@@ -0,0 +1,84 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<!--
+
+ Licensed to the Apache Software Foundation (ASF) under one or more
+ contributor license agreements. See the NOTICE file distributed with
+ this work for additional information regarding copyright ownership.
+ The ASF licenses this file to You under the Apache License, Version 2.0
+ (the "License"); you may not use this file except in compliance with
+ the License. You may obtain a copy of the License at
+
+ http://www.apache.org/licenses/LICENSE-2.0
+
+ Unless required by applicable law or agreed to in writing, software
+ distributed under the License is distributed on an "AS IS" BASIS,
+ WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ See the License for the specific language governing permissions and
+ limitations under the License.
+
+-->
+<project xmlns="http://maven.apache.org/POM/4.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd">
+ <modelVersion>4.0.0</modelVersion>
+
+ <parent>
+ <groupId>org.apache.royale.examples</groupId>
+ <artifactId>examples-blog</artifactId>
+ <version>0.9.3-SNAPSHOT</version>
+ </parent>
+
+ <artifactId>BE0010_Customization_through_the_Royale_API</artifactId>
+ <version>0.9.3-SNAPSHOT</version>
+ <packaging>swf</packaging>
+
+ <name>Apache Royale: Examples: Blog: 0010: Customization through the Royale API</name>
+
+ <build>
+ <sourceDirectory>src/main/royale</sourceDirectory>
+ <plugins>
+ <plugin>
+ <groupId>org.apache.royale.compiler</groupId>
+ <artifactId>royale-maven-plugin</artifactId>
+ <extensions>true</extensions>
+ <configuration>
+ <mainClass>BE0010_Customization_through_the_Royale_API.mxml</mainClass>
+ <targets>JSRoyale,SWF</targets>
+ <debug>false</debug>
+ <htmlTemplate>${basedir}/target/javascript/bin/js-debug/jewel-example-index-template.html</htmlTemplate>
+ </configuration>
+ </plugin>
+ </plugins>
+ </build>
+
+ <dependencies>
+ <dependency>
+ <groupId>com.adobe.flash.framework</groupId>
+ <artifactId>playerglobal</artifactId>
+ <version>${flash.version}</version>
+ <type>swc</type>
+ <scope>provided</scope>
+ </dependency>
+ <dependency>
+ <groupId>org.apache.royale.framework</groupId>
+ <artifactId>Jewel</artifactId>
+ <version>0.9.3-SNAPSHOT</version>
+ <type>swc</type>
+ <classifier>swf</classifier>
+ </dependency>
+ <dependency>
+ <groupId>org.apache.royale.framework</groupId>
+ <artifactId>Jewel</artifactId>
+ <version>0.9.3-SNAPSHOT</version>
+ <type>swc</type>
+ <classifier>js</classifier>
+ </dependency>
+ <dependency>
+ <groupId>org.apache.royale.framework</groupId>
+ <artifactId>Jewel-Light-NoFlat-Primary-Red-Theme</artifactId>
+ <version>0.9.3-SNAPSHOT</version>
+ <type>swc</type>
+ <scope>theme</scope>
+ <classifier>js</classifier>
+ </dependency>
+ </dependencies>
+
+</project>
diff --git a/examples/blog/BE0010_Customization_through_the_Royale_API/src/main/resources/jewel-example-index-template.html b/examples/blog/BE0010_Customization_through_the_Royale_API/src/main/resources/jewel-example-index-template.html
new file mode 100644
index 0000000..140ba98
--- /dev/null
+++ b/examples/blog/BE0010_Customization_through_the_Royale_API/src/main/resources/jewel-example-index-template.html
@@ -0,0 +1,30 @@
+<!--
+ Licensed to the Apache Software Foundation (ASF) under one or more
+ contributor license agreements. See the NOTICE file distributed with
+ this work for additional information regarding copyright ownership.
+ The ASF licenses this file to You under the Apache License, Version 2.0
+ (the "License"); you may not use this file except in compliance with
+ the License. You may obtain a copy of the License at
+
+ http://www.apache.org/licenses/LICENSE-2.0
+
+ Unless required by applicable law or agreed to in writing, software
+ distributed under the License is distributed on an "AS IS" BASIS,
+ WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ See the License for the specific language governing permissions and
+ limitations under the License.
+-->
+<!DOCTYPE html>
+<html>
+<head>
+ <meta http-equiv="Content-Type" content="text/html; charset=utf-8">
+ <meta name="Custom Template for injecting custom style CSS">
+ <meta name="viewport" content="width=device-width, initial-scale=1.0, minimum-scale=1.0">
+ <link rel="stylesheet" type="text/css" href="${application}.css">
+ <link href="https://fonts.googleapis.com/css?family=Lato:400,700" rel="stylesheet">
+${head}
+</head>
+<body>
+${body}
+</body>
+</html>
diff --git a/examples/blog/BE0010_Customization_through_the_Royale_API/src/main/royale/BE0010_Customization_through_the_Royale_API.mxml b/examples/blog/BE0010_Customization_through_the_Royale_API/src/main/royale/BE0010_Customization_through_the_Royale_API.mxml
new file mode 100644
index 0000000..3f3e615
--- /dev/null
+++ b/examples/blog/BE0010_Customization_through_the_Royale_API/src/main/royale/BE0010_Customization_through_the_Royale_API.mxml
@@ -0,0 +1,101 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<!--
+
+ Licensed to the Apache Software Foundation (ASF) under one or more
+ contributor license agreements. See the NOTICE file distributed with
+ this work for additional information regarding copyright ownership.
+ The ASF licenses this file to You under the Apache License, Version 2.0
+ (the "License"); you may not use this file except in compliance with
+ the License. You may obtain a copy of the License at
+
+ http://www.apache.org/licenses/LICENSE-2.0
+
+ Unless required by applicable law or agreed to in writing, software
+ distributed under the License is distributed on an "AS IS" BASIS,
+ WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ See the License for the specific language governing permissions and
+ limitations under the License.
+
+-->
+<j:Application xmlns:fx="http://ns.adobe.com/mxml/2009"
+ xmlns:j="library://ns.apache.org/royale/jewel"
+ xmlns:js="library://ns.apache.org/royale/basic"
+ xmlns:html="library://ns.apache.org/royale/html"
+ xmlns:models="models.*">
+
+ <fx:Script>
+ <![CDATA[
+ import org.apache.royale.core.IBeadLayout;
+ import org.apache.royale.core.IBeadView;
+ import org.apache.royale.events.CloseEvent;
+ import org.apache.royale.events.Event;
+ import org.apache.royale.events.MouseEvent;
+ import org.apache.royale.jewel.Alert;
+ import org.apache.royale.jewel.CheckBox;
+ import org.apache.royale.jewel.beads.layouts.HorizontalLayout;
+ import org.apache.royale.jewel.beads.layouts.VerticalLayout;
+ import org.apache.royale.jewel.beads.views.AlertView;
+
+ private var alert:Alert;
+ private var check:CheckBox;
+
+ // Adding content to Alert component and changing ControlBar's Buttons Layout
+ private function clickHandler(event:MouseEvent):void {
+ alert = Alert.show("This example shows access to AlertView and ControlBar to add a CheckBox to Alert's content area and expand Buttons layout and change defaults. The height of the alert is set up to 300px too.", "Cutomized Alert Example", 3);
+ alert.addEventListener(CloseEvent.CLOSE, alertClickHandler);
+ alert.height = 300;
+
+ check = new CheckBox();
+ check.selected = true;
+ check.text = "Buttons must fill ControlBar's availabe space";
+ check.addEventListener(Event.CHANGE, expandButtons);
+
+ expandButtons();
+ }
+
+ private function expandButtons(event:Event = null):void {
+ var alertView:AlertView = alert.getBeadByType(IBeadView) as AlertView;
+
+ var verticalLayout = new VerticalLayout();
+ verticalLayout.gap = 9;
+ alertView.content.addBead(verticalLayout);
+
+ if(event == null)
+ {
+ alertView.content.addElement(check);
+ }
+
+ var layout:HorizontalLayout = alertView.controlBar.getBeadByType(IBeadLayout) as HorizontalLayout;
+ layout.itemsExpand = check.selected;
+ }
+
+ // Event handler function for displaying the selected Alert button.
+ private function alertClickHandler(event:CloseEvent):void {
+ alert.removeEventListener(CloseEvent.CLOSE, alertClickHandler);
+
+ if (event.detail == Alert.YES)
+ status.text="You answered Yes";
+ else
+ status.text="You answered No";
+ }
+ ]]>
+ </fx:Script>
+
+ <j:initialView>
+ <j:View>
+ <js:beads>
+ <j:HorizontalCenteredLayout/>
+ </js:beads>
+
+ <j:Card width="350">
+ <html:H3 text="Customization through Royale API"/>
+
+ <j:Label text="This is a complex example that add and retrieve beads at runtime. Click the button below to display an Alert window that add content and make changes in some layout parts."
+ multiline="true"/>
+ <j:Button text="Click Me" click="clickHandler(event)"/>
+ <j:Label id="status"/>
+ </j:Card>
+ </j:View>
+ </j:initialView>
+
+</j:Application>
\ No newline at end of file
diff --git a/examples/blog/pom.xml b/examples/blog/pom.xml
index 5f457b6..6e00791 100644
--- a/examples/blog/pom.xml
+++ b/examples/blog/pom.xml
@@ -42,6 +42,7 @@
<module>BE0007_Selecting_options_from_a_group_of_jewel_checkbox_controls</module>
<module>BE0008_Using_View_States_to_show_or_hide_content</module>
<module>BE0009_Using_an_Item_ Renderer_with_a_List</module>
+ <module>BE0010_Customization_through_the_Royale_API</module>
</modules>
<build>
diff --git a/examples/royale/JewelExample/src/main/royale/AlertPlayGround.mxml b/examples/royale/JewelExample/src/main/royale/AlertPlayGround.mxml
index 1f7ec8f..0bc347a 100644
--- a/examples/royale/JewelExample/src/main/royale/AlertPlayGround.mxml
+++ b/examples/royale/JewelExample/src/main/royale/AlertPlayGround.mxml
@@ -60,7 +60,7 @@ limitations under the License.
var alertView:AlertView = alert.getBeadByType(IBeadView) as AlertView;
var verticalLayout = new VerticalLayout();
- verticalLayout.gap = 3;
+ verticalLayout.gap = 9;
alertView.content.addBead(verticalLayout);
if(event == null)