static read-only variable that returns wheather or not the external interface is available

A JavaScript function in XML that can be used to clear the browser window status.

See also

 DOMEx.call(DOMEx.blankTheWindowStatus); 

A JavaScript function in XML that can be used to retreve the current browser location hash value.
If there is no hash the JavaScript will return an empty string.

See also

 var theHash:String = DOMEx.eget(DOMEx.getHash); 

marshallExceptions switcher with a test for if available.
If not available or marshallExceptions is false returns false otherwise true.
read-write

Same as the ExternalInterface.objectID except also tests for if available.
If the ExternalInterface is not available this will return an empty string.
read-only

note: via the idGet method you can specify which objects id to get, by tag index.

See also

read-only variable statChange

JavaScript in XML used to change the browser window status.

DOMEx.call(DOMEx.statChange, "statusString");

The constructor only needs to be used when setting up a javaScript to swf public function invoker.

See also

Adds a ExternalInterface callback if possible.

Alerts a string via the browser, if possible. If the ExternalInterface is available.

Appends text to an html element.

You can specify how to get the element, by ID or by Tag Name, if by Tag Name last param is which Tag index.

DOMEx.appendTextTo("elementsID", "textToAdd"); //by ID
DOMEx.appendTextTo("elementsTagName", "textToAdd", "byTagName", 0); //by tag name

Same as normal ExternalInterface.call, except a test for if the ExternalInterface is available is also done. If not available, nothing happens.
This function is surrounded by a try catch, to catch any marshelled exceptions.
eget is not. That's their only difference.

See also

Same as external interface call but also checks for if available.

See also

Attempts to get the id of the swf object (by tag index) that is in the wrapper. (cross-browser)

var swfsId:String = DOMEx.idGet();

(example html)

<object type="application/x-shockwave-flash"....></object>

<div> some content </div>

<object type="application/x-shockwave-flash"....></object>

<div> more content </div>

<object type="application/x-shockwave-flash"....></object>

...

var swfsId:String = DOMEx.idGet(1);

The only non-static method. Needs the DisplayObject instance
(the one with the public methods/variables you wish to call/get/set) passed to an instantiated DOMEx.

Used to create a javaScript to swf public function invoker/variable getter and setter.

Use this as the function you make a master talk of, and you will be able to call any public function in the swf via javaScript in the wrapper.
You will also have the ability to get public variables from the swf, and set public variables in the swf.
This method can also be used to invoke any function, when used inside the swf, but its purpose is for javaScript to swf communication.

Setup is a three step proccess.
See the examples below.

See also

//public getter assignment:
public function get getterNameYoullCall():Function {
   
   return ActualFunction;
}
private function ActualFunction(...args):*
{
     //things to do in the swf
}

// and/or just plain getters:
      
private var myVar:Boolean = true;
public function get avar():Boolean { return myVar; }
      
    
//and plain public vars:
    
public var someArray:Array = [1,2,3];
       
           
//and public setters:
       
public function set myArray(toThis:Array):void
{
      someArray = toThis;
      someArray.push("setter magic");
}
     
public function get myArray():Array
{
       return someArray;
}
     
// and/or just plain public functions:
      
public function functionNameYoullCall(...args):*
{
      
       //things to do in the swf

}
         
public function addThese(numOne:Number, numTwo:Number):Number
{
       return numOne + numTwo;
}

DOMEx.addCall("callForFunction", new DOMEx(this).invokeViaJavScript);

DOMEx.makeMasterTalk("masterFunctionName", "callForFunction", DOMEx.idGet());

JavaScript XML Variable Creation Method

You can use simple javaScript commands such as "alert('hello world')"
Or full functions with paramaters. See the examples below.

var myFunction:String = 
  "function changeinners(arg1, arg2) {document.getElementById(arg1).innerHTML=arg2;}"

var myJavascript:XML = DOMEx.makeJavaScript(myFunction);
DOMEx.call(myJavaScript, "divID", "<div>html content</div>");

A useful function that assigns a chosen javaScript function name (on the DOM)
to an external callBack function you have already set up.
The resulting javaScript function acts as if it is the Actionscript callBack method itself.

Versus having to manually script for the swf file object then call the callBack as follows:
document.getElementById(mySWFfileId).callBackFunctionName(args); //this way does not always work to refernce the swf file.

Instead, using the makeMasterTalk function makes it possible to simply call:
choosenNameForTheCallBackCall(...args) in your wrapper to invoke the callBack.
note: The function that is set up for you by makeMasterTalk works 90% of the time. (just not IE Mac)
A javaScript file named MasterTalk.js is included in the zip for your reference.

The value of this method is that the only thing needed for use of a DOM based swf
that communicates back and forth with a javaScript enabled DOM based wrapper,
is this class, and to embed the swf with an id.

After you assign a function it can be called from both the wrapper and from your swf:
DOMEx.call(choosenNameForTheCallBackCall, args);
Doing such a thing would be like calling a function within, from without, but within !?
There may be times when you want to do that.
Perhaps if the choosen name is passed in by flashvars or in some other way user controlled.


Makes: A javaScript function of the name you choose,
or a javaScript function named "masterTalk" if no name is passed.
Also, marshallExpections will automatically be set to true.
note: to make it false declare DOMEx.marshall = false; after the makeMasterTalk call

Special Errors: If the name you want already has a value in the DOM (is not undefined),
a javaScript alert will alert you of the situation.
The makeMasterTalk function will not create a javaScript function with a name that is not undefined,
please see the examples.

Parameters

See also

if(DOMEx.addCall("callBacksName", myActionScriptFunction))
DOMEx.makeMasterTalk("nameYouWant", "callBacksName", "swfsID"); //you can use DOMEx.idGet() to get the id
private function myActionScriptFunction(...optional args):*{
   //do something in the swf
}

if(DOMEx.addCall("callBacksName", myActionScriptFunction))
DOMEx.makeMasterTalk("nameYouWant", "callbacksName"); //id left out

if(DOMEx.addCall("callBacksName", myActionScriptFunction))
DOMEx.makeMasterTalk("nameYouWant");//id and callback name left out

makeMasterTalk("doSomething" ...)

Makes one kind of html element horizontally resizeable (cross-browser).

Resizability is signified by a hand curcor at about the last 90% of the element and a title of "drag to resize" when the pointer cursor is active. The elements that are having this applied should not already have a title.

DOMEx.resizeMakeAbleHorizontal("pre"); //makes all pres in the wrapper horizontally resizeable.

Updates or replaces the innerHTML of an element.

This function should not be used until the DOM is fully loaded.
You can specify how to reference the element, by ID or by Tag Name.
If by Tag Name the second to last param is the Tag index.
The last param is a boolean for if replace or not.

//updates the innerHTML of an element by ID:
DOMEx.updateInnerHTML("elementsID", "<div>some html</div>"); 

//replaces the innerHTML of the element by tag name that is at tag index 2:
DOMEx.updateInnerHTML("elemntsTagName", "<div>html</div>", "byTagName", 2, true);