javascript - Confluence 插件在哪里定义 HTML 代码

Question

我是 Confluence Add-Ons 开发的新手。我想使用 API 中的示例。例如看这个页面Dialog 2 ，HTML-Code 和 JS-Code 是分开的。

我知道如何定义 JS 文件以及如何引用 atlassian-plugin.xml。

看这里

<web-resource key="Confluence-resources" name="Confluence-Web-Resources">
    <dependency>com.atlassian.auiplugin:ajs</dependency>
    <resource type="download" name="confluence.js" location="/js/confluence.js"/>

  </web-resource>

但是我必须在哪里定义 HTML 代码？

Answer 1

本质上，您需要通过 Macro 类中的 execute 方法呈现 HTML。但是，实际上，有一些“Atlassian 批准的”方法。

您可能需要考虑 VelocityUtils.getRenderedTemplate 方法的内置 Velocity 模板支持。

引用Atlassian's Documentation ，你可能可以这样写:

public String execute(Map params, String body, RenderContext renderContext) throws MacroException {
    // do something with params ...

    Map context = MacroUtils.defaultVelocityContext();
    context.put("page", page);
    context.put("labels", labels);
    return VelocityUtils.getRenderedTemplate("com/atlassian/confluence/example/sample-velocity.vm", context);
}

近年来，他们也开始推广使用Soy Template。