@digitalc/dxp-ui 0.0.4 → 0.0.5-alpha.10

package/README.md

@@ -4,12 +4,15 @@ React Component.
 
 ## Feature
 
-- React life cycle support @digitalc/dxp-ui component
+- React life cycle support [@digitalc/dxp-ui](https://www.npmjs.com/package/@digitalc/dxp-ui) component
+目前计划是提供基于antd5的基础组件库，分别 支持 TM、esales、GOMO 不同风格，后续提供全量定业务组件库。即可不用使用第三方组件，快速切换组件风格，同时支持业务组件库，方便业务组件二次开发。
 
 ## Install
 
 ```bash | pure
 npm install @digitalc/dxp-ui
+//  目前版本不稳定，推荐用官方源安装，如果其他源安装失败，可以设置 npm 的镜像源。
+npm config set registry https://registry.npmjs.org/
 ```
 
 ## Usage
@@ -17,22 +20,157 @@ npm install @digitalc/dxp-ui
 <!-- prettier-ignore -->
 ```tsx | pure
 import { Button } from '@digitalc/dxp-ui';
+// 后续完善打包工具后，会自动引入样式，目前如果样式不对的情况下，需要手动引入样式。
 import "@digitalc/dxp-ui/umd/dxp-ui.min.css"
 
 const Demo = () => {
-
     return (
-        <div style={{ margin: 20 }}>
-            <div>
-                <Button>
-                    Create Button
-                </Button>
-              </div>
-
-            <div style={{ height: 200 }} />
-        </div>
+        <>
+          <Button type="primary" className="abac">
+            Primary Button
+          </Button>
+
+          <Button>Default Button</Button>
+
+          <Button disabled>Disabled Button</Button>
+
+          <Button inverse type="primary">
+            inverse  Button
+          </Button>
+        </>
     );
 };
 
 export default Demo;
 ```
+
+注意：
+如果是使用的 Umi4、Vite 5 和 Turbopack 将原生支持智能样式编译的（：内置各种语言预处理工具），可以直接引用即可。
+
+但如果是 使用的 webpack 或 umi3 脚手架的前端项目，需要在内部的 webpack 配置less编译。（因为包是esm格式，并支持了按需加载，所以没编译less文件），具体是通过 webpack-chain 添加指定的包，并进行构建。
+
+```
+  chainWebpack(memo, { webpack, env }) {
+    // 额外 处理 dxp-ui-less...  需要安装 less-loader： npm install less-loader --save-dev
+
+     代码在下面，第4条。
+
+  }
+```
+
+## 兼容 @digitalc/dxp-ui 组件库
+
+dxp-ui 使用了 antd5 做二次开发，但在"umi": "^3.x"项目中，已有组件库版本是 antd 4.x。
+底层依赖的版本与4有差异，编译时会报错，所以需要兼容 @digitalc/dxp-ui 组件库。
+
+整体兼容方案如下：
+
+### 1、安装两个版本npm
+
+如果必须需要用到 antd4 版本,可以看这篇 antd 多版本共存：
+https://ant-design.antgroup.com/docs/react/migration-v5-cn
+
+5.0 有哪些不兼容的变化: https://ant-design.antgroup.com/docs/react/migration-v5-cn
+
+```bash
+在 package.json 文件，添加以下内容，并执行 npm install ：
+"@digitalc/dxp-ui": "^0.0.5-alpha.6",
+"antd": "^5.24.5",
+"antd4": "npm:antd@4.24.16", // 兼容 antd4 ，但需要把 antd 前缀让出来。
+```
+
+### 2、在 umi.config.ts 中配置以下代码：
+
+```js
+export default {
+  antd: false, // 关闭 antd 的默认载入
+  esbuild: {},
+  // nodeModulesTransform: {
+  //   type: 'none',
+  // },
+};
+```
+
+替换压缩器为 esbuild这一步是因为比 webpack 快,非强制，如果开启，需要安装依赖。
+
+```bash
+$ yarn add @umijs/plugin-esbuild
+```
+
+默认会处理 node_modules 中的代码，这个打开后就不会处理 node_modules 中的代码，导致打包格式不对。 Umi 以下配置不要打开（必须关闭）)。
+
+```js
+// nodeModulesTransform: {
+//   type: 'none',
+// },
+```
+
+### 3、在 根 BaseLayout.jsx 中，引入 ConfigProvider，将 children 用 ConfigProvider 包裹。
+
+```js
+import { ConfigProvider as Antd5ConfigProvider } from 'antd';
+
+// antd5 配置前缀，防止与 antd4 css 冲突
+<Antd5ConfigProvider
+  prefixCls={'ant5'}
+  theme={{
+    cssVar: true,
+    hashed: false,
+  }}
+>
+  {children}
+</Antd5ConfigProvider>;
+```
+
+### 4、正常情况下，已经可用了，不需要配置额外操作（也不需要将之前的antd，改成antd4，直接用5覆盖，具体修改内容：看下v4 to v5 升级指南）。
+
+```js
+import { Button as AntdBtn4 } from 'antd4';
+import { Button as AntdBtn5 } from 'antd';
+import { Button, IconButton, IconButtonGroup, Toast, Stepper } from '@digitalc/dxp-ui';
+
+
+<Button type="primary">Primary Button</Button>
+<AntdBtn4>antd4 Button</AntdBtn4>
+<AntdBtn5>antd5 Button</AntdBtn5>
+
+
+```
+
+示例图：
+
+![image.png](https://p.ipic.vip/xa5nz7.png)
+
+改完后，尽量对项目做全量测试。
+如果出现 less 格式不对，则需要做额外处理。
+
+原因是使用的 Umi4、Vite 5 和 Turbopack 将原生支持智能样式编译的（：内置各种语言预处理工具），可以直接引用即可。
+
+但如果是使用的 webpack 或 umi3 脚手架的前端项目，需要在内部的 webpack 配置less编译。（因为包是esm格式，并支持了按需加载，所以没编译less文件），具体是通过 webpack-chain 添加指定的包，并进行构建。
+
+```bash
+  chainWebpack(memo, { webpack, env }) {
+    // 额外 处理 dxp-ui-less...  需要安装 less-loader： npm install less-loader --save-dev
+    memo.module
+      .rule('dxp-ui-less')
+      .test(/\.less$/)
+      .include.add(/node_modules[\\/]@digitalc[\\/]dxp-ui/) // 替换为你的包名（如 antd-mobile）
+      .end()
+      .use('less-loader')
+      .loader('less-loader')
+      .options({
+        lessOptions: {
+          javascriptEnabled: true,
+          // 可选：覆盖变量
+          modifyVars: {
+            'primary-color': '#1890ff',
+          },
+          // 其他自定义变量...
+        },
+      });
+  }
+```
+
+end。
+
+<img src="https://p.ipic.vip/xa5nz7.png" width="880" />

package/es/assets/iconFont/demo.css

@@ -0,0 +1,539 @@
+/* Logo 字体 */
+@font-face {
+  font-family: "iconfont logo";
+  src: url('https://at.alicdn.com/t/font_985780_km7mi63cihi.eot?t=1545807318834');
+  src: url('https://at.alicdn.com/t/font_985780_km7mi63cihi.eot?t=1545807318834#iefix') format('embedded-opentype'),
+    url('https://at.alicdn.com/t/font_985780_km7mi63cihi.woff?t=1545807318834') format('woff'),
+    url('https://at.alicdn.com/t/font_985780_km7mi63cihi.ttf?t=1545807318834') format('truetype'),
+    url('https://at.alicdn.com/t/font_985780_km7mi63cihi.svg?t=1545807318834#iconfont') format('svg');
+}
+
+.logo {
+  font-family: "iconfont logo";
+  font-size: 160px;
+  font-style: normal;
+  -webkit-font-smoothing: antialiased;
+  -moz-osx-font-smoothing: grayscale;
+}
+
+/* tabs */
+.nav-tabs {
+  position: relative;
+}
+
+.nav-tabs .nav-more {
+  position: absolute;
+  right: 0;
+  bottom: 0;
+  height: 42px;
+  line-height: 42px;
+  color: #666;
+}
+
+#tabs {
+  border-bottom: 1px solid #eee;
+}
+
+#tabs li {
+  cursor: pointer;
+  width: 100px;
+  height: 40px;
+  line-height: 40px;
+  text-align: center;
+  font-size: 16px;
+  border-bottom: 2px solid transparent;
+  position: relative;
+  z-index: 1;
+  margin-bottom: -1px;
+  color: #666;
+}
+
+
+#tabs .active {
+  border-bottom-color: #f00;
+  color: #222;
+}
+
+.tab-container .content {
+  display: none;
+}
+
+/* 页面布局 */
+.main {
+  padding: 30px 100px;
+  width: 960px;
+  margin: 0 auto;
+}
+
+.main .logo {
+  color: #333;
+  text-align: left;
+  margin-bottom: 30px;
+  line-height: 1;
+  height: 110px;
+  margin-top: -50px;
+  overflow: hidden;
+  *zoom: 1;
+}
+
+.main .logo a {
+  font-size: 160px;
+  color: #333;
+}
+
+.helps {
+  margin-top: 40px;
+}
+
+.helps pre {
+  padding: 20px;
+  margin: 10px 0;
+  border: solid 1px #e7e1cd;
+  background-color: #fffdef;
+  overflow: auto;
+}
+
+.icon_lists {
+  width: 100% !important;
+  overflow: hidden;
+  *zoom: 1;
+}
+
+.icon_lists li {
+  width: 100px;
+  margin-bottom: 10px;
+  margin-right: 20px;
+  text-align: center;
+  list-style: none !important;
+  cursor: default;
+}
+
+.icon_lists li .code-name {
+  line-height: 1.2;
+}
+
+.icon_lists .icon {
+  display: block;
+  height: 100px;
+  line-height: 100px;
+  font-size: 42px;
+  margin: 10px auto;
+  color: #333;
+  -webkit-transition: font-size 0.25s linear, width 0.25s linear;
+  -moz-transition: font-size 0.25s linear, width 0.25s linear;
+  transition: font-size 0.25s linear, width 0.25s linear;
+}
+
+.icon_lists .icon:hover {
+  font-size: 100px;
+}
+
+.icon_lists .svg-icon {
+  /* 通过设置 font-size 来改变图标大小 */
+  width: 1em;
+  /* 图标和文字相邻时，垂直对齐 */
+  vertical-align: -0.15em;
+  /* 通过设置 color 来改变 SVG 的颜色/fill */
+  fill: currentColor;
+  /* path 和 stroke 溢出 viewBox 部分在 IE 下会显示
+      normalize.css 中也包含这行 */
+  overflow: hidden;
+}
+
+.icon_lists li .name,
+.icon_lists li .code-name {
+  color: #666;
+}
+
+/* markdown 样式 */
+.markdown {
+  color: #666;
+  font-size: 14px;
+  line-height: 1.8;
+}
+
+.highlight {
+  line-height: 1.5;
+}
+
+.markdown img {
+  vertical-align: middle;
+  max-width: 100%;
+}
+
+.markdown h1 {
+  color: #404040;
+  font-weight: 500;
+  line-height: 40px;
+  margin-bottom: 24px;
+}
+
+.markdown h2,
+.markdown h3,
+.markdown h4,
+.markdown h5,
+.markdown h6 {
+  color: #404040;
+  margin: 1.6em 0 0.6em 0;
+  font-weight: 500;
+  clear: both;
+}
+
+.markdown h1 {
+  font-size: 28px;
+}
+
+.markdown h2 {
+  font-size: 22px;
+}
+
+.markdown h3 {
+  font-size: 16px;
+}
+
+.markdown h4 {
+  font-size: 14px;
+}
+
+.markdown h5 {
+  font-size: 12px;
+}
+
+.markdown h6 {
+  font-size: 12px;
+}
+
+.markdown hr {
+  height: 1px;
+  border: 0;
+  background: #e9e9e9;
+  margin: 16px 0;
+  clear: both;
+}
+
+.markdown p {
+  margin: 1em 0;
+}
+
+.markdown>p,
+.markdown>blockquote,
+.markdown>.highlight,
+.markdown>ol,
+.markdown>ul {
+  width: 80%;
+}
+
+.markdown ul>li {
+  list-style: circle;
+}
+
+.markdown>ul li,
+.markdown blockquote ul>li {
+  margin-left: 20px;
+  padding-left: 4px;
+}
+
+.markdown>ul li p,
+.markdown>ol li p {
+  margin: 0.6em 0;
+}
+
+.markdown ol>li {
+  list-style: decimal;
+}
+
+.markdown>ol li,
+.markdown blockquote ol>li {
+  margin-left: 20px;
+  padding-left: 4px;
+}
+
+.markdown code {
+  margin: 0 3px;
+  padding: 0 5px;
+  background: #eee;
+  border-radius: 3px;
+}
+
+.markdown strong,
+.markdown b {
+  font-weight: 600;
+}
+
+.markdown>table {
+  border-collapse: collapse;
+  border-spacing: 0px;
+  empty-cells: show;
+  border: 1px solid #e9e9e9;
+  width: 95%;
+  margin-bottom: 24px;
+}
+
+.markdown>table th {
+  white-space: nowrap;
+  color: #333;
+  font-weight: 600;
+}
+
+.markdown>table th,
+.markdown>table td {
+  border: 1px solid #e9e9e9;
+  padding: 8px 16px;
+  text-align: left;
+}
+
+.markdown>table th {
+  background: #F7F7F7;
+}
+
+.markdown blockquote {
+  font-size: 90%;
+  color: #999;
+  border-left: 4px solid #e9e9e9;
+  padding-left: 0.8em;
+  margin: 1em 0;
+}
+
+.markdown blockquote p {
+  margin: 0;
+}
+
+.markdown .anchor {
+  opacity: 0;
+  transition: opacity 0.3s ease;
+  margin-left: 8px;
+}
+
+.markdown .waiting {
+  color: #ccc;
+}
+
+.markdown h1:hover .anchor,
+.markdown h2:hover .anchor,
+.markdown h3:hover .anchor,
+.markdown h4:hover .anchor,
+.markdown h5:hover .anchor,
+.markdown h6:hover .anchor {
+  opacity: 1;
+  display: inline-block;
+}
+
+.markdown>br,
+.markdown>p>br {
+  clear: both;
+}
+
+
+.hljs {
+  display: block;
+  background: white;
+  padding: 0.5em;
+  color: #333333;
+  overflow-x: auto;
+}
+
+.hljs-comment,
+.hljs-meta {
+  color: #969896;
+}
+
+.hljs-string,
+.hljs-variable,
+.hljs-template-variable,
+.hljs-strong,
+.hljs-emphasis,
+.hljs-quote {
+  color: #df5000;
+}
+
+.hljs-keyword,
+.hljs-selector-tag,
+.hljs-type {
+  color: #a71d5d;
+}
+
+.hljs-literal,
+.hljs-symbol,
+.hljs-bullet,
+.hljs-attribute {
+  color: #0086b3;
+}
+
+.hljs-section,
+.hljs-name {
+  color: #63a35c;
+}
+
+.hljs-tag {
+  color: #333333;
+}
+
+.hljs-title,
+.hljs-attr,
+.hljs-selector-id,
+.hljs-selector-class,
+.hljs-selector-attr,
+.hljs-selector-pseudo {
+  color: #795da3;
+}
+
+.hljs-addition {
+  color: #55a532;
+  background-color: #eaffea;
+}
+
+.hljs-deletion {
+  color: #bd2c00;
+  background-color: #ffecec;
+}
+
+.hljs-link {
+  text-decoration: underline;
+}
+
+/* 代码高亮 */
+/* PrismJS 1.15.0
+https://prismjs.com/download.html#themes=prism&languages=markup+css+clike+javascript */
+/**
+ * prism.js default theme for JavaScript, CSS and HTML
+ * Based on dabblet (http://dabblet.com)
+ * @author Lea Verou
+ */
+code[class*="language-"],
+pre[class*="language-"] {
+  color: black;
+  background: none;
+  text-shadow: 0 1px white;
+  font-family: Consolas, Monaco, 'Andale Mono', 'Ubuntu Mono', monospace;
+  text-align: left;
+  white-space: pre;
+  word-spacing: normal;
+  word-break: normal;
+  word-wrap: normal;
+  line-height: 1.5;
+
+  -moz-tab-size: 4;
+  -o-tab-size: 4;
+  tab-size: 4;
+
+  -webkit-hyphens: none;
+  -moz-hyphens: none;
+  -ms-hyphens: none;
+  hyphens: none;
+}
+
+pre[class*="language-"]::-moz-selection,
+pre[class*="language-"] ::-moz-selection,
+code[class*="language-"]::-moz-selection,
+code[class*="language-"] ::-moz-selection {
+  text-shadow: none;
+  background: #b3d4fc;
+}
+
+pre[class*="language-"]::selection,
+pre[class*="language-"] ::selection,
+code[class*="language-"]::selection,
+code[class*="language-"] ::selection {
+  text-shadow: none;
+  background: #b3d4fc;
+}
+
+@media print {
+
+  code[class*="language-"],
+  pre[class*="language-"] {
+    text-shadow: none;
+  }
+}
+
+/* Code blocks */
+pre[class*="language-"] {
+  padding: 1em;
+  margin: .5em 0;
+  overflow: auto;
+}
+
+:not(pre)>code[class*="language-"],
+pre[class*="language-"] {
+  background: #f5f2f0;
+}
+
+/* Inline code */
+:not(pre)>code[class*="language-"] {
+  padding: .1em;
+  border-radius: .3em;
+  white-space: normal;
+}
+
+.token.comment,
+.token.prolog,
+.token.doctype,
+.token.cdata {
+  color: slategray;
+}
+
+.token.punctuation {
+  color: #999;
+}
+
+.namespace {
+  opacity: .7;
+}
+
+.token.property,
+.token.tag,
+.token.boolean,
+.token.number,
+.token.constant,
+.token.symbol,
+.token.deleted {
+  color: #905;
+}
+
+.token.selector,
+.token.attr-name,
+.token.string,
+.token.char,
+.token.builtin,
+.token.inserted {
+  color: #690;
+}
+
+.token.operator,
+.token.entity,
+.token.url,
+.language-css .token.string,
+.style .token.string {
+  color: #9a6e3a;
+  background: hsla(0, 0%, 100%, .5);
+}
+
+.token.atrule,
+.token.attr-value,
+.token.keyword {
+  color: #07a;
+}
+
+.token.function,
+.token.class-name {
+  color: #DD4A68;
+}
+
+.token.regex,
+.token.important,
+.token.variable {
+  color: #e90;
+}
+
+.token.important,
+.token.bold {
+  font-weight: bold;
+}
+
+.token.italic {
+  font-style: italic;
+}
+
+.token.entity {
+  cursor: help;
+}