[fix]整理jsdoc parameter 少了mapboxgl的部分 review by qiw

Author: luoxiao-supermap

build/jsdocs/template/publish.js

@@ -556,12 +556,7 @@ exports.publish = function (taffyData, opts, tutorials) {
     baseTypes.forEach((reg) => {
       linkNames = linkNames.replace(new RegExp(reg, 'ig'), '');
     });
-    return linkNames
-      .replace(/\|/g, '')
-      .replace(/\(\)/g, '')
-      .replace(/(\.<>)/g, '')
-      .replace(/(\.<>)/g, '')
-      .replace(/(\.<>)/g, '');
+    return linkNames.replace(/\|/g, '').replace(/\(/g, '').replace(/\)/g, '').replace(/\./g, '').replace(/</g, '').replace(/>/g, '');
   }
   function getLinkHref(str) {
     const haslink_reg = /<a[^>]*href=["'](?<url>[^"']*?)["'][^>]*>(?<text>[\w\W]*?)<\/a>/g;

build/jsdocs/template/typeLinkExt.js

@@ -4,7 +4,7 @@ var mbglapi = "https://www.mapbox.com/mapbox-gl-js/api/";
 var mapv = "https://github.com/huiyan-fe/mapv/blob/master/src/";
 var classicapi="https://iclient.supermap.io/web/libs/iclient8c/apidoc/files/SuperMap"
 var geojsonapi = "https://geojson.org";
-var geometryapi="https://datatracker.ietf.org/doc/html/rfc7946#section-3.1";
+var geometryapi="https://datatracker.ietf.org/doc/html/rfc7946";
 var helpDocApi = "https://iportal.supermap.io/iportal/help/html/zh/index.htm";
 var webApi = "https://developer.mozilla.org/zh-CN/docs/Web/";
 var threeApi = "https://threejs.org/docs/index.html";
@@ -92,8 +92,8 @@ var typeLinks = {
 
     // GeoJSON
     "GeoJSONObject": geojsonapi,
-    "GeoJSONGeometry": geometryapi,
-
+    "GeoJSONGeometry": geometryapi +'#section-3.1',
+    "GeoJSONFeature": geometryapi + '#section-3.2',
     // WebMap 结构
     "WebMapSummaryObject": helpDocApi + '#iP/Appendix/WebMap/WebMapSummary.htm',
 

examples/mapboxgl/04_mathExpressionAnalysisService.html

@@ -63,13 +63,6 @@
             //结果数据集名称,必设
             resultGridName: "MathExpressionAnalysis_Result",
             deleteExistResultDataset: true
-            /*//指定数据集中参与栅格代数运算的区域
-             extractRegion: L.polygon([
-             [38, 116],
-             [38, 117],
-             [42, 117],
-             [42, 116]
-             ])*/
         });
         //向iServer发起栅格代数运算请求
         mathExpressionAnalysisService.mathExpressionAnalysis(mathExpressionAnalysisParameters, function (serviceResult) {

src/common/commontypes/Bounds.js

@@ -312,7 +312,7 @@ export class Bounds {
      * var bounds1 = new Bounds(-50,-50,40,40);
      * //bounds 改变
      * bounds.extend(new LonLat(50,60));
-     * @param {(GeometryPoint|LonLat|Bounds)} object - 可以是 point、lonlat 和 bounds。
+     * @param {GeometryPoint|LonLat|Bounds} object - 可以是 point、lonlat 和 bounds。
      */
     extend(object) {
         var bounds = null;

src/common/iServer/BuffersAnalystJobsParameter.js

@@ -13,7 +13,7 @@ import { MappingParameters } from './MappingParameters';
  * @classdesc 缓冲区分析任务参数类。
  * @param {Object} options - 参数。
  * @param {string} options.datasetName - 数据集名。
- * @param {(Bounds|L.Bounds|ol.extent)} [options.bounds] - 分析范围（默认为全图范围）。
+ * @param {(SuperMap.Bounds|L.Bounds|L.LatLngBounds|ol.extent|mapboxgl.LngLatBounds|GeoJSONObject)} [options.bounds] - 分析范围（默认为全图范围）。
  * @param {string} [options.distance='15'] - 缓冲距离，或缓冲区半径。
  * @param {string} [options.distanceField='pickup_latitude'] - 缓冲区分析距离字段。
  * @param {AnalystSizeUnit} [options.distanceUnit=AnalystSizeUnit.METER] - 缓冲距离单位单位。
@@ -30,7 +30,7 @@ export class BuffersAnalystJobsParameter {
         this.datasetName = '';
 
         /**
-         * @member {(Bounds|L.Bounds|ol.extent)} BuffersAnalystJobsParameter.prototype.bounds
+         * @member {(SuperMap.Bounds|L.Bounds|L.LatLngBounds|ol.extent|mapboxgl.LngLatBounds|GeoJSONObject)} BuffersAnalystJobsParameter.prototype.bounds
          * @description 分析范围。
          */
         this.bounds = '';

src/common/iServer/ChartQueryParameters.js

@@ -14,7 +14,7 @@ import {ChartQueryFilterParameter} from './ChartQueryFilterParameter';
  * @param {string} options.queryMode - 海图查询模式类型，支持两种查询方式：海图属性查询（"ChartAttributeQuery"）和海图空间查询（"ChartBoundsQuery"）。
  * @param {Array.<string>} options.chartLayerNames - 查询的海图图层的名称。
  * @param {Array.<ChartQueryFilterParameter>} options.chartQueryFilterParameters - 海图查询过滤参数。包括：物标代码、物标可应用对象的选择（是否查询点、线或面）、属性字段过滤条件。
- * @param {(Bounds|L.Bounds|ol.extent)} [options.bounds] - 海图查询范围。当进行海图范围查询时，此参数为必选。
+ * @param {(SuperMap.Bounds|L.Bounds|L.LatLngBounds|ol.extent|mapboxgl.LngLatBounds|GeoJSONObject)} [options.bounds] - 海图查询范围。当进行海图范围查询时，此参数为必选。
  * @param {boolean} [options.returnContent=true] - 获取或设置是返回查询结果记录集 recordsets，还是返回查询结果的资源 resourceInfo。
  * @param {number} [options.startRecord=0] - 查询起始记录位置。
  * @param {number} [options.expectCount] - 期望查询结果返回的记录数，该值大于0。
@@ -31,7 +31,7 @@ export class ChartQueryParameters {
         this.queryMode = null;
 
         /**
-         * @member {(Bounds|L.Bounds|ol.extent)} ChartQueryParameters.prototype.bounds
+         * @member {(SuperMap.Bounds|L.Bounds|L.LatLngBounds|ol.extent|mapboxgl.LngLatBounds|GeoJSONObject)} ChartQueryParameters.prototype.bounds
          * @description 海图查询范围。
          */
         this.bounds = null;

src/common/iServer/ClipParameter.js

@@ -12,7 +12,7 @@ import {ServerGeometry} from './ServerGeometry';
  * @param {Object} options - 可选参数。
  * @param {string} [options.clipDatasetName] - 裁剪的数据集名。
  * @param {string} [options.clipDatasourceName] - 裁剪的数据集所在数据源的名字。
- * @param {GeometryPolygon|L.Polygon|L.GeoJSON|ol.geom.Polygon|ol.format.GeoJSON} [options.clipRegion] - 用户指定的裁剪区域。
+ * @param {GeometryPolygon|L.Polygon|L.GeoJSON|ol.geom.Polygon|ol.format.GeoJSON|GeoJSONObject}} [options.clipRegion] - 用户指定的裁剪区域。
  * @param {boolean} [options.isClipInRegion=true] - 是否对裁剪区内的数据集进行裁剪。
  * @param {boolean} [options.isExactClip=true] - 是否使用精确裁剪。
  * @usage
@@ -34,7 +34,7 @@ export class ClipParameter {
         this.clipDatasourceName = null;
 
         /**
-         * @member {GeometryPolygon|L.Polygon|L.GeoJSON|ol.geom.Polygon|ol.format.GeoJSON} ClipParameter.prototype.clipRegion
+         * @member {GeometryPolygon|L.Polygon|L.GeoJSON|ol.geom.Polygon|ol.format.GeoJSON|GeoJSONObject} ClipParameter.prototype.clipRegion
          * @description 用户指定的裁剪区域，优先使用，clipDatasetName 与 clipRegion 必须设置一个。
          */
         this.clipRegion = null;

src/common/iServer/ComputeWeightMatrixParameters.js

@@ -11,7 +11,7 @@ import {TransportationAnalystParameter} from './TransportationAnalystParameter';
  * @classdesc 耗费矩阵分析参数类。根据交通网络分析参数中的耗费字段返回一个耗费矩阵。该矩阵是一个二维数组，用来存储任意两点间的资源消耗。
  * @param {Object} options - 参数。
  * @param {boolean} [options.isAnalyzeById=false] - 是否通过节点 ID 指定路径分析的结点。
- * @param {Array.<GeometryPoint|L.LatLng|L.Point|ol.geom.Point|number>} options.nodes - 要计算耗费矩阵的点数组。
+ * @param {Array.<GeometryPoint|L.LatLng|L.Point|ol.geom.Point|mapboxgl.LngLat|Array.<number>>} options.nodes - 要计算耗费矩阵的点数组。
  * @param {TransportationAnalystParameter} [options.parameter] - 交通网络分析通用参数。
  * @usage
  */
@@ -26,7 +26,7 @@ export class ComputeWeightMatrixParameters {
         this.isAnalyzeById = false;
 
         /**
-         * @member {Array.<GeometryPoint|L.LatLng|L.Point|ol.geom.Point|number>} ComputeWeightMatrixParameters.prototype.nodes
+         * @member {Array.<GeometryPoint|L.LatLng|L.Point|ol.geom.Point|mapboxgl.LngLat|Array.<number>>} ComputeWeightMatrixParameters.prototype.nodes
          * @description 要计算耗费矩阵的点数组。
          *              当 {@link ComputeWeightMatrixParameters.isAnalyzeById} = false 时，nodes 应为点的坐标数组；
          *              当 {@link ComputeWeightMatrixParameters.isAnalyzeById} = true 时，nodes 应为点的 ID 数组。

src/common/iServer/DatasetOverlayAnalystParameters.js

@@ -17,7 +17,7 @@ import {ServerGeometry} from './ServerGeometry';
  * @param {string} options.sourceDataset - 源数据集名称。
  * @param {Array.<string>} [options.operateDatasetFields] - 叠加分析中操作数据集保留在结果数据集中的字段名列表。
  * @param {FilterParameter} [options.operateDatasetFilter] - 设置操作数据集中空间对象过滤条件。
- * @param {Array.<GeometryPolygon|L.Polygon|ol.geom.Polygon>} [options.operateRegions] - 操作面对象集合，表示与这些面对象进行叠加分析。与 operateDataset 参数互斥，冲突时以 operateDataset 为准。
+ * @param {Array.<GeometryPolygon|L.Polygon|ol.geom.Polygon|GeoJSONObject>} [options.operateRegions] - 操作面对象集合，表示与这些面对象进行叠加分析。与 operateDataset 参数互斥，冲突时以 operateDataset 为准。
  * @param {Array.<string>} [options.sourceDatasetFields] - 叠加分析中源数据集保留在结果数据集中的字段名列表。
  * @param {FilterParameter} [options.sourceDatasetFilter] - 设置源数据集中空间对象过滤条件。
  * @param {number} [options.tolerance=0] - 容限。
@@ -50,7 +50,7 @@ export class DatasetOverlayAnalystParameters extends OverlayAnalystParameters {
         this.operateDatasetFilter = new FilterParameter();
 
         /**
-         * @member {Array.<GeometryPolygon|L.Polygon|ol.geom.Polygon>} [DatasetOverlayAnalystParameters.prototype.operateRegions]
+         * @member {Array.<GeometryPolygon|L.Polygon|ol.geom.Polygon|GeoJSONObject>} [DatasetOverlayAnalystParameters.prototype.operateRegions]
          * @description 操作面对象集合，表示与这些面对象进行叠加分析。与 operateDataset 参数互斥，冲突时以 operateDataset 为准。
          */
         this.operateRegions = [];

src/common/iServer/DensityKernelAnalystParameters.js

@@ -12,7 +12,7 @@ import {Util} from '../commontypes/Util';
  * @param {string} options.dataset - 要用来做核密度分析数据源中数据集的名称。该名称用形如 "数据集名称@数据源别名" 形式来表示，例如：BaseMap_P@Jingjin。
  * @param {string} options.fieldName - 用于进行核密度分析的测量值的字段名称，核密度分析不支持文本类型的字段。
  * @param {string} options.resultGridName - 指定结果数据集名称。
- * @param {(Bounds|L.Bounds|ol.extent)} [options.bounds] - 核密度分析的范围，用于确定结果栅格数据集的范围。如果缺省，则默认为原数据集的范围。
+ * @param {(SuperMap.Bounds|L.Bounds|L.LatLngBounds|ol.extent|mapboxgl.LngLatBounds|GeoJSONObject)} [options.bounds] - 核密度分析的范围，用于确定结果栅格数据集的范围。如果缺省，则默认为原数据集的范围。
  * @param {number} [options.searchRadius] - 栅格邻域内用于计算密度的查找半径，单位与当前数据集相同。默认值为当前数据集的长宽中的最大值除30。
  * @param {number} [options.resultGridDatasetResolution] - 密度分析结果栅格数据的分辨率，单位与当前数据集相同。默认值为当前数据集的长宽中的最小值除500。
  * @param {string} [options.targetDatasource] - 指定的存储结果数据集的数据源，默认为当前分析的数据集所在的数据源。
@@ -32,7 +32,7 @@ export class DensityKernelAnalystParameters {
         this.dataset = null;
 
         /**
-         * @member {(Bounds|L.Bounds|ol.extent)} [DensityKernelAnalystParameters.prototype.bounds]
+         * @member {(SuperMap.Bounds|L.Bounds|L.LatLngBounds|ol.extent|mapboxgl.LngLatBounds|GeoJSONObject)} [DensityKernelAnalystParameters.prototype.bounds]
          * @description 核密度分析的范围，用于确定结果栅格数据集的范围。
          * 如果缺省，则默认为原数据集的范围。
          */