附件标签使用说明

本文说明了附件标签的语法、用途和使用情境。

<$rowno$>
<$res_id$>
<$res_title$>
<$res_url$>
<$res_size$>
<$res_content$>
<$res_suffix$>
<$res_creator$>
<$res_creatorcn$>
<$res_createdate$>
<$res_index$>

<$res_id$>

附件唯一标识号。

<$rowno$>

行号，为整数。

<$res_title(wordcount:int,append:String)$>

参数名	类型	含义
wordcount	int	可选。指明取的字数。中文算1个字符。
append	String	可选。超出wordcount个字符后，自动在后面追加append串。

附件的标题名称。
<$res_title$>：返回附件的全名。
<$res_title(50)$>：附件名称中50以上的将被截断，仅返回附件名称中的前50个字符。等同于<$res_title(50,"")$>
<$res_title(50,"...")$>：返回附件名称中前50个字符，超出部分追加...

<$res_suffix$>

文件名后缀，小写。例如.jpg

<$res_creator$>

创建人ID号

<$res_creatorcn$>

创建人姓名

<$res_createdate$>

创建时间

<$res_content$>

附件备注说明

<$res_size(format:String)$>

文件长度。

参数名	类型	含义
format	String	B、BYTE：以Byte为单位返回字符串，例如1,024,102Byte K、KB：以K为单位返回字符串，例如1,024KB M、MB：以M为单位返回字符串，例如1.20MB G、GB：以G为单位返回字符串，例如0.50GB H、Human-readable:按最适合读者阅读模式自动转换。以上Format均不区分大小写。其他格式化串，是指对byte为计算单位的值进行格式化。参看下面的NumberFormat说明。

例如，文件长度为1,264,128Byte，那么：
<$res_size$>:返回1264128，为数字；
<$res_size("KB")$>:返回1,234.5KB；
<$res_size("MB")$>:返回1.21MB；
<$res_size("h")$>:返回1.21MB

NumberFormat说明：

符号	位置	含义
`0`	数字	阿拉伯数字
`#`	数字	阿拉伯数字，如果不存在则显示为 0
`.`	数字	小数分隔符或货币小数分隔符
`-`	数字	减号
`,`	数字	分组分隔符
`E`	数字	分隔科学计数法中的尾数和指数。在前缀或后缀中无需加引号。
`;`	子模式边界	分隔正数和负数子模式
`%`	前缀或后缀	乘以 100 并显示为百分数
`\u2030`	前缀或后缀	乘以 1000 并显示为千分数
`¤` (`\u00A4`)	前缀或后缀	货币记号，由货币符号替换。如果两个同时出现，则用国际货币符号替换。如果出现在某个模式中，则使用货币小数分隔符，而不使用小数分隔符。
`'`	前缀或后缀	用于在前缀或或后缀中为特殊字符加引号，例如 `"'#'#"` 将 123 格式化为 `"#123"`。要创建单引号本身，请连续使用两个单引号：`"# o''clock"`。

<$res_url$>

附件URL访问绝对路径。

<$res_url("width:int,height:int")$>

参数名	类型	含义
width	int	-1或不是数字类型的取值，width将被设置为自动缩放。
height	int	-1或不是数字类型的取值，height将被设置为自动缩放。

只有对JPG、BMP、GIF、TIF格式图片文件有效。否则width、height参数将同时被忽略。

系统将按width和height的要求自动缩放图片，并返回该图片的URL访问路径。
<$res_url("100,200")$>：将生成width=100,height=200的新图片并返回该图片的URL路径。

<$res_url(width:int,height:int)$>

参数名	类型	含义
width	int	-1或不是数字类型的取值，width将被设置为自动缩放。
height	int	-1或不是数字类型的取值，height将被设置为自动缩放。

只有对JPG、BMP、GIF、TIF格式图片文件有效。否则width、height参数将同时被忽略。

系统将按width和height的要求自动缩放图片，并返回该图片的URL访问路径。
<$res_url(100,200)$>：将生成width=100,height=200的新图片并返回该图片的URL路径。
<$res_url(100,-1)$>：将生成width=100自动缩放图片并返回新图片的URL路径。

<$res_index$>

附件顺序号，为整数。