Axure RP 函数参考手册

文档概述

本参考文档包含Axure RP中所有可用的函数、运算符和变量。这些函数可以在原型设计中用于实现动态交互、数据处理和条件逻辑。 您可以使用左侧导航快速跳转到不同类别的函数,或使用顶部搜索框查找特定函数。

使用方法

在交互面板中,选择条件、设置值等动作时,点击「fx」按钮,在弹出的编辑对话框中输入函数。

函数语法

所有函数都需要使用双中括号包裹,例如:[[functionName()]]

复制代码

点击每个函数卡片右上角的复制按钮,即可快速复制函数代码。

中继器/数据集

中继器和数据集函数用于操作表格数据,实现数据的添加、删除、筛选和排序等功能。

Repeater

中继器

中继器的对象。Item.Repeater即为Item所在的中继器对象。

[[Item.Repeater]]

visibleItemCount

中继器

中继器项目列表中可见项的数量。比如:项目列表共有15项,分页显示为每页6项。当项目列表在第1、2页时,可见项数量为6;当项目列表在第3页时,可见项数量为3。

[[visibleItemCount]]

itemCount

中继器

获取中继器项目列表的总数量,或者叫加载项数量。默认情况下项目列表的总数量会与中继器数据集中的数据行数量一致,但是,如果进行了筛选,项目列表的总数量则是筛选后的数量,这个数量不受分页影响。

[[itemCount]]

dataCount

中继器

获取中继器数据集中数据行的总数量。

[[dataCount]]

pageCount

中继器

获取中继器分页的总数量,即能够获取分页后共有多少页。

[[pageCount]]

pageIndex

中继器

获取中继器项目列表当前显示内容的页码。

[[pageIndex]]

Item

中继器

获取数据集一行数据的集合,即数据行的对象。

[[Item]]

TargetItem

中继器

目标数据行的对象。

[[TargetItem]]

Item.列名

中继器

获取数据行中指定列的值。

[[Item.列名]]

index

中继器

获取数据行的索引编号,编号起始为1,由上至下每行递增1。

[[index]]

isFirst

中继器

判断数据行是否为第1行;如果是第1行,返回值为"True",否则为"False"。

[[isFirst]]

isLast

中继器

判断数据行是否为最末行;如果是最末行,返回值为"True",否则为"False"。

[[isLast]]

isEven

中继器

判断数据行是否为偶数行;如果是偶数行,返回值为"True",否则为"False"。

[[isEven]]

isOdd

中继器

判断数据行是否为奇数行;如果是奇数行,返回值为"True",否则为"False"。

[[isOdd]]

isMarked

中继器

判断数据行是否为被标记;如果被标记,返回值为"True",否则为"False"。

[[isMarked]]

isVisible

中继器

判断数据行是否为可见行;如果是可见行,返回值为"True",否则为"False"。

[[isVisible]]

全局变量

全局变量在整个原型中都可以访问和修改,用于存储需要在不同页面间共享的数据。

OnLoadVariable

全局

默认名称

[[OnLoadVariable]]

元件属性

元件属性函数用于获取和设置各种UI元件的属性,如文本内容、选中状态、可见性等。

this

元件

获取当前元件对象。当前元件是指当前添加交互动作的元件。

[[this]]

target

元件

获取目标元件对象。目标元件是指当前交互动作控制的元件。

[[target]]

x

元件

获取元件对象的X轴坐标值。

[[Lvar.x]]

y

元件

获取元件对象的Y轴坐标值。

[[Lvar.y]]

width

元件

获取元件对象的宽度值。

[[Lvar.width]]

height

元件

获取元件对象的高度值。

[[Lvar.height]]

scrollX

元件

获取元件对象的水平滚动距离(当前仅限动态面板)。

[[Lvar.scrollX]]

scrollY

元件

获取元件对象的垂直滚动距离(当前仅限动态面板)。

[[Lvar.scrollY]]

text

元件

获取元件对象的文本文字。

[[Lvar.text]]

name

元件

获取元件对象的自定义名称。

[[Lvar.name]]

top

元件

获取元件对象的上边界坐标值。

[[Lvar.top]]

left

元件

获取元件对象的左边界坐标值。

[[Lvar.left]]

right

元件

获取元件对象的右边界坐标值。

[[Lvar.right]]

bottom

元件

获取元件对象的下边界坐标值。

[[Lvar.bottom]]

opacity

元件

获取元件对象的不透明比例。

[[Lvar.opacity]]

rotation

元件

获取元件对象的旋转角度。

[[Lvar.rotation]]

页面属性

