From b21bd949b401dce5439f995321552b59747b43ef Mon Sep 17 00:00:00 2001
From: zouyaoji <370681295@qq.com>
Date: Wed, 7 Sep 2022 21:37:44 +0800
Subject: [PATCH] docs: update docs

---
 CHANGELOG.en-US.md                               | 14 ++++++++++++++
 CHANGELOG.zh-CN.md                               | 14 ++++++++++++++
 .../en-US/controls/vc-selection-indicator.md     |  4 +++-
 website/docs/en-US/quickstart.md                 |  2 +-
 .../zh-CN/controls/vc-selection-indicator.md     | 16 +++++++++++++---
 .../zh-CN/geometries/vc-geometry-polyline.md     |  1 +
 website/docs/zh-CN/quickstart.md                 |  2 +-
 7 files changed, 47 insertions(+), 6 deletions(-)

diff --git a/CHANGELOG.en-US.md b/CHANGELOG.en-US.md
index 80813d863..e88447225 100644
--- a/CHANGELOG.en-US.md
+++ b/CHANGELOG.en-US.md
@@ -1,5 +1,19 @@
 ## Changelog
 
+### 3.0.19
+
+_2022-09-07_
+
+#### Optimization
+
+- Add the global configuration `reloadMode`, when modifying many non-responsive property changes in an instant requires calling the reload method of the component, indicating whether to execute the reload method every time, or execute the reload method only once after all changes are completed.
+- When the `vc-selection-indicator` component picks up `Cesium3DTileFeature`, the position of the indicator takes priority to the position of the property field `position`, if it is empty, it takes the center point of the bounding box.
+
+#### Bug fixes
+
+- Fixed the issue that Cesium.Uri was removed from Cesium 1.97, which caused the `vc-imagery-provider-tianditu` component to be abnormal.
+- Fixed the issue that failed to import components on demand.
+
 ### 3.0.18
 
 _2022-08-23_
diff --git a/CHANGELOG.zh-CN.md b/CHANGELOG.zh-CN.md
index 646fb18c2..caf4d6034 100644
--- a/CHANGELOG.zh-CN.md
+++ b/CHANGELOG.zh-CN.md
@@ -1,5 +1,19 @@
 ## 更新日志
 
+### 3.0.19
+
+_2022-09-07_
+
+#### 优化
+
+- 增加全局配置 `reloadMode`，一瞬间修改很多非响应属性改变需要调用组件的 reload 方法时，指示是`每次都执行` reload 方法，还是全部改变完之后`只执行一次` reload 方法。
+- `vc-selection-indicator` 组件拾取 `Cesium3DTileFeature` 时，指示器位置优先取属性字段 `position` 的位置，如果为空则取为包围盒的中心点。
+
+#### Bug 修复
+
+- 修复 Cesium 1.97 版本去掉 Cesium.Uri 导致天地图组件不正常的问题。
+- 修复按需引入组件失败的问题。
+
 ### 3.0.18
 
 _2022-08-23_
diff --git a/website/docs/en-US/controls/vc-selection-indicator.md b/website/docs/en-US/controls/vc-selection-indicator.md
index d75e27f67..e0d33ea2f 100644
--- a/website/docs/en-US/controls/vc-selection-indicator.md
+++ b/website/docs/en-US/controls/vc-selection-indicator.md
@@ -1,7 +1,7 @@
 <!--
  * @Author: zouyaoji@https://github.com/zouyaoji
  * @Date: 2021-06-13 16:48:20
- * @LastEditTime: 2022-03-08 23:29:23
+ * @LastEditTime: 2022-09-07 21:24:51
  * @LastEditors: zouyaoji
  * @Description:
  * @FilePath: \vue-cesium@next\website\docs\en-US\controls\vc-selection-indicator.md
@@ -11,6 +11,8 @@
 
 Load a custom selector component to replace the selectionIndicator that comes with Cesium.
 
+**Note:** If the picked object is `Cesium3DTileFeature` the position of the indicator is the center point of the bounding box of the object. If it is a manual model and you want a more precise position, please use the `position` attribute in the building attribute field to describe the position information of the feature, such as `'[108, 32]'` .
+
 ### Basic usage
 
 Basic usage of the selector component.
diff --git a/website/docs/en-US/quickstart.md b/website/docs/en-US/quickstart.md
index a813a97fc..5a56880be 100644
--- a/website/docs/en-US/quickstart.md
+++ b/website/docs/en-US/quickstart.md
@@ -105,7 +105,7 @@ Please add the following configuration to the `tsconfig.json` or `jsconfig.json`
     // ...
     "types": ["vue-cesium/global", "vue-cesium/Cesium"]
   },
