遥遥领先,OpenTiny Vue 3.14.0 正式发布,增加了 MindMap 思维导图等3个新组件

你好,我是 Kagol。

我们非常高兴地宣布,2024年3月7日,OpenTiny Vue 发布了 v3.14.0 🎉。

OpenTiny 每次大版本发布,都会给大家带来一些实用的新特性,上一个版本我们推出了 Watermark 水印和 QrCode 二维码这两个新组件,并且对组件的 Demo 和 API 文档进行全面优化,优化后的文档更加清晰易懂、符合预期。

OpenTiny Vue 3.12.0 发布:文档大优化!增加水印和二维码两个新组件🎈

本次 3.14.0 版本主要推出以下新特性:

详细的 Release Notes 请参考:github.com/opentiny/ti…

本次版本共有22位贡献者参与开发,其中有3位是新贡献者,欢迎新朋友们👏

以下是新贡献者:

也感谢老朋友们对 OpenTiny 的辛苦付出!

尤其感谢:

  • @GaoNeng-wWw,他是我们 OpenTiny 的核心贡献者,从2023年3月份 TinyVue 刚开源就开始参与 TinyVue 贡献,为 TinyVue 贡献了 ConfigProvider 全局配置、ColorPicker 颜色选择器、MindMap 思维导图等多个组件,并且多次参与代码检视。同时 GaoNeng 同学还是我们开源之夏2023的导师,带领学生完成 RichTextEditor 富文本编辑器组件。GaoNeng 还为 TinyVue 项目沉淀了一篇宝贵的新组件开发指南文档:GaoNeng:我是如何为 OpenTiny 贡献新组件的?,如果你也想给我们贡献新组件,这篇文章可以提供一个很好的指引。
  • @mengqiuleo,xiaoy 同学是一名大三的学生,是一位热爱技术的程序媛,参与多个开源项目贡献,为 OpenTiny 增加 Playground 代码演练场,增加 Skeleton 骨架屏组件,并沉淀了一篇编写 RFC 的文档:#1334
  • @jxhhdx,为我们 TinyVue 的10多个组件增加了 TypeScript 类型声明,提升了开发体验。如果你也想参与 OpenTiny 贡献,但不知道怎么入手,为组件完善 TypeScript 是一个很好的起点。#370

你可以更新 @opentiny/vue@3.14.0 进行体验!

我们一起来看看都有哪些更新吧!

MindMap 思维导图

思维导图是一个非常实用但却很复杂的组件,业界组件库都没有这个组件。

去年6月份有朋友给我们提 Issue:#312,希望增加这个组件,经过近半年的孵化,终于在今年1月份,由 OpenTiny 核心贡献者 @GaoNeng-wWw 实现。

我们来看下这个组件的效果图:

遥遥领先,OpenTiny Vue 3.14.0 正式发布,增加了 MindMap 思维导图等3个新组件

看起来和 XMind / MindMaster 等思维导图差不多,支持非常丰富的快捷键:

  • Tab 键增加子节点
  • Enter 回车键增加同级节点
  • Delete 键删除节点及其所有子节点
  • 拖拽改变节点位置,支持放置在节点之前、节点之后、子节点三种位置
  • 方向键改变当前选中的节点
  • Ctrl + C / Ctrl + V 复制粘贴节点
  • 双击节点进入编辑态

使用起来也很方便。

<template>
  <tiny-mind-map class="mindmap"></tiny-mind-map>
</template>
<style scoped>
.mindmap {
  width: 100%;
  height: 400px;
}
</style>

更多 MindMap 组件的功能,欢迎到 TinyVue 官网进行体验:opentiny.design/tiny-vue

Skeleton 骨架屏

前端界面里的数据一般都是通过接口方式从后台获取的,在后台接口还没有返回数据之前,前端页面显示什么呢?

比较粗暴的方式就是显示一个空白页,用户只能傻傻地盯着这个空白页,等待数据展示,如果长时间没有显示内容,用户不知道发生了什么事情,可能会比较焦虑,从而关闭页面,放弃访问,并对这个网站产生不好的印象。

