Version 25.3.9411

• パラメータ
• アトリビュートの制御
• 例
• 関連項目

api:render キーワードを使用して、テンプレートをレンダリングします。

パラメータ

• template：評価する.rst ファイル。
• templateData：評価するインメモリテンプレート。
• in[put]：テンプレートに渡すアイテムのカンマ区切りリスト。
• out[put]：結果のアイテムまたはフィード。
• to：結果を追加するアトリビュート。api:render 構文を複数行のapi:set でラップすることで、結果を保存することもできます。
• onerror：テンプレートでエラーが発生した際に実行するアクション。例外がない場合にのみテンプレートを呼び出してレンダリングするには、onerror をclear に設定します。

アトリビュートの制御

None

例

メインテンプレートが残りの内容をレンダリングできるように例外をキャッチします：

<table border="1">
  <tr>
  <td>
    <api:render template="error.rst">
      <api:catch code="*">
        <a name="caught">
        A problem was encountered with the template
        </a>
      </api:catch>
    </api:render>
    <!-- Ensure that tags are closed -->
  </td>
  </tr>
</table>

インメモリテンプレートをレンダリングします：

<api:setc attr="a.t" value="this is [name]."/>
<api:set attr="i.name" value="a test" />
<api:set item="r" />
<api:render templateData="[a.t]" in="i" to="r.text" />
[r.text]

関連項目

• api:catch：APIScript で例外を処理する。
• api:finally：フォーマッティングが完了していることを確認する。