页面属性函数用于获取当前页面的相关信息,如页面名称、URL参数等。

pagename

页面

返回页面的名称,即我们在站点地图面板里面为所有页面所做的命名

[[PageName]]

窗口属性

窗口属性函数用于获取浏览器窗口的信息,如尺寸、滚动位置等。

Windows.width

窗口

打开原型页面的浏览器当前宽度。

[[Window.width]]

Windows.height

窗口

打开原型页面的浏览器当前高度。

[[Window.height]]

Windows.scrollX

窗口

浏览器中页面水平滚动的距离。

[[Window.ScrollX]]

Windows.scrollY

窗口

浏览器中页面垂直滚动的距离。

[[Window.ScrollY]]

鼠标属性

鼠标属性函数用于获取鼠标的位置信息和拖动数据,常用于交互效果的实现。

Cursor.x

鼠标

鼠标指针在页面中位置的X轴坐标。

[[Cursor.X]]

Cursor.y

鼠标

鼠标指针在页面中位置的Y轴坐标。

[[Cursor.Y]]

DragX

鼠标

鼠标指针沿X轴拖动元件时的瞬间(0.01秒)拖动距离。

[[DragX]]

DragY

鼠标

鼠标指针沿Y轴拖动元件时的瞬间(0.01秒)拖动距离。

[[DragY]]

TotalDragX

鼠标

鼠标指针拖动元件从开始到结束的X轴移动距离。

[[TotalDragX]]

TotalDragY

鼠标

鼠标指针拖动元件从开始到结束的Y轴移动距离。

[[TotalDragY]]

DragTime

鼠标

鼠标指针拖动元件从开始到结束的总时长。

[[DragTime]]

数字函数

数字函数用于处理数值类型的数据,提供格式化、精度控制等功能。

toExponential(decimalPoints)

数字

把对象的值转换为指数计数法。参数:decimalPoints为保留小数的位数。

[[n.toExponential(参数)]]

toFixed(decimalPoints)

数字

将一个数字转为保留指定位数的小数,小数位数超出指定位数时进行四舍五入。参数:decimalPoints为保留小数的位数。

[[n.toFixed(2)]]

toPrecision(length)

数字

把数字示例化为指定的长度。参数:length为示例化后的数字长度,小数点不计入长度。

[[n.toPrecision(6)]]

字符串函数

字符串函数用于处理文本数据,提供查找、替换、拼接等文本操作功能。

length

字符串

获取当前文本对象的长度,即字符个数,1个汉字的长度按1计算。

[[Lvar.length]]

charAt(index)

字符串

获取当前文本对象中指定位置的字符;参数:index为大于等于0的整数。

[[Lvar.charAt(1)]]

charCodeAt(index)

字符串

获取当前文本对象中指定位置字符的Unicode编码(中文编码段19968 ~ 40622),字符起始位置从0开始。参数:index为大于等于0的整数。

[[Lvar.charCodeAt(1)]]

concat('string')

字符串

将当前文本对象与另一个字符串组合。参数:string为组合在后方的字符串。

[[Lvar.concat('string')]]

indexOf('searchValue',start)

字符串

从左至右获取查询字符串在当前文本对象中首次出现的位置。未查询到时返回值为-1。参数:searchValue为查询的字符串;start为查询的起始位置。

[[Lvar.indexOf('searchValue',start)]]

lastIndexOf('searchvalue',start)

字符串

从右至左获取查询字符串在当前文本对象中首次出现的位置。未查询到时返回值为-1。参数:searchValue为查询的字符串;start为查询的起始位置。

[[Lvar.lastIndexOf('searchvalue',start)]]

replace('searchvalue','newvalue')

字符串

用新的字符串替换当前文本对象中指定的字符串。参数:searchvalue为被替换的字符串;newvalue为新文本对象或字符串。

[[Lvar.replace('searchvalue','newvalue')]]

slice(start,end)

字符串

从当前文本对象中截取从指定起始位置开始到终止位置之前的字符串。参数:start为被截取部分的起始位置,该数值可为负数;end为被截取部分的终止位置,该数值可为负数。

[[Lvar.slice(start,end)]]

split('separator',limit)

字符串

将当前文本对象中与分隔字符相同的字符转为",",形成多组字符串,并返回从左开始的指定组数。参数:separator为分隔字符,分隔字符可以为空,为空时将分隔每个字符为一组;limit为返回组数的数值。

[[Lvar.split('separator',limit)]]

substr(start,length)

字符串

从当前文本对象中指定起始位置开始截取一定长度的字符串。参数:start为被截取部分的起始位置;length为被截取部分的长度。

