来自京东的开源移动端 Vue 组件库 NutUI 2.0

[franslee]

NutUI 是一套来自京东用户体验设计部（ JDC ）前端开发部的移动端 Vue 组件库。NutUI 1.0 版本于 2018 年发布。

经过一段时间紧锣密鼓的开发，近期，我们正式发布了 NutUI 的 2.0 版。NutUI 2.0 定位于一个京东风格的移动端精品组件库，并不是 NutUI 1.x 的简单升级版。

（扫描二维码可以体验 NutUI 2.0 的组件示例）

• 官网： https://nutui.jd.com (PC 端)
• Github 仓库： https://github.com/jdf2e/nutui/

我们来看看 NutUI 2.0 有哪些重要的新特性。

京东 APP 7.0 视觉风格

NutUI 2.0 的组件在开发时参考了京东 APP 7.0 视觉规范，统一了视觉风格和动效。

如果与你需要的风格有差异，可以通过增加一个自定义 class 来调整样式。如果差异较大，可以替换掉整个组件的默认样式文件，既可达到修改样式的目的，又能减少被覆盖的冗余代码。

定制主题

NutUI 2.0 支持自定义组件库整体主题风格。通过在项目中重置一些样式变量的值，可轻而易举的实现组件换肤。

按需加载

NutUI 1.x 的按需加载是通过自定义构建的方式来实现的，虽可满足需求，但是让用户每次都进 node_modules 目录下找到 NutUI 项目目录安装依赖，再进行自定义构建多有不便。于是，2.0 版我们对组件的按需加载功能进行了重新设计。

使用 NutUI 2.0 的组件时，不必导入完整的组件库，直接在项目中引入我们需要的组件文件及其对应的样式文件即可。如：

import Button from '@nutui/nutui/dist/packages/button/button.js';
import '@nutui/nutui/dist/packages/button/button.css';

import Switch from '@nutui/nutui/dist/packages/switch/switch.js';
import '@nutui/nutui/dist/packages/Switch/switch.css';

不需要再进行自定义构建了，比 NutUI 1.x 方便不少吧。如果你觉得这种方式还不够方便或者不够优雅，也没关系，通过我们提供的 webpack 插件 @nutui/babel-plugin-separate-import ，还可以支持 ES6 module 风格的按需加载写法，且兼容不支持 ES6 module 语法的浏览器。如：

import { Button, Icon } from '@nutui/nutui';

安装插件也麻烦？不妨试试我们提供的一个 Vue 项目的构建工具 Gaea-cli，它可以快速生成一个已内置了这个插件的 Vue 模板工程，你可以直接基于这个工程开发项目。另外，这个构建工具还有很多高级功能，以及针对京东开发环境进行的特定优化，此前的系列版本已经过数十个项目的验证，还是比较稳定的。

国际化

NutUI 2.0 开始支持多语言。组件默认使用中文，可加载其他语言包来实现多语言切换功能。如果你的项目中已经使用了目前 Vue 生态里特别流行的国际化插件 vue-i18n 来实现项目的国际化功能，那么在使用 NutUI 2.0 组件的时候，也完全不需要担心，NutUI 2.0 的国际化功能是完全兼容 vue-i18n 插件的。

SVG 图标

SVG 图标较字体图标更灵活，更利于按需加载，也不会招致部分浏览器对其进行抗锯齿处理，清晰度高，结合 symbol 元素还可以实现 SVG 图标的复用。同时，SVG 图标在移动端的兼容性也是良好的。我们在 NutUI 1.x 时期就选择了 SVG 作为组件库的图标方案，而这种选择在 NutUI 2.0 版本获得了传承。

---

除了上述几点，NutUI 2.0 还有支持 TypeScript，支持 SSR 服务端渲染等特性。

全新架构

NutUI 2.0 基于全新的架构开发，并非基于 1.0 的架构升级而来。我们结合 1.0 的架构经验、2.0 的功能需求、工具的新变化、我厂的开发环境、主流优秀组件库的实现方案等因素，全新打造了 2.0 的架构。架构方面主要有以下特点：

• 基于 Webpack 4.0 开发，拥有更快的构建速度，输出更小的 bundle 文件
• 一次性构建出多种类型的 bundle，兼容各种主流模块化场景和非模块化引用场景
• 基于 Babel 7 实现了 Polyfill 的智能加载，无须额外引入 Babel-polyfill 文件也可兼容低版本浏览器
• Markdown 格式的文档便于书写和 Github 阅读，基于 MD 文件自动生成文档网站
• 示例页面 PWA 加持，支持离线缓存和创建主屏图标
• 接入持续化集成和自动化测试，提升代码可靠性
• 支持自动生成新组件模板
• 配套一个 webpack 插件和一个 Vue 模板工程构建工具（ Gaea 4.0)
• …

组件

组件库是个舞台，台上的主角不是组件库的功能和架构，而是组件。我们在组件开发上下了不少功夫，精心挑选和打磨了一批组件。NutUI 2.0 一期拥有组件三十多个，涉及“基础”、“布局”，“数据录入”、“操作反馈”、“数据展示”、“导航” 6 大类。

接下来，我们会集中精力继续新增一批组件，同时也会跟进对现有组件的打磨和维护。大家有什么通用组件的需求也可以反馈给我们。

---

NutUI 2.0 组件库没有埋任何彩蛋，大家尽管放心使用哦~

链接

• 官网： https://nutui.jd.com (PC 端)
• Github 仓库： https://github.com/jdf2e/nutui/
• 更新日志： https://github.com/jdf2e/nutui/releases
• 反馈建议： https://github.com/jdf2e/nutui/issues
• NutUI 按需加载插件： https://www.npmjs.com/package/@nutui/babel-plugin-separate-import
• Vue 模板工程构建工具： https://www.npmjs.com/package/gaea-cli
• 联系我们： [email protected]