APPLET タグ

APPLET タグの簡単な例を示します。


  <applet code="MyApplet.class" width=100 height=140></applet>

これは、コンパイル済みのコードが MyApplet.class (現在の HTML ドキュメントと同じディレクトリ内) にあるアプレットをロードして、アプレットの初期サイズを横 100 ピクセル、縦 140 ピクセルに設定するようビューアまたはブラウザに通知します。

次に、APPLET タグのより複雑な例を示します。


  <applet codebase="http://java.sun.com/applets/NervousText/1.1"
	code="NervousText.class" width=400 height=75>
  <param name="text" value="Welcome to HotJava!">
  <hr>
  If you were using a Java-enabled browser such as HotJava,
  you would see dancing text instead of this paragraph.
  <hr>
  </applet>

これは、コンパイル済みのコードが URL http://java.sun.com/applets/NervousText/1.1/NervousText.class にあるアプレットをロードして、そのアプレットの初期サイズを 400x75 ピクセルに設定するように、ビューアまたはブラウザに通知します。ビューアまたはブラウザは、アプレットの text 属性 (このアプレットが表示するテキストをカスタマイズする属性) を "Welcome to HotJava!" に設定する必要があります。Java アプレットを実行できないブラウザを使ってこのページを表示すると、ブラウザは APPLET タグと PARAM タグを無視し、 <param> タグと </applet> タグの間の HTML (代替 HTML) だけを表示します。

次は、上記の例を HTML ファイルに記述した結果です (ページを最初に開くときには、アプレットがロードされるまで待つ必要がある)。

If you were using a Java-enabled browser such as HotJava, you would see dancing text instead of this paragraph.

次に、APPLET タグの別の例を示します。


   <applet code=A21 width=256 height=256 archive="toir.jar">
   <param name=img value=test.gif>
   <hr>
   We need to convert some of the standard applets to use
   archive.  Any volunteers?
   <hr>
   </applet>

この例では、アプレットクラスは A21 です。そのバイトコードは、アーカイブ "toir.jar" に入っており、またこのアーカイブには、test.gif という名前の画像リソース (リソースのドキュメントを参照) が入っています。

次に、APPLET タグの完全な構文を示します。必須の要素は太字、省略可能な要素は普通の書体、ユーザ指定の要素は斜体で示します。

    <APPLET
        CODEBASE = codebaseURL
        ARCHIVE = archiveList
        CODE = appletFile ...or...  OBJECT = serializedApplet
        ALT = alternateText
        NAME = appletInstanceName
        WIDTH = pixels  HEIGHT = pixels
        ALIGN = alignment
        VSPACE = pixels  HSPACE = pixels
    >
    <PARAM NAME = appletAttribute1 VALUE = value>
    <PARAM NAME = appletAttribute2 VALUE = value>
    . . .
    alternateHTML
    </APPLET>

CODE、CODEBASE などはアプレットタグの属性で、ブラウザにアプレットに関する情報を伝えます。必須の属性は CODE、WIDTH、HEIGHT だけです。各属性について、次に説明します。

CODEBASE = codebaseURL: 省略可能な属性です。アプレットのベース URL (アプレットのコードを含むディレクトリ) を指定します。この属性を指定しない場合は、ドキュメントの URL が使用されます。
ARCHIVE = archiveList: 省略可能な属性です。「プリロード」されるクラスなどのリソースを格納しているアーカイブ (複数可) を指定します。これらのクラスは、指定された CODEBASE で AppletClassLoder のインスタンスを使ってロードされます。archiveList 内のアーカイブは「,」で区切られます。注: JDK 1.1 では、同じ CODEBASE を持つ複数の APPLET タグは、ClassLoader の同じインスタンスを共有します。クライアントコードには、この方法を使ってアプレット相互の通信を実装するものがあります。将来の JDK では、アプレット間通信の別の機構が提供される可能性があります。セキュリティ上の理由から、アプレットのクラスローダは、そのアプレットが起動されたのと同じコードベースからしか読み取ることができません。これは、archiveList 内のアーカイブがコードベースと同じディレクトリか、コードベースのサブディレクトリ内になければならないことを意味します。../a/b.jar の形式の archiveList 内のエントリは、セキュリティポリシーファイル内で明示的に許可されていない限り、機能しません (http コードベースの場合は例外で、archiveList 内のアーカイブはコードベースと同じホストのものでなくてはならないが、パスに「..」が含まれていても構わない)。
CODE = appletFile: 必須の属性です。アプレットのコンパイル済みの Applet サブクラスを含んでいるファイルの、名前を指定します。このファイル名は、アプレットのベース URL からの相対パスで指定します。絶対パスでは指定できません。CODE と OBJECT のどちらか 1 つが必要です。appletFile の値は、classname.class または packagename.classname.class のどちらかの形式になります。
OBJECT = serializedApplet: この属性は、アプレットの直列化表現を含んでいるファイルの、名前を指定します。アプレットは直列化解除されます。init() メソッドは呼び出されませんが、start() メソッドが呼び出されます。元のオブジェクトの直列化時に有効だった属性は、復元されません。この APPLET のインスタンスに渡された引数はすべて、このアプレットで利用できます。この機能の使用には、強い制限をかけるべきです。アプレットは、直列化する前に停止しなければなりません。CODE と OBJECT のどちらか 1 つが必要です。
ALT = alternateText: 省略可能な属性です。ブラウザが APPLET タグを理解できるが、Java アプレットを実行できない場合に表示されるテキストを指定します。
NAME = appletInstanceName: 省略可能な属性です。アプレットのインスタンスの名前を指定します。これにより、同一ページ上のアプレットが互いを検知 (および通信) することができます。
WIDTH = pixels HEIGHT = pixels: 必須の属性です。アプレットの表示領域の幅と高さ (ピクセル数) の初期値を指定します。アプレットが表示するウィンドウやダイアログは考慮しません。
ALIGN = alignment: 省略可能な属性です。アプレットの配置方法を指定します。この属性に設定できる値は IMG タグと同じで、left、right、top、texttop、middle、absmiddle、baseline、bottom、absbottom です。
VSPACE = pixels HSPACE = pixels: 省略可能な属性です。アプレットの外側の上下 (VSPACE) および左右 (HSPACE) のピクセル数を指定します。IMG タグの VSPACE と HSPACE 属性と同様に扱われます。
<PARAM NAME = appletAttribute1 VALUE = value> <PARAM NAME = appletAttribute2 VALUE = value> . . .: このタグは、アプレットの独自の属性を指定する唯一の方法です。アプレットは、getParameter() メソッドを使ってこれらの属性にアクセスします。

Java ソフトウェア