[[Lvar.substr(start,length)]]

substring(from,to)

字符串

从当前文本对象中截取从指定位置到另一指定位置区间的字符串。右侧位置不截取。参数:from为指定区间的起始位置;to为指定区间的终止位置。

[[Lvar.substring(from,to)]]

toLowerCase()

字符串

将文本对象中所有的大写字母转换为小写字母。

[[Lvar.toLowerCase()]]

toUpperCase()

字符串

将当前文本对象中所有的小写字母转换为大写字母。

[[Lvar.toUpperCase()]]

trim()

字符串

去除当前文本对象两端的空格。

[[Lvar.trim()]]

toString()

字符串

将一个逻辑值转换为字符串。

[[Lvar.toString()]]

数学函数

提供各种数学运算功能,包括基本算术、三角函数、对数函数、随机数生成等,用于处理数值型数据。

+

数学

加法运算

[[Lvar1+Lvar2]]

-

数学

减法运算

[[Lvar1-Lvar2]]

*

数学

乘法运算

[[Lvar1*Lvar2]]

/

数学

除法运算

[[Lvar1/Lvar2]]

%

数学

百分比

[[Lvar%100]]

abs(x)

数学

计算参数数值的绝对值。参数:x为数值,范围在 -1~1 之间。

[[Math.Abs(-1)]]

acos(x)

数学

获取一个数值的反余弦弧度值,其范围是 0~ pi 。参数:x为数值,范围在 -1~1 之间。

[[Math.Acos(0.5)]]

asin(x)

数学

获取一个数值的反正弦弧度值,其范围是 -pi/2~ pi/2 。参数:x为数值,范围在 -1~1 之间。

[[Math.Asin(0.5)]]

atan(x)

数学

获取一个数值的反正切弧度值,其范围是 -pi/2~ pi/2 。参数:x为数值。

[[Math.Atan(1)]]

atan2(y,x)

数学

获取Y/X的反正切值。参数:y为Y坐标;x为X坐标。

[[Math.Atan2(1,1)]]

ceil(x)

数学

获取大于等于参数值的最小整数。参数:x为数值。

[[Math.Ceil(1.2)]]

cos(x)

数学

获取参数值的余弦值。参数:x为弧度值。

[[Math.Cos(0)]]

exp(x)

数学

获取以自然对数e为底、以参数值为指数的幂。参数:x为数值。

[[Math.Exp(1)]]

floor(x)

数学

获取小于等于参数值的最大整数。参数:x为数值。

[[Math.Floor(1.8)]]

log(x)

数学

获取参数值的自然对数。参数:x为大于0的数值。

[[Math.Log(10)]]

max(x,y)

数学

获取两个参数值中的最大值。参数:x、y为数值。

[[Math.Max(x,y)]]

min(x,y)

数学

获取两个参数值中的最小值。参数:x、y为数值。

[[Math.Min(x,y)]]

pow(x,y)

数学

获取以x为底、以y为指数的幂。参数:x为底数;y为指数。

[[Math.Pow(2,3)]]

random()

数学

获取0.0到1.0之间的随机数。

[[Math.Random()]]

sin(x)

数学

获取参数值的正弦值。参数:x为弧度值。

[[Math.Sin(1.57)]]

sqrt(x)

数学

获取参数值的平方根。参数:x为大于等于0的数值。

[[Math.Sqrt(9)]]

tan(x)

数学

获取参数值的正切值。参数:x为弧度值。

[[Math.Tan(0.785)]]

日期函数

用于处理日期和时间数据,包括获取日期组件、日期计算、日期格式化以及时区转换等功能。

now()

日期

获取当前的系统时间,精确到毫秒。时间戳,距离1970-01-01 00:00:00的毫秒数。

[[Now()]]

genDate(year,month,day,hour,minute,second,millisecond)

日期

根据指定年月日时分秒毫秒构建一个日期对象。参数:year为年;month为月(0~11);day为日;hour为小时;minute为分钟;second为秒;millisecond为毫秒。

[[GenDate(2024,0,1,0,0,0,0)]]

getDate()

日期

获取日期对象的日值(1~31)。

[[Date.getDate()]]

getDay()

日期

获取日期对象的星期值(0~6),0表示星期日。

[[Date.getDay()]]

getDayOfWeek()

日期

获取日期对象的星期值(1~7),1表示星期日。

[[Date.getDayOfWeek()]]

getFullYear()

日期

获取日期对象的完整年份。

[[Date.getFullYear()]]

getHours()

日期