还有一种方式是使用一个加载中的图标,这样用户至少知道数据正在加载中,可能稍微等等内容就出来了,焦虑感会减少一些,但对于接下来大致会展示什么内容依然是模糊的。

骨架屏,顾名思义就是在真实内容展示之前,先展示一个内容的大致骨架,让用户大致有一个预期,接下来将要展示一张图片还是一段文本,页面内容的大致框架是什么。

Skeleton 骨架屏组件的使用场景主要有:

  • 网络较慢或加载内容较多时 。使用骨架屏向用户提供一个对即将出现内容的预期,解决等待加载过程中出现白屏或界面闪烁造成的割裂感。
  • 内容区域的布局排版固定时 。使用骨架屏展现内容的大概轮廓,如列表、文章、个人信息。

骨架屏是一种在数据尚未加载完成时展示给用户的占位符界面。它通过使用简单的占位元素和动画效果,模拟出页面正在加载的样式,给用户一种即将展示内容的期待感。

这个组件也很早就有朋友提 Issue:#355,今年2月份由 @mengqiuleo 实现。

效果如下:

遥遥领先,OpenTiny Vue 3.14.0 正式发布,增加了 MindMap 思维导图等3个新组件

默认情况下,Skeleton 组件显示标题+段落的骨架,并且有从左到右的动效。

我们的 Skeleton 是一个看着简单,却非常灵活的组件。

首先段落行数可以配置,默认是3行。

<template>
  <tiny-skeleton :rows="4"></tiny-skeleton>
</template>

显示效果如下:

遥遥领先,OpenTiny Vue 3.14.0 正式发布,增加了 MindMap 思维导图等3个新组件

段落宽度可以通过 rows-width 进行配置。

<template>
  <tiny-skeleton :rows-width="['200px', '100px', '50px']"></tiny-skeleton>
</template>

显示效果如下:

遥遥领先,OpenTiny Vue 3.14.0 正式发布,增加了 MindMap 思维导图等3个新组件

如果你想显示头像占位,可以配置 avatar 属性。

遥遥领先,OpenTiny Vue 3.14.0 正式发布,增加了 MindMap 思维导图等3个新组件

以上属性都是非常常见的配置项,如果这些配置项不能满足你的要求,你需要更加定制化的占位,我们也提供了细粒度模式,让你可以自由拼接自己的骨架屏组件。

细粒度模式通过 skeleton 组件的 placeholder 插槽和 skeleton-item 组件来实现。

比如我们的界面里面有一个这样的卡片:

遥遥领先,OpenTiny Vue 3.14.0 正式发布,增加了 MindMap 思维导图等3个新组件

在卡片中的图片和文字内容没有返回之前,应该显示一个图片+段落的占位。

目前的 Skeleton 组件并没有这样一个现成的配置,这时我们可以通过以下代码实现。

<template>
  <tiny-skeleton>
    <template #placeholder>
      <tiny-skeleton-item variant="image"></tiny-skeleton-item>
      <tiny-skeleton></tiny-skeleton>
    </template>
  </tiny-skeleton>
</template>

效果如下:

遥遥领先,OpenTiny Vue 3.14.0 正式发布,增加了 MindMap 思维导图等3个新组件

其中的 skeleton-item 目前支持3种形态 variant:

  • '':方形(默认)
  • 'circle':圆形
  • 'image':图片

有了细粒度模式,我们的 Skeleton 组件就有了无限的组合,可以自由拼接出任意形态的骨架屏。

更多 Skeleton 组件的功能,欢迎到 TinyVue 官网进行体验:opentiny.design/tiny-vue

Card 卡片

卡片组件也有不少朋友希望能支持,这也是个很常用的组件,由 @shenjunjian 提供。

效果如下:

遥遥领先,OpenTiny Vue 3.14.0 正式发布,增加了 MindMap 思维导图等3个新组件

Unplugin 自动导入插件

之前导入 TinyVue 组件主要有以下3种方式:

  • 多组件引入
<script setup lang="ts">
import { Button as TinyButton } from '@opentiny/vue'
</script>

<template>
  <tiny-button>确定</tiny-button>
</template>
  • 单组件引入

