Web Client Utils

### Eclipse Workspace Patch 1.0

#P web_client_utils

Index: src/com/servoy/plugins/ReferencesBehaviorProvider.java

===================================================================

--- src/com/servoy/plugins/ReferencesBehaviorProvider.java	(revision 0)

+++ src/com/servoy/plugins/ReferencesBehaviorProvider.java	(working copy)

@@ -0,0 +1,209 @@

+/*

+ * BehaviorProvider.java

+ *

+ * Created on November 29, 2007, 1:23 PM

+ *

+ * To change this template, choose Tools | Template Manager

+ * and open the template in the editor.

+ */

+

+package com.servoy.plugins;

+

+import java.util.ArrayList;

+import java.util.List;

+

+import org.apache.wicket.Component;

+import org.apache.wicket.RequestCycle;

+import org.apache.wicket.ResourceReference;

+import org.apache.wicket.ajax.AbstractDefaultAjaxBehavior;

+import org.apache.wicket.ajax.AjaxRequestTarget;

+import org.apache.wicket.markup.html.IHeaderResponse;

+import org.apache.wicket.util.string.Strings;

+

+import com.servoy.j2db.server.headlessclient.IWebClientPluginAccess;

+import com.servoy.j2db.ui.IProviderStylePropertyChanges;

+import com.servoy.j2db.ui.IStylePropertyChanges;

+

+/**

+ * A behavior that can link CSS and JS references to Wicket components.

+ * 

+ * @author Sean Devlin

+ * @author Servoy Stuff

+ * @author Andrei Costescu

+ */

+public class ReferencesBehaviorProvider extends AbstractDefaultAjaxBehavior {

+    

+	private static final long serialVersionUID = 7666601280436256255L;

+

+	protected final IWebClientPluginAccess app;

+

+	protected final List<Ref> references = new ArrayList<Ref>(2); // all reference types are kept in the order they were added (for example some js files need to load after a css file they use is loaded)

+	

+	protected static class Ref {

+		

+		public static final byte JS = 0;

+		public static final byte CSS = 1;

+		

+		protected final byte type;

+		protected final Object value;

+		

+		public Ref(byte type, Object value) {

+			this.type = type;

+			this.value = value;

+		}

+

+		@Override

+		public boolean equals(Object obj) {

+			if (this == obj)

+				return true;

+			if (obj == null)

+				return false;

+			if (getClass() != obj.getClass())

+				return false;

+			Ref other = (Ref) obj;

+			if (type != other.type)

+				return false;

+			if (value == null) {

+				if (other.value != null)

+					return false;

+			} else if (!value.equals(other.value))

+				return false;

+			return true;

+		}

+		

+	}

+

+    public ReferencesBehaviorProvider(IWebClientPluginAccess app) {

+		this.app = app;

+	}

+    

+    @Override

+    public void renderHead(IHeaderResponse response) {

+    	super.renderHead(response);

+		ResourceReference resourceReference = new ResourceReference("media");

+		String solutionName = app.getSolutionName();

+    	for (Ref ref : references) {

+    		if (Ref.JS == ref.type) {

+	    		if (ref.value instanceof ResourceReference) {

+	    			response.renderJavascriptReference((ResourceReference)ref.value);

+	    		} else {

+	    			response.renderJavascriptReference(Strings.replaceAll((String)ref.value, "media:///", RequestCycle.get().urlFor(resourceReference) + "?s=" + solutionName + "&id=").toString());

+	    		}

+    		} else if (Ref.CSS == ref.type) {

+    			if (ref.value instanceof ResourceReference) {

+    				response.renderCSSReference((ResourceReference)ref.value);

+    			} else {

+    				response.renderCSSReference(Strings.replaceAll((String)ref.value, "media:///", RequestCycle.get().urlFor(resourceReference) + "?s=" + solutionName + "&id=").toString());

+    			}

+    		}

+		}

+    }

+    

+    @Override

+    protected void respond(AjaxRequestTarget target) {

+    	// not interested

+    }

+    

+    protected int getReferencesCount()

+    {

+    	return references.size();

+    }

+

+    private void markComponentAsChanged(Component component) {

+    	// if the component is already showing mark it for re-render so that our behavior gets rendered as well

+    	Component c = component;

+    	while (c != null && !(c instanceof IProviderStylePropertyChanges))

+    	{

+    		c = c.getParent();

+    	}

+    	if (c instanceof IProviderStylePropertyChanges) {

+    		IStylePropertyChanges spc = ((IProviderStylePropertyChanges) c).getStylePropertyChanges();

+    		if (spc != null) spc.setChanged();

+    	}

+    }

+    

+	public void addCssReference(String url, Component component) {

+		if (url != null) {

+			Ref r = new Ref(Ref.CSS, url);

+			if (!references.contains(r)) {

+				if (getReferencesCount() == 0) component.add(this);

+				references.add(r);

+				markComponentAsChanged(component);

+			}

+		}

+	}

+

+	public void addJsReference(String url, Component component) {

+		if (url != null) {

+			Ref r = new Ref(Ref.JS, url);

+			if (!references.contains(r)) {

+				if (getReferencesCount() == 0) component.add(this);

+				references.add(r);

+				markComponentAsChanged(component);

+			}

+		}

+	}

+

+	public void addCssReference(ResourceReference ref, Component component) {

+		if (ref != null) {

+			Ref r = new Ref(Ref.CSS, ref);

+			if (!references.contains(r)) {

+				if (getReferencesCount() == 0) component.add(this);

+				references.add(r);

+				markComponentAsChanged(component);

+			}

+		}

+	}

+

+	public void addJsReference(ResourceReference ref, Component component) {

+		if (ref != null) {

+			Ref r = new Ref(Ref.JS, ref);

+			if (!references.contains(r)) {

+				if (getReferencesCount() == 0) component.add(this);

+				references.add(r);

+				markComponentAsChanged(component);

+			}

+		}

+	}

+

+	public void removeCssReference(ResourceReference ref, Component component) {

+		if (ref != null) {

+			Ref r = new Ref(Ref.CSS, ref);

+			if (references.remove(r)) {

+				if (getReferencesCount() == 0) component.remove(this);

+				markComponentAsChanged(component);

+			}

+		}

+	}

+

+	public void removeCssReference(String url, Component component) {

+		if (url != null) {

+			Ref r = new Ref(Ref.CSS, url);

+			if (references.remove(r)) {

+				if (getReferencesCount() == 0) component.remove(this);

+				markComponentAsChanged(component);

+			}

+		}

+	}

+

+	public void removeJsReference(ResourceReference ref, Component component) {

+		if (ref != null) {

+			Ref r = new Ref(Ref.JS, ref);

+			if (references.remove(r)) {

+				if (getReferencesCount() == 0) component.remove(this);

+				markComponentAsChanged(component);

+			}

+		}

+	}

+

+	public void removeJsReference(String url, Component component) {

+		if (url != null) {

+			Ref r = new Ref(Ref.JS, url);

+			if (references.remove(r)) {

+				if (getReferencesCount() == 0) component.remove(this);

+				markComponentAsChanged(component);

+			}

+		}

+	}

+    

+}

\ No newline at end of file

Index: src/com/servoy/plugins/BehaviorProvider.java

===================================================================

--- src/com/servoy/plugins/BehaviorProvider.java	(revision 54)

+++ src/com/servoy/plugins/BehaviorProvider.java	(working copy)

@@ -9,8 +9,7 @@

 package com.servoy.plugins;

-import java.util.ArrayList;

-import java.util.List;

+import java.lang.reflect.Method;

 import java.util.Map;

 import java.util.concurrent.ConcurrentHashMap;

@@ -17,15 +16,13 @@

 import org.apache.wicket.Request;

 import org.apache.wicket.RequestCycle;

 import org.apache.wicket.ResourceReference;

-import org.apache.wicket.ajax.AbstractDefaultAjaxBehavior;

 import org.apache.wicket.ajax.AjaxRequestTarget;

-import org.apache.wicket.markup.html.IHeaderResponse;

 import org.apache.wicket.protocol.http.servlet.ServletWebRequest;

 import org.apache.wicket.request.RequestParameters;

-import org.apache.wicket.util.string.Strings;

 import org.mozilla.javascript.Function;

 import com.servoy.j2db.scripting.FunctionDefinition;

+import com.servoy.j2db.server.headlessclient.IPageContributor;

 import com.servoy.j2db.server.headlessclient.IWebClientPluginAccess;

 import com.servoy.j2db.server.headlessclient.dataui.WebEventExecutor;

 import com.servoy.j2db.util.Utils;

@@ -36,50 +33,19 @@

  * @author Sean Devlin

  * @author Servoy Stuff

  */

