@gyenno/nutui-taro
Version:
京东风格的轻量级移动端 Vue2、Vue3 组件库（支持小程序开发）
227 lines (162 loc) • 9.1 kB
Markdown
<p align="center">
<img alt="logo" src="https://img11.360buyimg.com/imagetools/jfs/t1/211965/25/7152/22022/61b16785E433119bb/aa41d7a9f7e823f3.png" width="150" style="margin-bottom: 10px;">
</p>
<p align="center">京东风格的轻量级 Vue 组件库，支持移动端 H5 和 小程序开发</p>
<p align="center">
<a href="http://makeapullrequest.com">
<img src="https://img.shields.io/badge/PRs-welcome-brightgreen.svg?style=flat-square" alt="PRs Welcome">
</a>
<a href="https://github.com/jdf2e/nutui">
<img src="https://coveralls.io/repos/github/jdf2e/nutui/badge.svg?branch=master" alt="Coverage Status" />
</a>
<a href="https://github.com/jdf2e/nutui">
<img src="https://img.shields.io/npm/l/@nutui/nutui.svg" alt="license"/>
</a>
<a href="https://www.npmjs.com/package/@nutui/nutui">
<img src="https://img.shields.io/npm/v/@nutui/nutui.svg?style=flat-square">
</a>
<a href="https://www.npmjs.com/package/@nutui/nutui">
<img src="https://img.shields.io/npm/dt/@nutui/nutui.svg?style=flat-square">
</a>
<a href="https://travis-ci.org/jdf2e/nutui">
<img src="https://img.shields.io/travis/jdf2e/nutui.svg?style=flat-square">
</a>
</p>
<p align="center">
<a href="https://github.com/jdf2e/nutui">
<img src="https://img.shields.io/github/contributors/jdf2e/nutui" alt="GitHub contributors">
</a>
<a href="https://github.com/jdf2e/nutui">
<img src="https://img.shields.io/github/commit-activity/w/jdf2e/nutui" alt="GitHub commit activity">
</a>
<a href="https://github.com/jdf2e/nutui">
<img src="https://img.shields.io/github/issues-closed/jdf2e/nutui" alt="GitHub closed issues">
</a>
<a href="https://github.com/jdf2e/nutui">
<img src="https://img.shields.io/github/commits-since/jdf2e/nutui/latest/v4" alt="GitHub commits since latest release (by date)">
</a>
<a href="https://github.com/jdf2e/nutui">
<img src="https://img.shields.io/github/release-date/jdf2e/nutui" alt="GitHub Release Date">
</a>
</p>
<p align="center">
<img src="https://img12.360buyimg.com/imagetools/jfs/t1/162421/39/13392/9425/6052ea60E592310a9/264bdff23ef5fe95.png" width="164" alt="NutUI" />
<img src="https://img10.360buyimg.com/imagetools/jfs/t1/211804/23/22232/12144/634e4801Eac435cb6/cfd9e1773cf9423d.png" width="167" title="请用京东APP扫码">
<img src="https://storage.360buyimg.com/jdc-article/gh_f2231eb941be_258.jpg" width="166" title="请用微信扫码">
<img src="https://img12.360buyimg.com/imagetools/jfs/t1/205124/1/15643/30360/62aad730Ea5734bf9/703bb91a0b73282f.png" width="170" title="请用支付宝扫码">
</p>
---
> Nut[nʌt]，源自电影《冰河世纪》里松鼠 Scrat "执迷不悟"，一生追求，即便引发大灾难也绝不松手的坚果。
简体中文 | [English](./README_EN.md)
## 特性
* 🚀 70+ 高质量组件，覆盖移动端主流场景
* 💪 支持一套代码同时开发 H5+多端小程序
* 📖 基于京东APP 10.0 视觉规范
* 🍭 支持按需引用
* 📖 详尽的文档和示例
* 💪 支持 TypeScript
* 💪 支持服务端渲染（测试阶段）
* 🍭 支持组件级别定制主题，内置 700+ 个变量
* 🌍 国际化支持，已支持英文，印尼语和繁体中文
* 🍭 单元测试覆盖率超过 80%，保障稳定性
* 📖 提供 Sketch 设计资源
## 文档
官网：[nutui.jd.com](https://nutui.jd.com)
[@nutui/nutui](https://nutui.jd.com/h5/vue/4x/#/zh-CN/guide/intro)：适用于移动端 H5 页面开发
[@nutui/nutui-taro](https://nutui.jd.com/taro/vue/4x/#/zh-CN/guide/intro)：支持开发 Taro 多端小程序（微信、支付宝、京东等小程序）和 Taro-H5 项目
## 安装
```bash
// H5 项目
npm i @nutui/nutui
```
```bash
// Taro 小程序项目
npm i @nutui/nutui-taro
```
## 版本说明
目前 NutUI 有以下版本：
* NutUI 4.x，默认推荐版本，定期迭代更新发版。
* NutUI 3.x，长期维护版本，会同步 V4 版本问题修复，不对 API 做调整，不定期发版。
* NutUI 2.x，仅修复重要阻塞性问题，不定期发版。
## 示例
```js
import { createApp } from "vue"
import App from "./App.vue"
import NutUI from "@nutui/nutui"
import "@nutui/nutui/dist/style.css"
createApp(App).use(NutUI).mount("#app")
```
## 学习资源
[NutUI 实战快速入门](https://www.bilibili.com/video/BV14r4y1e7LK/?spm_id_from=333.999.0.0&vd_source=339cf5dcca71ec2905c729fd92bba8a9)
[awesome-nutui](https://github.com/jdf2e/nutui/blob/v4/awesome.md)
## 主题
我们提供了几套官方主题，来自京东内部实际业务，欢迎在项目中使用，如果不能满足需求，你也可以使用 ConfigProvider 组件自定义主题。
* <a href="https://nutui.jd.com/#/" target="_blank">京东APP视觉（Vue3，默认）</a>
* <a href="https://nutui.jd.com/h5/vue/4x/?jdb#/zh-CN/component/button" target="_blank">京东零售B商城主题（Vue3）</a>
* <a href="https://nutui.jd.com/h5/vue/4x/?jddkh#/zh-CN/component/button" target="_blank">京东企业业务主题（Vue3）</a>
* <a href="https://nutui.jd.com/jdt/#/zh-CN/guide/intro-jdt" target="_blank">京东科技视觉（Vue3，NutUI3.0）</a>
* <a href="https://nutui.jd.com/jdl/#/cell" target="_blank">京东物流视觉（Vue2，NutUI2.0）</a>
## 使用案例
NutUI 已经投入了我们的生产环境中使用，业界也在广泛地使用 NutUI 开发多端应用。
<p>
<img src="https://raw.githubusercontent.com/jdf2e/nutui-user-cases/master/user-cases.jpg" alt="NutUI" />
</p>
<p><a href="https://nutui.jd.com/#/case">更多案例</a></p>
<p><a href="https://get.jd.com/#/survey/index?id=4217247740034539">我们正在征集社区优秀案例，欢迎点击提交</a></p>
## 链接
<ul>
<li>
<a href="https://github.com/jdf2e/nutui/discussions">
Discussions (用👍投票)
</a>
</li>
<li>
<a href="https://github.com/jdf2e/nutui/issues?q=is%3Aissue+is%3Aopen+label%3A%22help+wanted%22">
Feature Requests (用👍投票)
</a>
</li>
<li>
<a href="https://github.com/jdf2e/nutui/labels/bug%203.0">
Bugs (用👍投票)
</a>
</li>
<li>
<a href="https://github.com/jdf2e/nutui/issues?q=is%3Aissue+is%3Aopen+label%3Aquestion">
Question (用👍投票)
</a>
</li>
</ul>
## 开发交流
| 版本 | 微信群 |内部咚咚群 |
| --- | --- |--- |
| [NutUI Vue](https://github.com/jdf2e/nutui/issues) | <img src="https://storage.360buyimg.com/nutui-static/image/wx-code.png" width="100" /> 回复「NutUI」 | 82957939
| [NutUI x Taro](https://github.com/jdf2e/nutui/issues) | <img src="https://camo.githubusercontent.com/db4276b4ee4b443158195e943e9e678cb4d2afb7580f70d4d817ef0a90413aec/687474703a2f2f73746f726167652e333630627579696d672e636f6d2f7461726f2d6a642d636f6d2f7374617469632f636f6e746163745f7461726f5f6e757475695f71722e706e67" width="100" /> 回复「NutUI」 | 1022545110 |
## 参与共建
#### NutUI 社区共建倡议
[NutUI 邀您共建，Contributor 您好](https://github.com/jdf2e/nutui/issues/1789)
#### 为 NutUI 贡献代码
NutUI 的共建方向主要分为：解决 issue、修复 bug、新增组件、增加国际化、UI 定制、平台适配、跨端扩展等。
欢迎社区开发者参与共建，在贡献您的代码之前请先阅读 [《NutUI 贡献指南》](https://github.com/jdf2e/nutui/issues/1671)。
## 问题反馈与建议
[给 NutUI 提 Issue](https://nutui.jd.com/nutui-issue-helper/?repo=jdf2e/nutui&lang=zh-cn)
> 在反馈问题之前，推荐阅读 [《提问的智慧》](https://github.com/ryanhanwu/How-To-Ask-Questions-The-Smart-Way)、[《如何向开源社区提问题》](https://github.com/seajs/seajs/issues/545)和[《如何有效地报告 Bug》](http://www.chiark.greenend.org.uk/%7Esgtatham/bugs-cn.html)，这样您能够更容易获得理解和帮助。
[参与 NutUI 社区讨论](https://github.com/jdf2e/nutui/discussions)
如果您有任何想法、疑问或建议，都可以参与社区讨论分享您的观点。
## 贡献者们
感谢以下所有给 NutUI 贡献过代码的 [开发者](https://github.com/jdf2e/nutui/graphs/contributors)。
<a href="https://github.com/jdf2e/nutui/graphs/contributors">
<img src="https://opencollective.com/nutui/contributors.svg?width=890&button=false" alt="contributors">
</a>
## Stargazers
[](https://github.com/jdf2e/nutui/stargazers)
## Forkers
[](https://github.com/jdf2e/nutui/network/members)
## 开发计划
[Milestones](https://github.com/jdf2e/nutui/projects)
## 更新日志
本项目遵从 [Angular Style Commit Message Conventions](https://gist.github.com/stephenparish/9941e89d80e2bc58a153)，更新日志请查阅 [Release](https://github.com/jdf2e/nutui/releases)。
## github stargazers
