The Java Tutorials have been written for JDK 8. Examples and practices described in this page don't take advantage of improvements introduced in later releases and might use technology no longer available.
See Java Language Changes for a summary of updated language features in Java SE 9 and subsequent releases.
See JDK Release Notes for information about new features, enhancements, and removed or deprecated options for all JDK releases.
A Java applet can load a web page in a browser window using the showDocument
methods in the
java.applet.AppletContext
class.
Here are the two forms of showDocument
:
public void showDocument(java.net.URL url) public void showDocument(java.net.URL url, String targetWindow)
The one-argument form of showDocument
simply instructs the browser to display the document at the specified URL, without specifying the window in which to display the document.
The two-argument form of showDocument
lets you specify the window or HTML frame in which to display the document. The second argument can have one of the following values:
"_blank"
– Display the document in a new, nameless window."windowName"
– Displays the document in a window named windowName. This window is created if necessary."_self"
– Display the document in the window and frame that contain the applet."_parent"
– Display the document in parent frame of the applet's frame. If the applet frame has no parent frame, this acts the same as "_self"
."_top"
– Display the document in the top-level frame. If the applet's frame is the top-level frame, this acts the same as "_self"
.JFrame
, but to an HTML frame within a browser window.
The following applet enables you try every argument of both forms of showDocument
. The applet opens a window that lets you type in a URL and choose an option for the targetWindow
argument. When you press Return or click the Show document button, the applet calls showDocument
.
Following is the applet code that calls showDocument
. Here is the whole program,
ShowDocument
.
...//In an Applet subclass: urlWindow = new URLWindow(getAppletContext()); . . . class URLWindow extends Frame { ... public URLWindow(AppletContext appletContext) { ... this.appletContext = appletContext; ... } ... public boolean action(Event event, Object o) { ... String urlString = /* user-entered string */; URL url = null; try { url = new URL(urlString); } catch (MalformedURLException e) { ...//Inform the user and return... } if (url != null) { if (/* user doesn't want to specify the window */) { appletContext.showDocument(url); } else { appletContext.showDocument(url, /* user-specified window */); } } ...
Download source code for the Show Document example to experiment further.