https://github.com/jaredtao/taoquick

a cool QtQuick component library (一套酷炫的QtQuick基础库)
https://github.com/jaredtao/taoquick

appveyor i18n qml qt qt5 qtquick qtquick-controls2 shadertoy skin-changer travis

Last synced: 22 days ago
JSON representation

a cool QtQuick component library (一套酷炫的QtQuick基础库)

• Host: GitHub
• URL: https://github.com/jaredtao/taoquick
• Owner: jaredtao
• License: mit
• Created: 2019-04-24T12:18:47.000Z (about 6 years ago)
• Default Branch: master
• Last Pushed: 2025-02-12T04:04:43.000Z (4 months ago)
• Last Synced: 2025-04-11T20:43:52.827Z (about 2 months ago)
• Topics: appveyor, i18n, qml, qt, qt5, qtquick, qtquick-controls2, shadertoy, skin-changer, travis
• Language: QML
• Homepage:
• Size: 40.8 MB
• Stars: 1,451
• Watchers: 45
• Forks: 375
• Open Issues: 9
• Metadata Files:
  • Readme: README-zh.md
  • License: LICENSE

Awesome Lists containing this project

README

        
[English](README.md)

[github原始仓库https://github.com/jaredtao/TaoQuick](https://github.com/jaredtao/TaoQuick)

[gitee镜像仓库https://gitee.com/jaredtao/TaoQuick](https://gitee.com/jaredtao/TaoQuick)

-------------------------------------------------------------

# 目录

- [目录](#目录)

- [TaoQuick](#taoquick)

- [徽章预览](#徽章预览)

  - [项目](#项目)

  - [Qt 官方商城](#qt-官方商城)

  - [编译](#编译)

  - [发布](#发布)

  - [仓库状态](#仓库状态)

  - [Issue](#issue)

  - [其它状态](#其它状态)

- [部分效果预览](#部分效果预览)

  - [主页](#主页)

  - [换皮肤](#换皮肤)

  - [多语言](#多语言)

  - [各种按钮组件](#各种按钮组件)

  - [数据输入组件](#数据输入组件)

  - [表格组件](#表格组件)

  - [带选项卡的列表](#带选项卡的列表)

  - [Edge浏览器选项卡](#edge浏览器选项卡)

  - [矩形框组件](#矩形框组件)

  - [用户向导](#用户向导)

  - [鼠标点击特效](#鼠标点击特效)

  - [Atom 摇摆](#atom-摇摆)

  - [ShaderToy-蜗牛](#shadertoy-蜗牛)

  - [ShaderToy-超级玛丽](#shadertoy-超级玛丽)

- [开发环境](#开发环境)

- [项目结构](#项目结构)

- [核心库 TaoQuick](#核心库-taoquick)

- [使用核心库TaoQuick](#使用核心库taoquick)

- [联系作者](#联系作者)

- [寻找同道中人](#寻找同道中人)

- [赞助](#赞助)

- [赞助列表](#赞助列表)

  

# TaoQuick

这是一个QtQuick/Qml组件库，集成了常用的QtQuick组件，并做了适当的属性封装、功能扩展，以方便开发Qml程序。

实现原理可以参考《玩转Qml》系列教程，以下网站都有收录:

[涛哥的博客](https://jaredtao.github.io)

[涛哥的博客-国内镜像](https://jaredtao.gitee.io)

# 徽章预览

## 项目

|[最佳实践计划][CII-link]|[许可][license-link]|

|:--:|:--:|

|![CII-badge]|![license-badge]|

[CII-badge]: https://bestpractices.coreinfrastructure.org/projects/3060/badge

[CII-link]: https://bestpractices.coreinfrastructure.org/projects/3060

[license-link]: https://github.com/jaredtao/TaoQuick/blob/master/LICENSE "LICENSE"

[license-badge]: https://img.shields.io/badge/license-MIT-blue.svg "MIT"

## Qt 官方商城

TaoQuick项目已同步在Qt官方商城上架

https://marketplace.qt.io/collections/newest/products/taoquick

## 编译

| [Windows][win-link]| [Ubuntu][ubuntu-link]|[MacOS][macos-link]|[Android][android-link]|[IOS][ios-link]|

|---------------|---------------|-----------------|-----------------|----------------|

| ![win-badge]  | ![ubuntu-badge]      | ![macos-badge] |![android-badge]   |![ios-badge]   |

[win-link]: https://github.com/JaredTao/TaoQuick/actions?query=workflow%3AWindows "WindowsAction"

[win-badge]: https://github.com/JaredTao/TaoQuick/workflows/Windows/badge.svg  "Windows"

[ubuntu-link]: https://github.com/JaredTao/TaoQuick/actions?query=workflow%3AUbuntu "UbuntuAction"

[ubuntu-badge]: https://github.com/JaredTao/TaoQuick/workflows/Ubuntu/badge.svg "Ubuntu"

[macos-link]: https://github.com/JaredTao/TaoQuick/actions?query=workflow%3AMacOS "MacOSAction"

[macos-badge]: https://github.com/JaredTao/TaoQuick/workflows/MacOS/badge.svg "MacOS"

[android-link]: https://github.com/JaredTao/TaoQuick/actions?query=workflow%3AAndroid "AndroidAction"

[android-badge]: https://github.com/JaredTao/TaoQuick/workflows/Android/badge.svg "Android"

[ios-link]: https://github.com/JaredTao/TaoQuick/actions?query=workflow%3AIOS "IOSAction"

[ios-badge]: https://github.com/JaredTao/TaoQuick/workflows/IOS/badge.svg "IOS"

## 发布

|[已发布][release-link]|[下载][download-link]|下载次数|

|:--:|:--:|:--:|

|![release-badge] |![download-badge]|![download-latest]|

[release-link]: https://github.com/jaredtao/TaoQuick/releases "Release status"

[release-badge]: https://img.shields.io/github/release/jaredtao/TaoQuick.svg?style=flat-square "Release status"

[download-link]: https://github.com/jaredtao/TaoQuick/releases/latest "Download status"

[download-badge]: https://img.shields.io/github/downloads/jaredtao/TaoQuick/total.svg "Download status"

[download-latest]: https://img.shields.io/github/downloads/jaredtao/TaoQuick/latest/total.svg "latest status"

## 仓库状态

|最新标签|用到的编程语言数量|用最多的编程语言|代码大小|仓库大小|

|:--: |:--: |:--:|:--:|:--:|

|![tag-latest]|![languanges]|![taolanguage]|![code-size]|![repo-size]|

[languanges]: https://img.shields.io/github/languages/count/jaredtao/taoquick.svg "language count"

[taolanguage]: https://img.shields.io/github/languages/top/jaredtao/taoquick.svg "top language"

[code-size]: https://img.shields.io/github/languages/code-size/jaredtao/taoquick.svg "code size"

[repo-size]: https://img.shields.io/github/repo-size/jaredtao/taoquick.svg "repo-size"

[tag-latest]: https://img.shields.io/github/tag/jaredtao/taoquick.svg

## Issue

|[Issues][issues-link]|关掉的issue|pull请求|关掉的pull|

|:--:|:--:|:--:|:--:|

|![issuse-badge]|![issue-closed]|![pull-request]|![pull-closed]|

[issues-link]: https://github.com/jaredtao/TaoQuick/issues 

[issuse-badge]: https://img.shields.io/github/issues/jaredtao/taoquick.svg?style=popout 

[issue-closed]: https://img.shields.io/github/issues-closed/jaredtao/taoquick.svg

[pull-request]: https://img.shields.io/github/issues-pr/jaredtao/taoquick.svg

[pull-closed]: https://img.shields.io/github/issues-pr-closed/jaredtao/taoquick.svg

## 其它状态

|提交频率|最后一次提交|发布时间|forks|stars|

|:--:|:--:|:--:|:--:|:--:|

|![commit-active]|![commit-latest]|![release-date]|![forks-badge]|![stars-badge]|

[forks-badge]: https://img.shields.io/github/forks/jaredtao/taoquick.svg "forks"

[stars-badge]: https://img.shields.io/github/stars/jaredtao/taoquick.svg "stars"

[commit-active]: https://img.shields.io/github/commit-activity/w/jaredtao/taoquick.svg

[commit-latest]: https://img.shields.io/github/last-commit/jaredtao/taoquick.svg

[release-date]: https://img.shields.io/github/release-date/jaredtao/taoquick.svg

# 部分效果预览

## 主页

![](preview/main.png)

## 换皮肤

![](preview/skin.png)

## 多语言

![](preview/I18n.png)

## 各种按钮组件

![](preview/Buttons.png)

## 数据输入组件

![](preview/Data.png)

## 表格组件

![](preview/Table.png)

## 带选项卡的列表

![](preview/ListViewWithTab.gif)

## Edge浏览器选项卡

![](preview/EdgeTab.gif)

## 矩形框组件

![](preview/rect.png)

## 用户向导

![](preview/wizard.png)

![](preview/wizard.gif)

## 鼠标点击特效

![](preview/ClickShow.gif)

## Atom 摇摆

![](preview/AtomJoggle.gif)

## ShaderToy-蜗牛

![](preview/snail.png)

## ShaderToy-超级玛丽

![](preview/SuperMario.png)

# 开发环境

* Qt 5.9

* Qt 5.12

* Qt 5.15

* Qt6.2 (在分支 qt6)

# 项目结构

项目结构如下

![](doc/struct1.png)

各目录说明如下表：

|目录|说明|备注|

|----|----|----|

|src|TaoQuick核心库|主要是qml代码和图片资源,以及designer支持相关的配置和脚本,不包含c++代码|

|exampes|各种示例程序|演示如何使用TaoQuick核心库,其中TaoQuickShow比较全面地展示TaoQuick的各项功能|

|3rdparty|第三方库||

|mkspecs|qmake功能的扩展||

|.github|github-actions配置|持续集成相关配置，用于自动化构建、发布|

# 核心库 TaoQuick

核心库目录为

src/TaoQuick/Qml

核心库结构如下

![](doc/core.png)

为了避免与Qt默认组件混淆，组件名称全部以Cus开头 (Custom的缩写)

CusConfig是核心库的全局配置,主要包括字体、颜色等,所有组件都按照此配置显示

其它各目录说明如下表：

|目录|说明|备注|

|----|----|----|

|Basic|基础的组件，诸如文本、悬浮提示等|用于统一整个工程中的基础组件，方便在工程变的庞大时，做全局替换|

|CusBackground|一个简单的背景框|一般放在程序的最开始，用来吸收空白区域的鼠标焦点|

|CusButton|按钮|已封装一部分经常用到的按钮，也可以二次定制各种效果|

|CusCheckBox|勾选||

|CusComboBox|下拉框||

|CusImage|基础的图像||

|CusInput|输入框||

|CusLabel|文本标签||

|CusListView|列表|简单的定制了滚动条|

|CusPopup|弹出框||

|CusScroll|滚动条||

|CusSlider|可拖动进度条||

|CusSpinBox|调节框||

|CusTable|表格|需要配合特定的C++ model使用,支持以行为单位的选中、打勾、鼠标框选、反选、连选、全选等|

|Effect|特效|动画、页面切换效果、ShaderToy等|

|Misc|其它杂项||

# 使用核心库TaoQuick 

详细的使用方法及示例，可以阅读 [入门指南](入门指南.md)

# 联系作者

作者：武威的涛哥

欢迎联系我，乐于提供技术咨询服务，可洽谈技术支持、商业合作。

QQ: 759378563

邮箱:  [email protected]            



*****

# 寻找同道中人

欢迎加入涛哥的QQ群: Qt进阶之路 

此群是高质量群，Qt界大佬众多，不灌水闲聊，日常交流技术、分享书籍、帮助解决实际问题。

1群：734623697

2群：342341405



******

# 赞助

 觉得分享的内容还不错, 就请作者喝杯奶茶吧~~



# 赞助列表

感谢以下网友的赞助与支持(排名不分先后)：

hxhlb (花心胡萝卜工作室)

咸鱼猴

Qt侠-刘典武

一去、二三里

大樹

丝绸-郑天佐

寒山-居士

小风电子

Qt君

海盗船

雨田哥

游龙

Rj

重庆-胡某某

Ivy

孙十一少

田宇

power

敢敢

扣脚翁

白菜豆腐

甜不辣

Mr.Hu

秾芳教主

焖哥

蓝色幻想

Martin Zuo

windsmoon

小手冰凉

永远=没有终点

我是王大狗

米粒旅行

...