@easyv/react-components 0.0.5 → 0.0.6

package/README.md

@@ -7,7 +7,53 @@ a react component library base on arco design
 
 ## Usage
 
-TODO
+### 安装包
+
+基础包
+
+```shell
+pnpm add @arco-design/web-react @arco-plugins/vite-react
+```
+
+主题包，例如 `@arco-themes/react-easytwin`
+
+```shell
+pnpm add @arco-themes/react-easytwin
+```
+
+### 配置
+
+以 vite 为例
+
+配置 `vite.config.ts`
+
+```js
+import { vitePluginForArco } from '@arco-plugins/vite-react';
+
+export default defineConfig({
+  // ...
+  plugins: [
+    // ...
+    vitePluginForArco({
+      theme: '@arco-themes/react-easytwin',
+    }),
+  ],
+});
+```
+
+如果是应用的暗色主题，请在 `index.html` 的 body 上添加 `arco-theme="dark"`，如果是亮色的，可以不加。
+
+### 使用
+
+可以统一在 `components` 目录下新建一个 `ui.ts` 文件，这个文件的主要作用就是从 `@easyv/react-components` 中导入组件并导出
+
+```ts
+export { Input } from '@easyv/react-components';
+```
+
+这样方便统一管理，后面如果要迁移组件库，只需要修改这个文件即可。
+
+注意：不要引 `@arco-design/web-react`，这是依赖的基础库，但不是直接使用的库。`@easyv/react-components` 会基于它做一些定制。
 
 ## Options
 

package/dist/Input/index.js

