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