| JavaScript手册 | |
 |
目录 |
|
此参考中包含 的内容 |
|
轻松上手 |
|
简介 |
|
操作符 |
|
语句 |
|
核心 |
|
文档 |
|
窗口 |
|
表单 |
|
浏览器 |
|
事件和 事件句柄 |
|
LiveWire 数据库服务 |
|
进程管理服务 |
|
实用工具 |
|
全局函数 |
|
LiveConnect 的Java包 |
|
索引 |
|
版权 |
Plugin
在客户端上安装的一个插件模块。
| 客户端对象 | |
| 实现版本 | Navigator 3.0 |
创建源
Plugin 对象是 JavaScript 的预定义对象，你可以通过 navigator.plugins 数组访问它们。
描述
一个 Plugin 对象就是一个安装在客户端的插件。所谓插件，就是浏览器用于显示特定类型嵌入数据时调用的软件模块。用户从帮助菜单中选择关于插件选项可以获取已安装插件的清单。
每个 Plugin 对象本身都是一个数组，其中包含的每个元素分别对应于每个该插件支持的 MIME 类型。而数组的每个元素都是一个 MimeType 对象。例如，下面的代码将显示第一个 Plugin 对象的第一个 MimeType 对象的 type 和描述 属性。
myMimeType.type 为 video/quicktime
myMimeType.description 为 QuickTime for Windows
Plugin 对象使你可以动态判断客户端上安装了哪些插件。你可以编写这样的脚本，用于在已安装对应的插件时显示嵌入插件数据，而在没有安装对应插件的时候显示某些如图像或文本等的替换信息。
插件可能是与平台相关的或可配置的，所以 Plugin 对象的 MimeType 对象数组在不同的平台或用户那里的情况可能并不相同。
每个 Plugin 对象都是 plugins 数组中的一个元素。
当你使用 EMBED 标记从插件应用程序中生成输出的时候，你就不能创建 Plugin 对象。你可以使用 document.embeds 数组获取对用 EMBED 标记创建的插件实例的引用。详细内容请参看 document.embeds 数组。
| description | 插件的描述。 |
| filename | 插件文件在磁盘上的文件名。 |
| length | 插件中 MimeType 对象数组的元素个数。 |
| name | 插件的名称。 |
示例
示例 1 用户可以从帮助菜单中选择关于插件获取已安装的插件列表。要查看浏览器完成此报表的源代码，可以首先从帮助菜单中选择关于插件选项，然后从查看菜单中选择页面源文件。
示例 2 下列代码将把预定义的 LiveAudio 属性赋给简明变量。
var myPluginName = navigator.plugins["LiveAudio"].name
var myPluginFile = navigator.plugins["LiveAudio"].filename
var myPluginDesc = navigator.plugins["LiveAudio"].description
示例 3 下面的代码将在已安装 LiveAudio 的情况下显示消息“LiveAudio 已经配置为 audio/wav”，也就是说它对应于“audio/wav”MIME类型：
var myPlugin = navigator.plugins["LiveAudio"]
var myType = myPlugin["audio/wav"]
if (myType && myType.enabledPlugin == myPlugin)
document.writeln("LiveAudio 已经配置为 audio/wav")
示例 4 下面的表达式将呈现出 Shockwave 可以显示的 MIME 类型数目：
navigator.plugins["Shockwave"].length
示例 5 下面的代码将列出一张表，其中显示了客户端每个 Plugin 对象的 name、filename、description 和 length 属性：
document.writeln("<TABLE BORDER=1><TR VALIGN=TOP>",
"<TH ALIGN=left>i",
"<TH ALIGN=left>名称",
"<TH ALIGN=left>文件名",
"<TH ALIGN=left>描述",
"<TH ALIGN=left>类型数</TR>")
for (i=0; i < navigator.plugins.length; i++) {
document.writeln("<TR VALIGN=TOP><TD>",i,
"<TD>",navigator.plugins[i].name,
"<TD>",navigator.plugins[i].filename,
"<TD>",navigator.plugins[i].description,
"<TD>",navigator.plugins[i].length,
"</TR>")
}
document.writeln("</TABLE>")
上面例子的输出结果与下面类似：
属性
description
人工可阅读的插件描述。该文本由插件开发者提供。
| 属性源 | Plugin |
| 只读 | |
| 实现版本 | Navigator 3.0 |
filename
插件文件在磁盘上的名称。
| 属性源 | Plugin |
| 只读 | |
| 实现版本 | Navigator 3.0 |
描述
filename 属性是插件程序文件名，由插件自身提供。该名称可能因平台不同而不同。
length
MimeType 对象的插件数组中的元素个数。
| 属性源 | Plugin |
| 只读 | |
| 实现版本 | Navigator 3.0 |
name
指定插件名称的字符串。
| 属性源 | Plugin |
| 只读 | |
| 实现版本 | Navigator 3.0 |
安全性
Navigator 3.0: 该属性缺省情况下是带有污点的。要获得关于数据污点更多的信息，请看“JavaScript 安全性”。
描述
插件的名称，由插件自身提供。每个插件都应该有一个唯一的名称标识自身。
【目录】 【上一页】 【下一章】 【索引】
回页面顶部