补充高效率点图层api描述 review by luox

xilanhuaweidapao · xilanhuaweidapao · commit 29357a484d86 · 2022-04-07T23:44:55.000+08:00
diff --git a/src/leaflet/overlay/GraphicLayer.js b/src/leaflet/overlay/GraphicLayer.js
@@ -39,13 +39,13 @@ const DEFAULT_ZOOM_OFFSET = {
  * @param {string}   [options.render='canvas'] - 指定使用的渲染器。可选值：'webgl'，'canvas'（ webgl 渲染目前只支持散点）。
  * @param {Array.<number>} [options.color=[0, 0, 0, 255]] - 要素颜色。
  * @param {Array.<number>} [options.highlightColor] - webgl 渲染时要素高亮颜色。
- * @param {number} [options.opacity=0.8] - 要素透明度。
- * @param {number} [options.radius=10] - 要素半径，单位为像素。
+ * @param {number} [options.opacity=0.8] - 要素透明度,。当 {@link Graphic} 的 style 参数传入设置了 fillOpacity 或 opacity 的 {@link CircleStyle} 或 {@link CloverStyle}，此参数无效。{@link Graphic} 的 style 传入 {@link ImageStyle} 后不支持此参数。
+ * @param {number} [options.radius=10] - 要素半径，单位为像素。当 {@link Graphic} 的 style 参数传入了 radius，此参数无效。
  * @param {number} [options.radiusScale=1] - webgl 渲染时的要素放大倍数。
  * @param {number} [options.radiusMinPixels=0] - webgl 渲染时的要素半径最小值，单位为像素。
  * @param {number} [options.radiusMaxPixels=Number.MAX_SAFE_INTEGER] - webgl 渲染时的要素半径最大值，单位为像素。
- * @param {number} [options.strokeWidth=1] - 边框大小。
- * @param {boolean} [options.outline=false] - 是否显示边框。
+ * @param {number} [options.strokeWidth=1] - 边框大小。当 {@link Graphic} 的 style 参数传入了 weight，此参数无效。
+ * @param {boolean} [options.outline=false] - 是否显示边框。当 {@link Graphic} 的 style 参数传入设置了 stroke 的 {@link CircleStyle} 或 {@link CloverStyle}，此参数无效。
  * @param {function} [options.onClick] -  图层鼠标点击响应事件（支持 webgl、canvas 渲染）。
  * @param {function} [options.onHover] -  图层鼠标悬停响应事件（只支持 webgl 渲染）。
  * @usage
diff --git a/src/openlayers/overlay/Graphic.js b/src/openlayers/overlay/Graphic.js
@@ -41,10 +41,10 @@ const Renderer = ['canvas', 'webgl'];
  * @param {string} [options.render ='canvas']  -  指定使用的渲染器。可选值："webgl"，"canvas"（webgl 渲染目前只支持散点）。
  * @param {boolean} [options.isHighLight=true] - 事件响应是否支持要素高亮。
  * @param {ol.style.Style} [options.highLightStyle=defaultHighLightStyle] - 高亮风格。
- * @param {Array.<number>} [options.color=[0, 0, 0, 255]] - 要素颜色。
+ * @param {Array.<number>} [options.color=[0, 0, 0, 255]] - 要素颜色。当 {@link ol.Graphic} 的 style 参数传入设置了 fill 的 {@link HitCloverShape} 或 {@link CloverShape}，此参数无效。
  * @param {Array.<number>} [options.highlightColor] - webgl 渲染时要素高亮颜色。
- * @param {number} [options.opacity=0.8] - 要素透明度。
- * @param {number} [options.radius=10] - 要素半径，单位像素。
+ * @param {number} [options.opacity=0.8] - 要素透明度,。当 {@link ol.Graphic} 的 style 参数传入设置了 fillOpacity 或 strokeOpacity 的 {@link HitCloverShape} 或 {@link CloverShape}，此参数无效。
+ * @param {number} [options.radius=10] - 要素半径，单位像素。当 {@link ol.Graphic} 的 style 参数传入设置了 radius 的 {@link HitCloverShape} 或 {@link CloverShape}，此参数无效。
  * @param {number} [options.radiusScale=1] - webgl 渲染时的要素放大倍数。
  * @param {number} [options.radiusMinPixels=0] - webgl 渲染时的要素半径最小值（像素）。
  * @param {number} [options.radiusMaxPixels=Number.MAX_SAFE_INTEGER] - webgl 渲染时的要素半径最大值（像素）。
