- 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
在线实例
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 加载影响。 |