面板(Panel)宏用于在页面中显示文本块,但是你可以对文本块像文本框一样定义格式。
提示:你可以使用在表格的单元格中和页面布局的块的列中使用面板宏。
下面是使用面板宏的示例:
我的标题
一个格式化后的内容面板。
使用面板宏
希望在页面中使用面板宏
- 打开你希望编辑 Confluence 页面,然后单击 编辑(Edit)按钮。页面的编辑模式将会被打开。
- 下一步,在编辑工具栏中单击宏浏览器图标。这时候宏浏览器将会在屏幕的中间打开。
- 在宏浏览器中,在窗口的右上角的对话框中输入你希望插入的宏的名称。当找到与你输入的宏名称接近的宏后将会在中间的面板上显示。单击需要的宏然后来查看可用进行配置的宏选项,在这里你可以对需要插入的宏设置相关参数,然后单击 插入(insert)来将需要的宏插入到页面中。
参数
宏参数的定义为,你可以使用这些参数在宏输出的内容和格式上进行定义。
Confluence 使用的存储格式或者 wikimarkup 格式中使用的参数和在宏浏览器中使用的标签是不同的,这些将会在下面在括号内容中列出(example
)。
参数 | 默认值 | 说明 |
---|
面板标题(Panel Title)
(title ) | none | 面板显示的标题。如果这个值指定的话,标题将会在自己的标题栏中显示。 |
边框样式(Border Style)
(borderStyle ) | solid | 边框的的样式。可以接受的值为: solid , dashed 和其他一些可用的 CSS 边框样式。 |
边框颜色(Border Colour)
(borderColor ) |
| 面板边框的颜色。颜色值可以用 HTML 的颜色名称指定或者 16 进制值。 |
边框宽度像素(Border Pixel Width )(Value Only)
(borderWidth ) |
| 边框的宽度(使用像素值)。 |
背景颜色(Background Colour)
(bgColor ) |
| 面板的背景颜色。颜色值可以用 HTML 的颜色名称指定或者 16 进制值。 |
背景标题颜色(Title Background Colour)
(titleBGColor ) |
| 面板标题栏的背景颜色。颜色值可以用 HTML 的颜色名称指定或者 16 进制值。 |
Title Text Colour
(titleColor ) |
| 面板中使用文本的颜色。颜色值可以用 HTML 的颜色名称指定或者 16 进制值。 |
代码示例
下面的代码是提供给希望进一步编辑 Confluence 页面的高级用户使用的。
宏名称: panel
宏内容:接受富文本。
存储格式示例
< ac:structured-macro ac:name = "panel" >
< ac:parameter ac:name = "bgColor" >#72bc72</ ac:parameter >
< ac:parameter ac:name = "titleBGColor" >#00a400</ ac:parameter >
< ac:parameter ac:name = "title" >My title</ ac:parameter >
< ac:parameter ac:name = "borderStyle" >dashed</ ac:parameter >
< ac:parameter ac:name = "borderColor" >blue</ ac:parameter >
< ac:parameter ac:name = "titleColor" >white</ ac:parameter >
< ac:rich-text-body >
< p >A formatted panel</ p >
</ ac:rich-text-body >
</ ac:structured-macro >
|
Wiki 标记格式示例
{panel:title=My title|borderStyle=dashed|borderColor=blue|titleBGColor=#00a400|titleColor=white|bgColor=#72bc72}
A formatted panel
{panel}
|