@@ -6,35 +6,72 @@ function _objectSpread(target) { for (var i = 1; i < arguments.length; i++) { va
 function _defineProperty(obj, key, value) { key = _toPropertyKey(key); if (key in obj) { Object.defineProperty(obj, key, { value: value, enumerable: true, configurable: true, writable: true }); } else { obj[key] = value; } return obj; }
 function _toPropertyKey(arg) { var key = _toPrimitive(arg, "string"); return _typeof(key) === "symbol" ? key : String(key); }
 function _toPrimitive(input, hint) { if (_typeof(input) !== "object" || input === null) return input; var prim = input[Symbol.toPrimitive]; if (prim !== undefined) { var res = prim.call(input, hint || "default"); if (_typeof(res) !== "object") return res; throw new TypeError("@@toPrimitive must return a primitive value."); } return (hint === "string" ? String : Number)(input); }
+function _slicedToArray(arr, i) { return _arrayWithHoles(arr) || _iterableToArrayLimit(arr, i) || _unsupportedIterableToArray(arr, i) || _nonIterableRest(); }
+function _nonIterableRest() { throw new TypeError("Invalid attempt to destructure non-iterable instance.\nIn order to be iterable, non-array objects must have a [Symbol.iterator]() method."); }
+function _unsupportedIterableToArray(o, minLen) { if (!o) return; if (typeof o === "string") return _arrayLikeToArray(o, minLen); var n = Object.prototype.toString.call(o).slice(8, -1); if (n === "Object" && o.constructor) n = o.constructor.name; if (n === "Map" || n === "Set") return Array.from(o); if (n === "Arguments" || /^(?:Ui|I)nt(?:8|16|32)(?:Clamped)?Array$/.test(n)) return _arrayLikeToArray(o, minLen); }
+function _arrayLikeToArray(arr, len) { if (len == null || len > arr.length) len = arr.length; for (var i = 0, arr2 = new Array(len); i < len; i++) arr2[i] = arr[i]; return arr2; }
+function _iterableToArrayLimit(arr, i) { var _i = null == arr ? null : "undefined" != typeof Symbol && arr[Symbol.iterator] || arr["@@iterator"]; if (null != _i) { var _s, _e, _x, _r, _arr = [], _n = !0, _d = !1; try { if (_x = (_i = _i.call(arr)).next, 0 === i) { if (Object(_i) !== _i) return; _n = !1; } else for (; !(_n = (_s = _x.call(_i)).done) && (_arr.push(_s.value), _arr.length !== i); _n = !0); } catch (err) { _d = !0, _e = err; } finally { try { if (!_n && null != _i.return && (_r = _i.return(), Object(_r) !== _r)) return; } finally { if (_d) throw _e; } } return _arr; } }
+function _arrayWithHoles(arr) { if (Array.isArray(arr)) return arr; }
 function _objectWithoutProperties(source, excluded) { if (source == null) return {}; var target = _objectWithoutPropertiesLoose(source, excluded); var key, i; if (Object.getOwnPropertySymbols) { var sourceSymbolKeys = Object.getOwnPropertySymbols(source); for (i = 0; i < sourceSymbolKeys.length; i++) { key = sourceSymbolKeys[i]; if (excluded.indexOf(key) >= 0) continue; if (!Object.prototype.propertyIsEnumerable.call(source, key)) continue; target[key] = source[key]; } } return target; }
 function _objectWithoutPropertiesLoose(source, excluded) { if (source == null) return {}; var target = {}; var sourceKeys = Object.keys(source); var key, i; for (i = 0; i < sourceKeys.length; i++) { key = sourceKeys[i]; if (excluded.indexOf(key) >= 0) continue; target[key] = source[key]; } return target; }
-import React, { forwardRef } from 'react';
+import React, { forwardRef, useCallback, useEffect, useRef, useState } from 'react';
 import { Input } from '@arco-design/web-react';
 import classNames from 'classnames';
 import { SearchCircleOutlined } from '@easyv/react-icons';
 import "./index.less";
 import { jsx as _jsx } from "react/jsx-runtime";
-var XInput = /*#__PURE__*/forwardRef(function (_ref, ref) {
-  var _ref$bordered = _ref.bordered,
-    bordered = _ref$bordered === void 0 ? true : _ref$bordered,
-    className = _ref.className,
-    restProps = _objectWithoutProperties(_ref, _excluded);
-  return /*#__PURE__*/_jsx(Input, _objectSpread({
+var XInput = /*#__PURE__*/forwardRef(function (props, ref) {
+  var _props$bordered = props.bordered,
+    bordered = _props$bordered === void 0 ? true : _props$bordered,
+    className = props.className,
+    restProps = _objectWithoutProperties(props, _excluded);
+  var isHalfControll = ('onBlurChange' in props);
+  var _useState = useState('value' in props ? props.value : undefined),
+    _useState2 = _slicedToArray(_useState, 2),
+    localValue = _useState2[0],
+    setLocalValue = _useState2[1];
+  var refValue = useRef(localValue);
+  refValue.current = localValue;
+  useEffect(function () {
+    if (isHalfControll && props.value !== localValue) {
+      setLocalValue(props.value);
+    }
+  }, [props.value, isHalfControll]);
+  var handlePressEnter = useCallback(function (e) {
+    return e.currentTarget.blur();
+  }, []);
+  var handleChange = useCallback(function (value) {
+    setLocalValue(value);
+  }, []);
+  var handleBlur = useCallback(function () {
+    if (refValue.current !== undefined && refValue.current !== props.value) {
+      if (props.enableEmpty) {
+        var _props$onBlurChange;
+        (_props$onBlurChange = props.onBlurChange) === null || _props$onBlurChange === void 0 ? void 0 : _props$onBlurChange.call(props, refValue.current);
+      } else {
+        setLocalValue(props.value);
+      }
+    }
+  }, []);
+  var halfControlledProps = {
+    value: localValue,
+    onChange: handleChange,
+    onBlur: handleBlur
+  };
+  return /*#__PURE__*/_jsx(Input, _objectSpread(_objectSpread({
     ref: ref,
     className: classNames(className, {
       'arco-input-borderless': !bordered
     }),
-    onPressEnter: function onPressEnter(e) {
-      e.target.blur();
-    }
-  }, restProps));
+    onPressEnter: handlePressEnter
+  }, isHalfControll ? halfControlledProps : {}), restProps));
 });
-var InputSearch = /*#__PURE__*/forwardRef(function (_ref2, ref) {
-  var _ref2$bordered = _ref2.bordered,
-    bordered = _ref2$bordered === void 0 ? true : _ref2$bordered,
-    className = _ref2.className,
-    onSearch = _ref2.onSearch,
-    restProps = _objectWithoutProperties(_ref2, _excluded2);
+var InputSearch = /*#__PURE__*/forwardRef(function (_ref, ref) {
+  var _ref$bordered = _ref.bordered,
+    bordered = _ref$bordered === void 0 ? true : _ref$bordered,
+    className = _ref.className,
+    onSearch = _ref.onSearch,
+    restProps = _objectWithoutProperties(_ref, _excluded2);
   return /*#__PURE__*/_jsx(Input, _objectSpread({
     ref: ref,
     className: classNames(className, {

package/dist/Input/interface.d.ts

@@ -1,7 +1,9 @@
 import type { InputProps } from '@arco-design/web-react';
 import type { InputSearchProps, RefInputType } from '@arco-design/web-react/es/Input';
 interface XInputProps extends InputProps {
+    enableEmpty?: boolean;
     bordered?: boolean;
+    onBlurChange?: (value: string) => void;
 }
 interface XInputSearchProps extends InputSearchProps {
     bordered?: boolean;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@easyv/react-components",
-  "version": "0.0.5",
+  "version": "0.0.6",
   "description": "a react component library base on arco design",
   "license": "MIT",
   "module": "dist/index.js",