swiff.md.svn-base

一款开源强大的javascript控件

Class: Swiff {#Swiff}
=====================

用于便捷的创建Flash对象的功能类

### Credits:

Flash detection and Internet Explorer/Flash Player 9 fix adapted from [SWFObject][].

### 语法:

	var mySwiff = new Swiff(path[, options]);

### 参数:

1. path    - (*string*) SWF文件的路径
2. options - (*object*, optional) 参看下列可选项

###	可选项:

* id - (*string*: 默认为'Swiff_' + 唯一的id) SWF对象的id
* width - (*number*: defaults to 1) SWF对象的宽度
* height - (*number*: defaults to 1) SWF对象的高度
* container - (*element*) SWF对象要放入的容器元素
* params - (*object*) 传递给SWF对象的参数(wmode, bgcolor, allowScriptAccess, loop, 等等)
  * allowScriptAccess - (*string*: 默认为always) 可访问SWF对象的域
  * quality - (*string*: 默认为'high') Flash影片的画面质量
  * swLiveConnect - (*boolean*: 默认为true) 指定第一次加载Flash Player时浏览器是否应启动Java
  * wMode - (*string*: 默认为'transparent') 允许SWF显示的背景为透明
* properties - (*object*) HTML object标签的其他属性
* vars - (*object*) 传递给flashVars的参数对象
* events - (*object*) SWF中调用的外部函数

### 返回值:

* (*element*) 新建的HTML object元素

### 示例:

	var obj = new Swiff('myMovie.swf', {
		id: 'myBeautifulMovie'
		width: 500,
		height: 400,
		params: {
			wmode: 'opaque',
			bgcolor: '#ff3300'
		},
		vars: {
			myVariable: myJsVar,
			myVariableString: 'hello'
		},
		events: {
			load: myOnloadFunc
		}
	});

### 备注:

1. 尽管Swiff返回了对象,但该对象没有扩展任何Element的方法
2. 对object/embed标签元素调用$函数, 则返回的结果仅仅是该元素的引用, 不作任何其他处理


Swiff 函数: remote {#Swiff:remote}
--------------------------------------

从JavaScript调用ActionScript中的方法

###	语法:

	var result = Swiff.remote(obj, fn);

###	参数:

1. obj - (*element*) Swiff实例(一个HTML object元素).
2. fn  - (*string*)  SWF中开放的ActionScript函数名

###	返回值:

* (*mixed*) ActionScript函数的执行返回值

###	示例:

	var obj = new Swiff('myMovie.swf');
	
	alert(Swiff.remote(obj, 'myFlashFn'));	//显示 "This is from the .swf file!".

###	备注:

SWF文件必须将ExternalInterface组件编译进去.详情请查看Adobe的文档[External Interface][]

[SWFObject]: http://blog.deconcept.com/swfobject/
[External Interface]: http://livedocs.adobe.com/flash/9.0/main/wwhelp/wwhimpl/common/html/wwhelp.htm?context=LiveDocs_Parts&file=00001652.html