gis-view-webgl2 0.1.16 → 0.1.17

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (92) hide show
  1. package/dist/gis-view.css +1 -1
  2. package/dist/index.cjs +1 -1
  3. package/dist/index.d.ts +141 -25
  4. package/dist/index.js +1 -1
  5. package/docs/AI/345/257/271/350/257/235/346/261/207/346/200/273.md +40 -314
  6. package/docs/GisView.md +1 -1
  7. package/docs/ai/06-/344/274/232/350/257/235/347/264/242/345/274/225/344/270/216/345/244/215/346/237/245/346/226/271/346/263/225.md +30 -247
  8. package/docs/demos/DemoShell.vue +2 -2
  9. package/docs/demos/EventDemo.vue +5 -3
  10. package/docs/demos/ExportImageDemo.vue +170 -0
  11. package/docs/demos/HeatmapDemo.vue +173 -0
  12. package/docs/demos/HistoryShortcutDemo.vue +159 -0
  13. package/docs/demos/ItemContentDemo.vue +611 -0
  14. package/docs/demos/PerfDemo.vue +162 -3
  15. package/docs/demos/ScaleLimitsDemo.vue +268 -0
  16. package/docs/demos/SearchFilterDemo.vue +29 -6
  17. package/docs/demos/SelectionBoxDemo.vue +175 -0
  18. package/docs/demos/StyleDemo.vue +69 -6
  19. package/docs/demos/api-index.js +16 -14
  20. package/docs/demos/demos.js +66 -26
  21. package/docs/demos/shared/demoStyle.css +15 -10
  22. package/docs/format/07-/344/272/213/344/273/266/350/275/275/350/215/267/344/270/216/347/244/272/344/276/213/346/225/260/346/215/256.md +3 -3
  23. package/docs/from0/00-WebGL/351/233/266/345/237/272/347/241/200/345/205/245/351/227/250.md +290 -0
  24. package/docs/from0/01-/345/205/210/346/212/212/345/234/260/345/233/276/346/203/263/346/270/205/346/245/232.md +1 -1
  25. package/docs/from0/02-WebGL2/350/265/267/346/255/245.md +27 -15
  26. package/docs/from0/03-/347/224/273/347/254/254/344/270/200/346/211/271/347/202/271.md +3 -1
  27. package/docs/from0/04-/347/224/273/347/272/277.md +9 -6
  28. package/docs/from0/05-/347/233/270/346/234/272/344/270/216/344/272/244/344/272/222.md +3 -2
  29. package/docs/from0/11-/346/200/247/350/203/275-/345/215/201/344/270/207/347/272/247/346/225/260/346/215/256.md +1 -1
  30. package/docs/from0/12-/346/211/223/345/214/205/344/270/216/351/230/205/350/257/273.md +1 -1
  31. package/docs/from0/14-/344/273/216/351/233/266/346/220/255/344/270/200/346/225/264/345/245/227-/344/270/213.md +1 -1
  32. package/docs/index.html +151 -8
  33. package/docs/internals/02-/344/273/216/345/210/233/345/273/272/345/210/260/347/254/254/344/270/200/345/270/247.md +2 -2
  34. package/docs/internals/05-/346/213/276/345/217/226.md +6 -3
  35. package/docs/internals/11-/350/246/206/347/233/226/345/261/202/346/240/207/347/255/276/344/270/216/346/217/220/347/244/272.md +2 -0
  36. package/docs/internals/15-01-/351/200/220/350/275/256/350/256/260/345/275/225-/346/226/260/345/242/236/344/270/216/344/277/256/345/244/215.md +2 -2
  37. package/docs/internals/15-02-/351/200/220/350/275/256/350/256/260/345/275/225-/346/200/247/350/203/275/344/270/216/344/277/256/345/244/215-/344/270/212.md +5 -5
  38. package/docs/internals/15-03-/351/200/220/350/275/256/350/256/260/345/275/225-/346/200/247/350/203/275/344/270/216/344/277/256/345/244/215-/344/270/213.md +18 -18
  39. package/docs/internals/15-04-/351/200/220/350/275/256/350/256/260/345/275/225-/347/203/255/345/212/233/345/233/276/344/270/216/346/200/247/350/203/275.md +12 -12
  40. package/docs/internals/16-03-/344/274/230/345/214/226/344/270/216/345/217/226/350/210/215-/344/270/213.md +1 -1
  41. package/docs/internals/18-/346/200/247/350/203/275/345/256/236/346/265/213/344/270/216WebGPU/350/257/204/344/274/260.md +116 -3
  42. package/docs/manual/02-/345/235/220/346/240/207/344/270/216/346/225/260/346/215/256.md +3 -2
  43. package/docs/manual/03-/351/205/215/347/275/256/351/241/271.md +41 -22
  44. package/docs/manual/07-/346/214/207/351/222/210/344/270/216/350/246/201/347/264/240/347/274/226/350/276/221.md +2 -2
  45. package/docs/manual/08-/351/200/211/344/270/255/344/270/216/346/213/220/347/202/271.md +3 -2
  46. package/docs/manual/11-/346/240/267/345/274/217/344/270/216/350/247/204/345/210/231.md +21 -2
  47. package/docs/manual/12-/346/240/207/347/255/276/344/270/216/350/243/205/351/245/260.md +184 -15
  48. package/docs/manual/13-/345/212/250/346/225/210/344/270/216/345/233/276/345/205/203.md +4 -4
  49. package/docs/manual/14-/350/247/206/345/233/276/344/270/216/347/255/233/351/200/211.md +94 -9
  50. package/docs/manual/16-/345/256/236/344/276/213/346/226/271/346/263/225/346/200/273/350/241/250.md +6 -5
  51. package/docs/manual/17-/345/217/202/346/225/260/351/200/237/346/237/245.md +5 -4
  52. package/docs/manual/18-/351/200/220/346/226/271/346/263/225/347/244/272/344/276/213.md +10 -3
  53. package/docs/manual/20-/346/200/247/350/203/275/344/270/216/345/244/247/346/225/260/346/215/256.md +107 -12
  54. package/docs/manual/21-/350/257/264/346/230/216/344/270/216/345/270/270/350/247/201/351/227/256/351/242/230.md +2 -2
  55. package/docs/playground/index.html +2 -2
  56. package/docs/steps/README.md +4 -3
  57. package/docs/steps/bench-scale.html +6 -0
  58. package/docs/steps/index.html +45 -1
  59. package/docs/steps/rounds/01-/347/254/2541-11/350/275/256.md +14 -14
  60. package/docs/steps/rounds/02-/347/254/25412-22/350/275/256.md +14 -14
  61. package/docs/steps/rounds/03-/347/254/25423-33/350/275/256.md +9 -9
  62. package/docs/steps/rounds/04-/347/254/25434-44/350/275/256.md +2 -2
  63. package/docs/steps/rounds/05-/347/254/25445-55/350/275/256.md +8 -8
  64. package/docs/steps/rounds/06-/347/254/25456-66/350/275/256.md +3 -3
  65. package/docs/steps/rounds/07-/347/254/25467-77/350/275/256.md +4 -4
  66. package/docs/steps/rounds/08-/347/254/25478-88/350/275/256.md +2 -2
  67. package/docs/steps/selftest-demos.html +399 -373
  68. package/docs/steps/selftest-docs.html +11 -9
  69. package/docs/steps/selftest-features.html +104 -0
  70. package/docs/steps/selftest-labels.html +169 -14
  71. package/docs/steps/selftest-perf.html +320 -40
  72. package/docs/steps/selftest-scale.html +111 -0
  73. package/docs/steps/selftest-webgl.html +85 -0
  74. package/docs/steps/step-11-background.js +1 -1
  75. package/docs/steps/webgl-basics.html +737 -0
  76. package/docs//344/273/2160/345/210/260/345/256/214/346/225/264/347/232/204/345/256/236/347/216/260.md +5 -3
  77. package/package.json +1 -1
  78. package/docs/demos/GisViewDemo.vue +0 -64
  79. package/docs/demos/gis-view-demo/GisViewDemoCardHeader.vue +0 -29
  80. package/docs/demos/gis-view-demo/GisViewDemoDialogs.vue +0 -82
  81. package/docs/demos/gis-view-demo/GisViewDemoFooter.vue +0 -16
  82. package/docs/demos/gis-view-demo/GisViewDemoHeading.vue +0 -16
  83. package/docs/demos/gis-view-demo/GisViewDemoPanelStack.vue +0 -71
  84. package/docs/demos/gis-view-demo/GisViewDemoStage.vue +0 -228
  85. package/docs/demos/gis-view-demo/demo.css +0 -1306
  86. package/docs/demos/gis-view-demo/demoContext.js +0 -12
  87. package/docs/demos/gis-view-demo/panels/DataPanels.vue +0 -303
  88. package/docs/demos/gis-view-demo/panels/OpsPanels.vue +0 -174
  89. package/docs/demos/gis-view-demo/panels/StylePanels.vue +0 -589
  90. package/docs/demos/gis-view-demo/panels/ViewPanels.vue +0 -426
  91. package/docs/demos/gis-view-demo/useGisViewDemo.js +0 -6440
  92. package/docs/steps/selftest-demo.html +0 -815
