如何在SWT视图中渲染HTML文件？求Eclipse Javadoc视图源码位置

Great questions! Let's break this down step by step.

The Javadoc view is part of the org.eclipse.jdt.ui plugin (part of Eclipse's Java Development Tools project). Here's how to locate its source:

• If you have the Eclipse SDK installed, use the Ctrl+Shift+T (Open Type) shortcut and search for JavadocView. The class lives in the org.eclipse.jdt.internal.ui.javadoc package. Since it's an internal class, you might need to adjust your Eclipse preferences: go to Window > Preferences > Java > Appearance > Type Filters and uncheck filters for internal packages to view it.
• For Git access, the JDT UI repository includes the file at this path:
  org.eclipse.jdt.ui/src/org/eclipse/jdt/internal/ui/javadoc/JavadocView.java
• You can also install the source bundle directly via Eclipse: go to Help > Install New Software, select the Eclipse SDK repository, and check the "JDT UI Sources" option.

The Eclipse Javadoc view uses SWT's Browser widget under the hood to render HTML. You can replicate this approach with these steps:

Step 1: Add the SWT Browser Widget to Your View #

Start by creating a basic SWT View and embedding a Browser control:

public class JavadocStyleView extends ViewPart {
    public static final String ID = "com.example.javadocstyleview";
    private Browser browser;

    @Override
    public void createPartControl(Composite parent) {
        // Initialize the Browser widget (note: requires platform-specific SWT libraries)
        browser = new Browser(parent, SWT.NONE);
        // Set layout to make the Browser fill the entire view
        parent.setLayout(new FillLayout());
    }

    @Override
    public void setFocus() {
        browser.setFocus();
    }
}

Step 2: Load HTML Content #

You can load content just like the Javadoc view does:

• Local HTML file: Use browser.setUrl(new File("path/to/your/document.html").toURI().toString());
• Dynamic HTML string: Use browser.setText("<html><body><h3>Custom Javadoc-style Content</h3><p>This mimics the Javadoc view's rendering.</p></body></html>");

Step 3: Add Javadoc-like Features #

To match the Javadoc view's behavior, add these enhancements:

• Handle link navigation: Attach a LocationListener to intercept clicks. For example, open internal links in your view and external links in the system browser:

  browser.addLocationListener(new LocationAdapter() {
      @Override
      public void changing(LocationEvent event) {
          if (event.location.startsWith("internal:")) {
              event.doit = false; // Block default navigation
              // Load custom internal content
              browser.setText(getInternalContent(event.location));
          } else if (event.location.startsWith("http")) {
              event.doit = false;
              // Open external links in system browser
              Program.launch(event.location);
          }
      }
  });
  

• Replicate Javadoc styling: Extract CSS from the Javadoc view's generated HTML (use "View Page Source" in the Javadoc view) and apply it to your own HTML to match the look.
• Generate dynamic content: If you need to render Java doc comments like the Javadoc view, use Javadoc's built-in APIs to generate HTML from code comments, then pass the result to the Browser widget.

Key Tips #

• The Browser widget uses the OS's native web engine (Chrome on Windows, WebKit on macOS/Linux), so test your HTML across platforms for compatibility.
• For better performance, cache generated HTML content if you're rendering frequently changing data.

内容的提问来源于stack exchange，提问作者Mauro