Skip to main content

global 对象

PagePlug中的global对象提供有关应用程序当前状态的信息

1、属性 ​

global对象包含以下属性：

{
   echartInstance: Object,
   store: object,
   URL: object,
   user: object,
   geolocation: object,
   mode: string,
   inCloudOS: Boolean,
   theme: Object
}

1.1 store ​

该对象包含应用程序本地存储的键值对。可以使用storeValue()更新存储的值。可以使用它们的键访问存储中的值。

// 存
storeValue("test", 123)
// 取
{{ global.store.text }}

1.2 URL ​

该对象包含与用户所在的当前 URL 关联的所有值。该字段的 queryParams 对象可用于读取使用navigateTo()从其他页面发送到该页面的数据。可以使用以下方法访问 URL 中的值：

{{ global.URL }}
{
  host: string,
  hostName: string,
  fullPath: string,
  pathName: string,
  port: string,
  protocol: string,
  hash: string,
  queryParams: object
}

URL 对象的host属性是一个字符串，其中包括主机名，然后是 ，:后跟 URL 的端口（如果端口可用）。

例子：

{{global.URL.host}}
"app.appsmith.com:111"

URL 的hostname属性是一个包含URL 域的字符串。简单来说，hostname 就是主机名（不含端口号）。

例子：

{{global.URL.hostname}}
"app.appsmith.com"

完整路径 URL 指定一个确切的位置（例如页面、应用程序、文件等）。除了域和顶级域 (TLD) 之外，完整路径 URL 还需要包括协议、子域（例如“app”、“support”等）、路径/目标以及可能的文件扩展名以及查询参数。完整路径可以包括：

  • 协议
  • 子域名
  • 域名
  • 顶级域 (TLD)
  • 路径
  • 参数

例子：

{{global.URL.fullPath}}
"https://app.appsmith.com/app/demo-app/page1-6324031aa"
**提示**

在前面的示例中，6324031aa表示名为 的页面的IDpage1。URL 中的当前页面 slug 是通过组合创建的$pageName-$pageId。每个页面都有一个分配给它的唯一页面 ID。

它是由一组路径段组成的字符串，每个路径段都有/前缀字符。如果 URL 没有路径段，则空字符串将是路径名属性的值。

例子：

{{global.URL.pathname}}
"/app/demo-app/page1-6324031aa"

URL 的port属性是一个字符串，其中包含 URL 的端口号。

例子：

{{global.URL.port}}
"3000"

URL 的protocol属性是一个字符串，表示 URL 的协议方案，包括:.

资源名称和协议标识由一个冒号和两个正斜杠彼此分隔。

例子：

{{global.URL.protocol}}
"https:"

该值是主题标签（包括global.URL.hash）之后的字符串。URL 片段标识后跟一个哈希符号（#），这是 URL 接口的哈希属性。#

例子：

{{global.URL.hash}}
"#n912xhego"

查询参数是一组预定义的参数，这些参数根据传递的数据定义特定的内容或操作。URL 的所有查询参数都附加在末尾，并以 a?作为分隔符。

例子：

{{global.URL.queryParams}}
"?name=value&variable=value"

1.3 user ​

该对象包含当前经过身份验证的用户的数据。

{
  email: string
  username: string
  name: string
  role: string
  useCase: string
  accountNonExpired: boolean
  accountNonLocked: boolean
  credentialsNonExpired: boolean
  adminSettingsVisible: boolean
  cloudOSLogged: boolean
}
属性用法待补充

  • geolocation ​

该对象包含请求当前用户位置和从此请求接收的坐标的函数https://developer.mozilla.org/en-US/docs/Web/API/Geolocation\_API。

{
 canBeRequested: boolean,
 getCurrentPosition: Function,
 watchPosition: Function,
 clearWatch: Function,
 currentPosition: {
   coords: {
      accuracy: number,
      altitude: number | null,
      altitudeAccuracy: number | null,
      heading: number | null,
      latitude: number,
      longitude: number,
      speed: number | mull,
   },
   timestamp: number,
 }
}

获取当前位置

特征：

(
 onSuccessCallback?,
 onErrorCallback?,
 options?: { maximumAge?: number, timeout?: number, enableHighAccuracy?: boolean }
) -> void

与原始浏览器 API 几乎相似，除了不需要传递成功回调之外。成功后，该位置将自动存储在global.geolocation.currentPosition.coords。如果传递了 onSuccessCallback，则会使用收到的位置信息调用它。

  • watchPosition​

特征：

(
  onSuccessCallback?,
  onErrorCallback?,
  options?: { maximumAge?: number, timeout?: number, enableHighAccuracy?: boolean }
) -> void

与原始浏览器 API 几乎相似，除了不需要传递成功回调之外。成功后，该位置将自动存储在上次更新位置时的更新位置global.geolocation.currentPosition.coords。global.geolocation.currentPosition.timestamp回调（如果提供）会在位置更改时自动执行。没有 watchId 被返回以及平台只允许一个watchPosition

特征：() -> Promise

与原始浏览器 API 几乎相似，除了您不必传递 watchId。如果watch处于活动状态，则必须在开始新watch之前将其清除。

1.4 mode ​

该字段是一个字符串，其中包含应用程序当前是在查看模式还是编辑模式下运行。它采用值 VIEW|EDIT

剩余属性还在补充，敬请期待！