SWFObject Flash 增强插件


  • SWFObject 2提供两种优化flash播放器的嵌入方法:基于标记的方法和依赖于js的方法。
  • SWFObject 2提供一个js的API,为嵌入SWF文件和获取Flash播放器的相关信息提供了一个完整的工具箱。
  • 只用了一个很小的js文件 (10Kb / GZIPed: 3.9Kb)。
  • SWFObject 1.5, UFO and the Adobe Flash Player Detection Kit的继承者。
  • 拟统一所有现有的Flash播放器的嵌入方法,并提供了嵌入Adobe Flash Player内容新的标准
  • SWFObject v2.2

  • github地址

在线实例

实例预览 addDomLoadEvent

实例预览 addLoadEvent

实例预览 createCSS

实例预览 createCSS Advanced

实例预览 createSWF

实例预览 createSWF Command

实例预览 embedSWF

实例预览 embedSWF Callback

实例预览 getFlashPlayerVersion

实例预览 getObjectById

实例预览 getQueryParamValue

实例预览 hasFlashPlayerVersion

实例预览 registerObject

实例预览 registerObject Callback

实例预览 removeSWF

实例预览 showExpressInstall

实例预览 switchOffAutoHideShow

实例预览 switchOffAutoHideShow Dynamic

使用方法

载入 JavaScript 文件

<script src='swfobject.js'></script>

API 方法

名称说明
addDomLoadEvent(fn)

增加一个只要 DOM 加载完成,就执行的函数。对于不支持的浏览器,将会降级使用 addLoadEvent 方法

addLoadEvent(fn)

在不覆盖 onload 事件的基础上,给 onload 增加一个函数

createCSS(
 selStr,
 declStr,
 mediaStr,
 newStyleBoolean
)

使用 SWFObject 公开的内部方法创建样式表

selStr (string)[必须]:CSS 选择器

declStr (string)[必须]:CSS 声明

mediaStr (string):媒体类型

newStyleBoolean (boolean):是否使用一个新的 style 标签来保存样式

createSWF(
 attObj,
 parObj,
 replaceElemIdStr
)

使用 SWFObject 公开的内部方法来加载 Flash

attObj (object):attributes 的参数。例:{name:value} [参考资料]

parObj (object):params 的参数。例:{name:value} [参考资料]

replaceElemIdStr (string):要加载 Flash 的元素 ID

 

【注意】

attObj 不要设置以下属性:

classid:"D27CDB6E-AE6D-11cf-96B8-444553540000" (SWFObject 会自动添加)

type:"application/x-shockwave-flash" (SWFObject 会自动添加)

codebase:"http://download.macromedia.com/pub/shockwave/cabs/flash/swflash.cab#version=6,0,0,0" (不推荐)

 

parObj 不要设置以下属性:

movie (请使用 data 属性)

embedSWF(
 swfUrlStr,
 replaceElemIdStr,
 widthStr,
 heightStr,
 swfVersionStr,
 xiSwfUrlStr,
 flashvarsObj,
 parObj,
 attObj,
 callbackFn
)

对 HTML 标记加载 Flash (也称为动态发布

参数:

swfUrlStr (string)[必须]:要加载 Flash 的 URL

replaceElemIdStr (string)[必须]:要加载 Flash 的元素 ID

widthStr (string)[必须]:Flash 的宽度

heightStr (string)[必须]:Flash 的高度

swfVersionStr (string):所需 Flash 播放器的最低版本。通常为三个数字的组合,如:"9.0.18",其中可以省略次要版本号,如:"9.0.0" 可以直接写为 "9"

xiSwfUrlStr (string):用来提示升级 Flash 的引导文件。Flash 版本低于要求的最低版本时,会显示这个 Flash,压缩包里面的 expressInstall.swf 可以在 6.0.65 及更高的版本中播放,它的最小尺寸为 310x137px

flashvarsObj (object):flashvars 的参数。例:{name:value}

parObj (object):params 的参数。例:{name:value} [参考资料]

attObj (object):attributes 的参数。例:{name:value} [参考资料]

callbackFn (function):Flash 加载成功后的回调函数

getFlashPlayerVersion()

获取 Flash 播放器的版本号,返回类型为 object,内容为:{major:n,minor:n,release:n}

getObjectById(objectIdStr)

获取加载 Flash 元素

注意:该方法仅支持静态发布

getQueryParamValue(paramStr)

获取 URL 中的参数

paramStr (string):参数名称

hasFlashPlayerVersion(versionStr)

判断 Flash 播放器是否达到要求版本号。返回 true 或 flash

versionStr (string):所需 Flash 播放器的最低版本。通常为三个数字的组合,如:"9.0.18",其中可以省略次要版本号,如:"9.0.0" 可以直接写为 "9"

registerObject(
 objectIdStr,
 swfVersionStr,
 xiSwfUrlStr,
 callbackFn
)

对使用标准的方法加载 Flash (也称为静态发布)

参数:

objectIdStr (string)[必须]:加载 Flash 元素(<object>)的 ID;

swfVersionStr (string)[必须]:所需 Flash 播放器的最低版本。通常为三个数字的组合,如:"9.0.18",其中可以省略次要版本号,如:"9.0.0" 可以直接写为 "9"

xiSwfUrlStr (string):用来提示升级 Flash 的引导文件。Flash 版本低于要求的最低版本时,会显示这个 Flash,压缩包里面的 expressInstall.swf 可以在 6.0.65 及更高的版本中播放,它的最小尺寸为 310x137px

callbackFn (function):Flash 加载成功后的回调函数

removeSWF(objElemIdStr)

删除 HTML 中的 Flash

objElemIdStr (string):要加载 Flash 的元素 ID

showExpressInstall(
 att,
 par,
 replaceElemIdStr,
 callbackFn
)

显示用来提示升级 Flash 

att (object):attributes 的参数。例:{name:value} [参考资料]

par (object):params 的参数。例:{name:value} [参考资料]

replaceElemIdStr (string):要加载 Flash 的元素 ID

callbackFn (function):Flash 加载成功后的回调函数

switchOffAutoHideShow()

禁用 SWFObject 默认显示或隐藏。确保调用后,不受之前的其他 SWFObject 加载影响。

下载地址