Skip to content

UI 模式概览 ​

UI 模式决定 RAKUFUN 购买入口在您的页面上长什么样、放在哪里。一共有四种,选一种用就行。

怎么选 ​

您的需求推荐模式要写的代码
最快接入,不想改页面布局默认模式最少
在页面某个位置(比如价格下面)放一个购买按钮按钮模式少
在页面某个位置放一条横幅横幅模式少
用自己设计的按钮,样式完全自己定自定义模式稍多

拿不准的话,先用默认模式。

前三种模式的界面由 SDK 提供,您只需要告诉 SDK 商品信息;自定义模式不用 SDK 的界面,购买按钮由您自己做。

实时演示 ​

下面可以切换查看 SDK 提供的三种界面(默认、按钮、横幅):

🎨 实时 UI 模式切换演示

在下方选择一个模式,即可实时查看 UI 渲染效果

模式控制:
状态:模式: 未选择 | 已挂载: false
按钮容器

在 button 模式下激活

横幅容器

在 banner 模式下激活

💡 提示:在 default 模式下,底部面板出现在页面底部。 在 button 和 banner 模式下,组件会渲染到上方的容器中。

四种模式一览 ​

1. 默认模式:页面底部的购买面板 ​

页面底部自动出现一个购买面板,不用改页面结构。引入 SDK 后,告诉它当前是什么商品即可。

html
<script src="https://sdk.rakufun.com/rakufun-universal.min.js"></script>
<script>
  rakufun.setUIProductData({
    url: window.location.href,
    title: '商品名称',
    price: '12800',
    images: ['https://example.com/product.jpg']
  });
</script>

查看详情 →


2. 按钮模式:放在指定位置的购买按钮 ​

在页面里放一个空的 div,SDK 会把购买按钮显示在那里。

html
<!-- 按钮会显示在这里 -->
<div class="rakufun-sdk-embed-button"></div>

<script src="https://sdk.rakufun.com/rakufun-universal.min.js"></script>
<script>
  rakufun.setUIMode('button');
  rakufun.setUIProductData({
    url: window.location.href,
    title: '商品名称',
    price: '12800',
    images: ['https://example.com/product.jpg']
  });
</script>

查看详情 →


3. 横幅模式:放在指定位置的横幅 ​

用法和按钮模式一样,只是显示的是一条横幅,点击横幅任意位置都能购买。

html
<!-- 横幅会显示在这里 -->
<div class="rakufun-sdk-embed-banner"></div>

<script src="https://sdk.rakufun.com/rakufun-universal.min.js"></script>
<script>
  rakufun.setUIMode('banner');
  rakufun.setUIProductData({
    url: window.location.href,
    title: '商品名称',
    price: '12800',
    images: ['https://example.com/product.jpg']
  });
</script>

查看详情 →


4. 自定义模式:使用您自己的按钮 ​

不用 SDK 的界面。先用 disableAutoUI() 关掉 SDK 自带的底部面板,用户点击您的按钮时调用 quickBuy()。

html
<button id="my-button">立即购买</button>

<script src="https://sdk.rakufun.com/rakufun-universal.min.js"></script>
<script>
  rakufun.disableAutoUI(); // 不显示 SDK 自带的底部面板
  document.getElementById('my-button').onclick = async () => {
    const result = await rakufun.quickBuy({
      url: window.location.href,
      title: '商品名称',
      price: '12800',
      images: ['https://example.com/product.jpg']
    });
    if (!result.success) console.error(result.message);
  };
</script>

查看详情 →


补充说明 ​

在日本测试时看不到界面 ​

日本 IP 下,SDK 默认不显示界面(默认、按钮、横幅三种模式都是)。在日本测试时,可以临时加一行:

javascript
rakufun.enableDebug(); // 会显示界面,页面右上角有 DEBUG 标记,测试完记得删掉

用户点击后,想先弹个确认框(仅按钮、横幅模式) ​

用 setUICartHandler。函数返回 true 才会继续购买,返回其他值都会取消。默认模式下这个设置不生效。

javascript
rakufun.setUICartHandler(async (product) => {
  return confirm(`确认购买 ${product.title}?`);
});

有疑问?联系我们:service@rakufun.com

基于 MIT 许可证发布