开发
API

open-data

基础库 2.30.0 开始支持本组件,低版本需做兼容处理

用于展示字节生态开放数据。

属性说明

属性名类型默认值必填说明最低支持版本
typestring开放数据类型2.30.0
default-textstring文本数据为空时的默认内容2.30.0
default-avatarstring用户头像为空时的默认图片,支持相对路径和网络图片路径2.30.0
use-empty-valuestringfalse当数据为空且未设置默认值时,是否显示官方默认值2.30.0
binderrorEventHandle出现错误时触发2.30.0

type 的合法值

说明最低支持版本
userNickName用户昵称2.30.0
userAvatarUrl用户头像,默认尺寸 64px * 64px2.30.0
userGender用户性别2.30.0
userCity用户所在城市2.30.0
userProvince用户所在省份2.30.0
userCountry用户所在国家2.30.0

官方默认值

type 值官方默认值最低支持版本
userNickName"用户"2.30.0
userAvatarUrl2.30.0
userGender"未知"2.30.0
userCity"未知"2.30.0
userProvince"未知"2.30.0
userCountry"未知"2.30.0

userAvatarUrl 的官方默认值请试用体验。

binderror 事件对象的 detail

object 类型,属性如下:

属性名类型说明最低支持版本
errMsgstring错误描述2.30.0
errNonumber错误码2.30.0

错误说明

errNoerrMsg说明最低支持版本
10103"network unavailable"网络错误2.30.0
10103"fail to load image"加载图片失败2.30.0
10301"feature is not supported in app"宿主不支持相关功能2.30.0
10401"internal error"内部错误2.30.0
10601"not login"宿主未登录2.30.0
10603"invalid session"宿主登录,小程序未登录2.30.0
20001"type is required"type 要求必传2.30.0
20001"type "${type}" is invalid"type 值无效2.30.0
21507"${type} is empty"开放数据为空2.30.0

扫码体验

请使用字节宿主APP扫码

代码示例

开发者工具中预览

<view>
  <button type="default" size="default" bindtap="login">login</button>
  <open-data type="userAvatarUrl" use-empty-value binderror="handleError" />
  <open-data type="userNickName" default-text="empty" binderror="handleError" />
</view>
Page({
  login() {
    tt.login({
      success() {
        tt.showToast({
          title: "登录成功",
          icon: "success",
        });
      },
      fail() {
        tt.showToast({
          title: "登录失败",
          icon: "fail",
        });
      },
    });
  },

  handleError(e) {
    console.log(`${e.detail.errNo}: ${e.detail.errMsg}`);
  },
});

Bug & Tip

  • Tip: 宿主和小程序都登录后才能显示开放数据。
点击纠错
评价此篇文档