<include>

OpenLaszloのソースコードは1ファイルで完結できますが、複数のファイルに分割することもできます。<include>タグを使うと、他のファイルの内容をインクルードできます。

<include>には3種類の使い方があります：

1. <library>ファイルのインクルード
2. XMLファイルのインクルード
3. テキストファイルのインクルード

href属性でインクルードするファイル名を指定します。ファイル名やディレクトリなどに特に制約はありません。

• インクルードするファイルは、ルート要素として<library>を持つXMLファイル(LZXファイル)で、ライブラリファイルと呼びます。
• ライブラリファイルはさらに他のライブラリファイルをインクルードすることができます。
• ライブラリファイルはコンパイル時に一回だけ読み込まれます。
• インクルードされるファイル名は、命名規則はなく自由につけられます。ディレクトリ構造にも制約はありません。
• ルート要素が<canvas>のファイルはインクルードできません。※一つのOpenLaszloアプリに<canvas>は一つです。

myWindow.lzxという別ファイルをインクルードしています。

<?xml version="1.0" encoding="UTF-8"?>
<canvas proxied="false" bgcolor="0xeeeeee"> 
  <include href="myWindow.lzx"/>
  <myWindow/>
  <myWindow x="160"/>
</canvas>

myWindow.lzx：

<?xml version="1.0" encoding="UTF-8"?>
<library> 
  <class name="myWindow" extends="window"
   title="ウインドウ" width="150" height="100">
    <button>ボタン</button>
  </class>
</library>

• ルート要素が<library>ではないXMLファイルをインクルードすることもできます。この場合、<include>タグを配置した場所にXMLファイルの中身が展開されます。
• ライブラリファイルと違い、何回でもインクルードできます。

ファイルの中身が単に置換されているイメージですね。

<?xml version="1.0" encoding="UTF-8"?>
<canvas proxied="false" bgcolor="0xeeeeee"> 
  <window width="150" height="200" layout="axis:y">
     <include href="myButton.lzx"/>
     <include href="myButton.lzx"/>
     <include href="myButton.lzx"/>
     <include href="myButton.lzx"/>
     <include href="myButton.lzx"/>
  </window>
</canvas>

myButton.lzx：

<button>ボタン！</button>

<include>タグのtype属性でtextを指定すると、テキストファイル(XMLファイルではなく単なる文字列のファイル)をインクルードできます。

ファイルの中身が置換されているイメージです。

<?xml version="1.0" encoding="UTF-8"?>
<canvas proxied="false" bgcolor="0xeeeeee"> 
  <window width="200" height="100" layout="axis:y">
     <text>
        <include href="myText.txt" type="text"/>
     </text>
     <button>
        <include href="myText.txt" type="text"/>
     </button>
  </window>
</canvas>

myText.txt：

こんにちは。コンニチハ。