更新记录

0.0.10(2021-07-27)

  • 优化 兼容VUE3项目

0.0.9(2021-05-21)

  • 修复 导入页面运行报错的问题

0.0.8(2020-12-14)

  • 修复 文档错误的问题
查看更多

平台兼容性

阿里云 腾讯云 支付宝小程序云
×

云函数类插件通用教程

使用云函数类插件的前提是:使用HBuilderX 2.9+


什么是 uniCloud

uniCloud 是 DCloud 联合阿里云、腾讯云,为开发者提供的基于 serverless 模式和 js 编程的云开发平台,更多请参考uniCloud文档

云端一体页面的优势是什么

过去,开发一个列表,需要在后端设计数据库,提供接口,前端写列表,处理分页、下拉刷新,并保证长列表的性能,全套工作下来需要1、2天。

现在有了云端一体列表,上述工作都不用做了,页面拿来就用。

在HBuilderX 2.9+,新建页面时,可以直接选择大量云端一体页面模板,数据库、后台接口、前端页面都有了。

当然,您也可以调整,自定义数据库表和前端的ui。

后台数据表

后台数据表使用 openDB 设计规范,它约定了一个标准用户表的表名和字段定义,并且基于nosql的特性,可以由开发者自行扩展字段。openDBuniCloud的重要软基建,支撑uniCloud数字生态的发展。

页面模板简介

列表是我们在项目开发中常见的一个需求,对于基础列表 uni-list 组件已经提供了大部分常见的功能。

但是如果我们想要实现一个复杂的新闻列表,难免需要我们去实现不同的复杂列表布局,例如一些图文混排、左图右文、右图左文、大图略缩图、多图略缩图等多种不同排版组合,同时我们可能还需要应对不同的数据展示。

那么现在我们给大家提供了一个基于 uni-list 组件的云端一体化新闻列表页面模板,帮大家快速构建一个复杂多变的新闻列表。

当前模板做了四个事情:

  • 通过 openDBopendb-news-articles表规范表结构
  • 基于 uni-clientdb 组件操作数据库
  • 实现常见的六种新闻列表排版,减少实现同类需求构建代码的工作量
  • 实现简单的下拉刷新,上拉加载

Tips

  • 暂不支持 nvue 页面

使用说明

当前模板是在 uni-list 组件基础上,通过插槽的方式实现了不同的新闻列表排版,同时使用了 uni-clientDB 完成了云端一体化。大大减少了大家的的代码开发时间。

  1. 在项目目录上右键选择创建uniCloud云开发环境并选择服务商
  2. uniCloud目录上右键选择关联云服务空间或项目并选择服务空间
  3. uniCloud > database > db_init.json 文件,右键选择初始化云数据库,等待初始化完成。数据结构参考 openDBopendb-news-articles表结构
  4. 运行到 Chrome 查看效果

代码说明

代码逻辑以及样式见代码示例

基本排版

我们提供了六种排版布局,基本上包括了市面上大部分的新闻类列表的常见排版,当前模板为 垂直排列,略缩图显示大图 , 具体实现代码如下


<uni-list>
    <!-- 垂直排列,略缩图显示大图 -->
    <uni-list-item direction="column" note="Dcloud 128评论 21 赞">
        <template v-slot:header>
            <view class="uni-title">垂直排列的大图模式列表, header 内容为插槽自定义的内容</view>
            <view class="uni-thumb uni-content list-picture"><image src="/static/logo.png" mode="aspectFill"></image></view>
        </template>
    </uni-list-item>
</uni-list>

样式覆盖

模板中通过 common/uni-ui.scss 定义了一些标题、图片等的基础样式

如果以上六种排版不能满足需求或者需要调整现有排版的样式,直接修改或覆盖对应样式即可。

其他模板样式

  1. 云端一体混合布局:https://ext.dcloud.net.cn/plugin?id=2546
  2. (当前模板)云端一体垂直布局,大图模式:https://ext.dcloud.net.cn/plugin?id=2583
  3. 云端一体垂直布局,多行图文混排:https://ext.dcloud.net.cn/plugin?id=2584
  4. 云端一体垂直布局,多图模式:https://ext.dcloud.net.cn/plugin?id=2585
  5. 云端一体水平布局,左图右文:https://ext.dcloud.net.cn/plugin?id=2586
  6. 云端一体水平布局,左文右图:https://ext.dcloud.net.cn/plugin?id=2587
  7. 云端一体垂直布局,无图模式,主标题+副标题:https://ext.dcloud.net.cn/plugin?id=2588

隐私、权限声明

1. 本插件需要申请的系统权限列表:

2. 本插件采集的数据、发送的服务器地址、以及数据用途说明:

3. 本插件是否包含广告,如包含需详细说明广告表达方式、展示频率:

许可协议

clientDB使用许可协议

本协议是数字天堂(北京)网络技术有限公司(以下称“DCloud”)与您之间达成的关于clientDB框架(以下简称本框架)的协议。 本协议签订地点为中华人民共和国北京市海淀区。 您使用本框架即视为您已阅读并同意受本协议的约束。

知识产权及使用授权

您可以自由下载、使用、复制本框架而不需要向DCloud付费。 DCloud所拥有的知识产权,包括但不限于商标、专利、著作权、商业秘密、专有数据、源码,并不发生转移或共享。 您使用本框架开发的代码及输出物,包括但不限于网站、移动应用,其知识产权归属您所有。 本框架未包含第三方软件或技术,不涉及额外遵循第三方软件的授权协议问题。

您的义务

您不得破解、反编译、逆向工程本框架,不得破解或劫持本框架网络请求,不得对DCloud服务进行网络攻击,不得利用DCloud系统漏洞谋利或侵害DCloud利益,不得替换、删改本框架自带的非用户自定义文件。 未经书面许可您不可利用DCloud产品的全部或部分文件、模块、组件来制作与DCloud争夺用户的产品(通过DCloud插件市场服务开发者不属于此范围)。 如果您违反您的义务,DCloud将有权停止您使用本框架,造成的损失由您自行承担。 如果您给DCloud造成重大损失,或者在接收到DCloud的停止违约通知后拒不改正,DCloud将有权停止对您的DCloud所有产品和服务的使用授权,冻结您在DCloud所有产品服务中的预付款项和应收款项,因此造成的损失由您自行承担。 如果您的行为产生法律问题,DCloud有权追责您的法律责任。

隐私条款

本框架未进行任何数据采集、发送等涉及数据隐私的行为。

安全

您理解并同意,本框架同其他软件一样,无法承诺绝对的安全性。 当DCloud发现本框架的任何安全漏洞时,将及时在社区发送公告,并将及时发布紧急更新补丁和升级推送通知。

免责声明

DCloud不因开发者使用本框架而承担任何法律责任。

协议修订

根据发展,DCloud可能会对本协议进行修改。修改时,DCloud会在产品或者网页中显著的位置发布相关信息以便及时通知到用户。如果您选择继续使用本框架,即表示您同意接受这些修改。

使用中有什么不明白的地方,就向插件作者提问吧~ 我要提问