@hzab/form-render 1.7.16 → 1.7.18

package/docs/components/RichEditor.md

@@ -0,0 +1,94 @@
+# RichEditor
+
+基于 wangEditor 的富文本编辑器，支持 OSS / 私有化上传。Schema 中可使用 `RichEditor` 或别名 `Editor`。
+
+## PC 使用前安装依赖
+
+```bash
+npm install @wangeditor/editor-for-react
+```
+
+## Schema 示例
+
+```json
+{
+  "x-component": "RichEditor",
+  "x-component-props": {
+    "height": "400px",
+    "uploadMode": "oss",
+    "toolbarConfig": {},
+    "editorConfig": {
+      "placeholder": "请输入内容..."
+    }
+  }
+}
+```
+
+独立使用：
+
+```jsx
+import { RichEditor } from "@hzab/form-render/src/components";
+import { useRef } from "react";
+
+export default function Demo() {
+  const editorRef = useRef();
+  return <RichEditor ref={editorRef} height="400px" />;
+}
+```
+
+向富文本 set 内容：`editorRef.current.setEditorContent(HtmlString)`
+
+获取富文本当前内容：`editorRef.current.getEditorContent()`
+
+### RichEditor Attributes
+
+| 参数              | 类型                    | 必填 | 默认值 | 说明 |
+| ----------------- | ----------------------- | ---- | ------ | ---- |
+| value             | string                  | 否   | -      | 编辑器 HTML 内容 |
+| onChange          | Function                | 否   | -      | 内容变化回调 |
+| height            | string                  | 否   | -      | 编辑器高度 |
+| toolbarConfig     | Partial\<IToolbarConfig\> | 否 | {}     | 工具栏配置 |
+| editorConfig      | Partial\<IEditorConfig\>  | 否 | `{ placeholder: '请输入内容...' }` | 编辑器配置 |
+| uploadMode        | string                  | 否   | oss    | 上传模式：`oss` / `offline` 等 |
+| ossOpt            | Object                  | 否   | -      | OSS 上传配置 |
+| uploadParams      | Object                  | 否   | {}     | 上传入参 |
+| ossServerUrl      | string                  | 否   | 全局配置或 `/api/v1/user/oss/getWebOssConfig` | 获取 OSS 配置接口 |
+| ossUrl            | string                  | 否   | 同 ossServerUrl | OSS 配置接口（兼容字段） |
+| offlineServerUrl  | string                  | 否   | -      | 私有化上传接口 |
+| offlinePreviewUrl | string                  | 否   | -      | 私有化预览前缀 |
+| customRequest     | Function                | 否   | -      | 自定义上传请求 |
+| zIndex            | number                  | 否   | 9999   | 编辑器层级 |
+
+图片上传可在 `editorConfig.MENU_CONF.uploadImage` 中配置，参考 [wangEditor 文档](https://www.wangeditor.com/v5/menu-config.html#upload-image)。
+
+```jsx
+editorConfig = {
+  MENU_CONF: {
+    uploadImage: {
+      server: "/api/upload",
+      fieldName: "your-custom-name",
+      maxFileSize: 1 * 1024 * 1024,
+      maxNumberOfFiles: 10,
+      allowedFileTypes: ["image/*"],
+      meta: { token: "xxx" },
+      headers: { Accept: "text/x-json" },
+      withCredentials: true,
+      timeout: 5 * 1000,
+    },
+  },
+};
+```
+
+## 移动端使用前安装依赖
+
+```bash
+npm install lib-flexible
+```
+
+```jsx
+import HandleMobile from "./components/handleMobileVw";
+
+export default function Demo() {
+  return <HandleMobile content={HtmlString} />;
+}
+```

package/docs/components/Text.md

@@ -0,0 +1,26 @@
+# Text
+
+只读文本展示组件，常用于 schema 合并、LocationListPicker 弹层等内部场景；也可在 schema 中直接使用。
+
+## Schema 示例
+
+```json
+{
+  "x-component": "Text",
+  "x-component-props": {
+    "content": "静态文案",
+    "mode": "div"
+  }
+}
+```
+
+表单字段有值时优先展示 `value`，否则展示 `content`。
+
+### Text Attributes
+
+| 参数      | 类型   | 必填 | 默认值 | 说明 |
+| --------- | ------ | ---- | ------ | ---- |
+| value     | any    | 否   | -      | 字段值，优先展示 |
+| content   | any    | 否   | -      | 无 value 时的静态内容 |
+| mode      | string | 否   | div    | 渲染标签名；`normal` 或不传时为 `div`，也可设为 `span` / `p` 等 |
+| className | string | 否   | -      | 附加 class，根节点带 `formily-text` |

package/docs/components/TreeCheckbox.md

@@ -0,0 +1,52 @@
+# TreeCheckbox
+
+树形多选复选框，支持按层级合并叶子节点，以及最外层 Tab 展示。
+
+## Schema 示例
+
+```json
+{
+  "x-component": "TreeCheckbox",
+  "x-component-props": {
+    "mergeLeaf": true,
+    "mergeFullLeaf": true,
+    "tabBox": false,
+    "fieldNames": {
+      "label": "label",
+      "value": "value",
+      "children": "children"
+    }
+  },
+  "enum": [
+    {
+      "label": "一级",
+      "value": "1",
+      "children": [
+        { "label": "二级-1", "value": "1-1" },
+        { "label": "二级-2", "value": "1-2" }
+      ]
+    }
+  ]
+}
+```
+
+数据也可通过 `x-component-props.dataSource` 或 `field.dataSource` 传入。
+
+### TreeCheckbox Attributes
+
+| 参数          | 类型    | 必填 | 默认值                                             | 说明 |
+| ------------- | ------- | ---- | -------------------------------------------------- | ---- |
+| dataSource    | Array   | 否   | field.dataSource                                   | 树数据 |
+| mergeFullLeaf | boolean | 否   | true                                               | 合并不存在 children 的层级 |
+| mergeLeaf     | boolean | 否   | true                                               | 合并每一层级的叶子节点 |
+| fieldNames    | Object  | 否   | `{ label, value, children }`                       | 自定义 options 中字段名 |
+| disabled      | boolean | 否   | false                                              | 禁用状态 |
+| readOnly      | boolean | 否   | false                                              | 只读状态 |
+| tabBox        | boolean | 否   | false                                              | 最外层使用 tab |
+| tabConfList   | Array   | 否   | -                                                  | tab 配置列表；存在时优先用于计算 tab 层级数 |
+| tabLevel      | number  | 否   | -                                                  | tab 层级数（`tabBox === true` 时为 1） |
+| labelKey      | string  | 否   | label                                              | 兼容旧字段，后续废弃 |
+| valueKey      | string  | 否   | value                                              | 兼容旧字段，后续废弃 |
+| childrenKey   | string  | 否   | children                                           | 兼容旧字段，后续废弃 |
+
+表单值为选中节点 `value` 组成的数组。

package/{src/components/Upload/README.md → docs/components/Upload.md}

@@ -27,13 +27,26 @@
 | ossServerUrl         | string   | 否   | -        | 获取 oss 参数的接口，默认 /api/v1/user/oss/getWebOssConfig                           |
 | ossOpt               | Object   | 否   | -        | oss 上传的配置参数                                                                   |
 | fileListConf         | Object   | 否   | {}       | 结果数据配置                                                                         |
-| previewConfig        | Object   | 否   | {}       | 预览场景的配置                                                                       |
+| previewConfig        | Object   | 否   | {}       | 预览场景配置（见下表）。仅影响列表/弹窗预览，不进入 onChange / 表单提交 |
+| previewBaseUrl       | string   | 否   | -        | 仅预览使用的域名/路径前缀（糖衣）。与 `previewConfig.url` 并存时，以 `previewConfig.url` 为准；不进入表单提交 |
 | onCountExceed        | Function | 否   | -        | 数量超出 maxCount 时的回调                                                           |
 | beforeUploadCheck    | Function | 否   | -        | 追加的 beforeUpload 检查，返回 Promise.reject() 进行拦截                             |
 | templateUrl          | string   | 否   | -        | 模板下载的地址                                                                       |
 | templateDownloadText | string   | 否   | 模板下载 | 模板下载按钮的文案                                                                   |
 | uploadParams         | Object   | 否   | {}       | 文件上传接口入参                                                                     |
 
+### previewConfig 预览配置
+
+| 参数 | 类型 | 必填 | 默认值 | 说明 |
+| ---- | ---- | ---- | ------ | ---- |
+| url | string | 否 | - | 预览域名或路径前缀，如 `https://cdn.example.com`。相对路径会拼到此前缀后用于列表缩略图与弹窗预览 |
+| query | object | 否 | - | 追加到预览地址的 query 对象，推荐写法，如 `{ loookType: 1 }` |
+| search | string | 否 | - | `?` 后的原始字符串（可不含 `?`），会先解析再与 `query` 合并；同名键以 `query` 为准 |
+
+兼容：把 `query` 写成字符串（如 `"loookType=1"`）时，组件会解析为 `search`，无需立刻改业务 schema。
+
+> **边界**：`previewConfig.url` / `previewBaseUrl` 只用于上传列表视图与弹窗预览；`onChange` 与表单提交仍使用后端返回的相对/原始路径，不会提交拼接后的完整地址。
+
 ### fileListConf 结果数据配置
 
 | 参数     | 类型   | 必填 | 默认值 | 说明                         |

package/docs/components/UserSelect.md

@@ -0,0 +1,59 @@
+# UserSelect
+
+人员下拉选择器，基于 antd Select，支持头像、手机号、身份证号等扩展展示。
+
+## Schema 示例
+
+```json
+{
+  "x-component": "UserSelect",
+  "x-component-props": {
+    "isAvatar": true,
+    "avatarSize": "default",
+    "configKey": {
+      "phoneKey": "phone",
+      "idCardKey": "idCard"
+    }
+  },
+  "enum": [
+    {
+      "label": "张三",
+      "value": "1",
+      "phone": "13800000000",
+      "idCard": "3301**********1234",
+      "avatar": "https://example.com/avatar.png"
+    }
+  ]
+}
+```
+
+数据源也可通过 Formily `field.dataSource` 或 `x-component-props.options` 传入。
+
+### UserSelect Attributes
+
+| 参数       | 类型     | 必填 | 默认值  | 说明 |
+| ---------- | -------- | ---- | ------- | ---- |
+| options    | Array    | 否   | -       | 下拉数据；也可使用 schema `enum` / `field.dataSource` |
+| isAvatar   | boolean  | 否   | false   | 是否显示头像 |
+| avatarSize | AvatarSize | 否 | default | antd Avatar 尺寸 |
+| configKey  | Object   | 否   | -       | 自定义字段映射，见下表 |
+| InfoRender | Function | 否   | -       | 自定义 option 信息区渲染，入参为 option 对象 |
+
+其余 props 透传 antd Select。
+
+### configKey
+
+| 参数      | 类型   | 必填 | 默认值 | 说明 |
+| --------- | ------ | ---- | ------ | ---- |
+| phoneKey  | string | 否   | phone  | 手机号字段名 |
+| idCardKey | string | 否   | idCard | 身份证号字段名 |
+
+### options 子项
+
+| 参数   | 类型           | 必填 | 默认值 | 说明 |
+| ------ | -------------- | ---- | ------ | ---- |
+| label  | string         | 是   | -      | 展示名称 |
+| value  | string\|number | 是   | -      | 选项值 |
+| avatar | string         | 否   | -      | 头像 URL |
+| phone  | string         | 否   | -      | 手机号（可被 configKey 覆盖） |
+| idCard | string         | 否   | -      | 身份证号（可被 configKey 覆盖） |

package/package.json

@@ -1,11 +1,14 @@
 {
   "name": "@hzab/form-render",
-  "version": "1.7.16",
+  "version": "1.7.18",
   "description": "",
   "main": "src",
   "scripts": {
     "dev": "webpack serve -c ./config/webpack.config.js --env local",
     "build": "webpack -c ./config/webpack.config.js --env production",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "test:coverage": "vitest run --coverage",
     "version:alpha": "npm version prerelease --preid=alpha",
     "publish:alpha": "npm publish --tag alpha",
     "version:beta": "npm version prerelease --preid=beta",
@@ -17,6 +20,7 @@
   },
   "files": [
     "src",
+    "docs",
     "CHANGELOG.md"
   ],
   "keywords": [],
@@ -27,16 +31,21 @@
     "@hzab/permissions": "^0.1.1",
     "@hzab/utils": "^1.0.16",
     "@hzab/webpack-config": "0.0.12",
+    "@testing-library/jest-dom": "^5.17.0",
+    "@testing-library/react": "^12.1.5",
+    "@testing-library/user-event": "^13.5.0",
     "@types/react": "^17.0.62",
     "@types/react-dom": "^17.0.20",
     "antd": "^4.24.12",
     "dayjs": "1.11.10",
     "eslint": "^8.30.0",
+    "jsdom": "^30.0.1",
     "less": "^4.1.3",
     "react": "^17.0.2",
     "react-dom": "^17.0.2",
     "react-router-dom": "^6.8.1",
-    "typescript": "^4.9.4"
+    "typescript": "^4.9.4",
+    "vitest": "^4.1.10"
   },
   "peerDependencies": {
     "@hzab/utils": ">=1.0.6",

package/src/components/LocationListPicker/index.tsx

@@ -55,7 +55,7 @@ export const LocationListPicker = observer((props) => {
       // 取消监听
       mapUtilsRef.current?.off("click", onMapClick);
       mapUtilsRef.current?.off("dblclick", onMapDbClick);
-      mapDomRef.current.current.removeEventListener("mousemove", onMouseMove);
+      mapDomRef.current?.current?.removeEventListener?.("mousemove", onMouseMove);
     };
   }, []);
 

package/src/components/LocationPicker/Map/AMap/common/loader.ts

@@ -1,3 +1,5 @@
+import AMapLoader from "@amap/amap-jsapi-loader"
+
 const defaultVersion = "2.0";
 const defaultPlugins = ["AMap.Geocoder", "AMap.AutoComplete", "AMap.PolygonEditor", "AMap.PolylineEditor"];
 
@@ -33,9 +35,6 @@ function Loader(opt) {
 
     window._AMapLoaderTemp.plugins = plugins ? [...defaultPlugins, ...(plugins || [])] : defaultPlugins;
 
-    // 不用地图组件时可以不安装  "@amap/amap-jsapi-loader"
-    const AMapLoader = require("@amap/amap-jsapi-loader");
-
     window._AMapLoaderTemp.loading = true;
     window._AMapLoaderTemp.promise = AMapLoader.load({
       key: key || window._AMapLoaderTemp.key, // 申请好的Web端开发者Key，首次调用 load 时必填

package/src/components/Upload/common/handleIOFileList.ts

@@ -1,11 +1,12 @@
 import { getFileURL } from "@hzab/utils/src/file/file";
 import { getFileType } from "@hzab/utils/src/file/fileType";
-import { isBase64Str } from "@hzab/utils/src/base64Str";
 import { getUFileName, getFileName, getFullFileName, getFileExt } from "@hzab/utils/src/file/fileName";
-import { getFileNameObj } from "@hzab/utils/src/upload/uploadUtils";
+import { getFileNameObj, mergePreviewConfig } from "@hzab/utils/src/upload/uploadUtils";
 import { nanoidNumALetters } from "@hzab/utils/src/nanoid";
 import { getFormRenderPCGlobalServeConfig } from "../../../globalConfig";
-import { addQuery } from "@hzab/utils/src/url"
+import { addQuery } from "@hzab/utils/src/url";
+
+export { mergePreviewConfig };
 
 
 /**
@@ -139,43 +140,6 @@ export const objStrToObj = function (objStr) {
   return _objStr;
 };
 
-/**
- * 预览 url 添加前缀
- * @param {*} uri
- * @param {*} previewConfig
- * @returns
- */
-export function mergePreviewConfig(uri, previewConfig) {
-  let _uri = uri;
-  let basePath = "";
-  if (typeof _uri === "object") {
-    basePath = _uri.basePath;
-    _uri = _uri.previewUrl || _uri.url;
-  }
-  if (typeof _uri !== "string") {
-    return _uri;
-  }
-  _uri = _uri?.trim();
-  // base64 直接返回
-  if (isBase64Str(_uri)) {
-    return _uri;
-  }
-  const isUriPattern = /http[s]?:\/\/[^\s]+/.test(_uri);
-  const query = previewConfig?.query?.trim() ? "?" + previewConfig?.query?.trim() : "";
-
-  if (isUriPattern) {
-    // 源地址为 http 地址，直接拼接 query 参数
-    return `${_uri}${query}`;
-  }
-
-  if (previewConfig) {
-    // 拼接前缀
-    return `${previewConfig?.url?.trim()}/${_uri}${query}`?.trim();
-  }
-
-  return _uri;
-}
-
 /**
  * 子项数据归一化
  * 字符串：url、base64

package/src/components/Upload/common/utils.js

@@ -1,5 +1,5 @@
-import { formatDirStr, mergeDirStr, handleMaxCount, mergePreviewConfig } from "@hzab/utils/upload/uploadUtils";
-import { getFileURL } from "@hzab/utils/file/file";
+import { formatDirStr, mergeDirStr, handleMaxCount, mergePreviewConfig } from "@hzab/utils/src/upload/uploadUtils";
+import { getFileURL } from "@hzab/utils/src/file/file";
 import { isBase64Str } from "@hzab/utils/src/base64Str";
 import {
   checkImageUrl,
@@ -7,6 +7,7 @@ import {
   checkAudioUrl,
   isValidMediaType,
   checkUrlSuffix,
+  getFileType,
 } from "@hzab/utils/src/file/fileType";
 import { getArr } from "@hzab/utils/src/array";
 

package/src/components/Upload/uploader-input.jsx

@@ -1,5 +1,6 @@
 import { useState, useRef, useEffect, useMemo } from "react";
 import { Button, Modal, message } from "antd";
+import _ from "lodash";
 
 import ItemList from "./components/ItemList";
 
@@ -9,8 +10,6 @@ import { handleOssUpload } from "./common/ossUpload";
 
 import "./uploader.less";
 
-const _ = require("lodash");
-
 function Uploader(props) {
   const {
     name,

package/src/components/Upload/uploader.jsx

@@ -10,6 +10,7 @@ import { Button, Upload as AUpload, message } from "antd";
 import React, { useEffect, useState, useMemo } from "react";
 
 import { handleInputFileList, handleOutputFileList } from "./common/handleIOFileList";
+import { mergePreviewConfig } from "@hzab/utils/src/upload/uploadUtils";
 
 import PreviewModal, { hasPreviewRender, hasPreviewMedium } from "./components/PreviewModal";
 import { getOssUploadRequest, getOfflineUploadRequest } from "./common/customRequest";
@@ -57,6 +58,8 @@ export function Uploader({ onChange, ...props }) {
     isResRemoveArr = true,
     /** 预览配置参数 */
     previewConfig = {},
+    /** 仅预览使用的域名/路径前缀，不参与 onChange / 表单提交；优先级低于 previewConfig.url */
+    previewBaseUrl = getFormRenderPCGlobalServeConfig()?.previewBaseUrl || "",
     onCountExceed,
     templateUrl,
     beforeUploadCheck,
@@ -65,10 +68,31 @@ export function Uploader({ onChange, ...props }) {
     isFileJson = false,
     thumbnailParams = { image_process: "resize,w_200" },
     readPretty,
+    afterUpload
   } = props;
   const isPrivateStore =
     props.uploadParams?.fileAcl === "private" || props.ossOpt?.signatureParams?.fileAcl === "private";
 
+  /** 预览前缀配置：previewConfig.url 优先，其次 previewBaseUrl；*/
+  const resolvedPreviewConfig = useMemo(() => {
+    const url = previewConfig?.url || previewBaseUrl;
+    const { query, search, ...rest } = previewConfig || {};
+    const isQueryObject = query && typeof query === "object";
+    const legacyQueryStr = typeof query === "string" ? query.trim() : "";
+    const resolvedSearch = (search || legacyQueryStr || "").replace(/^\?/, "") || undefined;
+    const resolvedQuery = isQueryObject ? query : undefined;
+
+    if (!url && !resolvedQuery && !resolvedSearch) {
+      return previewConfig || {};
+    }
+    return {
+      ...rest,
+      url,
+      ...(resolvedQuery ? { query: resolvedQuery } : {}),
+      ...(resolvedSearch ? { search: resolvedSearch } : {}),
+    };
+  }, [previewConfig.url, previewConfig.query, previewConfig.search, previewBaseUrl]);
+
   /**
    * 数据格式配置
    */
@@ -96,6 +120,7 @@ export function Uploader({ onChange, ...props }) {
    * @returns
    */
   const handleChange = async ({ fileList, file, event }) => {
+
     setFileList(fileList);
     // 上传中不进行处理，结局 ossPromise 不存在的问题
     if (file.status !== "done") {
@@ -103,6 +128,7 @@ export function Uploader({ onChange, ...props }) {
     }
 
     let _files = [...fileList];
+
     // 取出异步 url
     for (let i = 0; i < _files.length; i++) {
       let _file = _files[i]?.originFileObj || _files[i];
@@ -132,10 +158,23 @@ export function Uploader({ onChange, ...props }) {
     });
 
     onChange && onChange?.(_files);
+    afterUpload && await afterUpload({
+      files: fileList,
+      urls: _files
+    })
+
+    setChecking(false);
+
   };
 
+
   useEffect(() => {
-    const list = handleInputFileList(value, { ...fileListConf, maxCount, previewConfig, thumbnailParams });
+    const list = handleInputFileList(value, {
+      ...fileListConf,
+      maxCount,
+      previewConfig: resolvedPreviewConfig,
+      thumbnailParams,
+    });
 
     async function handlePreview() {
       await handlePreviewUrls(list, {
@@ -150,7 +189,27 @@ export function Uploader({ onChange, ...props }) {
     } else {
       setFileList(list);
     }
-  }, [value]);
+  }, [value, resolvedPreviewConfig]);
+
+  /** 仅用于列表展示：补齐 thumbUrl/previewUrl，不改动 url（提交仍用相对路径） */
+  const displayFileList = useMemo(() => {
+    if (!resolvedPreviewConfig?.url || !fileList?.length) {
+      return fileList;
+    }
+    return fileList.map((file) => {
+      if (!file || typeof file !== "object") {
+        return file;
+      }
+      // 用存储路径 url 拼前缀，避免已是完整 previewUrl 时语义混乱；无 url 时回退对象自身
+      const previewUrl = mergePreviewConfig(file.url || file, resolvedPreviewConfig);
+      const thumbUrl = file.thumbUrl ? mergePreviewConfig(file.thumbUrl, resolvedPreviewConfig) : previewUrl;
+      return {
+        ...file,
+        previewUrl,
+        thumbUrl,
+      };
+    });
+  }, [fileList, resolvedPreviewConfig]);
 
   const onRemove = (file) => {
     const files = (fileList || []).filter((v) => v.url !== file.url);
@@ -206,7 +265,7 @@ export function Uploader({ onChange, ...props }) {
     multiple: multiple,
     listType: listType,
     maxCount: maxCount,
-    fileList: fileList,
+    fileList: displayFileList,
     onChange: handleChange,
     disabled,
     readOnly,
@@ -246,13 +305,16 @@ export function Uploader({ onChange, ...props }) {
           return AUpload.LIST_IGNORE;
         }
       }
-      setChecking(false);
     },
     customRequest,
+    ...(props || {}),
+    // 保证展示列表与预览逻辑不被 props 覆盖丢失
+    fileList: displayFileList,
     onPreview(file) {
       // TODO: 逻辑合并到数据处理中
       const isShowPreview = hasPreviewRender(file) || hasPreviewMedium(props.accept);
-      const fileUrl = file.previewUrl;
+      // 预览出口统一走 mergePreviewConfig；提交仍使用 file.url 相对路径
+      const fileUrl = mergePreviewConfig(file.url || file, resolvedPreviewConfig);
       if (isShowPreview) {
         setPreviewFile({
           ...file,
@@ -283,6 +345,7 @@ export function Uploader({ onChange, ...props }) {
     // },
     ...(props || {}),
   };
+
   const isShowUploadBtn = useMemo(() => {
     if (disabled || readOnly || readPretty) {
       return null;
@@ -301,6 +364,8 @@ export function Uploader({ onChange, ...props }) {
       )
     ) : null;
   }, [maxCount, fileList, disabled, readOnly, readPretty, checking, btnText, listType]);
+
+
   return (
     <>
       <AUpload className="oss-uploader" {..._uploadProps}>
@@ -316,7 +381,7 @@ export function Uploader({ onChange, ...props }) {
         accept={props?.accept}
         setPreviewFile={setPreviewFile}
         modalConf={props.modalConf}
-        previewConfig={previewConfig}
+        previewConfig={resolvedPreviewConfig}
       />
     </>
   );

package/src/components/LocationPicker/README.md

@@ -1,44 +0,0 @@
-## 使用前安装依赖
-
-npm install @amap/amap-jsapi-loader
-
-## 注意事项
-
-- isObjectRes 在 @hzab/form-render0.5.0 版本中去除，结果全部存放在对象中
-- changeMode 在 @hzab/form-render0.5.1 版本中去除，仅允许点击地图选点
-
-## 引入
-
-```jsx
-import MapLocationPoint from "./mapLocationPoint";
-
-export default function AMap(props) {
-  return <MapLocationPoint hasSearch={true}></MapLocationPoint>;
-}
-```
-
-### InfoPanel Attributes
-
-| 参数               | 类型    | 必填 | 默认值    | 说明                                             |
-| ------------------ | ------- | ---- | --------- | ------------------------------------------------ |
-| mode               | string  | 否   | dialog    | 地图显示的类型， dialog 弹窗显示、 show 直接显示 |
-| element            | string  | 否   | Polypoint | 地图绘制的元素名Polypoint&Polyline&Polygon |
-| layout             | string  | 否   | ver       | 选择器和地图的布局 hor 水平、 ver 垂直           |
-| hasSearch          | boolean | 否   | true      | 是否允许搜索                                     |
-| isAutoFixAddr      | boolean | 否   | false     | 打开地图时是否根据经纬度自动修正已填的地址       |
-| lonKey             | string  | 否   | longitude | 经度字段 key                                     |
-| latKey             | string  | 否   | latitude  | 维度字段 key                                     |
-| addrKey            | string  | 否   | address   | 地址字段 key                                     |
-| isAutoSearch       | boolean | 否   | false     | 搜索框是否自动搜索                               |
-| markerIconConf     | Object  | 否   | -         | markerIcon 配置对象                              |
-| icons              | Object  | 否   | -         | icon 图片配置                                    |
-| getCurPositionConf | Object  | 否   | -         | getCurrentPosition Config                        |
-
-#### icons
-
-| 参数         | 类型   | 必填 | 默认值 | 说明                     |
-| ------------ | ------ | ---- | ------ | ------------------------ |
-| markerIcon   | string | 否   | dialog | marker icon 图片地址     |
-| pickerIcon   | string | 否   | dialog | 选点 icon 图片地址或元素 |
-| positionIcon | string | 否   | dialog | 定位 icon 图片地址或元素 |
-| resetIcon    | string | 否   | dialog | 重置 icon 图片地址或元素 |