页面树结构
Skip to end of metadata
Go to start of metadata

要在制定的页面中显示所有的附件,请参考页面 在页面中显示附件列表 页面中的详细内容。

代码示例:

下面的代码是提供给希望进一步编辑 Confluence 页面的高级用户使用的。

宏名称:attachments

宏内容:None

参数名称

是否是必须的

默认值

参数说明和可以接受的值

参数名称

是否是必须的

默认值

参数说明和可以接受的值

oldNofalse

可用的值:

  • false - 为每一个附件仅显示最新版本。
  • true – 为每一个附件显示所有的版本,包括前期的老版本。
patternsNo(None)

一个正则表达式的逗号分割符用来用附件名过滤附件。请注意,使用的参数必须是正则表达式。

例如:

  • 如果希望找到文件的后缀名为 'jpg' 的文件,使用 .*jpg (而不是 *.jpg)。
  • 如果希望找到文件名以 'jpg' 或者 'png' 结尾,使用.*jpg.*png。


sortByNodate

可用的值

  • date
  • size
  • name
pageNo宏需要引用的页面。被用来显示附件列表的其他页面的名称。换句话说是你希望显示其他页面中的附件列表。
sortOrderNo

默认的排序使用 sortBy 类型进行排序的方式:

  • 'date' 按照年份的倒序排序。
  • 'size' 从最大到最小排序
  • 'name' 按照字母顺序排序

可用的值:

  • ascending
  • descending
labelsNo(None)

一个使用逗号分隔符的页面标签列表。Confluence 将会对有指定标签页面包含的附件显示出来。

如果有多个标签的话,对标签进行合并的方式是 AND 不是 OR,意识是如果有 2 个标签,那么页面必须要同时都有这 2 个标签。

uploadNofalse决定的附件清单是否包括,允许用户浏览,并附加新的文件的选项。

存储格式示例

<ac:structured-macro ac:name="attachments">
  <ac:parameter ac:name="old">false</ac:parameter>
  <ac:parameter ac:name="patterns">.*png,.*jpg</ac:parameter>
  <ac:parameter ac:name="sortBy">name</ac:parameter>
  <ac:parameter ac:name="page">
    <ac:link>
      <ri:page ri:content-title="My page about chocolate"/>
    </ac:link>
  </ac:parameter>
  <ac:parameter ac:name="sortOrder">descending</ac:parameter>
  <ac:parameter ac:name="labels">chocolate,cookies</ac:parameter>
  <ac:parameter ac:name="upload">false</ac:parameter>
</ac:structured-macro>

Wiki 标记示例

{attachments:old=false|patterns=.*png,.*jpg|sortby=name|page=My page about chocolate|sortorder=descending|labels=chocolate,cookies|upload=false}


  • 无标签