Skip to content

测试版

这些 App Bridge 组件是新加入的,尚未在真实的 Shopify admin 中测试。测试期间,API 可能会在 minor 版本中变更。如有问题,请提交 issue。

useAppBridge() ​

开始之前,请参阅安装。

useAppBridge() 返回全局 shopify,类型为 ShopifyGlobal:

vue
<script setup lang="ts">
import { useAppBridge } from 'polaris-vue-elements/app-bridge'

const shopify = useAppBridge()

function generate(): void {
  shopify.toast.show('Blog post template generated')
}
</script>

<template>
  <button @click="generate">Generate blog post</button>
</template>

与 @shopify/app-bridge-react 一样:

  • 在服务器端,它返回一个对象,读取其任何属性都会抛出错误。请在 onMounted() 或事件处理函数中 调用这些 API。
  • 在浏览器中,如果 shopify 未定义,它会抛出错误,这"likely means the App Bridge script tag was not added correctly to this page"。

像嵌入式应用指南那样直接使用全局 shopify 也可以。

基于 MIT 许可证发布。Vue 标志由 Evan You 设计,采用 CC BY-NC-SA 4.0 许可。