需要先安装对应的组件包:npm i @opentiny/vue-button

<script setup lang="ts">
import TinyButton from '@opentiny/vue-button'
</script>

<template>
  <tiny-button>确定</tiny-button>
</template>
  • 完整引入
import { createApp } from 'vue'
import TinyVue from '@opentiny/vue'

const app = createApp(App)
app.use(TinyVue)

参考 TinyVue 官网:引入组件

多组件引入目前是 TinyVue 官方推荐的方式,这种方式可以实现按需引入,但是需要手动在用到的地方引入组件。

单组件引入不仅需要在用到的地方引入组件,还需要手动安装该组件的软件包,非常麻烦,一般在只使用了少量 TinyVue 组件的场景下会使用。

完整引入虽然不需要手动引入组件,但是没法做到按需引入,官网不推荐使用。

业界组件库一般都会提供 unplugin 自动导入插件,开发者只需要在 vite/webpack 中配置下这个插件,就可以直接使用组件库中的组件,无需手动导入,并且组件是按需导入的,不会增加项目的产物包体积。

这给开发者提供了很大的便利,提升了 DX 体验,也有开发者给我们提交了增加 unplugin 支持的 Issue:#304,3周前,@mengqiuleo 实现了这个功能🎉。

开发者只需要在 vite/webpack 配置中加入以下代码(以 vite 为例):

需要先安装 unplugin 插件:npm i @opentiny/unplugin-tiny-vue

// vite.config.ts

import autoImportPlugin from '@opentiny/unplugin-tiny-vue'

export default defineConfig({
  plugins: [ vue(), autoImportPlugin() ]
})

之后开发者就可以在项目中直接使用 TinyVue 的组件,而无需导入。

<template>
  <tiny-button>确定</tiny-button>
</template>

贡献者招募

2024年,我们规划了很多新组件和新特性,欢迎朋友们一起参与共建。

可以在以下 discussion 进行任务认领:

TinyVue 2024年规划

目前还有以下新组件待实现:

还有以下新特性待实现:

另外我们也规划了很多工程优化方面的任务,用以提升项目开发的质量和效率,主要包含:

  • 完善组件的 TypeScript 类型声明 #370
  • 优化组件的 Demo/API 文档 #484
  • 完善 E2E 测试用例
  • 完善单元测试用例 #206
  • Pager 组件抽离 renderless 逻辑层
  • Grid 组件抽离 renderless 逻辑层
  • 完善英文网站
  • 完善 renderless 相关文档

如果你不满足于开发新特性,而是想独立负责一个完整的项目,探索一些新技术,我们也欢迎你一起参与进来,2024年我们将持续扩展组件库生态,主要包含:

  • 持续完善 TinyReact 组件库,完善 react-common 适配层,增加更丰富的组件模板
  • 适配 openInula 框架,增加 inula-common 适配层
  • 完善移动端组件库并部署官网,为 TinyEngine 低代码引擎提供移动端组件物料
  • 探索和扩展 Solid / Svelte 等新兴框架的组件库
  • 完善 TinyPro 后台管理系统 RuoYi-Vue
  • ⭐开发鸿蒙组件库 HarmonyOS Developer,鸿蒙操作系统是未来的趋势,如何让 TinyVue 的UI组件在鸿蒙操作系统上跑起来,为鸿蒙应用开发提效,丰富鸿蒙开源生态,也是我们未来计划探索的领域。

欢迎加入 OpenTiny 开源社区。

添加微信小助手:opentiny-official,一起参与共建!

开源不易,请给 TinyVue 点个 Star ⭐ 鼓励下,感谢你对我们 OpenTiny 的大力支持!

源码:github.com/opentiny/ti…

联系我们

GitHub:github.com/opentiny/ti…(欢迎 Star ⭐)

官网:opentiny.design/tiny-vue

B站:space.bilibili.com/15284299

公众号:OpenTiny

原文链接:https://juejin.cn/post/7347510186908581924 作者:Kagol

(0)
上一篇 2024年3月18日 下午5:05
下一篇 2024年3月18日 下午5:16

相关推荐

发表回复

登录后才能评论