SWFObject Flash 增强插件

前端开发仓库

使用方法

载入 JavaScript 文件

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

API 方法

名称 说明
addDomLoadEvent(fn)

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

addLoadEvent(fn)

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

createCSS(
 selStr,
 declStr,
 mediaStr,
 newStyleBoolean
)

使用 SWFObject 公开的内部方法创建样式表 [Demo1] [Demo2]

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

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

mediaStr (string):媒体类型

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

createSWF(
 attObj,
 parObj,
 replaceElemIdStr
)

使用 SWFObject 公开的内部方法来加载 Flash [Demo1] [Demo2]

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 (也称为动态发布) [Demo1] [Demo2]

参数:

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} [Demo]

getObjectById(objectIdStr)

获取加载 Flash 元素 [Demo]

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

getQueryParamValue(paramStr)

获取 URL 中的参数 [Demo]

paramStr (string):参数名称

hasFlashPlayerVersion(versionStr)

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

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

registerObject(
 objectIdStr,
 swfVersionStr,
 xiSwfUrlStr,
 callbackFn
)

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

参数:

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 [Demo]

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

showExpressInstall(
 att,
 par,
 replaceElemIdStr,
 callbackFn
)

显示用来提示升级 Flash [Demo]

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

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

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

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

switchOffAutoHideShow()

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

相关信息

来源:
https://github.com/swfobject/swfobject
授权协议:
MIT