-  "include": ["src/**/*", "node_modules/vue-cesium/Cesium.d.ts"]
+  "include": ["src/**/*", "node_modules/vue-cesium/Cesium.d.ts", "node_modules/vue-cesium/global.d.ts"]
 }
 ```
 
diff --git a/website/docs/zh-CN/controls/vc-selection-indicator.md b/website/docs/zh-CN/controls/vc-selection-indicator.md
index 986224cfb..f79b47bbf 100644
--- a/website/docs/zh-CN/controls/vc-selection-indicator.md
+++ b/website/docs/zh-CN/controls/vc-selection-indicator.md
@@ -1,7 +1,7 @@
 <!--
  * @Author: zouyaoji@https://github.com/zouyaoji
  * @Date: 2021-11-04 10:37:42
- * @LastEditTime: 2022-03-08 23:19:17
+ * @LastEditTime: 2022-09-07 21:31:17
  * @LastEditors: zouyaoji
  * @Description:
  * @FilePath: \vue-cesium@next\website\docs\zh-CN\controls\vc-selection-indicator.md
@@ -11,6 +11,8 @@
 
 加载自定义选择器组件，替换 Cesium 自带的 selectionIndicator。
 
+**注意：** 如果是拾取到的对象是 `Cesium3DTileFeature` 指示器的位置是该对象的包围盒的中心点。如果是手工模型并且想要更精准的位置请在建筑属性字段用 `position` 属性描述该要素的位置信息，如 `'[108, 32]'` 。
+
 ### 基础用法
 
 选择器组件的基础用法。
@@ -19,7 +21,7 @@
 
 ```html
 <el-row ref="viewerContainer" class="demo-viewer">
-  <vc-viewer :selection-indicator="false" :info-box="false">
+  <vc-viewer :selection-indicator="true" :info-box="true">
     <vc-selection-indicator ref="selectionIndicator" @pick-evt="pickEvt"></vc-selection-indicator>
     <vc-entity ref="entity" :billboard="billboard" :position="{lng: 108, lat: 32}" :point="point" :label="label">
       <vc-graphics-rectangle :coordinates="[130, 20, 80, 25]" material="green"></vc-graphics-rectangle>
@@ -27,6 +29,15 @@
     <vc-layer-imagery :sort-order="10">
       <vc-imagery-provider-tianditu map-style="img_c" token="436ce7e50d27eede2f2929307e6b33c0"></vc-imagery-provider-tianditu>
     </vc-layer-imagery>
+    <vc-layer-imagery>
+      <vc-imagery-provider-wms
+        ref="provider"
+        url="https://nationalmap.gov.au/proxy/http://geoserver.nationalmap.nicta.com.au/geotopo_250k/ows"
+        layers="Hydrography:bores"
+        :parameters="{transparent: true, format: 'image/png'}"
+      ></vc-imagery-provider-wms>
+    </vc-layer-imagery>
+    <vc-primitive-tileset url="https://resource.dvgis.cn/data/3dtiles/ljz/tileset.json"> </vc-primitive-tileset>
   </vc-viewer>
   <el-row class="demo-toolbar">
     <el-button type="danger" round @click="unload">销毁</el-button>
@@ -63,7 +74,6 @@
       },
       unload() {
         this.$refs.selectionIndicator.unload()
-        window.aa = this.$refs.selectionIndicator
       },
       load() {
         this.$refs.selectionIndicator.load()
diff --git a/website/docs/zh-CN/geometries/vc-geometry-polyline.md b/website/docs/zh-CN/geometries/vc-geometry-polyline.md
index 47b554740..dc2507cb9 100644
--- a/website/docs/zh-CN/geometries/vc-geometry-polyline.md
+++ b/website/docs/zh-CN/geometries/vc-geometry-polyline.md
@@ -82,6 +82,7 @@
           colors2.value.push(Cesium.Color.fromRandom({ alpha: 1.0 }))
         }
         window.positions1 = positions1
+        window.colors1 = colors1
         appearance.value = new Cesium.PolylineColorAppearance()
         vertexFormat.value = Cesium.PolylineColorAppearance.VERTEX_FORMAT
       }
diff --git a/website/docs/zh-CN/quickstart.md b/website/docs/zh-CN/quickstart.md
index 813c952b2..3e1c3e23d 100644
--- a/website/docs/zh-CN/quickstart.md
+++ b/website/docs/zh-CN/quickstart.md
@@ -116,7 +116,7 @@ import 'vue-cesium/dist/index.css'
       "vue-cesium/Cesium"
     ]
   },
-  "include": ["src/**/*", "node_modules/vue-cesium/Cesium.d.ts"]
+  "include": ["src/**/*", "node_modules/vue-cesium/Cesium.d.ts", "node_modules/vue-cesium/global.d.ts"]
 }
 ```