codecamp

tt.showFavoriteGuide

基础库 1.41.0 开始支持本方法,低版本需做兼容处理

在小程序内调起关注小程序的引导组件,用于引导用户关注小程序。


参数

Object object

属性类型默认值必填说明
typestring小程序中默认值是 bar,小游戏中只能使用 tip引导组件类型,可以是 bar(底部弹窗)、tip(顶部气泡)
contentstring一键添加到我的小程序弹窗文案,最多显示 12 个字符
positionstring小程序中默认值是 bottom,小游戏中该字段无意义弹窗类型为 bar 时的位置参数,可以是 bottom(贴近底部)、overtab(悬于页面 tab 区域上方)
successfunction接口调用成功后的回调函数
failfunction接口调用失败后的回调函数
completefunction接口调用结束后的回调函数(调用成功、失败都会执行)


展现形式

目前小程序收藏引导组件支持以下两种类型,开发者可根据自身业务进行选择:

1. 气泡引导(type = tip)

气泡引导是一种轻量引导组件,它的调用既不会阻塞用户后续行为,也不要求用户一定去响应操作,在一定时间内向用户展现信息,便自动消失。

图片名称

展现策略:

  • 3s 后自动消失,组件箭头指向小程序菜单
  • 每位用户最多触达【2 次】,最短间隔【3 天】才能第二次展现
  • 若检测到用户已收藏该小程序,则不展示任何引导组件

注意,展现策略仅在线上版、审核版有效,测试版、预览版不受限制。


2. 浮窗引导

浮窗引导的展现力度比气泡引导更强,用户在组件上能进行“添加”操作。

图片名称

展现策略:

  • 10s 后自动消失
  • 每位用户最多触达【2 次】,最短间隔【一周】才能第二次展现
  • 若检测到用户已收藏该小程序,则不展示任何引导组件

注意,展现策略仅在线上版、审核版有效,测试版、预览版不受限制。


代码示例

tt.showFavoriteGuide({
  type: "bar",
  content: "一键添加到我的小程序",
  position: "bottom",
  success(res) {
    console.log("引导组件展示成功");
  },
  fail(res) {
    console.log("引导组件展示失败");
  }
});
tt.showActionSheet
tt.showNavigationBarLoading
温馨提示
下载编程狮App,免费阅读超1000+编程语言教程
取消
确定
目录

字节跳动小程序 介绍

字节跳动小程序 开发

字节跳动小程序开发框架

字节跳动小程序开发框架基础说明

字节跳动小程序开发框架基础功能

字节跳动小程序开发框架逻辑层

无标题文章

无标题目录

API

无标题文章

无标题文章

无标题文章

无标题文章

无标题文章

无标题目录

无标题目录

无标题文章

关闭

MIP.setData({ 'pageTheme' : getCookie('pageTheme') || {'day':true, 'night':false}, 'pageFontSize' : getCookie('pageFontSize') || 20 }); MIP.watch('pageTheme', function(newValue){ setCookie('pageTheme', JSON.stringify(newValue)) }); MIP.watch('pageFontSize', function(newValue){ setCookie('pageFontSize', newValue) }); function setCookie(name, value){ var days = 1; var exp = new Date(); exp.setTime(exp.getTime() + days*24*60*60*1000); document.cookie = name + '=' + value + ';expires=' + exp.toUTCString(); } function getCookie(name){ var reg = new RegExp('(^| )' + name + '=([^;]*)(;|$)'); return document.cookie.match(reg) ? JSON.parse(document.cookie.match(reg)[2]) : null; }