package/dist/index.d.ts CHANGED
@@ -13,6 +13,31 @@ export interface GisViewCamera {
13
13
  scale: number
14
14
  }
15
15
 
16
+ /** 当前实际生效的缩放范围 */
17
+ export interface GisViewScaleRange {
18
+ /** 实际生效的最小比例(像素 / 世界单位) */
19
+ min: number
20
+ /** 实际生效的最大比例(像素 / 世界单位) */
21
+ max: number
22
+ /** min 的来源:number 是固定配置;fit 表示按当前数据范围与 fitPadding 自动计算 */
23
+ minMode: 'number' | 'fit'
24
+ }
25
+
26
+ /** 拾取外扩容差(CSS 像素):在绘制出来的形状之外再放宽多少 */
27
+ export interface GisViewPickToleranceOptions {
28
+ /** 节点:在符号半径之外再放宽,缺省 3 */
29
+ point?: number
30
+ /** 线路:在线宽的一半之外再放宽,缺省 3 */
31
+ line?: number
32
+ /** 拐点:在拐点半径之外再放宽,缺省 3 */
33
+ waypoint?: number
34
+ /** 点聚合圆:在聚合半径之外再放宽,缺省 3 */
35
+ cluster?: number
36
+ }
37
+
38
+ /** 拾取容差:一个数字表示四类目标共用,对象写法可分别设置;0 表示严格贴着绘制形状 */
39
+ export type GisViewPickToleranceInput = number | GisViewPickToleranceOptions
40
+
16
41
  /** 用户操作空闲回调 / idle 事件的载荷 */
