uni-halo/.agents/skills/uniapp-project/references/components/built-in/unicloud-db.md

unicloud-db

Instructions

组件是一个数据库查询组件，它是对 clientDB 的jsåº“çš„å†å°è£ ã€‚

前端通过组件方式直接获取uniCloud的云端数据库中的数据，并绑定在界面上进行渲染。

åœ¨ä¼ ç»Ÿå¼€å‘ä¸­ï¼Œå¼€å‘è€ éœ€è¦åœ¨å‰ç«¯å®šä¹‰data、通过request联网获取接口数据、然后赋值给data。同时后端还需要写接口来查库和反馈数据。

Syntax

• 使用 <unicloud-db />（或 <unicloud-db></unicloud-db>，当需要包裹子节点时）。
• 遇到平台差异时，建议使用条件编译（#ifdef / #endif）显式处理。

Properties

See official docs for full properties list: https://doc.dcloud.net.cn/uniCloud/unicloud-db

Events

See official docs for full events list: https://doc.dcloud.net.cn/uniCloud/unicloud-db

Slots

属性	类型	描述
data	Array	Object
pagination	Object	分页属性
loading	Boolean	æŸ¥è¯¢ä¸­çš„çŠ¶æ€ã€‚å¯æ ¹æ®æ­¤çŠ¶æ€ï¼Œåœ¨template中通过v-ifæ˜¾ç¤ºç­‰å¾ å† å®¹ï¼Œå¦‚ åŠ è½½ä¸­...
hasMore	Boolean	æ˜¯å¦æœ‰æ›´å¤šæ•°æ®ã€‚å¯æ ¹æ®æ­¤çŠ¶æ€ï¼Œåœ¨template中通过v-if显示没有更多数据了，如 , è¯¦æƒ https://ext.dcloud.net.cn/plugin?id=29
error	Object	æŸ¥è¯¢é”™è¯¯ã€‚å¯æ ¹æ®æ­¤çŠ¶æ€ï¼Œåœ¨template中通过v-ifæ˜¾ç¤ºç­‰å¾ å† å®¹ï¼Œå¦‚ åŠ è½½é”™è¯¯
options	Object	åœ¨å°ç¨‹åºä¸­ï¼Œæ’æ§½ä¸èƒ½è®¿é—®å¤–é¢çš„æ•°æ®ï¼Œéœ€é€šè¿‡æ­¤å‚æ•°ä¼ é€’, ä¸æ”¯æŒä¼ é€’å‡½æ•°

Platform Compatibility

See official docs for platform support table: https://doc.dcloud.net.cn/uniCloud/unicloud-db

Examples

Example (Example 1)

<unicloud-db v-slot:default="{data, loading, error, options}" collection="table1" field="field1" :getone="true" where="id=='1'">
  <view>
    {{ data}}
  </view>
</unicloud-db>

Example (Example 2)

<unicloud-db v-slot:default="{data, loading, error, options}" collection="table1" field="field1" :getone="true" where="id=='1'">
  <view>
    {{ data}}
  </view>
</unicloud-db>

Example (Example 3)

<template>
  <view>
    <unicloud-db v-slot:default="{data, loading, error, options}" collection="user" field="name" :getone="true" where="id=='1'">
      <view>
          {{ data.name}}
      </view>
    </unicloud-db>
  </view>
</template>

Example (Example 4)

<template>
  <view>
    <unicloud-db v-slot:default="{data, loading, error, options}" collection="user" field="name" :getone="true" where="id=='1'">
      <view>
          {{ data.name}}
      </view>
    </unicloud-db>
  </view>
</template>

Example (Example 5)

<unicloud-db v-slot:default="{data, pagination, loading, hasMore, error, options}"></unicloud-db>

Example (Example 6)

<unicloud-db v-slot:default="{data, pagination, loading, hasMore, error, options}"></unicloud-db>

Reference: Official Documentation