Оглавление | Назад | Вперёд | Индекс

Plugin

Модуль plug-in, установленный на клиенте.

Клиентский объект
Реализован в	JavaScript 1.1

Создание

Plugin-объекты являются предопределёнными объектами JavaScript, доступ к которым Вы получаете через массив navigator.plugins array.

Описание

Объект Plugin это plug-in, установленный на клиентской машине. Рlug-in это программный модуль, который может вызваться браузером для отображения в браузере специализированных типов внедрённых данных. Пользователь может получить список установленных plug-in'ов, выбрав меню About Plug-ins из Help.

Каждый Plugin-объект сам по себе является массивом, содержащим один элемент для каждого MIME-типа, поддерживаемого этим plug-in'ом. Каждый элемент массива это MimeType-объект. Например, следующий код отображает свойства type и description первого MimeType-объекта первого Plugin-объекта.

myPlugin=navigator.plugins[0]
myMimeType=myPlugin[0]
document.writeln('myMimeType.type is ',myMimeType.type,"<BR>")
document.writeln('myMimeType.description is ',myMimeType.description)

Этот код даст на выходе примерно следующее:

myMimeType.type is video/quicktime
myMimeType.description is QuickTime for Windows

Plugin-объект позволяет Вам динамически определять, какие plug-in'ы установлены на клиенте. Вы можете написать скрипт для отображения внедрённых plug-in-данных, если соответствующий plug-in установлен, или вывести некоторую альтернативную информацию, такую как рисунок или текст, если не установлен.

Plug-in'ы могут быть зависимы от платформы и конфигурироваться, поэтому MimeType-массив объектов Plugin может отличаться на разных платформах и для разных пользователей.

Каждый Plugin-объект является элементом массива plugins.

Если Вы используете тэг EMBED для генерирования вывода из plug-in-приложения, Вы не создаёте Plugin-объект. Используйте массив document.embeds для обращения к экземплярам 'plug-in'ов, созданных тэгами EMBED. См. массив - document.embeds.

Свойства. Резюме.

Свойство	Описание
`description`	Описание plug-in'а.
`filename`	Имя файла plug-in'а на диске.
`length`	Количество элементов массива `MimeType`-объектов plug-in'а.
`name`	Имя plug-in'а.

Методы. Резюме.

Этот объект наследует методы watch и unwatch из объекта Object.

Примеры

Пример 1. Пользователь может получить список установленных plug-in'ов, выбрав меню About Plug-ins из Help. Чтобы увидеть код, используемый браузером для этого сообщения, выберите меню About Plug-ins из Help, затем выберите Page Source из View.

Пример 2. Следующий код присваивает укороченные переменные предопределённым свойствам LiveAudio.

var myPluginName = navigator.plugins["LiveAudio"].name
var myPluginFile = navigator.plugins["LiveAudio"].filename
var myPluginDesc = navigator.plugins["LiveAudio"].description

Пример 3. Этот код выводит сообщение "LiveAudio is configured for audio/wav", если LiveAudio plug-in установлен и подключён для "audio/wav" MIME-типа:

var myPlugin = navigator.plugins["LiveAudio"]
var myType = myPlugin["audio/wav"]
if (myType && myType.enabledPlugin == myPlugin)
   document.writeln("LiveAudio is configured for audio/wav")

Пример 4. Следующее выражение представляет количество MIME-типов, которые Shockwave может отобразить:

navigator.plugins["Shockwave"].length

Пример 5. Этот код выводит свойства name, filename, description и length каждого Plugin-объекта на клиенте:

document.writeln("<TABLE BORDER=1><TR VALIGN=TOP>",
   "<TH ALIGN=left>i",
   "<TH ALIGN=left>name",
   "<TH ALIGN=left>filename",
   "<TH ALIGN=left>description",
   "<TH ALIGN=left># of types</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>")

Этот пример даст примерно такой вывод:

i	name	filename	description	# of types
0	QuickTime Plug-In	d:\nettools\netscape\nav30\Program\ plugins\NPQTW32.DLL	QuickTime Plug-In for Win32 v.1.0.0	1
1	LiveAudio	d:\nettools\netscape\nav30\Program\ plugins\NPAUDIO.DLL	LiveAudio--Netscape Navigator sound playing component	7
2	NPAVI32 Dynamic Link Library	d:\nettools\netscape\nav30\Program\ plugins\npavi32.dll	NPAVI32, avi plugin DLL	2
3	Netscape Default Plugin	d:\nettools\netscape\nav30\Program\ plugins\npnul32.dll	Null Plugin	1

См. также

MimeType, document.embeds

description

Читабельное описание plug-in'а. Это текст, предоставляемый разработчиками plug-in'ов.

Свойство из	`Plugin`
Только для чтения
Реализовано в	JavaScript 1.1

filename

Имя файла plug-in'а на диске.

Свойство из	`Plugin`
Только для чтения
Реализовано в	JavaScript 1.1

Описание

Свойство filename это имя программного файла plug-in'а, которое предоставляется самим plug-in'ом. Это имя может варьироваться для разных платформ.

Примеры

См. пример для Plugin.

length

Количество элементов в массиве MimeType-объектов plug-in'а.

Свойство из	`Plugin`
Только для чтения
Реализовано в	JavaScript 1.1

name

Строка, специфицирующая имя plug-in'а.

Свойство из	`Plugin`
Только для чтения
Реализовано в	JavaScript 1.1

Безопасность

JavaScript 1.1. Это свойство разрушено по умолчанию. О разрушении данных см. книгу Клиентский JavaScript. Руководство.

Описание

Имя plug-in'а, предоставляемое самим plug-in'ом. Каждый plug-in должен иметь уникальное имя-идентификатор.

Оглавление | Назад | Вперёд | Индекс

Дата последнего обновления: 28 мая 1999 года.
Copyright (c) 1999 Netscape Communications Corporation