Browser Support

Identifier:

org.eclipse.ui.browserSupport

Since:

3.1

Description:

This extension point is used to contribute workbench browser support. The support is responsible for opening URLs for all the Eclipse plug-ins. Workbench provides a very rudimentary implementation with a more complete implementation available as an optional RCP plug-in.

Contributions that are meant to be shipped with the product as the standard support should be marked as default. This way, it is possible to override the support with another contribution that is not marked as default. Note however that only one support can be active at any point in time. In case of multiple default and/or non-default contributions, the result is non-deterministic.

Configuration Markup:

<!ELEMENT extension (support+)>

<!ATTLIST extension

point CDATA #REQUIRED

id CDATA #IMPLIED

name CDATA #IMPLIED>

point - A fully qualified identifier of the target extension point.
id - An optional identifier of the extension instance.
name - An optional name of the extension instance.

<!ELEMENT support EMPTY>

<!ATTLIST support

class CDATA #REQUIRED

default (true | false) "false">

class - The class providing the browser support for the workbench. This class should extend org.eclipse.ui.browser.AbstractWorkbenchBrowserSupport.
default - indicates whether this support is the default. Browser support should be marked as default if it is normally shipped with the product as the standard browser support. Browser supports that need to override the default support should have this flag set to false. When workbench encounters two extensions, it will pick a non-default over a default one.

Examples:

The following is an example of a browser support contribution:


   <extension point="org.eclipse.ui.browserSupport">
      <support
          default="true"
          class="com.example.xyz.MyBrowserSupport">
      </support>
   </extension>

API Information:

The contributors are expected to provide a class that extends org.eclipse.ui.browser.AbstractWorkbenchBrowserSupport.

Supplied Implementation:

The workbench provides a simple implementation of the browser support that is used when no contributions are found in the registry.

Copyright (c) 2005 IBM Corporation and others.
This program and the accompanying materials are made available under the terms of the Eclipse Public License 2.0 which accompanies this distribution, and is available at https://www.eclipse.org/legal/epl-v20.html/ SPDX-License-Identifier: EPL-2.0