{"id":13632907,"url":"https://github.com/dcloudio/uni-ui","last_synced_at":"2025-05-13T15:09:20.299Z","repository":{"id":37285605,"uuid":"160188343","full_name":"dcloudio/uni-ui","owner":"dcloudio","description":"基于uni-app的、全端兼容的、高性能UI框架","archived":false,"fork":false,"pushed_at":"2025-04-25T07:00:42.000Z","size":8866,"stargazers_count":1972,"open_issues_count":98,"forks_count":673,"subscribers_count":52,"default_branch":"master","last_synced_at":"2025-05-09T22:05:46.282Z","etag":null,"topics":["component","ui-kit","ui-library","uni-app","vue","vue-component","vue3"],"latest_commit_sha":null,"homepage":"https://uniapp.dcloud.io/component/uniui/uni-ui.html","language":"Vue","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/dcloudio.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2018-12-03T12:35:24.000Z","updated_at":"2025-05-07T04:55:58.000Z","dependencies_parsed_at":"2023-02-19T09:16:05.664Z","dependency_job_id":"4542f83d-72f9-45d1-96f5-3cafb476942c","html_url":"https://github.com/dcloudio/uni-ui","commit_stats":{"total_commits":2064,"total_committers":78,"mean_commits":26.46153846153846,"dds":0.6337209302325582,"last_synced_commit":"21bce101123dbbbb44493c7f813e4635cec3d5c0"},"previous_names":[],"tags_count":22,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/dcloudio%2Funi-ui","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/dcloudio%2Funi-ui/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/dcloudio%2Funi-ui/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/dcloudio%2Funi-ui/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/dcloudio","download_url":"https://codeload.github.com/dcloudio/uni-ui/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":253969239,"owners_count":21992262,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["component","ui-kit","ui-library","uni-app","vue","vue-component","vue3"],"created_at":"2024-08-01T22:03:26.884Z","updated_at":"2025-05-13T15:09:15.288Z","avatar_url":"https://github.com/dcloudio.png","language":"Vue","readme":"### [查看文档](https://uniapp.dcloud.io/component/uniui/uni-transition)\n#### 如使用过程中有任何问题，或者您对uni-ui有一些好的建议，欢迎加入 uni-ui 交流群：871950839 \n\n## uni-ui产品特点\n\n### 1. 高性能\n\n目前为止，在小程序和混合app领域，暂时还没有比 `uni-ui` 更高性能的框架。\n- 自动差量更新数据\n\n虽然uni-app支持小程序自定义组件，所有小程序的ui库都可以用。但小程序自定义组件的ui库都需要使用setData手动更新数据，在大数据量时、或高频更新数据时，很容易产生性能问题。\n\n而 `uni-ui` 属于vue组件，uni-app引擎底层自动diff更新数据。当然其实插件市场里众多vue组件都具备这个特点。\n- 优化逻辑层和视图层通讯折损\n\n非H5，不管是小程序还是App，不管是app的webview渲染还是原生渲染，全都是逻辑层和视图层分离的。这里就有一个逻辑层和视图层通讯的折损问题。\n比如在视图层拖动一个可跟手的组件，由于通讯的损耗，用js监听很难做到实时跟手。\n\n这时就需要使用css动画以及平台底层提供的wxs、bindingx等技术。不过这些技术都比较复杂，所以 `uni-ui` 里做了封装，在需要跟手式操作的ui组件，比如swiperaction列表项左滑菜单，就在底层使用了这些技术，实现了高性能的交互体验\n- 背景停止\n\n很多ui组件是会一直动的，比如轮播图、跑马灯。即便这个窗体被新窗体挡住，它在背景层仍然在消耗着硬件资源。在Android的webview版本为chrome66以上，背景操作ui会引发很严重的性能问题，造成前台界面明显卡顿。\n\n而 `uni-ui` 的组件，会自动判断自己的显示状态，在组件不再可见时，不会再消耗硬件资源。\n\n### 2. 全端\n\n `uni-ui` 的组件都是多端自适应的，底层会抹平很多小程序平台的差异或bug。\n\n比如导航栏navbar组件，会自动处理不同端的状态栏。\n比如swiperaction组件，在app和微信小程序上会使用交互体验更好的wxs技术，但在不支持wxs的其他小程序端会使用js模拟类似效果。\n\n `uni-ui` 还支持nvue原生渲染，[详见](https://github.com/dcloudio/uni-ui/tree/nvue-uni-ui)\n\n未来 `uni-ui` 还会支持pc等大屏设备。\n\n### 3. 与uni统计自动集成实现免打点\n\nuni统计是优秀的多端统计平台，见[tongji.dcloud.net.cn](https://tongji.dcloud.net.cn)。\n\n除了一张报表看全端，它的另一个重要特点是免打点。\n比如使用 `uni-ui` 的navbar标题栏、收藏、购物车等组件，均可实现自动打点，统计页面标题等各种行为数据。\n当然你也可以关闭uni统计，这不是强制的。\n\n### 4. 主题扩展\n\n `uni-ui` 支持[uni.scss](https://uniapp.dcloud.io/collocation/uni-scss)，可以方便的切换App的风格。\n\nui是一种需求非常发散的产品，DCloud官方也无意用 `uni-ui` 压制第三方ui插件的空间，但官方有义务在性能和多端方面提供一个开源的标杆给大家。\n\n我们欢迎更多优秀的ui组件出现，也欢迎更多人贡献 `uni-ui` 的主题风格，满足更多用户的需求。\n\n\n# 快速开始\n\n## 方式一：使用 uni_modules 安装（推荐）\n\n使用 `uni_modules` 方式安装组件库，可以直接通过插件市场导入，通过右键菜单快速更新组件，不需要引用、注册，直接在页面中使用 `uni-ui` 组件。[点击安装 uni-ui 组件库](https://ext.dcloud.net.cn/plugin?id=55)\n\n**注意：下载最新的组件目前仅支持 uni_modules ,非 uni_modules 版本最高支持到组件的1.2.10版本**\n\n如不能升级到 `uni_modules` 版本，可以使用 `uni_modules` 安装好对应组件，将组件拷贝到对应目录。\n\n例如需更新 `uni-list`和`uni-badge` ,将 `uni_modules\u003euni-list\u003ecomponents`和`uni_modules\u003euni-badege\u003ecomponents`下所有目录拷贝到如下目录即可：\n\n**目录示例**\n```json {2,3,4,5,6,7}\n┌─components              组件目录\n│  ├─uni-list             list 列表目录\n│  │  └─uni-list.vue      list 组件文件\n│  ├─uni-list-item        list-item 列表目录\n│  │  └─uni-list-item.vue list 组件文件\n│  ├─uni-badge         \t  badge 角标目录\n│  │  └─uni-badge.vue     badge 组件文件\n│  └─ //....              更多组件文件\n├─pages                   业务页面文件存放的目录\n│  ├─index\n│  │  └─index.vue         index示例页面\n├─main.js                 Vue初始化入口文件\n├─App.vue                 应用配置，用来配置App全局样式以及监听 应用生命周期\n├─manifest.json           配置应用名称、appid、logo、版本等打包信息，详见\n└─pages.json              配置页\n\n```\n\n\n## 方式二：使用 npm 安装\n\n在 `vue-cli` 项目中可以使用 `npm` 安装 `uni-ui` 库 ，或者直接在 `HBuilderX` 项目中使用 `npm` 。（不推荐后一种方式）\n\n\u003e **注意**\n\u003e cli 项目默认是不编译 `node_modules` 下的组件的，导致条件编译等功能失效 ，导致组件异常\n\u003e 需要在根目录创建 `vue.config.js` 文件 ，增加 `@dcloudio/uni-ui` 包的编译即可正常\n\u003e ```javascript\n\u003e // vue.config.js\n\u003e module.exports = {\n\u003e \t\ttranspileDependencies:['@dcloudio/uni-ui']\n\u003e }\n\u003e ```\n\n\n\n**准备 sass**\n\n`vue-cli` 项目请先安装 sass 及 sass-loader，如在 HBuliderX 中使用，可跳过此步。\n\n- 安装 sass\n```\n npm i sass -D   或   yarn add sass -D  \n```\n\n- 安装 sass-loader\n```\nnpm i sass-loader@10.1.1 -D   或   yarn add sass-loader@10.1.1 -D\n```\n\n\u003e sass-loader 请使用低于 @11.0.0 的版本，[sass-loader@11.0.0 不支持 vue@2.6.12 ](https://stackoverflow.com/questions/66082397/typeerror-this-getoptions-is-not-a-function)\n\n\n**安装 uni-ui**\n\n```\nnpm i @dcloudio/uni-ui   或   yarn add @dcloudio/uni-ui\n```\n\n\n\n在 ``script`` 中引用组件：\n\n```javascript\nimport {uniBadge} from '@dcloudio/uni-ui'\n//import uniBadge from '@dcloudio/uni-ui/lib/uni-badge/uni-badge.vue' //也可使用此方式引入组件\nexport default {\n    components: {uniBadge}\n}\n```\n\n\n在 ``template`` 中使用组件： \n\n```html\n\u003cuni-badge text=\"1\"\u003e\u003c/uni-badge\u003e\n\u003cuni-badge text=\"2\" type=\"success\" @click=\"bindClick\"\u003e\u003c/uni-badge\u003e\n\u003cuni-badge text=\"3\" type=\"primary\" :inverted=\"true\"\u003e\u003c/uni-badge\u003e\n```\n\u003e **注意**\n\u003e - `CLI` 引用方式， `H5` 端不支持在 `main.js` 中全局注册组件，如有需求请使用（[easyCom](https://uniapp.dcloud.io/collocation/pages?id=easycom)） 的方式引用组件\n\u003e - 使用 npm 安装的组件，默认情况下 babel-loader 会忽略所有 node_modules 中的文件 ，导致条件编译失效，需要通过配置 `vue.config.js` 解决：\n\u003e ```javascript\n\u003e // 在根目录创建 vue.config.js 文件，并配置如下\n\u003e module.exports = {\n\u003e \ttranspileDependencies: ['@dcloudio/uni-ui']\n\u003e }\n\u003e ```\n\n\n## 使用 npm + easycom \n\n使用 `npm` 安装好 `uni-ui` 之后，需要配置 `easycom` 规则，让 `npm` 安装的组件支持  `easycom`\n\n打开项目根目录下的 `pages.json` 并添加 `easycom` 节点：\n\n```javascript {8}\n// pages.json\n\n{\n\t\"easycom\": {\n\t\t\"autoscan\": true,\n\t\t\"custom\": {\n\t\t\t// uni-ui 规则如下配置\n\t\t\t\"^uni-(.*)\": \"@dcloudio/uni-ui/lib/uni-$1/uni-$1.vue\"\n\t\t}\n\t},\n\t\n\t// 其他内容\n\tpages:[\n\t\t// ...\n\t]\n}\n\n```\n\n### uni-ui 已支持的组件列表\n|组件名|组件说明|\n|---|---|\n|uni-badge|[数字角标](https://ext.dcloud.net.cn/plugin?name=uni-badge)|\n|uni-breadcrumb|[面包屑](https://ext.dcloud.net.cn/plugin?name=uni-breadcrumb)|\n|uni-calendar|[日历](https://ext.dcloud.net.cn/plugin?name=uni-calendar)|\n|uni-card|[卡片](https://ext.dcloud.net.cn/plugin?name=uni-card)|\n|uni-collapse|[折叠面板](https://ext.dcloud.net.cn/plugin?name=uni-collapse)|\n|uni-combox|[组合框](https://ext.dcloud.net.cn/plugin?name=uni-combox)|\n|uni-countdown|[倒计时](https://ext.dcloud.net.cn/plugin?name=uni-countdown)|\n|uni-data-checkbox|[数据选择器](https://ext.dcloud.net.cn/plugin?name=uni-data-checkbox)|\n|uni-data-picker|[数据驱动的picker选择器](https://ext.dcloud.net.cn/plugin?name=uni-data-picker)|\n|uni-data-select|[下拉框选择器](https://ext.dcloud.net.cn/plugin?name=uni-data-select)|\n|uni-dateformat|[日期格式化](https://ext.dcloud.net.cn/plugin?name=uni-dateformat)|\n|uni-datetime-picker|[日期选择器](https://ext.dcloud.net.cn/plugin?name=uni-datetime-picker)|\n|uni-drawer|[抽屉](https://ext.dcloud.net.cn/plugin?name=uni-drawer)|\n|uni-easyinput|[增强输入框](https://ext.dcloud.net.cn/plugin?name=uni-easyinput)|\n|uni-fab|[悬浮按钮](https://ext.dcloud.net.cn/plugin?name=uni-fab)|\n|uni-fav|[收藏按钮](https://ext.dcloud.net.cn/plugin?name=uni-fav)|\n|uni-file-picker|[文件选择上传](https://ext.dcloud.net.cn/plugin?name=uni-file-picker)|\n|uni-forms|[表单](https://ext.dcloud.net.cn/plugin?name=uni-forms)|\n|uni-goods-nav|[商品导航](https://ext.dcloud.net.cn/plugin?name=uni-goods-nav)|\n|uni-grid|[宫格](https://ext.dcloud.net.cn/plugin?name=uni-grid)|\n|uni-group|[分组](https://ext.dcloud.net.cn/plugin?name=uni-group)|\n|uni-icons|[图标](https://ext.dcloud.net.cn/plugin?name=uni-icons)|\n|uni-indexed-list|[索引列表](https://ext.dcloud.net.cn/plugin?name=uni-indexed-list)|\n|uni-link|[超链接](https://ext.dcloud.net.cn/plugin?name=uni-link)|\n|uni-list|[列表](https://ext.dcloud.net.cn/plugin?name=uni-list)|\n|uni-load-more|[加载更多](https://ext.dcloud.net.cn/plugin?name=uni-load-more)|\n|uni-nav-bar|[自定义导航栏](https://ext.dcloud.net.cn/plugin?name=uni-nav-bar)|\n|uni-notice-bar|[通告栏](https://ext.dcloud.net.cn/plugin?name=uni-notice-bar)|\n|uni-number-box|[数字输入框](https://ext.dcloud.net.cn/plugin?name=uni-number-box)|\n|uni-pagination|[分页器](https://ext.dcloud.net.cn/plugin?name=uni-pagination)|\n|uni-popup|[弹出层](https://ext.dcloud.net.cn/plugin?name=uni-popup)|\n|uni-rate|[评分](https://ext.dcloud.net.cn/plugin?name=uni-rate)|\n|uni-row|[布局-行](https://ext.dcloud.net.cn/plugin?name=uni-row)|\n|uni-scss|[辅助样式](https://ext.dcloud.net.cn/plugin?name=uni-scss)|\n|uni-search-bar|[搜索栏](https://ext.dcloud.net.cn/plugin?name=uni-search-bar)|\n|uni-section|[标题栏](https://ext.dcloud.net.cn/plugin?name=uni-section)|\n|uni-segmented-control|[分段器](https://ext.dcloud.net.cn/plugin?name=uni-segmented-control)|\n|uni-steps|[步骤条](https://ext.dcloud.net.cn/plugin?name=uni-steps)|\n|uni-swipe-action|[滑动操作](https://ext.dcloud.net.cn/plugin?name=uni-swipe-action)|\n|uni-swiper-dot|[轮播图指示点](https://ext.dcloud.net.cn/plugin?name=uni-swiper-dot)|\n|uni-table|[表格](https://ext.dcloud.net.cn/plugin?name=uni-table)|\n|uni-tag|[标签](https://ext.dcloud.net.cn/plugin?name=uni-tag)|\n|uni-title|[章节标题](https://ext.dcloud.net.cn/plugin?name=uni-title)|\n|uni-tooltip|[提示文字](https://ext.dcloud.net.cn/plugin?name=uni-tooltip)|\n|uni-transition|[过渡动画](https://ext.dcloud.net.cn/plugin?name=uni-transition)|\n\n\n### 其他\n\n- uni-ui 是全端兼容的基于flex布局的、无dom的ui库\n- uni-ui 是uni-app内置组件的扩展。注意与web开发不同，uni-ui不包括基础组件，它是基础组件的补充。web开发中有的开发者习惯用一个ui库完成所有开发，但在uni-app体系中，推荐开发者首先使用性能更高的基础组件，然后按需引入必要的扩展组件。\n\n\n\u003e **注意**\n\u003e - `uni-ui` 不支持使用 `Vue.use()` 的方式安装\n\n\n\n### 贡献代码\n在使用 `uni-ui` 中，如遇到无法解决的问题，请提 [Issues](https://github.com/dcloudio/uni-ui/issues) 给我们，假如您有更好的点子或更好的实现方式，也欢迎给我们提交 [PR](https://github.com/dcloudio/uni-ui/pulls)","funding_links":[],"categories":["Vue","跨平台多端应用前端框架uni-app一站式开发资源汇总 ![Awesome](https://cdn.rawgit.com/sindresorhus/awesome/d7305f38d29fed78fa85652e3a63e154dd8e8829/media/badge.svg)","UI 组件库"],"sub_categories":["uni-app开源组件"],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdcloudio%2Funi-ui","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fdcloudio%2Funi-ui","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdcloudio%2Funi-ui/lists"}