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