Axure 9高级教程:Axure函数使用手册
一、函数使用方法
Axure函数使用的基本语法是:用”[[ ]]”双方括号(即英文双中括号)包含,变量值和函数用英文句号(即点”. ”)连接。
例如:[[LVAR. Width]] 表示变量LVAR的宽度
[[This. Width]] 当前元件的宽度
二、 函数分类
根据Axure函数的应用范围,可划分为以下10类:元件函数、页面函数、窗口函数、鼠标指针函数、数字函数、字符串函数、数学函数、日期函数、中继器函数和布尔运算符(逻辑运算)。
三、函数使用说明
3.1 元件函数
This:获取当前元件对象,当前元件指添加事件的元件。
Target:获取目标元件对象,目标元件指添加动作的元件。
x:获取元件对象的X轴坐标值。
y:获取元件对象Y轴坐标值。
width:获取元件对象的宽度值。
height:获取元件对象的高度值。
scrollX:获取元件对象水平移动的距离。
scrollY:获取元件对象垂直移动的距离。
text:获取元件对象的文字。
name:获取元件对象的名称。
top:获取元件对象顶部边界的坐标值。
left:获取元件对象左边界的坐标值。
right:获取元件对象右边界的坐标值。
bottom:获取元件对象底部边界的坐标值。
opacity:获取元件对象的不透明度。
rotation:获取元件对象的旋转角度。
3.2 页面函数
PageName:获取当前页面的名称。
3.3 窗口函数
Windows.width:获取浏览器的当前宽度。
Windows.height:获取浏览器的当前高度。
Windows.scrollX:获取浏览器的水平滚动距离。
Windows.scrollY:获取浏览器的垂直滚动距离。
3.4 鼠标指针函数
Cursor.x:获取鼠标当前位置的X轴坐标。
Cursor.Y:获取鼠标当前位置的Y轴坐标。
DragX:获取鼠标在水平方向的移动速度(0.01秒内移动的距离)。
DragY:获取鼠标在垂直方向的移动速度(0.01秒内移动的距离)。
TotalDragX:整个拖动过程中,鼠标指针在水平方向上移动的距离。
TotalDragY:整个拖动过程中,鼠标指针在垂直方向上移动的距离。
DragTime:鼠标拖动操作的总时长。从鼠标按下左键到释放左键的总时长,中间过程中,如果未移动鼠标位置,也计算时长。
3.5 数字函数
toExponential(decimalPoints):将对象的值转换为指数计数法。decimalPoints为小数点后保留的小数位数。
toFixed(decimalPoints):将一个数字转换为保留指定小数位数的数字,超出的后面小数位将自动进行四舍五入。decimalPoints为小数点后保留的小数位数。
toPrecision(length):将数字格式化为指定的长度,小数点不计算长度,length为指定的长度。
3.6 字符串函数
length:获取当前文本对象的长度,即字符长度,1个汉字的长度按1计算。
charAt(index):获取当前文本对象指定位置的字符,index为大于等于0的整数,字符位置从0开始计数,0为第一位。
charCodeAt(index):获取当前文本对象中指定位置字符的Unicode编码(中文编码段19968 ~ 40622);字符起始位置从0开始。 index为大于等于0的整数。
concat('string'):将当前文本对象与另外一个字符串组合,string为组合后显示在后方的字符串。如:[[ABC.concat('123')]],返回值是ABC123(注意表达式中别漏了中间那个点“.”)
indexOf('searchValue',start):从左至右查询字符串在当前文本对象中首次出现的位置。未查询到,返回值为-1。参数:searchValue为查询的字符串;start为查询的起始位置,官方虽未明说,但经测试是可用的。官方默认没有start,则是从文本的最左侧开始查询。
lastIndexOf('searchvalue,start'):从右至左查询字符串在当前文本对象中首次出现的位置。未查询到,返回值为-1。参数:searchValue为查询的字符串;start为查询的起始位置,官方虽未明说,但经测试是可用的。官方默认没有start,则是从文本的最右侧开始查询。
replace('searchvalue','newvalue'):用新的字符串替换文本对象中指定的字符串。参数:newvalue为新的字符串,searchvalue为被替换的字符串。
slice(start,end):从当前文本对象中截取从指定位置开始到指定位置结束之间的字符串。参数:start为截取部分的起始位置,该数值可为负数。负数代表从文本对象的尾部开始,-1表示末位。-2表示倒数第二位。end为截取部分的结束位置,可省略,省略则表示从截取开始位置至文本对象的末位。这里提取的字符串不包含结束位置。
split('separator',limit):将当前文本对象中与分隔字符相同的字符转为“,”,形成多组字符串,并返回从左开始的指定组数。 参数:separator为分隔字符,分隔字符可以为空,为空时将分隔每个字符为一组;limit为返回组数的数值,该参数可以省略,省略该参数则返回所有字符串组。
substr(start,length):当前文本对象中从指定起始位置截取一定长度的字符串。参数:start为截取的起始位置,length为截取的长度,该参数可以省略,省略则表示从起始位置一直截取到文本对象末尾。
substring(from,to):从当前文本对象中截取从指定位置开始到另一指定位置区间的字符串。参数:from为指定区间的起始位置,to为指定区间的结束位置,该参数可以省略,省略则表示从起始位置截取到文本对象的末尾。这里提取的字符串不包含末位。
toLowerCase( ):将文本对象中所有的大写字母转换为小写字母。
toUpperCase( ):将文本对象中所有的小写字母转换为大写字母。
trim( ):删除文本对象两端的空格
toString( ):将一个逻辑值转换为字符串。
3.7 数学函数
+ 数的和 语法:[[LVAR1+LVAR2]]
- 数的差 语法:[[LVAR1-LVAR2]]
* 数的乘积 语法:[[LVAR1*LVAR2]]
/ 数的商 语法:[[LVAR1+LVAR2]]
% 数的余数 语法:[[LVAR1%LVAR2]]
Math.abs(x) :计算参数值的绝对值。参数:x为数值。
Math.acos(x) :获取一个数值的反余弦弧度值,其范围是 0~ pi 。 参数:x为数值,范围在 -1~1 之间。
Math.asin(x) :获取一个数值的反正弦值。 参数:x为数值,范围在 -1~1 之间。
Math.atan(x) :获取一个数值的反正切值。参数:x为数值。
Math.atan2(y,x) :获取某一点(x,y)的角度值。 参数:“x,y”为点的坐标数值。返回-PI到PI之间的值,是从x轴正向逆时针旋转到点(x,y)经过的角度。
Math.ceil(x) :向上取整函数,获取大于或者等于指定数值的最小整数。 参数:x为数值。
Math.cos(x) :获取一个数值的余弦函数。。返回-1.0到1.0之间的数。参数:x为弧度数值。
Math.exp(x) :获取一个数值的指数函数,计算以e为底的指数。 参数:x为数值。返回 e 的 x 次幂。e 代表自然对数的底数,其值近似为2.71828。如:exp(1),输出:2.718281828459045。
Math.floor(x):向下取整函数,获取小于或者等于指定数值的最大整数。 参数:x为数值。
Math.log(x) :对数函数,计算以e为底的对数值。 参数:x为数值。
Math.max(x,y) :获取参数中的最大值。 参数:“x,y”表示多个数值,不一定为2个数值。
Math.min(x,y) :获取参数中的最小值。 参数:“x,y”表示多个数值,不一定为2个数值。
Math.pow(x,y) :幂函数,计算x的y次幂。 参数:x为底数,x为大于等于0的数字;y为指数,y为整数,不能为小数。
Math.random( ) :随机数函数,返回一个0~1之间的随机数。 示例:获取10-15之间的随机小数,计算公式为Math.random( )*5+10。
Math.sin(x) :正弦函数。 参数:x为弧度数值。
Math.sqrt(x) :平方根函数。 参数:x为数值。
Math.tan(x) :正切函数。 参数:x为弧度数值。
3.8 日期函数
Now :获取当前计算机系统日期对象。
GenDate :获取原型生成日期对象。
getDate( ) :获取日期对象“日期”部分数值(1 ~ 31)。
getDay( ) :获取日期对象“星期”部分的数值(0 ~ 6)。
getDayOfWeek( ) :获取日期对象“星期”部分的英文名称。
getFullYear( ) :获取日期对象“年份”部分四位数值。
getHours( ) :获取日期对象“小时”部分数值(0 ~ 23)。
getMilliseconds( ) :获取日期对象的毫秒数(0 ~ 999)。
getMinutes( ) :获取日期对象“分钟”部分数值(0 ~59)。
getMonth( ) :获取日期对象“月份”部分的数值(1 ~ 12)。
getMonthName( ) :获取日期对象“月份”部分的英文名称。
getSeconds( ) :获取日期对象“秒数”部分数值(0 ~59)。
getTime( ) :获取当前日期对象中的时间值。该时间值表示从1970年1月1日00:00:00开始,到当前日期对象时,所经过的毫秒数,以格林威治时间为准。
getTimezoneOffset( ) :获取世界标准时间(UTC)与当前主机时间之间的分钟差值。
getUTCDate( ) :使用世界标准时间获取当前日期对象“日期”部分数值(1 ~ 31)。
getUTCDay( ) :使用世界标准时间获取当前日期对象“星期”部分的数值(0 ~ 6)。
getUTCFullYear( ) :使用世界标准时间获取当前日期对象“年份”部分四位数值。
getUTCHours( ) :使用世界标准时间获取当前日期对象“小时”部分数值(0 ~ 23)
getUTCMilliseconds( ) :使用世界标准时间获取当前日期对象的毫秒数(0 ~ 999)。
getUTCMinutes( ) :使用世界标准时间获取当前日期对象“分钟”部分数值(0 ~59)。
getUTCMonth( ) :使用世界标准时间获取当前日期对象“月份”部分的数值(1 ~ 12)。
getUTCSeconds( ) :使用世界标准时间获取当前日期对象“秒数”部分数值(0 ~59)。
Date.parse(datestring) :用于分析一个包含日期的字符串,并返回该日期与1970年1月1日00:00:00之间相差的毫秒数 参数:datestring为日期格式的字符串,格式为:yyyy/mm/dd hh:mm:ss。
toDateString( ) :以字符串的形式获取一个日期。
toISOString( ) :获取当前日期对象的IOS格式的日期字串,格式:YYYY-MM-DDTHH:mm:ss.sssZ。
toJSON( ) :获取当前日期对象的JSON格式的日期字串,格式: YYYY-MM-DDTHH:mm:ss.sssZ。
toLocaleDateString( ) 以字符串的形式获取本地化当前日期对象。并且只包含“年月日”部分的短日期信息。
toLocaleTimeString( ):以字符串的形式获取本地化当前日期对象。并且只包含“时分秒”部分的短日期信息。
toUTCString( ) :以字符串的形式获取相对于当前日期对象的世界标准时间。
Date.UTC(year,month,day,hour,min,sec,millisec) :获取相对于1970 年 1 月 1 日 00:00:00的世界标准时间,与指定日期对象之间相差的毫秒数。 参数:组成指定日期对象的年、月、日、时、分、秒以及毫秒的数值。
valueOf( ) :获取当前日期对象的原始值。
addYears(years) :将指定的年份数加到当前日期对象上,获取一个新的日期对象。 参数:years为整数数值,正负均可。
addMonths(months) :将指定的月份数加到当前日期对象上,获取一个新的日期对象。 参数:months为整数数值,正负均可。
addDays(days) :将指定的天数加到当前日期对象上,获取一个新的日期对象。 参数:days为整数数值,正负均可。
addHours(hours) :将指定的小时数加到当前日期对象上,获取一个新的日期对象。 参数:hours为整数数值,正负均可。
addMinutes(minutes) :将指定的分钟数加到当前日期对象上,获取一个新的日期对象。 参数:minutes为整数数值,正负均可。
addSeconds(seconds) :将指定的秒数加到当前日期对象上,获取一个新的日期对象。 参数:seconds为整数数值,正负均可。
addMilliseconds(ms) :将指定的毫秒数加到当前日期对象上,获取一个新的日期对象。 参数:ms为整数数值,正负均可。
Year :获取系统日期对象“年份”部分的四位数值。
Month :获取系统日期对象“月份”部分数值(1 ~ 12)。
Day :获取系统日期对象“日期”部分数值(1 ~ 31)。
Hours :获取系统日期对象“小时”部分数值(0 ~ 23)。
Minutes :获取系统日期对象“分钟”部分数值(0 ~ 59)。
Seconds :获取系统日期对象“秒数”部分数值(0 ~ 59)。
3.9 中继器函数
Repeater :中继器的对象。Item.Repeater即为Item所在的中继器对象。
visibleItemCount :中继器项目列表中可见项的数量。比如:项目列表共有23项,分页显示为每页7项。当项目列表在第1、2、3页时,可见项数量为7;当项目列表在第4页时,可见项数量为2。(即:前面每页都是7项,最后一页只有2项)
itemCount :获取中继器项目列表的总数量,或者叫加载项数量。默认情况下项目列表的总数量会与中继器数据集中的数据行数量一致,但是,如果进行了筛选,项目列表的总数量则是筛选后的数量,这个数量与分页无关。
dataCount :获取中继器数据集中数据行的总数量。
pageCount :获取中继器分页的总数量,即能够获取分页后共有多少页。
pageIndex :获取中继器项目列表当前显示内容的页码。
Item :获取数据集一行数据的集合,即数据行的对象。
TargetItem :目标数据行的对象。
Item.列名:获取数据行中指定列的值。
index:获取数据行的索引编号,编号起始为1,由上至下每行递增1。
isFirst :判断数据行是否为第1行;如果是第1行,返回值为“True”,否则为“False”。
isLast:判断数据行是否为最末行;如果是最末行,返回值为“True”,否则为“False”。
isEven:判断数据行是否为偶数行;如果是偶数行,返回值为“True”,否则为“False”。
isOdd:判断数据行是否为奇数行;如果是奇数行,返回值为“True”,否则为“False”。
isMarked:判断数据行是否为被标记;如果被标记,返回值为“True”,否则为“False”。
isVisible:判断数据行是否为可见行;如果是可见行,返回值为“True”,否则为“False”。
3.10 布尔运算符
== 等于
!= 不等于
< 小于
<= 小于等于
> 大于
>= 大于等于
&& 并且
|| 或者
【原型演示介绍函数说明案例】
http://cloud.axureshop.com/r1kvtv