首先说一下 YUI Extjs Astra三者的Charts的关系:
Extjs原名YUI-Extjs,最初Extjs是对YUI的封装
Extjs 3.0新增的Charts功能实际上是对YUI Charts的封装
YUI Charts是对Astra Charts的封装
Astra Charts是Astra Flash Components的组件之一
Astra Flash Components是YAHOO提供的flash/flex组件库
Extjs和YUI两者实现CHARTS的示例代码:
//yui LineChart 核心代码
var mychart = new YAHOO.widget.LineChart( "chart", myDataSource,
{
series: seriesDef,
xField: "month",
yAxis: currencyAxis,
dataTipFunction: YAHOO.example.getDataTipText,
//only needed for flash player express install
expressInstall: "assets/expressinstall.swf"
});
//extjs LineChart 核心代码
new Ext.Panel({
title: 'ExtJS.com Visits Trend',
renderTo: 'container',
width:500,
height:300,
layout:'fit',
items: {
xtype: 'linechart',
store: store,
xField: 'name',
yField: 'visits',
listeners: {
itemclick: function(o){
var rec = store.getAt(o.index);
Ext.example.msg('Item Selected', 'You chose {0}.', rec.get('name'));
}
}
}
});
具体实现代码大家请参考官方网站:
http://extjs.com/deploy/dev/examples/chart/charts.html
http://developer.yahoo.com/yui/charts/
由于Extjs的charts功能只是对YUI charts的封装所以我这里只是介绍一下YUI Charts的实现原理。
首先看一下YUI Charts主要类结构
[img]http://seanhe.iteye.com/upload/attachment/139090/ac27d212-f640-3f56-b1dd-9bb51f798262.png[/img]
YAHOO.widget.Chart是所有Chart的基类,其中饼图YAHOO.widget.PieChart是直接继承YAHOO.widget.Chart;而其他柱状图、连线图等其他图形是继承 YAHOO.widget.CartesianChart。而YAHOO.widget.Chart的父类YAHOO.widget.FlashAdapter是实现Chart功能最重要的类,就像它的名字显示的含义一样这个类是js和flash交互的适配器。
下面再看一下为了支持YUI实现Charts功能YUI在Astra Charts上进行的封装
[img]http://seanhe.iteye.com/upload/attachment/139158/20a23107-a7f6-3c45-9750-a8758e46c209.png[/img]
右边2个类是Astra Charts原有的类
YUIAdapter和Charts是为了YUI实现Chart相关功能对Astra Charts进行的封装
Sprite 是不需要时间轴的对象的相应基类。
下面看一下YAHOO.widget.LineChart的初始化过程,也就是执行上面第一段代码时的时序图[img]http://seanhe.iteye.com/upload/attachment/139092/030e4dbe-cfa9-3512-8c2d-a6f0cf47ad64.png[/img]
上图中的XXXChart代表YAHOO.widget.LineChart的一些父类,这里为了画图时简单一点。
new YAHOO.widget.LineChart( …)构造Chart对象,实质上是调用父类的构造函数,最终调用FlashAdapter的构造函数。FlashAdapter的私有方法_embedSWF中创建了一个SWFObject对象
/**
* Embeds the SWF in the page and associates it with this instance.
*
* @method _embedSWF
* @private
*/
_embedSWF: function(swfURL, containerID, swfID, version, backgroundColor, expressInstall, wmode)
{
//standard SWFObject embed
var swfObj = new YAHOO.deconcept.SWFObject(swfURL, swfID, "100%", "100%", version, backgroundColor);
if(expressInstall)
{
swfObj.useExpressInstall(expressInstall);
}
//make sure we can communicate with ExternalInterface
swfObj.addParam("allowScriptAccess", "always");
if(wmode)
{
swfObj.addParam("wmode", wmode);
}
//again, a useful ExternalInterface trick
swfObj.addVariable("allowedDomain", document.location.hostname);
//tell the SWF which HTML element it is in
swfObj.addVariable("elementID", swfID);
// set the name of the function to call when the swf has an event
swfObj.addVariable("eventHandler", "YAHOO.widget.FlashAdapter.eventHandler");
var container = YAHOO.util.Dom.get(containerID);
var result = swfObj.write(container);
if(result)
{
this._swf = YAHOO.util.Dom.get(swfID);
//if successful, let's add an owner property to the SWF reference
//this will allow the event handler to communicate with a YAHOO.widget.FlashAdapter
this._swf.owner = this;
}
else
{
YAHOO.log("Unable to load SWF " + swfURL);
}
},
上面的代码注释大家应该基本可以看明白是怎么回事,我再稍微做一下解释。
SWFObject是一种易用的、符合标准的在网页中嵌入flash对象的方法 ,能够自动检测PC、Mac机器上各种主流浏览器对Flash插件的支持情况。
SWFObject属于另一个开源项目:http://code.google.com/p/swfobject/
swfObj.addParam(“allowScriptAccess”, “always”);//allowscriptaccess=always 允许随时执行脚本操作 使 Flash 应用程序可与其所在的 HTML 页通信
swfObj.addVariable(“allowedDomain”, document.location.hostname);//actionscript与JS的交互不允许跨域
swfObj.addVariable(“eventHandler”, “YAHOO.widget.FlashAdapter.eventHandler”);//指定js提供给actionscript的事件回调函数
swfObj.write(container);//在container这个DOM内插入SWF对象代码
this._swf//就是对SWF对象的引用
this._swf.owner = this;//这里的this代表的就是执行new YAHOO.widget.LineChart( …)后生成的对象
在执行完上面时序图的初始化之后,swf对象就被嵌入了HTML中,后续就要执行FLASH的初始化工作。请看下面的时序图
[img]http://seanhe.iteye.com/upload/attachment/139094/2509585f-792d-3451-ad67-cce4f921f7b5.png[/img]
如上图显示FLASH PLAYER先去调用了Charts的构造函数,但是Charts的构造函数是空的所以实际上最初只是调用了YUIAdapter的构造函数,下面是YUIAdapter的一些核心代码,其他关于charts.swf的代码请看附件charts.rar
public function YUIAdapter()
{
var swfReady:Object;
if (this.stage)
{
this.stage.addEventListener(Event.RESIZE, stageResizeHandler);
this.stage.scaleMode = StageScaleMode.NO_SCALE;
this.stage.align = StageAlign.TOP_LEFT;
}// end if
try
{
ExternalInterface.marshallExceptions = true;
}// end try
catch (error:Error)
{
}// end catch
this._errorText = new TextField();
this._errorText.defaultTextFormat = new TextFormat("_sans", 10, 16711680);
this._errorText.wordWrap = true;
this._errorText.autoSize = TextFieldAutoSize.LEFT;
this._errorText.selectable = false;
this._errorText.mouseEnabled = false;
this.addChild(this._errorText);
this.addEventListener(Event.ADDED, addedHandler);
if (ExternalInterface.available)
{
this.initializeComponent();
swfReady;
this.dispatchEventToJavaScript(swfReady);
}
else
{
throw new IOError("Flash YUIComponent cannot communicate with JavaScript content.");
}// end else if
return;
}// end function
public function getAltText() : String
{
return this._altText;
}// end function
protected function refreshComponentSize() : void
{
if (this.component)
{
var _loc_1:int;
this.component.y = 0;
this.component.x = _loc_1;
this.component.width = this.stage.stageWidth;
this.component.height = this.stage.stageHeight;
}// end if
return;
}// end function
protected function showFatalError(param1:Object) : void
{
if (!param1)
{
param1 = "";
}// end if
if (this._errorText)
{
this._errorText.appendText(param1.toString());
this._errorText.scrollV = this._errorText.maxScrollV;
this._errorText.mouseEnabled = true;
this._errorText.selectable = true;
}// end if
return;
}// end function
protected function addedHandler(param1:Event) : void
{
this.setChildIndex(this._errorText, this.numChildren--);
return;
}// end function
protected function log(param1:Object, param2:String = null) : void
{
if (param1 == null)
{
param1 = "";
}// end if
this.dispatchEventToJavaScript({type:"log", message:param1.toString(), category:param2});
return;
}// end function
protected function initializeComponent() : void
{
this.elementID = this.loaderInfo.parameters.elementID;
this.javaScriptEventHandler = this.loaderInfo.parameters.eventHandler;
var allowedDomain:* = this.loaderInfo.parameters.allowedDomain;
if (allowedDomain)
{
Security.allowDomain(allowedDomain);
this.log("allowing: " + allowedDomain);
}// end if
try
{
ExternalInterface.addCallback("getAltText", getAltText);
ExternalInterface.addCallback("setAltText", setAltText);
}// end try
catch (error:SecurityError)
{
}// end catch
return;
}// end function
protected function dispatchEventToJavaScript(param1:Object) : void
{
var event:* = param1;
try
{
if (ExternalInterface.available)
{
ExternalInterface.call(this.javaScriptEventHandler, this.elementID, event);
}// end if
}// end try
catch (error:Error)
{
if (error is SecurityError)
{
this.showFatalError("Warning: Cannot establish communication between YUI Charts and JavaScript. YUI Charts must be served from HTTP and cannot be viewed locally with file:/// protocol unless location is trusted by Flash Player.\n\nFor more information see:\nhttp://www.adobe.com/products/flashplayer/articles/localcontent/\n\n");
}// end if
}// end catch
return;
}// end function
请看一下上面代码的部分解释
ExternalInterface.marshallExceptions = true;//指示外部接口是否应该尝试将 ActionScript 异常传递到当前浏览器并将 JavaScript 异常传递到 Flash Player。
ExternalInterface.available//指示此播放器是否位于提供外部接口的容器中。
this.javaScriptEventHandler = this.loaderInfo.parameters.eventHandler;//从参数中得到JS提供给Actionscript的事件回调函数
ExternalInterface.addCallback(“getAltText”, getAltText);//将 ActionScript 方法注册为可从容器调用。
ExternalInterface.call(this.javaScriptEventHandler, this.elementID, event);//调用由 Flash Player 容器公开的函数,不传递参数或传递多个参数。
YAHOO.widget.FlashAdapter.eventHandler()这个方法类似于静态方法,将请求分发给LineChart的对象去执行_eventHandler方法。后面代码执行顺序请大家按上面的时序图去分析。
下面是Javascript和Actionscript通信的一些基础知识:
<param?name="allowScriptAccess"?value="always"/>
<embed ... allowscriptaccess="always" type="application/x-shockwave-flash"/>
value参数说明:
always 允许随时执行脚本操作。
never 禁止所有脚本执行操作。
samedomain 只有在 Flash 应用程序来自与 HTML 页相同的域时才允许执行脚本操作。
ExternalInterface.marshallExceptions:指示外部接口是否应该尝试将 ActionScript 异常传递到当前浏览器并将 JavaScript 异常传递到 Flash Player。必须显式将此属性设置为 true,以便在 ActionScript 中捕获 JavaScript 异常以及在 JavaScript 中捕获 ActionScript 异常。
ExternalInterface.available:指示此播放器是否位于提供外部接口的容器中。如果外部接口可用,则此属性为 true;否则,为 false。
ExternalInterface
public static function addCallback(functionName:String, closure:Function):void functionName:String — 容器可用于调用函数的名称。closure:Function — 要调用的 closure 函数。 将 ActionScript 方法注册为可从容器调用。成功调用 addCallBack() 后,容器中的 JavaScript 或 ActiveX 代码可以调用在 Flash Player 中注册的函数。
public static function call(functionName:String, ... arguments): 调用由 Flash Player 容器公开的函数,不传递参数或传递多个参数。如果该函数不可用,调用将返回 null;否则,它返回由该函数提供的值。不允许在 Opera 或 Netscape 浏览器中使用递归;在这些浏览器上,递归调用将生成 null 响应。(Internet Explorer 和 Firefox 浏览器上支持递归。)
参考文档:
ExternalInterface :http://livedocs.adobe.com/flex/3_cn/langref/flash/external/ExternalInterface.html
SWFObject:http://code.google.com/p/swfobject/
http://farthinker.cn/2007/12/27/swfobject-2_0-doc-translation/
[b]再申明一下小弟对Actionscript编程没有任何经验,上面的分析都是凭我以往的开发经验做的分析,请各位老大拍砖指正我分析的错误。[/b]