FinClip为企业提供小程序生态圈技术产品,开发者可在FinClip小程序开发帮助中心找到相关FinClip小程序指引

# 跳转(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

对应的动作事件

© FinClip with ❤ , Since 2017