-public class BehaviorProvider extends AbstractDefaultAjaxBehavior {

+public class BehaviorProvider extends ReferencesBehaviorProvider {

-	private static final long serialVersionUID = 7666601280436256255L;

+	private static final long serialVersionUID = 7666601280436256256L;

-	public final static String CALLBACK_BEHAVIOR = "com.servoy.jscallback";

+	public final static String BEHAVIOR_ID = "com.servoy.jscallback";

     protected Map<Integer,FunctionDefinition> callbacks = new ConcurrentHashMap<Integer,FunctionDefinition>();

-

-	protected final IWebClientPluginAccess app;

-

-	private final List<Object> jsReferences = new ArrayList<Object>(2);

-	private final List<Object> cssReferences = new ArrayList<Object>(2);

-

+	protected boolean showIndicator = true;

+	

     public BehaviorProvider(IWebClientPluginAccess app) {

-		this.app = app;

+		super(app);

 	}

-    @Override

-    public void renderHead(IHeaderResponse response) {

-    	super.renderHead(response);

-		ResourceReference resourceReference = new ResourceReference("media");

-		String solutionName = app.getSolutionName();

-    	for (Object url : jsReferences) {

-    		if (url instanceof ResourceReference)

-    		{

-    			response.renderJavascriptReference((ResourceReference)url);

-    		}

-    		else {

-    			url = Strings.replaceAll((String)url, "media:///", RequestCycle.get().urlFor(resourceReference) + "?s=" + solutionName + "&id=");

-    			response.renderJavascriptReference(url.toString());

-    		}

-		}

-    	for (Object url : cssReferences) {

-			if (url instanceof ResourceReference)

-    		{

-    			response.renderCSSReference((ResourceReference)url);

-    		}

-    		else {

-				url = Strings.replaceAll((String)url, "media:///", RequestCycle.get().urlFor(resourceReference) + "?s=" + solutionName + "&id=");

-    			response.renderCSSReference(url.toString());

-    		}

-		}

-    }

-

 	protected void respond(final AjaxRequestTarget target){   

         Request request = RequestCycle.get().getRequest();

 		final String param = request.getParameter("m");  

@@ -114,8 +80,6 @@

         }

     }

-	private boolean showIndicator = true;

-	

     @Override

     protected String findIndicatorId() {

     	if (showIndicator)

@@ -126,7 +90,7 @@

 	public String getUrlForCallback(Function callback, String[] args, boolean showLoadingIndicator) {

 		// make sure it is added the the current page.

-		app.getPageContributor().addBehavior(CALLBACK_BEHAVIOR, this);

+		app.getPageContributor().addBehavior(BEHAVIOR_ID, this);

 		FunctionDefinition fd = addCallBack(callback);

@@ -183,41 +147,81 @@

     }

 	public void addCssReference(String url) {

-		app.getPageContributor().addBehavior(CALLBACK_BEHAVIOR, this);

-		if (url != null && !cssReferences.contains(url)) cssReferences.add(url);

+		if(!executeGlobalMethod("addGlobalCSSResourceReference", String.class, url)) {

+			app.getPageContributor().addBehavior(BEHAVIOR_ID, this);

+			if (url != null) {

+				Ref r = new Ref(Ref.CSS, url);

+				if (!references.contains(r)) references.add(r);

+			}

+		}

 	}

 	public void addJsReference(String url) {

-		app.getPageContributor().addBehavior(CALLBACK_BEHAVIOR, this);

-		if (url != null && !jsReferences.contains(url)) jsReferences.add(url);

+		if(!executeGlobalMethod("addGlobalJSResourceReference", String.class, url)) {

+			app.getPageContributor().addBehavior(BEHAVIOR_ID, this);

+			if (url != null) {

+				Ref r = new Ref(Ref.JS, url);

+				if (!references.contains(r)) references.add(r);

+			}

+		}

 	}

 	public void addCssReference(ResourceReference url) {

-		app.getPageContributor().addBehavior(CALLBACK_BEHAVIOR, this);

-		if (url != null && !cssReferences.contains(url)) cssReferences.add(url);

+		if(!executeGlobalMethod("addGlobalCSSResourceReference", ResourceReference.class, url)) {

+			app.getPageContributor().addBehavior(BEHAVIOR_ID, this);

+			if (url != null) {

+				Ref r = new Ref(Ref.CSS, url);

+				if (!references.contains(r)) references.add(r);

+			}

+		}

 	}

 	public void addJsReference(ResourceReference url) {

-		app.getPageContributor().addBehavior(CALLBACK_BEHAVIOR, this);

-		if (url != null && !jsReferences.contains(url)) jsReferences.add(url);

+		if(!executeGlobalMethod("addGlobalJSResourceReference", ResourceReference.class, url)) {

+			app.getPageContributor().addBehavior(BEHAVIOR_ID, this);

+			if (url != null) {

+				Ref r = new Ref(Ref.JS, url);

+				if (!references.contains(r)) references.add(r);

+			}

+		}

 	}

 	public void removeCssReference(ResourceReference url) {

-		cssReferences.remove(url);

+		if(!executeGlobalMethod("removeGlobalResourceReference", ResourceReference.class, url)) {

+			if (url != null) references.remove(new Ref(Ref.CSS, url));

+		}

 	}

 	public void removeCssReference(String url) {

-		 cssReferences.remove(url);

+		if(!executeGlobalMethod("removeGlobalResourceReference", String.class, url)) {

+			if (url != null) references.remove(new Ref(Ref.CSS, url));

+		}

 	}

 	public void removeJsReference(ResourceReference url) {

-		jsReferences.remove(url);		

+		if(!executeGlobalMethod("removeGlobalResourceReference", ResourceReference.class, url)) {

+			if (url != null) references.remove(new Ref(Ref.JS, url));

+		}

 	}

 	public void removeJsReference(String url) {

-		jsReferences.remove(url);

+		if(!executeGlobalMethod("removeGlobalResourceReference", String.class, url)) {

+			if (url != null) references.remove(new Ref(Ref.JS, url));

+		}

 	}

+	private boolean executeGlobalMethod(String methodName, Class<?> parameterType, Object url) {

+		try {

+			IPageContributor pageContributor = app.getPageContributor();

+			Class<? extends IPageContributor> clazz = pageContributor.getClass();

+			Method m = clazz.getDeclaredMethod(methodName, new Class[]{ parameterType });

+			m.invoke(pageContributor, new Object[] { url });

+			return true;

+		} catch (Exception e) {

+			return false;

+		}

+	}

+	

 	/*

 	public interface ILatestPageBehaviorListener extends IBehaviorListener

 	{

Index: src/com/servoy/plugins/IWebClientProvider.java

===================================================================

--- src/com/servoy/plugins/IWebClientProvider.java	(revision 54)

+++ src/com/servoy/plugins/IWebClientProvider.java	(working copy)

@@ -3,7 +3,8 @@

 import org.apache.wicket.ResourceReference;

 import org.mozilla.javascript.Function;

-import com.servoy.j2db.scripting.IScriptObject;

+import com.servoy.j2db.scripting.IReturnedTypesProvider;

+import com.servoy.j2db.scripting.IScriptable;

 /**

  * Defines the provider's contract

@@ -10,17 +11,17 @@

  * 

  * @author sean

  */

-public interface IWebClientProvider extends IScriptObject {

+public interface IWebClientProvider extends IScriptable, IReturnedTypesProvider {

 	public String executeJS(final String js, final Function callback, final String[] args);

 	public String addCallback(final Function callback, final String[] args, boolean showLoadingIndicator);

-	public void addCssReference(String url);

-	public void addCssReference(ResourceReference url);

-	public void removeCssReference(String url);

-	public void removeCssReference(ResourceReference url);

-	public void addJsReference(String url);

-	public void addJsReference(ResourceReference url);

-	public void removeJsReference(String url);

-	public void removeJsReference(ResourceReference url);

+	public void internalAddCssReference(String url);

+	public void internalAddCssReference(ResourceReference url);

+	public void internalRemoveCssReference(String url);

+	public void internalRemoveCssReference(ResourceReference url);

+	public void internalAddJsReference(String url);

+	public void internalAddJsReference(ResourceReference url);

+	public void internalRemoveJsReference(String url);

+	public void internalRemoveJsReference(ResourceReference url);

 }

Index: src/com/servoy/plugins/servoy-extension.warnings.txt

===================================================================

--- src/com/servoy/plugins/servoy-extension.warnings.txt	(revision 0)

+++ src/com/servoy/plugins/servoy-extension.warnings.txt	(working copy)

@@ -0,0 +1,67 @@

+65 warnings

+

+EmptyTag - boolean com.servoy.plugins.WebClientProvider.isMarkupVisible(Object element): @return is empty.

+EmptyTag - java.lang.String com.servoy.plugins.WebClientProvider.addCallback(Function callbackMethod): @return is empty.

+EmptyTag - java.lang.String com.servoy.plugins.WebClientProvider.addCallback(Function callbackMethod, String[] argArray): @return is empty.

+EmptyTag - java.lang.String com.servoy.plugins.WebClientProvider.generateCallbackScript(Function callbackMethod): @return is empty.

+EmptyTag - java.lang.String com.servoy.plugins.WebClientProvider.generateCallbackScript(Function callbackMethod, String[] argArray): @return is empty.

+EmptyTag - java.lang.String com.servoy.plugins.WebClientProvider.generateCallbackScript(Function callbackMethod, String[] argArray, boolean showIndicator): @return is empty.

+EmptyTag - java.lang.String com.servoy.plugins.WebClientProvider.getElementMarkupId(Object formElement): @return is empty.

+EmptyTag - java.lang.String com.servoy.plugins.WebClientProvider.getJSONCallbackURL(Function function): @return is empty.

+EmptyTag - java.lang.String com.servoy.plugins.WebClientProvider.getJSONCallbackURL(Function function, Scriptable parametersObject): @return is empty.

+EmptyTag - java.lang.String com.servoy.plugins.WebClientProvider.getVersion(): @return is empty.

+EmptyTag - java.lang.String com.servoy.plugins.WebClientProvider.getXMLCallbackURL(Function function): @return is empty.

+EmptyTag - java.lang.String com.servoy.plugins.WebClientProvider.getXMLCallbackURL(Function function, Scriptable parametersObject): @return is empty.

+ParamTagWithoutContent - boolean com.servoy.plugins.WebClientProvider.isMarkupVisible(Object element): @param tag without text: 'element'.

+ParamTagWithoutContent - java.lang.String com.servoy.plugins.WebClientProvider.addCallback(Function callbackMethod): @param tag without text: 'callbackMethod'.

+ParamTagWithoutContent - java.lang.String com.servoy.plugins.WebClientProvider.addCallback(Function callbackMethod, String[] argArray): @param tag without text: 'argArray'.

+ParamTagWithoutContent - java.lang.String com.servoy.plugins.WebClientProvider.addCallback(Function callbackMethod, String[] argArray): @param tag without text: 'callbackMethod'.

+ParamTagWithoutContent - java.lang.String com.servoy.plugins.WebClientProvider.generateCallbackScript(Function callbackMethod): @param tag without text: 'callbackMethod'.

+ParamTagWithoutContent - java.lang.String com.servoy.plugins.WebClientProvider.generateCallbackScript(Function callbackMethod, String[] argArray): @param tag without text: 'argArray'.

+ParamTagWithoutContent - java.lang.String com.servoy.plugins.WebClientProvider.generateCallbackScript(Function callbackMethod, String[] argArray): @param tag without text: 'callbackMethod'.

+ParamTagWithoutContent - java.lang.String com.servoy.plugins.WebClientProvider.generateCallbackScript(Function callbackMethod, String[] argArray, boolean showIndicator): @param tag without text: 'argArray'.

+ParamTagWithoutContent - java.lang.String com.servoy.plugins.WebClientProvider.generateCallbackScript(Function callbackMethod, String[] argArray, boolean showIndicator): @param tag without text: 'callbackMethod'.

+ParamTagWithoutContent - java.lang.String com.servoy.plugins.WebClientProvider.generateCallbackScript(Function callbackMethod, String[] argArray, boolean showIndicator): @param tag without text: 'showIndicator'.

+ParamTagWithoutContent - java.lang.String com.servoy.plugins.WebClientProvider.getElementMarkupId(Object formElement): @param tag without text: 'formElement'.

+ParamTagWithoutContent - java.lang.String com.servoy.plugins.WebClientProvider.getJSONCallbackURL(Function function): @param tag without text: 'function'.

+ParamTagWithoutContent - java.lang.String com.servoy.plugins.WebClientProvider.getJSONCallbackURL(Function function, Scriptable parametersObject): @param tag without text: 'funtion'.

+ParamTagWithoutContent - java.lang.String com.servoy.plugins.WebClientProvider.getJSONCallbackURL(Function function, Scriptable parametersObject): @param tag without text: 'parametersObject'.

+ParamTagWithoutContent - java.lang.String com.servoy.plugins.WebClientProvider.getXMLCallbackURL(Function function): @param tag without text: 'function'.

+ParamTagWithoutContent - java.lang.String com.servoy.plugins.WebClientProvider.getXMLCallbackURL(Function function, Scriptable parametersObject): @param tag without text: 'function'.

+ParamTagWithoutContent - java.lang.String com.servoy.plugins.WebClientProvider.getXMLCallbackURL(Function function, Scriptable parametersObject): @param tag without text: 'parametersObject'.

+ParamTagWithoutContent - void com.servoy.plugins.WebClientProvider.addCssReference(ResourceReference webResourceReference): @param tag without text: 'webResourceReference'.

+ParamTagWithoutContent - void com.servoy.plugins.WebClientProvider.addCssReference(ResourceReference webResourceReference, Object formOrElement): @param tag without text: 'formOrElement'.

+ParamTagWithoutContent - void com.servoy.plugins.WebClientProvider.addCssReference(ResourceReference webResourceReference, Object formOrElement): @param tag without text: 'webResourceReference'.

+ParamTagWithoutContent - void com.servoy.plugins.WebClientProvider.addCssReference(String stringReference): @param tag without text: 'stringReference'.

+ParamTagWithoutContent - void com.servoy.plugins.WebClientProvider.addCssReference(String stringReference, Object formOrElement): @param tag without text: 'formOrElement'.

+ParamTagWithoutContent - void com.servoy.plugins.WebClientProvider.addCssReference(String stringReference, Object formOrElement): @param tag without text: 'stringReference'.

+ParamTagWithoutContent - void com.servoy.plugins.WebClientProvider.addJsReference(ResourceReference webResourceReference): @param tag without text: 'webResourceReference'.

+ParamTagWithoutContent - void com.servoy.plugins.WebClientProvider.addJsReference(ResourceReference webResourceReference, Object formOrElement): @param tag without text: 'formOrElement'.

+ParamTagWithoutContent - void com.servoy.plugins.WebClientProvider.addJsReference(ResourceReference webResourceReference, Object formOrElement): @param tag without text: 'webResourceReference'.

+ParamTagWithoutContent - void com.servoy.plugins.WebClientProvider.addJsReference(String stringReference): @param tag without text: 'stringReference'.

+ParamTagWithoutContent - void com.servoy.plugins.WebClientProvider.addJsReference(String stringReference, Object formOrElement): @param tag without text: 'formOrElement'.

+ParamTagWithoutContent - void com.servoy.plugins.WebClientProvider.addJsReference(String stringReference, Object formOrElement): @param tag without text: 'stringReference'.

+ParamTagWithoutContent - void com.servoy.plugins.WebClientProvider.executeClientSideJS(String jsToExecute): @param tag without text: 'jsToExecute'.

+ParamTagWithoutContent - void com.servoy.plugins.WebClientProvider.executeClientSideJS(String jsToExecute, Function callbackMethod): @param tag without text: 'callbackMethod'.

+ParamTagWithoutContent - void com.servoy.plugins.WebClientProvider.executeClientSideJS(String jsToExecute, Function callbackMethod): @param tag without text: 'jsToExecute'.

+ParamTagWithoutContent - void com.servoy.plugins.WebClientProvider.executeClientSideJS(String jsToExecute, Function callbackMethod, String[] argArray): @param tag without text: 'argArray'.

+ParamTagWithoutContent - void com.servoy.plugins.WebClientProvider.executeClientSideJS(String jsToExecute, Function callbackMethod, String[] argArray): @param tag without text: 'callbackMethod'.

+ParamTagWithoutContent - void com.servoy.plugins.WebClientProvider.executeClientSideJS(String jsToExecute, Function callbackMethod, String[] argArray): @param tag without text: 'jsToExecute'.

+ParamTagWithoutContent - void com.servoy.plugins.WebClientProvider.removeCssReference(ResourceReference webResourceReference): @param tag without text: 'webResourceReference'.

+ParamTagWithoutContent - void com.servoy.plugins.WebClientProvider.removeCssReference(ResourceReference webResourceReference, Object formOrElement): @param tag without text: 'formOrElement'.

+ParamTagWithoutContent - void com.servoy.plugins.WebClientProvider.removeCssReference(ResourceReference webResourceReference, Object formOrElement): @param tag without text: 'webResourceReference'.

+ParamTagWithoutContent - void com.servoy.plugins.WebClientProvider.removeCssReference(String stringReference): @param tag without text: 'stringReference'.

+ParamTagWithoutContent - void com.servoy.plugins.WebClientProvider.removeCssReference(String stringReference, Object formOrElement): @param tag without text: 'formOrElement'.

+ParamTagWithoutContent - void com.servoy.plugins.WebClientProvider.removeCssReference(String stringReference, Object formOrElement): @param tag without text: 'stringReference'.

+ParamTagWithoutContent - void com.servoy.plugins.WebClientProvider.removeExtraCssClass(Object element): @param tag without text: 'element'.

+ParamTagWithoutContent - void com.servoy.plugins.WebClientProvider.removeJsReference(ResourceReference webResourceReference): @param tag without text: 'webResourceReference'.

+ParamTagWithoutContent - void com.servoy.plugins.WebClientProvider.removeJsReference(ResourceReference webResourceReference, Object formOrElement): @param tag without text: 'formOrElement'.

+ParamTagWithoutContent - void com.servoy.plugins.WebClientProvider.removeJsReference(ResourceReference webResourceReference, Object formOrElement): @param tag without text: 'webResourceReference'.

+ParamTagWithoutContent - void com.servoy.plugins.WebClientProvider.removeJsReference(String stringReference): @param tag without text: 'stringReference'.

+ParamTagWithoutContent - void com.servoy.plugins.WebClientProvider.removeJsReference(String stringReference, Object formOrElement): @param tag without text: 'formOrElement'.

+ParamTagWithoutContent - void com.servoy.plugins.WebClientProvider.removeJsReference(String stringReference, Object formOrElement): @param tag without text: 'stringReference'.

+ParamTagWithoutContent - void com.servoy.plugins.WebClientProvider.setExtraCssClass(Object element, String classAttribute): @param tag without text: 'classAttribute'.

+ParamTagWithoutContent - void com.servoy.plugins.WebClientProvider.setExtraCssClass(Object element, String classAttribute): @param tag without text: 'element'.

+ParamTagWithoutContent - void com.servoy.plugins.WebClientProvider.setMarkupVisible(Object element, boolean visibility): @param tag without text: 'element'.

+ParamTagWithoutContent - void com.servoy.plugins.WebClientProvider.setMarkupVisible(Object element, boolean visibility): @param tag without text: 'visibility'.

+ParamTagWithoutContent - void com.servoy.plugins.WebClientProvider.setRendered(Object element): @param tag without text: 'element'.

Index: src/com/servoy/plugins/servoy-extension.xml

===================================================================

--- src/com/servoy/plugins/servoy-extension.xml	(revision 0)

+++ src/com/servoy/plugins/servoy-extension.xml	(working copy)

@@ -0,0 +1,787 @@

+<?xml version="1.0" encoding="UTF-8" standalone="no"?>

+<servoyextension>

+  <servoydoc>

+    <plugins>

+      <object clientSupport="wc,sc" publicName="WebClientUtils" qualifiedName="com.servoy.plugins.WebClientProvider" scriptingName="plugins.WebClientUtils">

+        <functions>

+          <function clientSupport="wc,sc" deprecated="true" name="addCallback" undocumented="true">

+            <argumentsTypes>

+              <argumentType typecode="org.mozilla.javascript.Function"/>

+            </argumentsTypes>

+            <return type="com.servoy.j2db.documentation.scripting.docs.String" typecode="java.lang.String"/>

+            <parameters>

+              <parameter name="callbackMethod" type="com.servoy.j2db.documentation.scripting.docs.Function" typecode="org.mozilla.javascript.Function"/>

+            </parameters>

+          </function>

+          <function clientSupport="wc,sc" deprecated="true" name="addCallback" undocumented="true">

+            <argumentsTypes>

+              <argumentType typecode="org.mozilla.javascript.Function"/>

+              <argumentType typecode="[Ljava.lang.String;"/>

+            </argumentsTypes>

+            <return type="com.servoy.j2db.documentation.scripting.docs.String" typecode="java.lang.String"/>

+            <parameters>

+              <parameter name="callbackMethod" type="com.servoy.j2db.documentation.scripting.docs.Function" typecode="org.mozilla.javascript.Function"/>

+              <parameter name="argArray" type="com.servoy.j2db.documentation.scripting.docs.String[]" typecode="[Ljava.lang.String;"/>

+            </parameters>

+          </function>

+          <function clientSupport="wc,sc" name="addCssReference">

+            <argumentsTypes>

+              <argumentType typecode="java.lang.String"/>

+            </argumentsTypes>

+            <return type="void" typecode="void"/>

+            <descriptions>

+              <description clientSupport="wc,sc"><![CDATA[Adds a global (or form/element when the second arg. is provided) css url.

+Note: up to plugin version v1.3.6, global references had a bug - they were only added to current request's page (each time the API was used).]]></description>

+            </descriptions>

+            <summaries>

+              <summary clientSupport="wc,sc"><![CDATA[Adds a global (or form/element when the second arg.]]></summary>

+            </summaries>

+            <samples>

+              <sample clientSupport="wc,sc"><![CDATA[// add global reference (to all pages)

+%%elementName%%.addCssReference('http://yourserver.com/css/yourstyle.css');

+//add form reference

+%%elementName%%.addCssReference('http://yourserver.com/css/yourstyle.css', forms.myFormWithSpecialCSS);

+//add form element reference

+%%elementName%%.addCssReference('http://yourserver.com/css/yourstyle.css', elements.myElementWithSpecialCSS);]]></sample>

+            </samples>

+            <parameters>

+              <parameter name="stringReference" type="com.servoy.j2db.documentation.scripting.docs.String" typecode="java.lang.String"/>

+            </parameters>

+          </function>

+          <function clientSupport="wc,sc" name="addCssReference">

+            <argumentsTypes>

+              <argumentType typecode="java.lang.String"/>

+              <argumentType typecode="java.lang.Object"/>

+            </argumentsTypes>

+            <return type="void" typecode="void"/>

+            <descriptions>

+              <description clientSupport="wc,sc"><![CDATA[Adds a global (or form/element when the second arg. is provided) css url.

+Note: up to plugin version v1.3.6, global references had a bug - they were only added to current request's page (each time the API was used).]]></description>

+            </descriptions>

+            <summaries>

+              <summary clientSupport="wc,sc"><![CDATA[Adds a global (or form/element when the second arg.]]></summary>

+            </summaries>

+            <samples>

+              <sample clientSupport="wc,sc"><![CDATA[// add global reference (to all pages)

+%%elementName%%.addCssReference('http://yourserver.com/css/yourstyle.css');

+//add form reference

+%%elementName%%.addCssReference('http://yourserver.com/css/yourstyle.css', forms.myFormWithSpecialCSS);

+//add form element reference

+%%elementName%%.addCssReference('http://yourserver.com/css/yourstyle.css', elements.myElementWithSpecialCSS);]]></sample>

+            </samples>

+            <parameters>

+              <parameter name="stringReference" type="com.servoy.j2db.documentation.scripting.docs.String" typecode="java.lang.String"/>

+              <parameter name="formOrElement" type="com.servoy.j2db.documentation.scripting.docs.Object" typecode="java.lang.Object"/>

+            </parameters>

+          </function>

+          <function clientSupport="wc,sc" name="addCssReference">

+            <argumentsTypes>

+              <argumentType typecode="org.apache.wicket.ResourceReference"/>

+            </argumentsTypes>

+            <return type="void" typecode="void"/>

+            <descriptions>

+              <description clientSupport="wc,sc"><![CDATA[Adds a built-in servoy css reference (see SERVOY_WEB_RESOURCES) to all pages (when global) or only to pages containing that form/element (when the second arg. is provided).

+Note: up to plugin version v1.3.6, global references had a bug - they were only added to current request's page (each time the API was used).]]></description>

+            </descriptions>

+            <summaries>

+              <summary clientSupport="wc,sc"><![CDATA[Adds a built-in servoy css reference (see SERVOY_WEB_RESOURCES) to all pages (when global) or only to pages containing that form/element (when the second arg.]]></summary>

+            </summaries>

+            <samples>

+              <sample clientSupport="wc,sc"><![CDATA[// add Servoy internal CSS style sheets (like Yahoo UI widgets styles)

+// Note that Yahoo UI widgets are only present from Servoy 60 and higer.

+%%elementName%%.addCssReference(SERVOY_WEB_RESOURCES.YUI_CSS_MENU)

+//add form reference

+%%elementName%%.addCssReference(SERVOY_WEB_RESOURCES.YUI_CSS_MENU, forms.myFormWithSpecialCSS);

+//add form element reference

+%%elementName%%.addCssReference(SERVOY_WEB_RESOURCES.YUI_CSS_MENU, elements.myElementWithSpecialCSS);]]></sample>

+            </samples>

+            <parameters>

+              <parameter name="webResourceReference" type="org.apache.wicket.ResourceReference" typecode="org.apache.wicket.ResourceReference"/>

+            </parameters>

+          </function>

+          <function clientSupport="wc,sc" name="addCssReference">

+            <argumentsTypes>

+              <argumentType typecode="org.apache.wicket.ResourceReference"/>

+              <argumentType typecode="java.lang.Object"/>

+            </argumentsTypes>

+            <return type="void" typecode="void"/>

+            <descriptions>

+              <description clientSupport="wc,sc"><![CDATA[Adds a built-in servoy css reference (see SERVOY_WEB_RESOURCES) to all pages (when global) or only to pages containing that form/element (when the second arg. is provided).

+Note: up to plugin version v1.3.6, global references had a bug - they were only added to current request's page (each time the API was used).]]></description>

+            </descriptions>

+            <summaries>

+              <summary clientSupport="wc,sc"><![CDATA[Adds a built-in servoy css reference (see SERVOY_WEB_RESOURCES) to all pages (when global) or only to pages containing that form/element (when the second arg.]]></summary>

+            </summaries>

+            <samples>

+              <sample clientSupport="wc,sc"><![CDATA[// add Servoy internal CSS style sheets (like Yahoo UI widgets styles)

+// Note that Yahoo UI widgets are only present from Servoy 60 and higer.

+%%elementName%%.addCssReference(SERVOY_WEB_RESOURCES.YUI_CSS_MENU)

+//add form reference

+%%elementName%%.addCssReference(SERVOY_WEB_RESOURCES.YUI_CSS_MENU, forms.myFormWithSpecialCSS);

+//add form element reference

+%%elementName%%.addCssReference(SERVOY_WEB_RESOURCES.YUI_CSS_MENU, elements.myElementWithSpecialCSS);]]></sample>

+            </samples>

+            <parameters>

+              <parameter name="webResourceReference" type="org.apache.wicket.ResourceReference" typecode="org.apache.wicket.ResourceReference"/>

+              <parameter name="formOrElement" type="com.servoy.j2db.documentation.scripting.docs.Object" typecode="java.lang.Object"/>

+            </parameters>

+          </function>

+          <function clientSupport="wc,sc" name="addJsReference">

+            <argumentsTypes>

+              <argumentType typecode="java.lang.String"/>

+            </argumentsTypes>

+            <return type="void" typecode="void"/>

+            <descriptions>

+              <description clientSupport="wc,sc"><![CDATA[Adds a global (or form/element when the second arg. is provided) javascript url.

+Note: up to plugin version v1.3.6, global references had a bug - they were only added to current request's page (each time the API was used).]]></description>

+            </descriptions>

+            <summaries>

+              <summary clientSupport="wc,sc"><![CDATA[Adds a global (or form/element when the second arg.]]></summary>

+            </summaries>

+            <samples>

+              <sample clientSupport="wc,sc"><![CDATA[// add global reference (to all pages)

+%%elementName%%.addJsReference('http://yourserver.com/js/yourscript.js');

+//add form reference

+%%elementName%%.addJsReference('http://yourserver.com/js/yourscript.js', forms.myFormWithSpecialJS);

+//add form element reference

+%%elementName%%.addJsReference('http://yourserver.com/js/yourscript.js', elements.myElementWithSpecialJS);]]></sample>

+            </samples>

+            <parameters>

+              <parameter name="stringReference" type="com.servoy.j2db.documentation.scripting.docs.String" typecode="java.lang.String"/>

+            </parameters>

+          </function>

+          <function clientSupport="wc,sc" name="addJsReference">

+            <argumentsTypes>

+              <argumentType typecode="java.lang.String"/>

+              <argumentType typecode="java.lang.Object"/>

+            </argumentsTypes>

+            <return type="void" typecode="void"/>

+            <descriptions>

+              <description clientSupport="wc,sc"><![CDATA[Adds a global (or form/element when the second arg. is provided) javascript url.

+Note: up to plugin version v1.3.6, global references had a bug - they were only added to current request's page (each time the API was used).]]></description>

+            </descriptions>

+            <summaries>

+              <summary clientSupport="wc,sc"><![CDATA[Adds a global (or form/element when the second arg.]]></summary>

+            </summaries>

+            <samples>

+              <sample clientSupport="wc,sc"><![CDATA[// add global reference (to all pages)

+%%elementName%%.addJsReference('http://yourserver.com/js/yourscript.js');

+//add form reference

+%%elementName%%.addJsReference('http://yourserver.com/js/yourscript.js', forms.myFormWithSpecialJS);

+//add form element reference

+%%elementName%%.addJsReference('http://yourserver.com/js/yourscript.js', elements.myElementWithSpecialJS);]]></sample>

+            </samples>

+            <parameters>

+              <parameter name="stringReference" type="com.servoy.j2db.documentation.scripting.docs.String" typecode="java.lang.String"/>

+              <parameter name="formOrElement" type="com.servoy.j2db.documentation.scripting.docs.Object" typecode="java.lang.Object"/>

+            </parameters>

+          </function>

+          <function clientSupport="wc,sc" name="addJsReference">

+            <argumentsTypes>

+              <argumentType typecode="org.apache.wicket.ResourceReference"/>

+            </argumentsTypes>

+            <return type="void" typecode="void"/>

+            <descriptions>

+              <description clientSupport="wc,sc"><![CDATA[Adds a built-in servoy javascript reference (see SERVOY_WEB_RESOURCES) to all pages (when global) or only to pages containing that form/element (when the second arg. is provided).

+Note: up to plugin version v1.3.6, global references had a bug - they were only added to current request's page (each time the API was used).]]></description>

+            </descriptions>

+            <summaries>

+              <summary clientSupport="wc,sc"><![CDATA[Adds a built-in servoy javascript reference (see SERVOY_WEB_RESOURCES) to all pages (when global) or only to pages containing that form/element (when the second arg.]]></summary>

+            </summaries>

+            <samples>

+              <sample clientSupport="wc,sc"><![CDATA[// add Servoy internal reference scripts (like Yahoo UI widgets)

+// Note that Yahoo UI widgets are only present from Servoy 60 and higer.

+%%elementName%%.addJsReference(SERVOY_WEB_RESOURCES.YUI_JS_MENU);

+//add form reference

+%%elementName%%.addJsReference(SERVOY_WEB_RESOURCES.YUI_JS_MENU, forms.myFormWithSpecialJS);

+//add form element reference

+%%elementName%%.addJsReference(SERVOY_WEB_RESOURCES.YUI_JS_MENU, elements.myElementWithSpecialJS);]]></sample>

+            </samples>

+            <parameters>

+              <parameter name="webResourceReference" type="org.apache.wicket.ResourceReference" typecode="org.apache.wicket.ResourceReference"/>

+            </parameters>

+          </function>

+          <function clientSupport="wc,sc" name="addJsReference">

+            <argumentsTypes>

+              <argumentType typecode="org.apache.wicket.ResourceReference"/>

+              <argumentType typecode="java.lang.Object"/>

+            </argumentsTypes>

+            <return type="void" typecode="void"/>

+            <descriptions>

+              <description clientSupport="wc,sc"><![CDATA[Adds a built-in servoy javascript reference (see SERVOY_WEB_RESOURCES) to all pages (when global) or only to pages containing that form/element (when the second arg. is provided).

+Note: up to plugin version v1.3.6, global references had a bug - they were only added to current request's page (each time the API was used).]]></description>

+            </descriptions>

+            <summaries>

+              <summary clientSupport="wc,sc"><![CDATA[Adds a built-in servoy javascript reference (see SERVOY_WEB_RESOURCES) to all pages (when global) or only to pages containing that form/element (when the second arg.]]></summary>

+            </summaries>

+            <samples>

+              <sample clientSupport="wc,sc"><![CDATA[// add Servoy internal reference scripts (like Yahoo UI widgets)

+// Note that Yahoo UI widgets are only present from Servoy 60 and higer.

+%%elementName%%.addJsReference(SERVOY_WEB_RESOURCES.YUI_JS_MENU);

+//add form reference

+%%elementName%%.addJsReference(SERVOY_WEB_RESOURCES.YUI_JS_MENU, forms.myFormWithSpecialJS);

+//add form element reference

+%%elementName%%.addJsReference(SERVOY_WEB_RESOURCES.YUI_JS_MENU, elements.myElementWithSpecialJS);]]></sample>

+            </samples>

+            <parameters>

+              <parameter name="webResourceReference" type="org.apache.wicket.ResourceReference" typecode="org.apache.wicket.ResourceReference"/>

+              <parameter name="formOrElement" type="com.servoy.j2db.documentation.scripting.docs.Object" typecode="java.lang.Object"/>

+            </parameters>

+          </function>

+          <function clientSupport="wc,sc" name="executeClientSideJS">

+            <argumentsTypes>

+              <argumentType typecode="java.lang.String"/>

+            </argumentsTypes>

+            <return type="void" typecode="void"/>

+            <descriptions>

+              <description clientSupport="wc,sc"><![CDATA[Executes Client-Side Javascript with optional callback on server.]]></description>

+            </descriptions>

+            <summaries>

+              <summary clientSupport="wc,sc"><![CDATA[Executes Client-Side Javascript with optional callback on server.]]></summary>

+            </summaries>

+            <samples>

+              <sample clientSupport="wc,sc"><![CDATA[// ex 1) Execute simple Client-Side Javascript (Web-Client only)

+var jsToExecute = \"alert('Hello World: Called From Servoy Method!');

+plugins.WebClientUtils.executeClientSideJS(jsToExecute)

+// ex 2) Execute client-side script w/ callback

+// Add two numbers on the client and send the result to the server.

+// You can send an array of literals back to the server and into a callback method.

+// (Literals will be evaluated on the client first)

+var jsToExecute = \"var sum = 1 + 2\";

+%%elementName%%.executeClientSideJS(jsToExecute, myCallBackMethod, ['sum']);]]></sample>

+            </samples>

+            <parameters>

+              <parameter name="jsToExecute" type="com.servoy.j2db.documentation.scripting.docs.String" typecode="java.lang.String"/>

+            </parameters>

+          </function>

+          <function clientSupport="wc,sc" name="executeClientSideJS">

+            <argumentsTypes>

+              <argumentType typecode="java.lang.String"/>

+              <argumentType typecode="org.mozilla.javascript.Function"/>

+            </argumentsTypes>

+            <return type="void" typecode="void"/>

+            <descriptions>

+              <description clientSupport="wc,sc"><![CDATA[Executes Client-Side Javascript with optional callback on server.]]></description>

+            </descriptions>

+            <summaries>

+              <summary clientSupport="wc,sc"><![CDATA[Executes Client-Side Javascript with optional callback on server.]]></summary>

+            </summaries>

+            <samples>

+              <sample clientSupport="wc,sc"><![CDATA[// ex 1) Execute simple Client-Side Javascript (Web-Client only)

+var jsToExecute = \"alert('Hello World: Called From Servoy Method!');

+plugins.WebClientUtils.executeClientSideJS(jsToExecute)

+// ex 2) Execute client-side script w/ callback

+// Add two numbers on the client and send the result to the server.

+// You can send an array of literals back to the server and into a callback method.

+// (Literals will be evaluated on the client first)

+var jsToExecute = \"var sum = 1 + 2\";

+%%elementName%%.executeClientSideJS(jsToExecute, myCallBackMethod, ['sum']);]]></sample>

+            </samples>

+            <parameters>

+              <parameter name="jsToExecute" type="com.servoy.j2db.documentation.scripting.docs.String" typecode="java.lang.String"/>

+              <parameter name="callbackMethod" type="com.servoy.j2db.documentation.scripting.docs.Function" typecode="org.mozilla.javascript.Function"/>

+            </parameters>

+          </function>

+          <function clientSupport="wc,sc" name="executeClientSideJS">

+            <argumentsTypes>

+              <argumentType typecode="java.lang.String"/>

+              <argumentType typecode="org.mozilla.javascript.Function"/>

+              <argumentType typecode="[Ljava.lang.String;"/>

+            </argumentsTypes>

+            <return type="void" typecode="void"/>

+            <descriptions>

+              <description clientSupport="wc,sc"><![CDATA[Executes Client-Side Javascript with optional callback on server.]]></description>

+            </descriptions>

+            <summaries>

+              <summary clientSupport="wc,sc"><![CDATA[Executes Client-Side Javascript with optional callback on server.]]></summary>

+            </summaries>

+            <samples>

+              <sample clientSupport="wc,sc"><![CDATA[// ex 1) Execute simple Client-Side Javascript (Web-Client only)

+var jsToExecute = \"alert('Hello World: Called From Servoy Method!');

+plugins.WebClientUtils.executeClientSideJS(jsToExecute)

+// ex 2) Execute client-side script w/ callback

+// Add two numbers on the client and send the result to the server.

+// You can send an array of literals back to the server and into a callback method.

+// (Literals will be evaluated on the client first)

+var jsToExecute = \"var sum = 1 + 2\";

+%%elementName%%.executeClientSideJS(jsToExecute, myCallBackMethod, ['sum']);]]></sample>

+            </samples>

+            <parameters>

+              <parameter name="jsToExecute" type="com.servoy.j2db.documentation.scripting.docs.String" typecode="java.lang.String"/>

+              <parameter name="callbackMethod" type="com.servoy.j2db.documentation.scripting.docs.Function" typecode="org.mozilla.javascript.Function"/>

+              <parameter name="argArray" type="com.servoy.j2db.documentation.scripting.docs.String[]" typecode="[Ljava.lang.String;"/>

+            </parameters>

+          </function>

+          <function clientSupport="wc,sc" name="generateCallbackScript">

+            <argumentsTypes>

+              <argumentType typecode="org.mozilla.javascript.Function"/>

+            </argumentsTypes>

+            <return type="com.servoy.j2db.documentation.scripting.docs.String" typecode="java.lang.String"/>

+            <descriptions>

+              <description clientSupport="wc,sc"><![CDATA[Adds web-client call-back behavior for a method, passing optional parameters, and optionally hiding the Ajax callback indicator.

+Returns the javascript for the client.]]></description>

+            </descriptions>

+            <summaries>

+              <summary clientSupport="wc,sc"><![CDATA[Adds web-client call-back behavior for a method, passing optional parameters, and optionally hiding the Ajax callback indicator.]]></summary>

+            </summaries>

+            <samples>

+              <sample clientSupport="wc,sc"><![CDATA[var callback = %%elementName%%.generateCallbackScript(myMethod, ['arg1','argN'], true);

+var script = 'function myFunction(arg1, argN){'+callback+'}';

+var markup = '<html><head><script type=\"text/javascript\">'+script+'</script></head></html>';]]></sample>

+            </samples>

+            <parameters>

+              <parameter name="callbackMethod" type="com.servoy.j2db.documentation.scripting.docs.Function" typecode="org.mozilla.javascript.Function"/>

+            </parameters>

+          </function>

+          <function clientSupport="wc,sc" name="generateCallbackScript">

+            <argumentsTypes>

+              <argumentType typecode="org.mozilla.javascript.Function"/>

+              <argumentType typecode="[Ljava.lang.String;"/>

+            </argumentsTypes>

+            <return type="com.servoy.j2db.documentation.scripting.docs.String" typecode="java.lang.String"/>

+            <descriptions>

+              <description clientSupport="wc,sc"><![CDATA[Adds web-client call-back behavior for a method, passing optional parameters, and optionally hiding the Ajax callback indicator.

+Returns the javascript for the client.]]></description>

+            </descriptions>

+            <summaries>

+              <summary clientSupport="wc,sc"><![CDATA[Adds web-client call-back behavior for a method, passing optional parameters, and optionally hiding the Ajax callback indicator.]]></summary>

+            </summaries>

+            <samples>

+              <sample clientSupport="wc,sc"><![CDATA[var callback = %%elementName%%.generateCallbackScript(myMethod, ['arg1','argN'], true);

+var script = 'function myFunction(arg1, argN){'+callback+'}';

+var markup = '<html><head><script type=\"text/javascript\">'+script+'</script></head></html>';]]></sample>

+            </samples>

+            <parameters>

+              <parameter name="callbackMethod" type="com.servoy.j2db.documentation.scripting.docs.Function" typecode="org.mozilla.javascript.Function"/>

+              <parameter name="argArray" type="com.servoy.j2db.documentation.scripting.docs.String[]" typecode="[Ljava.lang.String;"/>

+            </parameters>

+          </function>

+          <function clientSupport="wc,sc" name="generateCallbackScript">

+            <argumentsTypes>

+              <argumentType typecode="org.mozilla.javascript.Function"/>

+              <argumentType typecode="[Ljava.lang.String;"/>

+              <argumentType typecode="boolean"/>

+            </argumentsTypes>

+            <return type="com.servoy.j2db.documentation.scripting.docs.String" typecode="java.lang.String"/>

+            <descriptions>

+              <description clientSupport="wc,sc"><![CDATA[Adds web-client call-back behavior for a method, passing optional parameters, and optionally hiding the Ajax callback indicator.

+Returns the javascript for the client.]]></description>

+            </descriptions>

+            <summaries>

+              <summary clientSupport="wc,sc"><![CDATA[Adds web-client call-back behavior for a method, passing optional parameters, and optionally hiding the Ajax callback indicator.]]></summary>

+            </summaries>

+            <samples>

+              <sample clientSupport="wc,sc"><![CDATA[var callback = %%elementName%%.generateCallbackScript(myMethod, ['arg1','argN'], true);

+var script = 'function myFunction(arg1, argN){'+callback+'}';

+var markup = '<html><head><script type=\"text/javascript\">'+script+'</script></head></html>';]]></sample>

+            </samples>

+            <parameters>

+              <parameter name="callbackMethod" type="com.servoy.j2db.documentation.scripting.docs.Function" typecode="org.mozilla.javascript.Function"/>

+              <parameter name="argArray" type="com.servoy.j2db.documentation.scripting.docs.String[]" typecode="[Ljava.lang.String;"/>

+              <parameter name="showIndicator" type="com.servoy.j2db.documentation.scripting.docs.Boolean" typecode="boolean"/>

+            </parameters>

+          </function>

+          <function clientSupport="wc,sc" name="getElementMarkupId">

+            <argumentsTypes>

+              <argumentType typecode="java.lang.Object"/>

+            </argumentsTypes>

+            <return type="com.servoy.j2db.documentation.scripting.docs.String" typecode="java.lang.String"/>

+            <descriptions>

+              <description clientSupport="wc,sc"><![CDATA[Returns a Servoy markup Id to be used in your browser scripts.]]></description>

+            </descriptions>

+            <summaries>

+              <summary clientSupport="wc,sc"><![CDATA[Returns a Servoy markup Id to be used in your browser scripts.]]></summary>

+            </summaries>

+            <samples>

+              <sample clientSupport="wc,sc"><![CDATA[var wicketID = %%elementName%%.getElementMarkupId(elements.aField);]]></sample>

+            </samples>

+            <parameters>

+              <parameter name="formElement" type="com.servoy.j2db.documentation.scripting.docs.Object" typecode="java.lang.Object"/>

+            </parameters>

+          </function>

+          <function clientSupport="wc,sc" name="getJSONCallbackURL">

+            <argumentsTypes>

+              <argumentType typecode="org.mozilla.javascript.Function"/>

+            </argumentsTypes>

+            <return type="com.servoy.j2db.documentation.scripting.docs.String" typecode="java.lang.String"/>

+            <descriptions>

+              <description clientSupport="wc,sc"><![CDATA[Creates a URL for a Servoy method returning a JSON object to be used in Ajax calls for example.]]></description>

+            </descriptions>

+            <summaries>

+              <summary clientSupport="wc,sc"><![CDATA[Creates a URL for a Servoy method returning a JSON object to be used in Ajax calls for example.]]></summary>

+            </summaries>

+            <samples>

+              <sample clientSupport="wc,sc"><![CDATA[var url = %%elementName%%.getJSONCallbackURL(callbackFunction);]]></sample>

+            </samples>

+            <parameters>

+              <parameter name="function" type="com.servoy.j2db.documentation.scripting.docs.Function" typecode="org.mozilla.javascript.Function"/>

+            </parameters>

+          </function>

+          <function clientSupport="wc,sc" name="getJSONCallbackURL">

+            <argumentsTypes>

+              <argumentType typecode="org.mozilla.javascript.Function"/>

+              <argumentType typecode="org.mozilla.javascript.Scriptable"/>

+            </argumentsTypes>

+            <return type="com.servoy.j2db.documentation.scripting.docs.String" typecode="java.lang.String"/>

+            <descriptions>

+              <description clientSupport="wc,sc"><![CDATA[Creates a URL for a Servoy method returning a JSON object to be used in Ajax calls for example.]]></description>

+            </descriptions>

+            <summaries>

+              <summary clientSupport="wc,sc"><![CDATA[Creates a URL for a Servoy method returning a JSON object to be used in Ajax calls for example.]]></summary>

+            </summaries>

+            <samples>

+              <sample clientSupport="wc,sc"><![CDATA[var url = %%elementName%%.getJSONCallbackURL(callbackFunction);]]></sample>

+            </samples>

+            <parameters>

+              <parameter name="funtion"/>

+              <parameter name="parametersObject" type="com.servoy.j2db.documentation.scripting.docs.Object" typecode="org.mozilla.javascript.Scriptable"/>

+            </parameters>

+          </function>

+          <function clientSupport="wc,sc" name="getVersion">

+            <argumentsTypes/>

+            <return type="com.servoy.j2db.documentation.scripting.docs.String" typecode="java.lang.String"/>

+            <descriptions>

+              <description clientSupport="wc,sc"><![CDATA[Returns the plugin version.]]></description>

+            </descriptions>

+            <summaries>

+              <summary clientSupport="wc,sc"><![CDATA[Returns the plugin version.]]></summary>

+            </summaries>

+            <samples>

+              <sample clientSupport="wc,sc"><![CDATA[application.output(%%elementName%%.getVersion());]]></sample>

+            </samples>

+          </function>

+          <function clientSupport="wc,sc" name="getXMLCallbackURL">

+            <argumentsTypes>

+              <argumentType typecode="org.mozilla.javascript.Function"/>

+            </argumentsTypes>

+            <return type="com.servoy.j2db.documentation.scripting.docs.String" typecode="java.lang.String"/>

+            <descriptions>

+              <description clientSupport="wc,sc"><![CDATA[Creates a URL for a Servoy method returning a XML object to be used in Ajax calls for example.]]></description>

+            </descriptions>

+            <summaries>

+              <summary clientSupport="wc,sc"><![CDATA[Creates a URL for a Servoy method returning a XML object to be used in Ajax calls for example.]]></summary>

+            </summaries>

+            <samples>

+              <sample clientSupport="wc,sc"><![CDATA[var url = %%elementName%%.getXMLCallbackURL(callbackFunction);]]></sample>

+            </samples>

+            <parameters>

+              <parameter name="function" type="com.servoy.j2db.documentation.scripting.docs.Function" typecode="org.mozilla.javascript.Function"/>

+            </parameters>

+          </function>

+          <function clientSupport="wc,sc" name="getXMLCallbackURL">

+            <argumentsTypes>

+              <argumentType typecode="org.mozilla.javascript.Function"/>

+              <argumentType typecode="org.mozilla.javascript.Scriptable"/>

+            </argumentsTypes>

+            <return type="com.servoy.j2db.documentation.scripting.docs.String" typecode="java.lang.String"/>

+            <descriptions>

+              <description clientSupport="wc,sc"><![CDATA[Creates a URL for a Servoy method returning a XML object to be used in Ajax calls for example.]]></description>

+            </descriptions>

+            <summaries>

+              <summary clientSupport="wc,sc"><![CDATA[Creates a URL for a Servoy method returning a XML object to be used in Ajax calls for example.]]></summary>

+            </summaries>

+            <samples>

+              <sample clientSupport="wc,sc"><![CDATA[var url = %%elementName%%.getXMLCallbackURL(callbackFunction);]]></sample>

+            </samples>

+            <parameters>

+              <parameter name="function" type="com.servoy.j2db.documentation.scripting.docs.Function" typecode="org.mozilla.javascript.Function"/>

+              <parameter name="parametersObject" type="com.servoy.j2db.documentation.scripting.docs.Object" typecode="org.mozilla.javascript.Scriptable"/>

+            </parameters>

+          </function>

+          <function clientSupport="wc,sc" name="isMarkupVisible">

+            <argumentsTypes>

+              <argumentType typecode="java.lang.Object"/>

+            </argumentsTypes>

+            <return type="com.servoy.j2db.documentation.scripting.docs.Boolean" typecode="boolean"/>

+            <descriptions>

+              <description clientSupport="wc,sc"><![CDATA[Returns true if the elements markup is visible in the page.]]></description>

+            </descriptions>

+            <summaries>

+              <summary clientSupport="wc,sc"><![CDATA[Returns true if the elements markup is visible in the page.]]></summary>

+            </summaries>

+            <samples>

+              <sample clientSupport="wc,sc"><![CDATA[var visible = %%elementName%%.isMarkupVisible(elements.yourElement);

+%%elementName%%.setMarkupVisible(elements.yourElement,!visible);]]></sample>

+            </samples>

+            <parameters>

+              <parameter name="element" type="com.servoy.j2db.documentation.scripting.docs.Object" typecode="java.lang.Object"/>

+            </parameters>

+          </function>

+          <function clientSupport="wc,sc" name="removeCssReference">

+            <argumentsTypes>

+              <argumentType typecode="java.lang.String"/>

+            </argumentsTypes>

+            <return type="void" typecode="void"/>

+            <descriptions>

+              <description clientSupport="wc,sc"><![CDATA[Removes a global (or form/element when the second arg. is provided) css url.]]></description>

+            </descriptions>

+            <summaries>

+              <summary clientSupport="wc,sc"><![CDATA[Removes a global (or form/element when the second arg.]]></summary>

+            </summaries>

+            <samples>

+              <sample clientSupport="wc,sc"><![CDATA[// remove global reference

+%%elementName%%.removeCssReference('http://yourserver.com/css/yourstyle.css');

+//remove form reference

+%%elementName%%.removeCssReference('http://yourserver.com/css/yourstyle.css', forms.myFormWithSpecialCSS);

+//remove form element reference

+%%elementName%%.removeCssReference('http://yourserver.com/css/yourstyle.css', elements.myElementWithSpecialCSS);]]></sample>

+            </samples>

+            <parameters>

+              <parameter name="stringReference" type="com.servoy.j2db.documentation.scripting.docs.String" typecode="java.lang.String"/>

+            </parameters>

+          </function>

+          <function clientSupport="wc,sc" name="removeCssReference">

+            <argumentsTypes>

+              <argumentType typecode="java.lang.String"/>

+              <argumentType typecode="java.lang.Object"/>

+            </argumentsTypes>

+            <return type="void" typecode="void"/>

+            <descriptions>

+              <description clientSupport="wc,sc"><![CDATA[Removes a global (or form/element when the second arg. is provided) css url.]]></description>

+            </descriptions>

+            <summaries>

+              <summary clientSupport="wc,sc"><![CDATA[Removes a global (or form/element when the second arg.]]></summary>

+            </summaries>

+            <samples>

+              <sample clientSupport="wc,sc"><![CDATA[// remove global reference

+%%elementName%%.removeCssReference('http://yourserver.com/css/yourstyle.css');

+//remove form reference

+%%elementName%%.removeCssReference('http://yourserver.com/css/yourstyle.css', forms.myFormWithSpecialCSS);

+//remove form element reference

+%%elementName%%.removeCssReference('http://yourserver.com/css/yourstyle.css', elements.myElementWithSpecialCSS);]]></sample>

+            </samples>

+            <parameters>

+              <parameter name="stringReference" type="com.servoy.j2db.documentation.scripting.docs.String" typecode="java.lang.String"/>

+              <parameter name="formOrElement" type="com.servoy.j2db.documentation.scripting.docs.Object" typecode="java.lang.Object"/>

+            </parameters>

+          </function>

+          <function clientSupport="wc,sc" name="removeCssReference">

+            <argumentsTypes>

+              <argumentType typecode="org.apache.wicket.ResourceReference"/>

+            </argumentsTypes>

+            <return type="void" typecode="void"/>

+            <descriptions>

+              <description clientSupport="wc,sc"><![CDATA[Removes a built-in Servoy css reference (see SERVOY_WEB_RESOURCES).]]></description>

+            </descriptions>

+            <summaries>

+              <summary clientSupport="wc,sc"><![CDATA[Removes a built-in Servoy css reference (see SERVOY_WEB_RESOURCES).]]></summary>

+            </summaries>

+            <samples>

+              <sample clientSupport="wc,sc"><![CDATA[// remove Servoy internal CSS style sheets (like Yahoo UI widgets styles)

+// Note that Yahoo UI widgets are only present from Servoy 60 and higer.

+%%elementName%%.removeCssReference(SERVOY_WEB_RESOURCES.YUI_CSS_MENU);

+//remove form reference

+%%elementName%%.removeCssReference(SERVOY_WEB_RESOURCES.YUI_CSS_MENU, forms.myFormWithSpecialCSS);

+//remove form element reference

+%%elementName%%.removeCssReference(SERVOY_WEB_RESOURCES.YUI_CSS_MENU, elements.myElementWithSpecialCSS);]]></sample>

+            </samples>

+            <parameters>

+              <parameter name="webResourceReference" type="org.apache.wicket.ResourceReference" typecode="org.apache.wicket.ResourceReference"/>

+            </parameters>

+          </function>

+          <function clientSupport="wc,sc" name="removeCssReference">

+            <argumentsTypes>

+              <argumentType typecode="org.apache.wicket.ResourceReference"/>

+              <argumentType typecode="java.lang.Object"/>

+            </argumentsTypes>

+            <return type="void" typecode="void"/>

+            <descriptions>

+              <description clientSupport="wc,sc"><![CDATA[Removes a built-in Servoy css reference (see SERVOY_WEB_RESOURCES).]]></description>

+            </descriptions>

+            <summaries>

+              <summary clientSupport="wc,sc"><![CDATA[Removes a built-in Servoy css reference (see SERVOY_WEB_RESOURCES).]]></summary>

+            </summaries>

+            <samples>

+              <sample clientSupport="wc,sc"><![CDATA[// remove Servoy internal CSS style sheets (like Yahoo UI widgets styles)

+// Note that Yahoo UI widgets are only present from Servoy 60 and higer.

+%%elementName%%.removeCssReference(SERVOY_WEB_RESOURCES.YUI_CSS_MENU);

+//remove form reference

+%%elementName%%.removeCssReference(SERVOY_WEB_RESOURCES.YUI_CSS_MENU, forms.myFormWithSpecialCSS);

+//remove form element reference

+%%elementName%%.removeCssReference(SERVOY_WEB_RESOURCES.YUI_CSS_MENU, elements.myElementWithSpecialCSS);]]></sample>

+            </samples>

+            <parameters>

+              <parameter name="webResourceReference" type="org.apache.wicket.ResourceReference" typecode="org.apache.wicket.ResourceReference"/>

+              <parameter name="formOrElement" type="com.servoy.j2db.documentation.scripting.docs.Object" typecode="java.lang.Object"/>

+            </parameters>

+          </function>

+          <function clientSupport="wc,sc" name="removeExtraCssClass">

+            <argumentsTypes>

+              <argumentType typecode="java.lang.Object"/>

+            </argumentsTypes>

+            <return type="void" typecode="void"/>

+            <descriptions>

+              <description clientSupport="wc,sc"><![CDATA[Removes an extra class attribute previously set to an element.]]></description>

+            </descriptions>

+            <summaries>

+              <summary clientSupport="wc,sc"><![CDATA[Removes an extra class attribute previously set to an element.]]></summary>

+            </summaries>

+            <samples>

+              <sample clientSupport="wc,sc"><![CDATA[%%elementName%%.removeExtraCssClass(elements.yourElement);]]></sample>

+            </samples>

+            <parameters>

+              <parameter name="element" type="com.servoy.j2db.documentation.scripting.docs.Object" typecode="java.lang.Object"/>

+            </parameters>

+          </function>

+          <function clientSupport="wc,sc" name="removeJsReference">

+            <argumentsTypes>

+              <argumentType typecode="java.lang.String"/>

+            </argumentsTypes>

+            <return type="void" typecode="void"/>

+            <descriptions>

+              <description clientSupport="wc,sc"><![CDATA[Removes a global (or form/element when the second arg. is provided) javascript url.]]></description>

+            </descriptions>

+            <summaries>

+              <summary clientSupport="wc,sc"><![CDATA[Removes a global (or form/element when the second arg.]]></summary>

+            </summaries>

+            <samples>

+              <sample clientSupport="wc,sc"><![CDATA[// remove global reference

+%%elementName%%.removeJsReference('http://yourserver.com/js/yourscript.js');

+//remove form reference

+%%elementName%%.removeJsReference('http://yourserver.com/js/yourscript.js', forms.myFormWithSpecialJS);

+//remove form element reference

+%%elementName%%.removeJsReference('http://yourserver.com/js/yourscript.js', elements.myElementWithSpecialJS);]]></sample>

+            </samples>

+            <parameters>

+              <parameter name="stringReference" type="com.servoy.j2db.documentation.scripting.docs.String" typecode="java.lang.String"/>

+            </parameters>

+          </function>

+          <function clientSupport="wc,sc" name="removeJsReference">

+            <argumentsTypes>

+              <argumentType typecode="java.lang.String"/>

+              <argumentType typecode="java.lang.Object"/>

+            </argumentsTypes>

+            <return type="void" typecode="void"/>

+            <descriptions>

+              <description clientSupport="wc,sc"><![CDATA[Removes a global (or form/element when the second arg. is provided) javascript url.]]></description>

+            </descriptions>

+            <summaries>

+              <summary clientSupport="wc,sc"><![CDATA[Removes a global (or form/element when the second arg.]]></summary>

+            </summaries>

+            <samples>

+              <sample clientSupport="wc,sc"><![CDATA[// remove global reference

+%%elementName%%.removeJsReference('http://yourserver.com/js/yourscript.js');

+//remove form reference

+%%elementName%%.removeJsReference('http://yourserver.com/js/yourscript.js', forms.myFormWithSpecialJS);

+//remove form element reference

+%%elementName%%.removeJsReference('http://yourserver.com/js/yourscript.js', elements.myElementWithSpecialJS);]]></sample>

+            </samples>

+            <parameters>

+              <parameter name="stringReference" type="com.servoy.j2db.documentation.scripting.docs.String" typecode="java.lang.String"/>

+              <parameter name="formOrElement" type="com.servoy.j2db.documentation.scripting.docs.Object" typecode="java.lang.Object"/>

+            </parameters>

+          </function>

+          <function clientSupport="wc,sc" name="removeJsReference">

+            <argumentsTypes>

+              <argumentType typecode="org.apache.wicket.ResourceReference"/>

+            </argumentsTypes>

+            <return type="void" typecode="void"/>

+            <descriptions>

+              <description clientSupport="wc,sc"><![CDATA[Removes a built-in Servoy javascript reference (see SERVOY_WEB_RESOURCES).]]></description>

+            </descriptions>

+            <summaries>

+              <summary clientSupport="wc,sc"><![CDATA[Removes a built-in Servoy javascript reference (see SERVOY_WEB_RESOURCES).]]></summary>

+            </summaries>

+            <samples>

+              <sample clientSupport="wc,sc"><![CDATA[// remove Servoy internal reference scripts (like Yahoo UI widgets)

+// Note that Yahoo UI widgets are only present from Servoy 60 and higer.

+%%elementName%%.removeJsReference(SERVOY_WEB_RESOURCES.YUI_JS_MENU);

+//remove form reference

+%%elementName%%.removeJsReference(SERVOY_WEB_RESOURCES.YUI_JS_MENU, forms.myFormWithSpecialJS);

+//remove form element reference

+%%elementName%%.removeJsReference(SERVOY_WEB_RESOURCES.YUI_JS_MENU, elements.myElementWithSpecialJS);]]></sample>

+            </samples>

+            <parameters>

+              <parameter name="webResourceReference" type="org.apache.wicket.ResourceReference" typecode="org.apache.wicket.ResourceReference"/>

+            </parameters>

+          </function>

+          <function clientSupport="wc,sc" name="removeJsReference">

+            <argumentsTypes>

+              <argumentType typecode="org.apache.wicket.ResourceReference"/>

+              <argumentType typecode="java.lang.Object"/>

+            </argumentsTypes>

+            <return type="void" typecode="void"/>

+            <descriptions>

+              <description clientSupport="wc,sc"><![CDATA[Removes a built-in Servoy javascript reference (see SERVOY_WEB_RESOURCES).]]></description>

+            </descriptions>

+            <summaries>

+              <summary clientSupport="wc,sc"><![CDATA[Removes a built-in Servoy javascript reference (see SERVOY_WEB_RESOURCES).]]></summary>

+            </summaries>

+            <samples>

+              <sample clientSupport="wc,sc"><![CDATA[// remove Servoy internal reference scripts (like Yahoo UI widgets)

+// Note that Yahoo UI widgets are only present from Servoy 60 and higer.

+%%elementName%%.removeJsReference(SERVOY_WEB_RESOURCES.YUI_JS_MENU);

+//remove form reference

+%%elementName%%.removeJsReference(SERVOY_WEB_RESOURCES.YUI_JS_MENU, forms.myFormWithSpecialJS);

+//remove form element reference

+%%elementName%%.removeJsReference(SERVOY_WEB_RESOURCES.YUI_JS_MENU, elements.myElementWithSpecialJS);]]></sample>

+            </samples>

+            <parameters>

+              <parameter name="webResourceReference" type="org.apache.wicket.ResourceReference" typecode="org.apache.wicket.ResourceReference"/>

+              <parameter name="formOrElement" type="com.servoy.j2db.documentation.scripting.docs.Object" typecode="java.lang.Object"/>

+            </parameters>

+          </function>

+          <function clientSupport="wc,sc" name="setExtraCssClass">

+            <argumentsTypes>

+              <argumentType typecode="java.lang.Object"/>

+              <argumentType typecode="java.lang.String"/>

+            </argumentsTypes>

+            <return type="void" typecode="void"/>

+            <descriptions>

+              <description clientSupport="wc,sc"><![CDATA[Sets an extra class attribute to an element.]]></description>

+            </descriptions>

+            <summaries>

+              <summary clientSupport="wc,sc"><![CDATA[Sets an extra class attribute to an element.]]></summary>

+            </summaries>

+            <samples>

+              <sample clientSupport="wc,sc"><![CDATA[%%elementName%%.setExtraCssClass(elements.yourElement, 'specialClass');]]></sample>

+            </samples>

+            <parameters>

+              <parameter name="element" type="com.servoy.j2db.documentation.scripting.docs.Object" typecode="java.lang.Object"/>

+              <parameter name="classAttribute" type="com.servoy.j2db.documentation.scripting.docs.String" typecode="java.lang.String"/>

+            </parameters>

+          </function>

+          <function clientSupport="wc,sc" name="setMarkupVisible">

+            <argumentsTypes>

+              <argumentType typecode="java.lang.Object"/>

+              <argumentType typecode="boolean"/>

+            </argumentsTypes>

+            <return type="void" typecode="void"/>

+            <descriptions>

+              <description clientSupport="wc,sc"><![CDATA[Sets the visiblity of the element markup.]]></description>

+            </descriptions>

+            <summaries>

+              <summary clientSupport="wc,sc"><![CDATA[Sets the visiblity of the element markup.]]></summary>

+            </summaries>

+            <samples>

+              <sample clientSupport="wc,sc"><![CDATA[var visible = %%elementName%%.isMarkupVisible(elements.yourElement);

+%%elementName%%.setMarkupVisible(elements.yourElement,!visible);]]></sample>

+            </samples>

+            <parameters>

+              <parameter name="element" type="com.servoy.j2db.documentation.scripting.docs.Object" typecode="java.lang.Object"/>

+              <parameter name="visibility" type="com.servoy.j2db.documentation.scripting.docs.Boolean" typecode="boolean"/>

+            </parameters>

+          </function>

+          <function clientSupport="wc,sc" name="setRendered">

+            <argumentsTypes>

+              <argumentType typecode="java.lang.Object"/>

+            </argumentsTypes>

+            <return type="void" typecode="void"/>

+            <descriptions>

+              <description clientSupport="wc,sc"><![CDATA[Marks the element as rendered to avoid the server from re-syncing again upon the next update.]]></description>

+            </descriptions>

+            <summaries>

+              <summary clientSupport="wc,sc"><![CDATA[Marks the element as rendered to avoid the server from re-syncing again upon the next update.]]></summary>

+            </summaries>

+            <samples>

+              <sample clientSupport="wc,sc"><![CDATA[%%elementName%%.setRendered(elements.yourElement);]]></sample>

+            </samples>

+            <parameters>

+              <parameter name="element" type="com.servoy.j2db.documentation.scripting.docs.Object" typecode="java.lang.Object"/>

+            </parameters>

+          </function>

+        </functions>

+      </object>

+    </plugins>

+  </servoydoc>

+</servoyextension>

Index: src/com/servoy/plugins/WebClientPlugin.java

===================================================================

--- src/com/servoy/plugins/WebClientPlugin.java	(revision 54)

+++ src/com/servoy/plugins/WebClientPlugin.java	(working copy)

@@ -16,6 +16,7 @@

 import javax.swing.Icon;

 import javax.swing.ImageIcon;

+import com.servoy.j2db.documentation.ServoyDocumented;

 import com.servoy.j2db.plugins.IClientPlugin;

 import com.servoy.j2db.plugins.IClientPluginAccess;

 import com.servoy.j2db.plugins.IServerAccess;

@@ -23,6 +24,7 @@

 import com.servoy.j2db.plugins.PluginException;

 import com.servoy.j2db.preference.PreferencePanel;

 import com.servoy.j2db.scripting.IScriptObject;

+import com.servoy.j2db.scripting.IScriptable;

 /**

  * Main plugin entry

@@ -33,9 +35,11 @@

 public class WebClientPlugin implements IClientPlugin, IServerPlugin {

 	private IClientPluginAccess app;

-	private IScriptObject provider;

+	private IScriptable provider;

 	private Icon icon;

+	public static final String PLUGIN_NAME = "WebClientUtils";

+

 	// plugin implementations

 	public Icon getImage() {

 		if (icon == null)

@@ -45,7 +49,7 @@

 	}

 	public String getName() {

-		return "WebClientUtils";

+		return PLUGIN_NAME;

 	}

 	public PreferencePanel[] getPreferencePanels() {

@@ -58,7 +62,7 @@

 		return props;

 	}

-	public IScriptObject getScriptObject() {

+	public IScriptable getScriptObject() {

 		if (provider == null) {

 			provider = new WebClientProvider(this);

 		}

Index: src/com/servoy/plugins/WebClientProvider.java

===================================================================

--- src/com/servoy/plugins/WebClientProvider.java	(revision 54)

+++ src/com/servoy/plugins/WebClientProvider.java	(working copy)

@@ -12,10 +12,15 @@

 import org.mozilla.javascript.NativeArray;

 import org.mozilla.javascript.NativeJavaObject;

 import org.mozilla.javascript.Scriptable;

+import org.mozilla.javascript.annotations.JSFunction;

+import com.servoy.j2db.IForm;

 import com.servoy.j2db.Messages;

+import com.servoy.j2db.documentation.ServoyDocumented;

 import com.servoy.j2db.plugins.IClientPluginAccess;

 import com.servoy.j2db.server.headlessclient.IWebClientPluginAccess;

+import com.servoy.j2db.ui.IComponent;

+import com.servoy.j2db.ui.IFormUI;

 import com.servoy.j2db.ui.IProviderStylePropertyChanges;

 /**

@@ -24,6 +29,7 @@

  * @author sean

  * @author Servoy Stuff

  */

+@ServoyDocumented(publicName = WebClientPlugin.PLUGIN_NAME, scriptingName = "plugins." + WebClientPlugin.PLUGIN_NAME)

 public class WebClientProvider implements IWebClientProvider {

 	private static final String PLUGIN_VERSION = "1.3.6";

@@ -44,32 +50,68 @@

     	}

     	return null;

 	}

-		

-	public String js_getJSONCallbackURL(final Function callback) {

-		return js_getJSONCallbackURL(callback, null);

+	

+	/**

+	 * Creates a URL for a Servoy method returning a JSON object to be used in Ajax calls for example.

+	 * 

+	 * @sample

+	 * var url = %%elementName%%.getJSONCallbackURL(callbackFunction);

+	 * 

+	 * @param function

+	 * @return

+	 */

+	@JSFunction

+	public String getJSONCallbackURL(final Function function) {

+		return getJSONCallbackURL(function, null);

 	}

-	public String js_getJSONCallbackURL(final Function callback, final Scriptable args) {

-		if(getApp() != null && callback != null) {

+	/**

+	 * @clonedesc getJSONCallbackURL(Function)

+	 * @sampleas getJSONCallbackURL(Function)

+	 * @param funtion

+	 * @param parametersObject

+	 * @return

+	 */

+	@JSFunction

+	public String getJSONCallbackURL(final Function function, final Scriptable parametersObject) {

+		if(getApp() != null && function != null) {

 			if(getApp() != null){

 				JSONBehavior bp = getJSONBehavior(); 

-				Map<String, Object> map = getMapFromScriptable(args);

-				if (bp != null) return bp.getUrlForCallback(callback,map);  

+				Map<String, Object> map = getMapFromScriptable(parametersObject);

+				if (bp != null) return bp.getUrlForCallback(function,map);  

 	    	}

     	}

 		return null;

 	}

-	public String js_getXMLCallbackURL(final Function callback) {

-		return js_getXMLCallbackURL(callback, null);

+	/**

+	 * Creates a URL for a Servoy method returning a XML object to be used in Ajax calls for example.

+	 * 

+	 * @sample

+	 * var url = %%elementName%%.getXMLCallbackURL(callbackFunction);

+	 * 

+	 * @param function

+	 * @return

+	 */

+	@JSFunction

+	public String getXMLCallbackURL(final Function function) {

+		return getXMLCallbackURL(function, null);

 	}

-	public String js_getXMLCallbackURL(final Function callback, final Scriptable args) {

-		if(getApp() != null && callback != null) {

+	/**

+	 * @clonedesc getXMLCallbackURL(Function)

+	 * @sampleas getXMLCallbackURL(Function)

+	 * @param function

+	 * @param parametersObject

+	 * @return

+	 */

+	@JSFunction

+	public String getXMLCallbackURL(final Function function, final Scriptable parametersObject) {

+		if(getApp() != null && function != null) {

 			if(getApp() != null){

 				XMLBehavior bp = getXMLBehavior(); 

-				Map<String, Object> map = getMapFromScriptable(args);

-				if (bp != null) return bp.getUrlForCallback(callback, map);  

+				Map<String, Object> map = getMapFromScriptable(parametersObject);

+				if (bp != null) return bp.getUrlForCallback(function, map);  

 	    	}

     	}

 		return null;

@@ -96,55 +138,122 @@

         return null;

 	}

-	public void addCssReference(String url) {

+	public void internalAddCssReference(String url) {

 		BehaviorProvider bp = getBehavior(); 

 		if (bp != null) bp.addCssReference(url);

 	}

-	public void addCssReference(ResourceReference url) {

+	public void internalAddCssReference(ResourceReference url) {

 		BehaviorProvider bp = getBehavior(); 

 		if (bp != null) bp.addCssReference(url);

 	}

-	public void removeCssReference(ResourceReference url) {

+	protected Component getFormUIComponent(IForm form) {

+		if (form != null) {

+			IFormUI formUI = form.getFormUI();

+			return getComponent(formUI);

+		}

+		return null;

+	}

+	

+	protected Component getComponent(IComponent element) {

+		return (element instanceof Component) ? (Component) element : null;

+	}

+

+	public void internalAddCssReference(String url, Component c) {

+		if (c != null) {

+			ReferencesBehaviorProvider bp = getBehavior(c); 

+			if (bp != null) bp.addCssReference(url, c);

+		}

+	}

+

+	public void internalAddCssReference(ResourceReference ref, Component c) {

+		if (c != null) {

+			ReferencesBehaviorProvider bp = getBehavior(c); 

+			if (bp != null) bp.addCssReference(ref, c);

+		}

+	}

+	

+	public void internalRemoveCssReference(ResourceReference url) {

 		BehaviorProvider bp = getBehavior(); 

 		if (bp != null) bp.removeCssReference(url);

 	}

-	public void removeCssReference(String url) {

+	public void internalRemoveCssReference(String url) {

 		BehaviorProvider bp = getBehavior(); 

 		if (bp != null) bp.removeCssReference(url);

 	}

-	public void addJsReference(String url) {

+	public void internalRemoveCssReference(ResourceReference url, Component c) {

+		if (c != null) {

+			ReferencesBehaviorProvider bp = getBehavior(c); 

+			if (bp != null) bp.removeCssReference(url, c);

+		}

+	}

+	

+	public void internalRemoveCssReference(String url, Component c) {

+		if (c != null) {

+			ReferencesBehaviorProvider bp = getBehavior(c); 

+			if (bp != null) bp.removeCssReference(url, c);

+		}

+	}

+	

+	public void internalAddJsReference(String url, Component c) {

+		if (c != null) {

+			ReferencesBehaviorProvider bp = getBehavior(c);

+			if (bp != null) bp.addJsReference(url, c);

+		}

+	}

+	

+	public void internalAddJsReference(ResourceReference url, Component c) {

+		if (c != null) {

+			ReferencesBehaviorProvider bp = getBehavior(c);

+			if (bp != null) bp.addJsReference(url, c);

+		}

+	}

+	

+	public void internalAddJsReference(String url) {

 		BehaviorProvider bp = getBehavior(); 

 		if (bp != null) bp.addJsReference(url);

 	}

-	public void addJsReference(ResourceReference url) {

+	public void internalAddJsReference(ResourceReference url) {

 		BehaviorProvider bp = getBehavior(); 

 		if (bp != null) bp.addJsReference(url);

 	}

-	public void removeJsReference(ResourceReference url) {

+	public void internalRemoveJsReference(ResourceReference url) {

 		BehaviorProvider bp = getBehavior(); 

 		if (bp != null) bp.removeJsReference(url);

 	}

-	public void removeJsReference(String url) {