5章 テンプレート

3. 文書型の定義

コンテンツ制作者の入力項目となる部分を定義するのが文書型の定義です。各テンプレートは、それぞれの文書型定義をひとつだけ持っています。WebRelease はこの文書型定義からページ編集画面（コンテンツ入力フォーム）を自動生成します。

テンプレートの「展開」の中からは、この文書型の定義に従ってコンテンツとして入力されたデータにアクセスし、それを html などに整形します。

テンプレートの文書型の定義は、テンプレート編集画面の「要素」タブで行います。

要素を追加するには、画面右上の「追加」ボタンをクリックします。新たに要素を追加すると「名称未設定」という名前で「１行テキスト」型の要素が作成されますので、要素名、型（種類）などを設定変更して目的の要素を作成します。

要素の順序（位置）を変更する場合は、ポップアップで位置を指定してから「保存」ボタンをクリックします。要素の順序は、ページ作成時の入力フォーム（ページ編集画面）の項目の順序となります。ページ作成時に入力しやすい順序になるように要素を並べると良いでしょう。

不要になった要素は、その要素が選択されている状態で画面右上の「削除」ボタンをクリックすることで削除できます。

この例では、文書型として「productInfo」をグループ項目で作り、その下に子要素「name」「pictures」「description」を作っています。 この文書定義は下記の手順で作成できます。

• テンプレート作成直後には「名称未設定」という名前の「１行テキスト」要素が作成されています。まず、この要素を選びます。（左サイドバー内で要素名をクリックするとその要素を選ぶことができます。選ばれている要素には青丸マークが付きます） 要素名を「productInfo」に変更します。また、要素のタイプを「グループ項目」に変更します。
• 要素の型を「グループ項目」に変更すると「名称未設定」という名前の「子要素」が作成され、それが選択された状態になります。その子要素の名称を「name」に変更して「保存」ボタンをクリックします。
• 「追加」ボタンをクリックして「name」の次に新しい要素を作ります。その要素の名前を「pictures」に変更します。また、要素のタイプを「イメージ」に変更します。
• 「追加」ボタンをクリックして「pictures」の次に新しい要素を作ります。その要素の名前を「description」に変更します。また、要素のタイプを「複数行テキスト」に変更します。

要素の名前

テンプレートの要素には名前をつけることができます。要素の名前は展開の中で要素を参照する時に使用します。また、ページを作成するときに要素の値を入力するフォームで使用されます。フォームにデータを入力するときに、入力すべき内容がよくわかるように要素の名前を付けてください。

要素の名前はテンプレート内でユニークになるように付けてください。ひとつのテンプレートに同じ名前の要素がふたつ以上あると、展開のなかで要素を指定することができなくなります。

要素名に使用できる名前には制限があります。下記を参照してください。

入力フィールド名（日本語）／（英語）

要素には入力フィールド名をつけることができます。 入力フィールド名が指定されている場合、ページ作成時の入力フォームでは要素名に代わって入力フィールド名が表示されます。入力フィールド名は展開の中では使用することはできません。

入力フィールド名を活用することで、要素の名前には展開内でのコーディングがしやすい英字名を付けておき、また、入力フィールド名には入力するスタッフにわかりやすい日本語名前を付ける、ということが可能になります。

入力フィールド名を変更してもテンプレートの展開を修正する必要がないので、入力画面側のニーズに合わせて入力フィールド名はいつでも変更することができます。

入力フィールド名にはどんな名前でも付けることができます。

入力フィールド名には英語名もつけることができます。ブラウザの言語設定が日本語以外に設定されている状況で入力フィールド名が表示される場合は、英語名の入力フィールド名が表示に使用されます。