Browsers

org.eclipse.ui.browser.browsers

3.0 (originally added in release 2.0 as org.eclipse.help.ui.browser)

For providing web browsers capable of displaying html documents at a given URL.

<!ELEMENT extension (browser)*>

<!ATTLIST extension

point CDATA #REQUIRED

id    CDATA #IMPLIED

name  CDATA #IMPLIED>


<!ELEMENT browser (location)*>

<!ATTLIST browser

id           CDATA #REQUIRED

factoryclass CDATA #IMPLIED

name         CDATA #REQUIRED

os           CDATA #IMPLIED

executable   CDATA #IMPLIED>


<!ELEMENT location (#PCDATA)>

Default install locations. these locations should not contain the initial path, as it will be substituted with all known drives. (e.g. on Windows, a location of "test.exe" would look for "c:\test.exe", "d:\test.exe", etc. for all known drives.



The following is a sample usage of the browser extension point:

 

<extension point=

"org.eclipse.help.base.browser"

>

<browser id=

"org.eclipse.myPlugin.myBrowserID"

factoryClass=

"org.eclipse.myPlugin.myPackage.MyFactoryClass"

name=

"My Browser"

>

</browser>

</extension>

The supplied factory class must implement the org.eclipse.help.browser.IBrowserFactory interface. Methods in that interface determine whether the factory is available on the given system, i.e. is capable of supplying browser instances, and create browser instances that implement IBrowser interface.

The org.eclipse.help.base and org.eclipse.help.ui plug-ins contain implementation of browsers on common platforms. Other plug-ins can provide different implementations. In the preferences, the user can select the default browser from among available browsers.