17
42
  export interface GisViewIdlePayload {
18
43
  /** 距离创建或上一次指针 / 滚轮 / 键盘操作的毫秒数 */
@@ -4576,8 +4601,9 @@ export type GisViewDenseMode = 'auto' | 'on' | 'off'
4576
4601
 
4577
4602
  /**
4578
4603
  * denseMode 的对象写法:阈值都按「正数才生效」处理,不写用内置缺省。
4579
- * `visibleThreshold` 是视口内节点数,`densityThreshold` 是每百万 CSS 像素的节点数,
4580
- * `pointThreshold` 是整份数据的节点总数;任意一项越线就进入 dense。
4604
+ * `visibleThreshold` / `visibleLineThreshold` 是视口内节点 / 线路数,
4605
+ * `densityThreshold` 是每百万 CSS 像素的节点密度,
4606
+ * `pointThreshold` / `lineThreshold` 是整份数据的节点 / 线路总数;任意一项越线就进入 dense。
4581
4607
  */
4582
4608
  export interface GisViewDenseModeOptions {
4583
4609
  mode?: GisViewDenseMode
@@ -4587,6 +4613,10 @@ export interface GisViewDenseModeOptions {
4587
4613
  densityThreshold?: number
4588
4614
  /** 数据总节点数阈值,默认 50000(只看总量,不要求同屏) */
4589
4615
  pointThreshold?: number
4616
+ /** 视口内可见线路达到多少条进入密集档,默认 12000 */
4617
+ visibleLineThreshold?: number
4618
+ /** 数据总线路数阈值,默认 30000(只看总量,不要求同屏) */
4619
+ lineThreshold?: number
4590
4620
  }
4591
4621
 
4592
4622
  /** denseMode 的入参:布尔值 true / false 等价于 'on' / 'off' */
@@ -4596,13 +4626,25 @@ export type GisViewDenseModeInput = boolean | GisViewDenseMode | GisViewDenseMod
4596
4626
  export interface GisViewDenseState {
4597
4627
  mode: GisViewDenseMode
4598
4628
  active: boolean
4629
+ /** 当前自适应档位:normal 不降级 / dense 标签优化 + 暂停动效 / extreme 再接管 quality: 'auto' */
4630
+ tier: 'normal' | 'dense' | 'extreme'
4599
4631
  /** 这次判定的依据(checking 表示还在等首帧 / 发散渲染铺完) */
4600
- reason: 'manual-on' | 'manual-off' | 'total' | 'visible' | 'density' | 'below-threshold' | 'checking'
4632
+ reason: 'manual-on' | 'manual-off' | 'total' | 'line-total' | 'visible' | 'visible-line' | 'density' | 'below-threshold' | 'checking'
4601
4633
  /** 最近一次量到的可见节点数(只数到触发阈值;按总量触发时是 null) */
4602
4634
  visiblePoints: number | null
4635
+ /** 最近一次量到的可见线路数(与 visiblePoints 同一口径,按总量触发时是 null) */
4636
+ visibleLines: number | null
4603
4637
  visibleThreshold: number
4604
4638
  densityThreshold: number
4605
4639
  pointThreshold: number
4640
+ visibleLineThreshold: number
4641
+ lineThreshold: number
4642
+ /** 当前自动启用的优化项;qualityAuto 为 true 表示 extreme 正在代管画质档 */
4643
+ strategy: {
4644
+ labelOptimize: boolean
4645
+ effectsPaused: boolean
4646
+ qualityAuto: boolean
4647
+ }
4606
4648
  }
4607
4649
 
4608
4650
  /** 渲染帧回调载荷:onStats 的读数 + 帧序号 / 节流间隔 / 时刻与当前相机 */
@@ -4723,6 +4765,23 @@ export interface GisViewPointRule {
4723
4765
  name?: string
4724
4766
  }
4725
4767
 
4768
+ /**
4769
+ * 线路规则能写的样式:在普通线样式之外多一份 decorations。
4770
+ * 默认普通规则只在线路自身没写 `decorations` 时补这份清单,`override: true` 时整份替换;
4771
+ * 规则根上的 `decorationsMode` / `decorationsPriority` 可以显式改成合并或覆盖。
4772
+ * 规则装饰只在渲染层生效,不会写回 `lines[].decorations`。
4773
+ */
4774
+ export interface GisViewLineRuleStyle extends GisViewLineStyle {
4775
+ /** 命中该规则时使用的线路装饰清单;写法与 `lines[].decorations` 一致 */
4776
+ decorations?: GisViewLineDecoration[]
4777
+ }
4778
+
4779
+ /** 规则装饰与线路自身装饰的关系:保持旧口径 / 合并 / 规则整份覆盖 */
4780
+ export type GisViewLineDecorationsMode = 'default' | 'merge' | 'replace'
4781
+
4782
+ /** 合并时哪一份优先级更高(后画、压在上面):'line'(缺省)线路自身,'rule' 规则装饰 */
4783
+ export type GisViewLineDecorationsPriority = 'line' | 'rule'
4784
+
4726
4785
  /**
4727
4786
  * 线的批量样式规则:条件命中就套用 style。
4728
4787
  * 缺省只补线自身没写的字段;写 `override: true` 时这条规则的字段压过线自身字段,
@@ -4730,9 +4789,19 @@ export interface GisViewPointRule {
4730
4789
  */
4731
4790
  export interface GisViewLineRule {
4732
4791
  when?: GisViewConditionInput<GisViewLine>
4733
- style: GisViewLineStyle
4792
+ style: GisViewLineRuleStyle
4734
4793
  /** 优先级:缺省 false(规则只补线自身没写的字段);true 时这条规则的样式压过线自身字段 */
4735
4794
  override?: boolean
4795
+ /**
4796
+ * 规则装饰与线路自身 `decorations` 的关系,只在 `style.decorations` 有值时生效:
4797
+ * - `default`(缺省):保持旧行为 —— 普通规则只补线路没写装饰的情况,`override: true` 整份替换;
4798
+ * - `merge`:把两份清单合并;`decorationsPriority` 决定谁后画(高优先级压在上面);
4799
+ * - `replace`:规则装饰整份替换线路自身装饰,不要求写 `override: true`。
4800
+ * 多条命中规则各自带装饰时,仍按普通 / override 两层各自取最后命中的那一条。
4801
+ */
4802
+ decorationsMode?: GisViewLineDecorationsMode
4803
+ /** `decorationsMode: 'merge'` 时谁压在上面,缺省 `'line'`;`'rule'` 时规则装饰后画 */
4804
+ decorationsPriority?: GisViewLineDecorationsPriority
4736
4805
  name?: string
4737
4806
  }
4738
4807
 
@@ -4766,7 +4835,11 @@ export type GisViewLineLabelPosition = number | string | { ratio?: number; dista
4766
4835
  export interface GisViewLabelPayload {
4767
4836
  /** 在 points 数组里的下标 */
4768
4837
  index: number
4838
+ /** 当前标签定义的 id(同一节点上有多条标签时用来区分) */
4839
+ labelId?: string
4769
4840
  item: GisViewPoint
4841
+ /** ECharts 风格别名:与 item 指向同一份节点数据 */
4842
+ data: GisViewPoint
4770
4843
  /** 世界坐标 */
4771
4844
  x: number
4772
4845
  y: number
@@ -4787,10 +4860,12 @@ export type GisViewLabelContent = string | ((payload: GisViewLabelPayload) => st
4787
4860
  * 也能整份把导出结果喂回来。
4788
4861
  */
4789
4862
  export interface GisViewItemLabel {
4790
- /** 这一条标签的 id:与配置里的某一条对上就合并,对不上就是这条要素自己多出来的一条 */
4863
+ /** 这一条标签的 id:与外层配置里的同 id 条目合并,对不上就是这条要素自己多出来的一条(不同 id 共存) */
4791
4864
  id?: string
4792
4865
  /** 文本来源:字符串按模板解析、函数按 payload 算,覆盖配置里的 content;false 表示这一条不画 */
4793
4866
  content?: GisViewLabelContent | GisViewLineLabelContent | false
4867
+ /** ECharts 风格别名:等价 content;两者都写时 content 优先 */
4868
+ formatter?: GisViewLabelContent | GisViewLineLabelContent
4794
4869
  /** 字符串内容是否按 HTML 渲染 */
4795
4870
  html?: boolean
4796
4871
  /** 取哪个字段作为文本,缺省按 label / name 取 */
@@ -4838,10 +4913,12 @@ export interface GisViewItemLabel {
4838
4913
  export interface GisViewLabelOptions {
4839
4914
  /** 配置了 label 就默认渲染,显式 false 关闭 */
4840
4915
  enabled?: boolean
4841
- /** 这一条标签的 id:数据里的 labels 按它对上号,updateLabel / removeLabel 用它点名改哪一条 */
4916
+ /** 这一条标签的 id:数据里的 labels 按它对上号(同 id 合并覆盖、不同 id 追加共存),updateLabel / removeLabel 用它点名改哪一条 */
4842
4917
  id?: string
4843
4918
  /** 文本来源:模板字符串或函数,缺省取点的 label / name */
4844
4919
  content?: GisViewLabelContent
4920
+ /** ECharts 风格别名:等价 content;两者都写时 content 优先 */
4921
+ formatter?: GisViewLabelContent
4845
4922
  /** 取哪个字段作为文本,缺省按 label / name 取 */
4846
4923
  field?: string
4847
4924
  /** 显示在节点的哪一侧,默认 right */
@@ -4926,7 +5003,11 @@ export interface GisViewLabelOptions {
4926
5003
  export interface GisViewLineLabelPayload {
4927
5004
  /** 在 lines 数组里的下标 */
4928
5005
  index: number
5006
+ /** 当前标签定义的 id(同一条线上有多条标签时用来区分) */
5007
+ labelId?: string
4929
5008
  item: GisViewLine
5009
+ /** ECharts 风格别名:与 item 指向同一份线路数据 */
5010
+ data: GisViewLine
4930
5011
  /** 路径总长度与锚点距起点的长度(世界单位) */
4931
5012
  length: number
4932
5013
  distance: number
@@ -4947,10 +5028,12 @@ export type GisViewLineLabelContent = string | ((payload: GisViewLineLabelPayloa
4947
5028
  export interface GisViewLineLabelOptions {
4948
5029
  /** 配置了就默认渲染,显式 false 关闭 */
4949
5030
  enabled?: boolean
4950
- /** 这一条标签的 id:数据里的 labels 按它对上号,updateLabel / removeLabel 用它点名改哪一条 */
5031
+ /** 这一条标签的 id:数据里的 labels 按它对上号(同 id 合并覆盖、不同 id 追加共存),updateLabel / removeLabel 用它点名改哪一条 */
4951
5032
  id?: string
4952
5033
  /** 文本来源:模板字符串或函数,缺省取线的 label / name */
4953
5034
  content?: GisViewLineLabelContent
5035
+ /** ECharts 风格别名:等价 content;两者都写时 content 优先 */
5036
+ formatter?: GisViewLineLabelContent
4954
5037
  /** 取哪个字段作为文本,缺省按 label / name 取 */
4955
5038
  field?: string
4956
5039
  /** 沿线位置,缺省 0.5(中点),见 GisViewLineLabelPosition */
@@ -5657,14 +5740,16 @@ export interface GisViewDecorationCommitResult {
5657
5740
  draft?: GisViewDecorationDraftPayload
5658
5741
  }
5659
5742
 
5660
- /** 悬浮提示内容:模板字符串(`{name}` / `{vnkv}`)或返回文本 / 元素 / null 的函数 */
5661
- export type GisViewTooltipContent = string | ((payload: GisViewPickResult) => string | HTMLElement | number | null | undefined)
5743
+ /** 悬浮提示内容:模板字符串(`{name}` / `{vnkv}`)或返回文本 / 元素 / null 的函数;函数的 data 与 item 同一份 */
5744
+ export type GisViewTooltipContent = string | ((params: GisViewPickResult & { data: GisViewPoint | GisViewLine }) => string | HTMLElement | number | null | undefined)
5662
5745
 
5663
5746
  export interface GisViewTooltipOptions {
5664
5747
  /** 配置了 tooltip 就默认显示,显式 false 关闭 */
5665
5748
  enabled?: boolean
5666
5749
  /** 兜底内容:没配分类内容时用 */
5667
5750
  content?: GisViewTooltipContent
5751
+ /** ECharts 风格别名:等价 content;两者都写时 content 优先 */
5752
+ formatter?: GisViewTooltipContent
5668
5753
  /** 节点专属内容,false 表示节点不显示提示 */
5669
5754
  point?: GisViewTooltipContent | false
5670
5755
  /** 线专属内容,false 表示线不显示提示 */
@@ -7057,8 +7142,8 @@ export interface GisViewOptions {
7057
7142
  */
7058
7143
  quality?: GisViewQualityOptions
7059
7144
  /**
7060
- * 大数据展示模式:`'auto'`(缺省)按视口内可见节点数、屏幕密度与数据总量自动切;
7061
- * `'on'` / `'off'` / true / false 强制开关;对象写法可改三档阈值(见 GisViewDenseModeOptions)。
7145
+ * 大数据展示模式:`'auto'`(缺省)按可见节点 / 线路数、节点屏幕密度与数据总量自动切;
7146
+ * `'on'` / `'off'` / true / false 强制开关;对象写法可改点 / 线各自阈值(见 GisViewDenseModeOptions)。
7062
7147
  * 进入密集档后标签自动走避让 / 截断(等价 labelOptimize: true),线路动点与节点涟漪暂停;
7063
7148
  * 运行时用 updateOptions({ denseMode }) 切换,当前有效值与判定依据看 getStats().dense。
7064
7149
  */
@@ -7148,14 +7233,16 @@ export interface GisViewOptions {
7148
7233
  /**
7149
7234
  * 节点标签:配了就按这个配置渲染,内容、位置、数量与显隐都可配。
7150
7235
  * 写数组就是「一个节点上显示多条标签」:数组里每一条各自有内容 / 位置 / 样式 / 显隐,
7151
- * 用 id 与数据里的 labels 对上号(不写 id 时第一个是 default,之后是 label2 / label3…)
7236
+ * 用 id 与数据里的 labels 对上号(不写 id 时第一个是 default,之后是 label2 / label3…)。
7237
+ * 也可直接写字符串 / 函数,等价于只设置 content;对象里的 formatter 是 content 的别名。
7152
7238
  */
7153
- label?: GisViewLabelOptions | GisViewLabelOptions[]
7239
+ label?: GisViewLabelOptions | GisViewLabelContent | Array<GisViewLabelOptions | GisViewLabelContent>
7154
7240
  /**
7155
7241
  * 线路标签:按比例或绝对距离摆在线路上任意位置,内容与避让同样可配;
7156
- * 写数组就是「一条线上显示多条标签」,与节点标签同一套逐条写法
7242
+ * 写数组就是「一条线上显示多条标签」,与节点标签同一套逐条写法;
7243
+ * 最外层同样可直接写字符串 / 函数,对象里的 formatter 与 content 等价。
7157
7244
  */
7158
- lineLabel?: GisViewLineLabelOptions | GisViewLineLabelOptions[]
7245
+ lineLabel?: GisViewLineLabelOptions | GisViewLineLabelContent | Array<GisViewLineLabelOptions | GisViewLineLabelContent>
7159
7246
  /**
7160
7247
  * 标签显示优化开关,缺省 `false`:关着(缺省)走「强制显示」——不避让、不按 maxCount 截断、
7161
7248
  * 不设扫描预算 / 候选上限,视口内该出现的标签一条不少;打开(`true`)与从前完全一致:
@@ -7186,8 +7273,8 @@ export interface GisViewOptions {
7186
7273
  * updateGraphic / removeGraphic / clearGraphics 增删改;exportImage 的 PNG / SVG 都会带上这一层。
7187
7274
  */
7188
7275
  graphics?: GisViewGraphic[]
7189
- /** 悬停提示:配了就按这个配置显示,点 / 线 / 通道可分别配置内容 */
7190
- tooltip?: GisViewTooltipOptions
7276
+ /** 悬停提示:配了就按这个配置显示,点 / 线 / 通道可分别配置内容;也可直接写字符串 / 函数,对象里的 formatter 与 content 等价 */
7277
+ tooltip?: GisViewTooltipOptions | GisViewTooltipContent
7191
7278
  /** 初始筛选条件,等价于创建之后调用 setFilter;可以写完整格式,也可以只给节点条件 */
7192
7279
  filter?: GisViewFilterInput | null
7193
7280
  /**
@@ -7302,6 +7389,13 @@ export interface GisViewOptions {
7302
7389
  * 还能配按住 Ctrl / ⌘ 时的另一套。不配时用 gis-view.css 里的 --gis-view-cursor-* 变量
7303
7390
  */
7304
7391
  cursorStyle?: GisViewCursorStyle
7392
+ /**
7393
+ * 拾取外扩容差(CSS 像素):在节点符号、线路、拐点、聚合圆实际画出来的边缘之外再放宽多少。
7394
+ * 数字写法四类共用;对象可分别给 point / line / waypoint / cluster,缺省各 3px。
7395
+ * 觉得「没点在线上 / 节点上也会命中」就调到 0 ~ 2;触屏或小目标可以适当放大。
7396
+ * 运行时 updateOptions({ pickTolerance }) 立即生效,下一次拾取按新值计算。
7397
+ */
7398
+ pickTolerance?: GisViewPickToleranceInput
7305
7399
  /**
7306
7400
  * 拖动节点时线路是否实时跟随:默认 true(拖动过程中线路端点一路跟着走)。
7307
7401
  * 关掉之后拖动期间只移动节点本身,线路保持原样,停手(pointerup)时一次性更新到新位置。
@@ -7372,8 +7466,12 @@ export interface GisViewOptions {
7372
7466
  waypointStyle?: GisViewPointStyle
7373
7467
  /** 拐点被选中时的样式:没有配置(且 defaultHighlight 为 false)时选中不改变外观 */
7374
7468
  waypointSelectStyle?: GisViewPointStyle
7375
- /** 相机比例下限(像素 / 世界单位),默认 0.002 */
7376
- minScale?: number
7469
+ /**
7470
+ * 相机比例下限(像素 / 世界单位),默认 0.002。
7471
+ * 写 'fit' 时按当前数据包围盒与 fitPadding 自动计算,缩到最小时至少能看见完整网架;
7472
+ * 数据范围、视口尺寸或 fitPadding 变化后,下限会跟着更新。
7473
+ */
7474
+ minScale?: number | 'fit'
7377
7475
  /** 相机比例上限(像素 / 世界单位),默认 1000000000;显式值仍会限制 fitSpacing 能达到的间距 */
7378
7476
  maxScale?: number
7379
7477
  /** 适应视图时四周留白(CSS 像素) */
@@ -7579,14 +7677,17 @@ export type GisViewSearchScope = 'points' | 'lines' | 'channels' | 'groups'
7579
7677
  export type GisViewSearchScopeInput = GisViewSearchScope | 'point' | 'line' | 'channel' | 'group'
7580
7678
 
7581
7679
  export interface GisViewSearchOptions {
7582
- /** 关键字:空格分隔多个词时要在同一个字段里全部出现才命中,不区分大小写 */
7680
+ /** 关键字:不区分大小写的子串匹配;空格分隔多个词时要在同一个字段里全部出现才命中 */
7583
7681
  keyword?: string
7584
7682
  /**
7585
7683
  * 搜索范围,缺省四类都搜。复数的 points / lines / channels / groups 与单数别名
7586
7684
  * point / line / channel / group 都收;写错或空数组会回落到四类全搜。
7587
7685
  */
7588
7686
  scope?: GisViewSearchScopeInput | GisViewSearchScopeInput[]
7589
- /** 限定参与匹配的字段路径(如 ['name', 'props.vn_kv']),缺省用要素的全部字段 */
7687
+ /**
7688
+ * 限定参与匹配的字段路径(如 ['name', 'props.vn_kv', 'props.tags.0']),缺省用要素的全部字段。
7689
+ * 路径指向对象 / 数组时会继续展开;自动全字段模式最多展开 6 层、每条 256 个标量字段。
7690
+ */
7590
7691
  fields?: string[]
7591
7692
  /** 每类要素的命中上限,缺省 200,0 表示不限 */
7592
7693
  limit?: number
@@ -7677,6 +7778,12 @@ export interface GisViewFocusOptions {
7677
7778
  * 也可以另给一批写法(见 GisViewSelectionRefs)只选别的
7678
7779
  */
7679
7780
  select?: boolean | GisViewSelectionRefs
7781
+ /**
7782
+ * 在 `select` 的结果上再额外加入一批选中项(始终按 add 处理,不受 `mode` 影响)。
7783
+ * 只写 selectAdditional 时保留当前选中集,只把这一批加进去;
7784
+ * `focusOn(hits, { select: true, selectAdditional: pinnedIds })` 可以同时选中命中和固定关注项。
7785
+ */
7786
+ selectAdditional?: GisViewSelectionRefs
7680
7787
  /** 配合 select:怎么并进当前选中集,缺省 replace(换一份) */
7681
7788
  mode?: GisViewSelectMode
7682
7789
  }
@@ -8548,7 +8655,10 @@ export interface GisViewInstance {
8548
8655
  stopCameraAnimation(): GisViewInstance
8549
8656
  /** 当前相机飞行读数;没有动画时 null */
8550
8657
  getCameraAnimation(): GisViewCameraAnimation | null
8551
- /** 按关键字搜索节点 / 线路 / 通道:只返回命中(不改数据、不改筛选、也不动视角),聚焦与选中交给使用方 */
8658
+ /**
8659
+ * 按关键字搜索节点 / 线路 / 通道 / 分组:返回命中的叶子字段与值(对象 / 数组会递归展开)。
8660
+ * 只返回命中,不改数据、不改筛选、也不动视角;聚焦与选中交给使用方。
8661
+ */
8552
8662
  search(input: string | GisViewSearchOptions): GisViewSearchResult
8553
8663
  /**
8554
8664
  * 异步搜索:与 search 同一份口径,只是数据量大时把「摊平字段 + 逐条比较」放进 Worker,
@@ -8561,6 +8671,8 @@ export interface GisViewInstance {
8561
8671
  getCamera(): GisViewCamera
8562
8672
  /** 当前视图比例(像素 / 世界单位),与 getCamera().scale 同一份读数 */
8563
8673
  getScale(): number
8674
+ /** 当前实际生效的缩放范围;minScale: 'fit' 时 min 随数据范围与视口实时计算,可直接驱动外部滑块 */
8675
+ getScaleRange(): GisViewScaleRange
8564
8676
  /** 直接设置视图比例;origin 是画布 CSS 像素锚点,缺省为视口中心 */
8565
8677
  setScale(scale: number, origin?: [number, number]): GisViewInstance
8566
8678
  /** 当前视图中心 [x, y](返回副本,可直接改) */
@@ -9576,6 +9688,8 @@ export interface GisViewEngineOptions {
9576
9688
  selectionBoxPersistent?: boolean
9577
9689
  /** 选中 / 拖动 / 待确认合并的节点、选中通道以及它们的 decorations 是否画在所有要素之上,默认 true */
9578
9690
  selectionOnTop?: boolean
9691
+ /** 拾取外扩容差(CSS 像素),见 GisViewOptions.pickTolerance */
9692
+ pickTolerance?: GisViewPickToleranceInput
9579
9693
  /**
9580
9694
  * 通道选中模式:点中通道里的一条回线时选中什么 —— 'line'(缺省)只选这一条、'group' 连它所在分组、
9581
9695
  * 'channel' 整条通道;通道以外的线路永远只选自己。它只影响「下一次点选怎么摊开选中集」,
@@ -9600,7 +9714,8 @@ export interface GisViewEngineOptions {
9600
9714
  waypointVisibility?: 'selected' | 'always'
9601
9715
  waypointStyle?: GisViewPointStyle | null
9602
9716
  waypointSelectStyle?: GisViewPointStyle | null
9603
- minScale?: number
9717
+ /** 相机比例下限:数字为固定值;'fit' 按当前数据范围与 fitPadding 自动计算 */
9718
+ minScale?: number | 'fit'
9604
9719
  maxScale?: number
9605
9720
  fitPadding?: number
9606
9721
  pixelRatio?: number
@@ -9823,9 +9938,10 @@ export interface GisViewEngine {
9823
9938
  forEachLine(visit: (index: number, item: GisViewLine, path: ReadonlyArray<[number, number]>) => void): void
9824
9939
  /**
9825
9940
  * 上一条的视口版:只遍历路径包围盒和给定世界范围相交的线。
9826
- * 线路标签排版用它做粗筛,十万条线时不必为了几十个标签扫描整份数据。
9941
+ * 线路标签排版用它做粗筛,十万条线时不必为了几十个标签扫描整份数据;
9942
+ * 回调返回 false 可提前结束(密集档统计只数到阈值的两倍)。
9827
9943
  */
9828
- forEachLineInView(rect: GisViewBounds, visit: (index: number, item: GisViewLine, path: ReadonlyArray<[number, number]>) => void): void
9944
+ forEachLineInView(rect: GisViewBounds, visit: (index: number, item: GisViewLine, path: ReadonlyArray<[number, number]>) => void | boolean): void
9829
9945
  /**
9830
9946
  * 上一条的点版:只遍历落在给定世界矩形里的可见节点(数据顺序、不建中间数组)。
9831
9947
  * 标签排版用它做视口粗筛,十万级数据放大看一小片时不必整份扫一遍。