Built-in JS functions
utils - utility functions
utils.openUrl()
Open a URL.
// Syntax
utils.openUrl( url: string, options?: { newTab: boolean = true } )
url
Required. A String value that specifies the URL to open. It must start with http:// or https://.
newTab
Optional. Boolean value that, when True, specifies the url is to open in a new tab. The default value is True.
// Example: Open google.com in a new tab.
utils.openUrl("https://www.google.com", { newTab: true })
utils.openApp()
Open an Lowcoder app.
// Syntax
utils.openApp( applicationId: string, options?: { queryParams?: {"key":"value"}, hashParams?: {"key":"value"}, newTab: true } )
appId
Required. A String value that specifies the ID of the app to open.
queryParams: {'key1':'value1',key2:'value2',...}
Optional. An Object that specifies query parameters to pass into the app. The query parameters are added to the app URL in the form of ?key1=value1&key2=value2&...
hashParams:{'key1':'value1',key2:'value2',...}
Optional. An Object that specifies hash parameters to pass into the app. The hash parameters are added to the app URL in the form of #key1=value1&key2=value2&...
newTab
Optional. A Boolean value that, when True, specifies the url is to open in a new tab. The default value is True.
// Example: Open an Lowcoder app in a new tab.
utils.openApp("632bddc33bb9722fb888f6c0", { newTab: true })
// Example: Open an Lowcoder app and pass in "id" parameter.
utils.openApp("632bddc33bb9722fb888f6c0", {
queryParams: { "id": table1.selectedRow.id },
} )
utils.downloadFile()
Download a file containing the specified data.
// Syntax
utils.downloadFile(data: any, fileName: string, options?: {
fileType?: string,
dataType?: "url" | "base64"
} )
data
Required. A String or Object that specifies the data to download from queries, components, transformers, etc.
fileName
Required. A String value that specifies the name of the file to download.
fileType
Optional. A String value that specifies the type of the file to download. All MIME types are supported.
dataType
Optional. A String value that specifies the type of the data: "url" or "base64".
// Example: Download the base64 data from a file component as a PNG file named users-data.
utils.downloadFile(file1.value[0], "users-data", {
fileType: "png",
dataType: "base64",
})
// Example: Download the results of query1 as a XLXS file named users-data.
utils.downloadFile(query1.data, "users-data", { fileType: "xlsx" })
// or in this way:
utils.downloadFile(query1.data, "users-data.xlsx")
// Example: Download the results of query1 as a XLXS file named users-data.
utils.downloadFile(restApiQuery.data, "users-data", {
fileType: "pdf",
dataType: "base64",
})
utils.copyToClipboard()
Copy a string to clipboard.
// Syntax
utils.copyToClipboard( text: string )
text
Required. A String value that specifies the content to copy.
// Example: Copy the content of input component to clipboard.
utils.copyToClipboard( input1.value )
utils.logoutUser()
Logout a User from the current Session.
// Syntax
utils.logOut()
message - global notification
Use message
methods to send a global alert notification, which displays at the top of the screen and lasts for 3 seconds by default. Each of the following four methods supports a unique display style.
// message.info( text: string, options?: {duration: number = 3 } )
message.info("Please confirm your information", { duration: 10 })
// message.success( text: string, options?: {duration: number = 3 } )
message.success("Query runs successfully", { duration: 10 })
// message.warn( text: string, options?: {duration: number = 3 } )
message.warn("Warning", { duration: 10 })
// message.error( text: string, options?: {duration: number = 3 } )
message.error("Query runs with error", { duration: 10 })
localStorage
Use localStorage
methods to store and manage key-value pair data locally, which is not reset when the app refreshes, and can be accessed in any app within the workspace using localStorage.values
.
setItem(key: string, value: any)
Store a key-value pair.
removeItem(key: string)
Delete a key-value pair.
clear()
Clear all data in localStorage.
localStorage.values
You can access any key-value pair in local storage using localStorage.values.
in JavaScript queries.
Inspect the data in localStorage in Globals in the data browser.
localStorage.setItem()
Store a key-value pair.
// Syntax
localStorage.setItem(key: string, value: any)
// Example
localStorage.setItem("order", select1.value)
localStorage.removeItem()
Delete a key-value pair.
// Syntax
localStorage.removeItem(key: string)
// Example
localStorage.removeItem("order")
localStorage.clear()
Clear all data in localStorage.
Responsiveness / Screen information
To enable responsive Layouts, you need to know which device type your app is currently viewed. This helper gives you information about the screen sizes. The values automatically update on Screen size changes.
screenInfo.deviceType
You can use deviceType to get the Type of the Device based on the current screen width of the Lowoder app (or the website where it is embedded). This value automatically updates on Screen size changes.
screenInfo.deviceType
=> returns String: Desktop | Tablet | Mobile
screenInfo.height
screenInfo.height
=> returns Number: height of the screen (browser window)
screenInfo.width
screenInfo.width
=> returns Number: width of the screen (browser window)
screenInfo.isDesktop
screenInfo.isDesktop
=> returns Boolean: if the current width is considered as Desktop size
screenInfo.isTablet
screenInfo.isTablet
=> returns Boolean: if the current width is considered as Tablet size
screenInfo.isMobile
screenInfo.isMobile
=> returns Boolean: if the current width is considered as Mobile size
Last updated
Was this helpful?