获取日期对象的小时值(0~23)。

[[Date.getHours()]]

getMilliseconds()

日期

获取日期对象的毫秒值(0~999)。

[[Date.getMilliseconds()]]

getMinutes()

日期

获取日期对象的分钟值(0~59)。

[[Date.getMinutes()]]

getMonth()

日期

获取日期对象的月份值(0~11)。

[[Date.getMonth()]]

getMonthName()

日期

获取日期对象的月份名称。

[[Date.getMonthName()]]

getSeconds()

日期

获取日期对象的秒值(0~59)。

[[Date.getSeconds()]]

getTime()

日期

获取日期对象的时间戳。

[[Date.getTime()]]

getTimezoneOffset()

日期

获取日期对象的时区偏移量(分钟)。

[[Date.getTimezoneOffset()]]

getUTCDate()

日期

获取日期对象UTC的日值(1~31)。

[[Date.getUTCDate()]]

getUTCDay()

日期

获取日期对象UTC的星期值(0~6)。

[[Date.getUTCDay()]]

getUTCFullYear()

日期

获取日期对象UTC的完整年份。

[[Date.getUTCFullYear()]]

getUTCHours()

日期

获取日期对象UTC的小时值(0~23)。

[[Date.getUTCHours()]]

getUTCMilliseconds()

日期

获取日期对象UTC的毫秒值(0~999)。

[[Date.getUTCMilliseconds()]]

getUTCMinutes()

日期

获取日期对象UTC的分钟值(0~59)。

[[Date.getUTCMinutes()]]

getUTCMonth()

日期

获取日期对象UTC的月份值(0~11)。

[[Date.getUTCMonth()]]

getUTCSeconds()

日期

获取日期对象UTC的秒值(0~59)。

[[Date.getUTCSeconds()]]

parse()

日期

解析日期字符串,返回时间戳。

[[Date.parse()]]

toDateString()

日期

将日期对象转换为日期字符串。

[[Date.toDateString()]]

toISOString()

日期

将日期对象转换为ISO格式字符串。

[[Date.toISOString()]]

toJSON()

日期

将日期对象转换为JSON格式字符串。

[[Date.toJSON()]]

toLocaleDateString()

日期

将日期对象转换为本地格式的日期字符串。

[[Date.toLocaleDateString()]]

toLocaleTimeString()

日期

将日期对象转换为本地格式的时间字符串。

[[Date.toLocaleTimeString()]]

toLocaleString()

日期

将日期对象转换为本地格式的日期和时间字符串。

[[Date.toLocaleString()]]

toTimeString()

日期

将日期对象转换为时间字符串。

[[Date.toTimeString()]]

toUTCString()

日期

将日期对象转换为UTC格式字符串。

[[Date.toUTCString()]]

UTC()

日期

根据指定年月日时分秒毫秒构建一个UTC时间的时间戳。

[[Date.UTC()]]

valueOf()

日期

获取日期对象的原始值(时间戳)。

[[Date.valueOf()]]

addYears(years)

日期

向日期对象添加指定年数。参数:years为年数。

[[Date.addYears(1)]]

addMonths(months)

日期

向日期对象添加指定月数。参数:months为月数。

[[Date.addMonths(1)]]

addDays(days)

日期

向日期对象添加指定天数。参数:days为天数。

[[Date.addDays(1)]]

addHours(hours)

日期

向日期对象添加指定小时数。参数:hours为小时数。

[[Date.addHours(1)]]

addMinutes(minutes)

日期

向日期对象添加指定分钟数。参数:minutes为分钟数。

[[Date.addMinutes(1)]]

addSeconds(seconds)

日期

向日期对象添加指定秒数。参数:seconds为秒数。

[[Date.addSeconds(1)]]

addMilliseconds(milliseconds)

日期

向日期对象添加指定毫秒数。参数:milliseconds为毫秒数。

[[Date.addMilliseconds(1000)]]

条件操作符

用于进行条件判断和逻辑运算,包括比较操作符、逻辑操作符等,常用于公式中的条件控制。

操作符 描述 示例
== 等于
[[Lvar1==Lvar2]]
!= 不等于
[[Lvar1!=Lvar2]]
< 小于
[[Lvar1<Lvar2]]
<= 小于等于
[[Lvar1<=Lvar2]]
> 大于
[[Lvar1>Lvar2]]
>= 大于等于
[[Lvar1>=Lvar2]]
&&
[[Lvar1==Lvar2 && Lvar3==Lvar4]]
||
[[Lvar1==Lvar2 || Lvar3==Lvar4]]