# 跳转(navigateTo)
该事件允许用户在应用程序的内部页面或外部URL之间导航。它可以在任何小部件操作上触发,如Button的onClick, Dropdown的onOptionChange等。在navigateTo函数中输入页面名称或外部URL(在onClick等触发操作下),如果需要,输入Query参数,并为新页面(新窗口或相同窗口)选择目的地。
JS 格式
navigateTo(pageName | Url: string, params?: {}, target: "SAME_WINDOW" | "NEW_WINDOW") -> Promise
参数
属性 | 说明 |
---|---|
pageName或Url | 您希望传输到的页面名称或URL,PageName区分大小写。 |
params(可选) | 通过URL传递的查询参数,用于与目标页共享信息。 |
target(可选) | 配置在哪里打开URL,默认当前窗口。 |
对应的动作事件
示例
例如Page1想给Page2共享某个数据
在button组件的onClick事件选择跳转到
选择页面:选择 Page2
在查询参数填入一下代码
- 点击跳转,在Page2,通过 global.URL.queryParams 可以取到该数据
如果点击的跳转新窗口,会在新窗口的url 上拿到参数
# 消息提示(showAlert)
向用户显示一个临时的消息提示,持续5秒。警报消息的持续时间不能修改。
格式
showAlert(message: string, style: string)
参数
属性 | 说明 |
---|---|
Message | 您希望传输到的页面名称或URL,PageName区分大小写。 |
Style(提示类型) | 警报消息的样式。可以是“info”、“success”、“error”或“warning”之一。 |
示例
在button的onClick事件选消息提示,并填写提示消息内容
消息、成功、错误、警告类型提示分别如下图所示
# 打开/关闭弹窗
这个函数用于在触发时打开一个弹窗。
格式
打开弹窗
showModal(modalName: string)
关闭弹窗
closeModal(modalName: string)
属性 | 说明 |
---|---|
Modal Name | 要显示的弹窗名称 |
示例
请注意
想打开弹窗之前记得先创建弹窗哦
在button按钮的onClick事件选择打开弹窗
点击按钮之后就可以显示弹窗啦
- 关闭弹窗,直接点击弹窗上右上角的叉号即可,或者在其他地方调用 closeModal(modalName: string)
# 全局数据
storeValue()函数将数据保存在浏览器中作为键值对,浏览器的localstorage里可以访问到,以后可以在应用程序中的任何地方访问。
# storeValue
- 存储数据
格式
storeValue(key: string, value: any, persist? = true)
如果希望存储输入框组件的文本,可以使用storeValue()
{{storeValue('email',input1.text)}}
- 读取数据
可以通过引用存储对象中的键来访问存储中的值。
{{ global.store.key }}
- 修改数据
可以通过使用其键覆盖数据来更新存储中保存的值。
比如,可以使用键isActive将布尔值从True更新为False,如下所示
export default {
updateStore: () => {
if(global.store.isActive === true)
storeValue("isActive", false)
}
}
如果需要存储许多值,而不是多次调用storeValue函数,建议使用对象形式来存储值。所有的值都可以在一个storeValue()函数中分配,如下所示
storeValue("user", { "name": "Bar Crouch", "email": "bar@appsmith.com", "pin": "9984"})
# removeValue
函数清除存储库中指定键的值。
{{removeValue(key)}}
参考下面的代码,使用JSObject删除键为isActive的值
export default {
deleteStore: () => {
// Delete value for a particular key
removeValue("isActive")
}
}
# clearStore
函数清除应用中所有数据。
{{clearStore()}}
- 对应的动作事件
# 复制到粘贴板
此函数用于将文本复制到剪贴板。
格式
copyToClipboard(data: string, options: object)
示例
例如:在按钮组件中选择复制输入框(input)组件的内容
# 定时器
定时事件(JavaScript中的计时函数)允许用户定期运行API和DB查询。您可以使用setInterval和clearInterval函数来配置这些。
# setInterval()
setInterval()在以固定的时间间隔执行回调函数。
setInterval()在以固定的时间间隔执行回调函数。
参数
属性 | 说明 |
---|---|
callbackFunction | 每隔特定时间间隔重复调用的函数。 |
interval | 调用callbackFunction之间等待的毫秒数,也就是时间间隔。 |
id | 定时器的唯一标识,使用clearInterval清除定时器就是传这个id |
对应的动作事件
示例
这个定时器会每隔10秒执行Query1.run()
setInterval(() => { Query1.run() }, 10000, "myTimer");
# clearInterval()
该函数可以清除定时器,避免定时器占用内存。
clearInterval(id: string)
参数
属性 | 说明 |
---|---|
id | 需要清除的定时器id |
对应的动作事件