docs: update docs

zouyaoji · Sep 7, 2022 · b21bd94 · b21bd94
1 parent 6286cd6
commit b21bd94
Show file tree

Hide file tree

Showing 7 changed files with 47 additions and 6 deletions.
diff --git 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
@@ -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
@@ -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
@@ -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
@@ -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,14 +21,23 @@
 
 ```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>
     </vc-entity>
     <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
@@ -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
@@ -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"]
 }
 ```