gis-view-webgl2 0.1.5 → 0.1.7

package/docs/steps/selftest-demos.html

@@ -649,6 +649,36 @@
 						check('鹰眼图配置：范围跟相机开关打开后下发 extentFollowCamera=true', setup.minimapOptions().extentFollowCamera === true && view.getOptions().minimap.extentFollowCamera === true, String(setup.minimapOptions().extentFollowCamera))
 						extentFollowInput.click()
 						await wait(120)
+						const extentContentInput = document.querySelector('[data-demo=minimap-extent-content]')
+						check('鹰眼图配置：extentFollowContent 默认关闭，内容变化不会重算小图范围', Boolean(extentContentInput) && !extentContentInput.checked && setup.minimapOptions().extentFollowContent === false && view.getOptions().minimap.extentFollowContent === false, extentContentInput ? `checked ${extentContentInput.checked} / option ${setup.minimapOptions().extentFollowContent}` : '没有内容范围开关')
+						extentContentInput.click()
+						await wait(160)
+						check('鹰眼图配置：内容范围开关打开后下发 extentFollowContent=true', setup.minimapOptions().extentFollowContent === true && view.getOptions().minimap.extentFollowContent === true, String(setup.minimapOptions().extentFollowContent))
+						extentContentInput.click()
+						await wait(120)
+						const dragHandle = document.querySelector('[data-demo=minimap-drag-handle]')
+						const dragRoot = document.querySelector('.gis-view__minimap')
+						const dragRectBefore = dragRoot?.getBoundingClientRect()
+						if (dragHandle && dragRoot && dragRectBefore) {
+							const pointer = { bubbles: true, cancelable: true, composed: true, pointerId: 23, pointerType: 'mouse', isPrimary: true, button: 0 }
+							const startX = dragRectBefore.left + dragRectBefore.width / 2
+							const startY = dragRectBefore.top + 8
+							dragHandle.dispatchEvent(new PointerEvent('pointerdown', { ...pointer, clientX: startX, clientY: startY }))
+							dragHandle.dispatchEvent(new PointerEvent('pointermove', { ...pointer, clientX: startX + 18, clientY: startY + 12 }))
+							dragHandle.dispatchEvent(new PointerEvent('pointerup', { ...pointer, clientX: startX + 18, clientY: startY + 12 }))
+							await wait(160)
+							const dragOffset = view.getOptions().minimap.offset
+							const dragRectAfter = dragRoot.getBoundingClientRect()
+							const moved = Math.abs((dragRectAfter.left - dragRectBefore.left) - 18) < 1 && Math.abs((dragRectAfter.top - dragRectBefore.top) - 12) < 1
+							check('鹰眼图配置：顶部手柄能整体拖动鹰眼图，offset 与容器位置同步', dragOffset?.[0] === 18 && dragOffset?.[1] === 12 && moved && text('minimap-offset-readout').includes('18, 12'), `offset=${JSON.stringify(dragOffset)} / ${dragRectBefore.left},${dragRectBefore.top} -> ${dragRectAfter.left},${dragRectAfter.top}`)
+							document.querySelector('[data-demo=minimap-offset-reset]').click()
+							await wait(120)
+							const resetOffset = view.getOptions().minimap.offset
+							check('鹰眼图配置：整图位置复位回到 offset [0, 0]', resetOffset?.[0] === 0 && resetOffset?.[1] === 0 && text('minimap-offset-readout').includes('0, 0'), `${JSON.stringify(resetOffset)} / ${text('minimap-offset-readout')}`)
+						}
+						else {
+							check('鹰眼图配置：能找到整图拖动手柄', false, dragHandle ? '小图根节点尺寸为 0' : '没有整图拖动手柄')
+						}
 						const pointSizeScaleInput = document.querySelector('[data-demo=minimap-point-size-scale]')
 						const lineWidthScaleInput = document.querySelector('[data-demo=minimap-line-width-scale]')
 						check(
@@ -804,6 +834,71 @@
 							view.focusOn(groupHit)
 							view.selectFeatures(groupHit)
 							check('搜索与筛选：scope=groups 返回通道分组，并可直接聚焦 / 选中分组命中', Boolean(groupReady) && readout('search-filter-summary').includes('节点 0') && readout('search-filter-summary').includes('通道 0') && groupHit?.kind === 'group' && view.getSelections().length > 0, `${readout('search-filter-summary')} / ${JSON.stringify(groupHit)}`)
+							// 相机飞行：duration 0 立即落位；普通时长能读进度并随时停；程序化改相机会自动让路
+							view.flyTo({ minX: 0, minY: 0, maxX: 10, maxY: 10 }, { duration: 0 })
+							const landed = view.getCamera()
+							check('相机飞行：duration=0 立即落位，中心与目标一致且没有残留动画',
+								Math.abs(landed.center[0] - 5) < 1e-6 && Math.abs(landed.center[1] - 5) < 1e-6 && view.cameraAnimating === false && view.getCameraAnimation() === null,
+								JSON.stringify(landed))
+							view.flyTo({ minX: 1000, minY: 1000, maxX: 1010, maxY: 1010 }, { duration: 600 })
+							const flight = view.getCameraAnimation()
+							check('相机飞行：进行中 cameraAnimating / getCameraAnimation / 终点读数都对得上',
+								view.cameraAnimating === true && flight?.active === true && flight.duration === 600 && Math.abs(flight.to.center[0] - 1005) < 1e-6 && Math.abs(flight.to.center[1] - 1005) < 1e-6,
+								JSON.stringify(flight))
+							const stopReturned = view.stopCameraAnimation()
+							check('相机飞行：stopCameraAnimation 链式返回实例、立即结束动画',
+								stopReturned === view && view.cameraAnimating === false && view.getCameraAnimation() === null)
+							view.flyTo({ minX: 1000, minY: 1000, maxX: 1010, maxY: 1010 }, { duration: 600 })
+							view.setCamera({ center: [12, 34] })
+							const overridden = view.getCamera()
+							check('相机飞行：程序化 setCamera 会取消飞行，最终相机以调用方为准',
+								view.cameraAnimating === false && overridden.center[0] === 12 && overridden.center[1] === 34,
+								JSON.stringify(overridden))
+							click('search-filter-fly-all')
+							await wait(60)
+							const demoFlying = readout('search-filter-camera').includes('true') && view.cameraAnimating && readout('search-filter-action').includes('flyTo')
+							click('search-filter-stop-flight')
+							await wait(60)
+							const demoStopped = readout('search-filter-camera').includes('false') && !view.cameraAnimating && readout('search-filter-action').includes('stopCameraAnimation')
+							check('相机飞行 demo：按钮能启动并停止飞行，读数同步 cameraAnimating', demoFlying && demoStopped, `${readout('search-filter-camera')} / ${readout('search-filter-action')}`)
+							// flyToCamera：只给 center 时比例沿用当前相机；只给 scale 时中心沿用当前相机
+							const cameraApiScale = view.getCamera().scale
+							const flyCameraReturned = view.flyToCamera({ center: [20, 30] }, { duration: 0 })
+							const centerOnly = view.getCamera()
+							view.flyToCamera({ scale: 5 }, { duration: 0 })
+							const scaleOnly = view.getCamera()
+							check('flyToCamera：未写的相机字段沿用当前值，duration=0 立即落位并链式返回实例',
+								flyCameraReturned === view && Math.abs(centerOnly.center[0] - 20) < 1e-6 && Math.abs(centerOnly.center[1] - 30) < 1e-6 && Math.abs(centerOnly.scale - cameraApiScale) < 1e-6 &&
+									Math.abs(scaleOnly.center[0] - 20) < 1e-6 && Math.abs(scaleOnly.center[1] - 30) < 1e-6 && Math.abs(scaleOnly.scale - 5) < 1e-6,
+								`center-only ${JSON.stringify(centerOnly)} / scale-only ${JSON.stringify(scaleOnly)}`)
+							click('search-filter-fly-camera')
+							await wait(80)
+							const cameraPresetFlying = view.cameraAnimating && readout('search-filter-action').includes('flyToCamera')
+							view.stopCameraAnimation()
+							check('flyToCamera demo：按钮直接飞相机目标，不经过要素解析', cameraPresetFlying, `${readout('search-filter-camera')} / ${readout('search-filter-action')}`)
+							// 线路窄样式：换色 / 加宽后 getLineStyle 立刻是新值，dataVersion 不动
+							const styleVersionBefore = view.dataVersion
+							const styleBefore = view.getLineStyle(0)
+							click('search-filter-line-recolor')
+							await wait(100)
+							const styleAfter = view.getLineStyle(0)
+							check('getLineStyle：线路换色 / 加宽后读到最新解析值，dataVersion 不变',
+								styleBefore !== null && styleAfter !== null && Math.abs(styleAfter.width - 3.2) < 1e-6 && Math.abs(styleAfter.opacity - 1) < 1e-6 &&
+									styleAfter.color.some((value, index) => Math.abs(value - styleBefore.color[index]) > 1e-3) &&
+									styleVersionBefore === view.dataVersion && readout('search-filter-line-style').includes('width=3.20'),
+								`${JSON.stringify(styleBefore)} -> ${JSON.stringify(styleAfter)} · dataVersion ${styleVersionBefore} -> ${view.dataVersion}`)
+							click('search-filter-line-recolor')
+							await wait(80)
+							// 数据修订号：改点后递增，onDataChange 载荷与只读属性是同一个数
+							const dataVersionBefore = view.dataVersion
+							click('search-filter-data-bump')
+							const dataVersionText = await until(() => {
+								const text = readout('search-filter-data-version')
+								return view.dataVersion > dataVersionBefore && text.includes(`dataVersion=${view.dataVersion}`) && text.includes(`onDataChange=${view.dataVersion}`) ? text : ''
+							}, 3000) ?? ''
+							check('dataVersion：改一个点后递增，onDataChange 载荷与只读属性同步',
+								Boolean(dataVersionText) && view.dataVersion > dataVersionBefore,
+								`${dataVersionBefore} -> ${view.dataVersion} / ${dataVersionText}`)
 							click('search-filter-preset-symbol')
 						const symbolReady = await until(() => readout('search-filter-summary').includes('节点 8'), 4000)
 						check('搜索与筛选：显式 fields=[symbol] 能搜默认跳过的符号字段', Boolean(symbolReady) && readout('search-filter-hit-0').includes('symbol = square'), `${readout('search-filter-summary')} / ${readout('search-filter-hit-0')}`)
@@ -2398,18 +2493,22 @@
 					await wait(150)
 					const apiItems = () => [...document.querySelectorAll('.demo-api-list:not(.demo-api-list--options) .demo-api-item')]
 					const optionItems = () => [...document.querySelectorAll('.demo-api-list--options .demo-api-item')]
-					check('实例方法速查：整份成员清单按分组列全（16 组 / 257 个成员）',
-						Boolean(ready) && document.querySelectorAll('.demo-api-group').length === 16 && apiItems().length === 257,
+					check('实例方法速查：整份成员清单按分组列全（16 组 / 265 个成员）',
+						Boolean(ready) && document.querySelectorAll('.demo-api-group').length === 16 && apiItems().length === 265,
 						`${document.querySelectorAll('.demo-api-group').length} 组 / ${apiItems().length} 个成员`)
 					const apiNames = apiItems().map(node => node.querySelector('b')?.textContent)
 					const roundNames = ['registerSymbol', 'unregisterSymbol', 'listSymbols']
 					check('实例方法速查：本轮新增的三个方法都在清单里（registerSymbol / unregisterSymbol / listSymbols）',
 						roundNames.every(name => apiNames.includes(name)),
 						roundNames.filter(name => !apiNames.includes(name)).join(' / ') || '三个都在')
-					const roundNamesAuto = ['getZoomBaseScale', 'setZoomBaseScale']
-					check('实例方法速查：自适应比例的读 / 写两个方法在清单里（getZoomBaseScale / setZoomBaseScale）',
-						roundNamesAuto.every(name => apiNames.includes(name)),
-						roundNamesAuto.filter(name => !apiNames.includes(name)).join(' / ') || '两个都在')
+					const roundNamesAuto = ['getZoomBaseScale', 'setZoomBaseScale']
+					check('实例方法速查：自适应比例的读 / 写两个方法在清单里（getZoomBaseScale / setZoomBaseScale）',
+						roundNamesAuto.every(name => apiNames.includes(name)),
+						roundNamesAuto.filter(name => !apiNames.includes(name)).join(' / ') || '两个都在')
+					const roundNamesCameraApi = ['flyToCamera', 'getLineStyle', 'dataVersion']
+					check('实例方法速查：相机目标、线路样式快照与数据版本三个成员在清单里',
+						roundNamesCameraApi.every(name => apiNames.includes(name)),
+						roundNamesCameraApi.filter(name => !apiNames.includes(name)).join(' / ') || '三个都在')
 					const roundNames1597 = ['addChannelGroupLines', 'joinChannelGroupLines', 'endAddChannel']
 					check('实例方法速查：这一轮拆出来的方法也在清单里（addChannelGroupLines / joinChannelGroupLines / endAddChannel）',
 						roundNames1597.every(name => apiNames.includes(name)),

package/docs/steps/selftest-docs.html

@@ -520,8 +520,8 @@
 				if (check('API 速查：挂上了 __gisApi 钩子（数据来自 api-index.js，没钩子多半是 file:// 打开的）', Boolean(apiHook))) {
 					const apiDoc = apiFrame.contentDocument
 					const summary = apiHook.summary
-					check('API 速查：清单来自 api-index（257 个成员 / 254 个方法 / 96 个 options / 16 个分组）',
-						summary.members === 257 && summary.methods === 254 && summary.options === 96 && summary.sections === 16,
+					check('API 速查：清单来自 api-index（265 个成员 / 260 个方法 / 5 个属性 / 96 个 options / 16 个分组）',
+						summary.members === 265 && summary.methods === 260 && summary.properties === 5 && summary.options === 96 && summary.sections === 16,
 						JSON.stringify(summary))
 					const topJumps = [...apiDoc.querySelectorAll('.doc-jump')]
 					const jumpTargets = topJumps.map(node => `${node.dataset.docJump}:${node.getAttribute('href')}`)
@@ -559,7 +559,7 @@
 						`${apiDoc.querySelectorAll('.api-member').length} 张卡片 / 属性 ${apiDoc.querySelectorAll('.api-member[data-kind="property"]').length} 张`)
 					const noExample = [...apiDoc.querySelectorAll('.api-member')].filter(node => Number(node.dataset.examples) < 1)
 					check('API 速查：每个成员都带至少一段示例（不出现空卡片）', noExample.length === 0,
-						noExample.length ? noExample.map(node => node.dataset.name).join(' / ') : '257 张卡片都有示例')
+						noExample.length ? noExample.map(node => node.dataset.name).join(' / ') : '265 张卡片都有示例')
 					check('API 速查：96 个 options 都列全（名字 / 类型 / 默认值 / 说明四件套）',
 						apiDoc.querySelectorAll('.api-option').length === summary.options && [...apiDoc.querySelectorAll('.api-option')].every(node => node.querySelector('.name code') && node.querySelector('.type') && node.querySelector('.def') && node.querySelector('.doc')),
 						`${apiDoc.querySelectorAll('.api-option').length} 个`)

package/docs/steps/selftest-features.html

@@ -3880,7 +3880,7 @@
 					rdHost.remove()
 				}
 				{
-					// 接口选中（select / selectFeatures）、读回选中（getSelectionData）与聚焦（focusOn：单个 / 一批 / 只居中）
+					// 接口选中（selectFeatures）、读回选中（getSelectionData）与聚焦（focusOn：单个 / 一批 / 只居中）
 					const apiHost = document.createElement('div')
 					apiHost.style.cssText = 'width:520px;height:340px'
 					document.body.appendChild(apiHost)

package/docs/steps/selftest-full.html

@@ -223,8 +223,49 @@
 				check('鹰眼图 extent: 打开 extentFollowCamera 后，相机落进小范围时 auto 以它为准',
 					tinyView.getOptions().minimap.extentFollowCamera === true && fillFocused > 200 && fillFocused > fillSquashed + 200,
 					`squashed=${fillSquashed} focused=${fillFocused}`)
+				// extentFollowContent 默认关闭：筛选掉外围节点后，鹰眼图仍用首次铺好的范围；显式打开后才跟着当前可见内容缩。
+				const lockHost = document.createElement('div')
+				lockHost.style.cssText = 'position:fixed;left:-9999px;top:0;width:420px;height:320px'
+				document.body.appendChild(lockHost)
+				const lockExtents = []
+				const lockView = createGisView(lockHost, {
+					points: [
+						{ id: 'near-a', x: 0, y: 0, zone: 'near' },
+						{ id: 'near-b', x: 10, y: 0, zone: 'near' },
+						{ id: 'far', x: 100, y: 40, zone: 'far' }
+					],
+					lines: [],
+					background: false,
+					minimap: {
+						width: 200,
+						height: 160,
+						background: false,
+						extent: 'auto',
+						extentFollowContent: false,
+						draw: info => lockExtents.push({ ...info.extent })
+					}
+				})
+				await settleFrames()
+				const lockBefore = lockExtents.at(-1)
+				lockView.setFilter({ points: { zone: 'near' }, worker: false })
+				await settleFrames()
+				const lockAfter = lockExtents.at(-1)
+				const sameExtent = lockBefore && lockAfter &&
+					Math.abs(lockBefore.minX - lockAfter.minX) < 1e-6 && Math.abs(lockBefore.minY - lockAfter.minY) < 1e-6 &&
+					Math.abs(lockBefore.maxX - lockAfter.maxX) < 1e-6 && Math.abs(lockBefore.maxY - lockAfter.maxY) < 1e-6
+				check('鹰眼图 extentFollowContent 默认关闭：外围节点被筛掉后包围盒保持不变',
+					lockView.getOptions().minimap.extentFollowContent === false && lockBefore?.maxX === 100 && lockBefore?.maxY === 40 && sameExtent,
+					`before=${JSON.stringify(lockBefore)} after=${JSON.stringify(lockAfter)}`)
+				lockView.updateOptions({ minimap: { ...lockView.getOptions().minimap, extentFollowContent: true } })
+				await settleFrames()
+				const lockFollowed = lockExtents.at(-1)
+				check('鹰眼图 extentFollowContent 打开后：包围盒按当前可见内容重算',
+					lockView.getOptions().minimap.extentFollowContent === true && lockFollowed?.maxX === 10 && lockFollowed?.maxY === 0,
+					JSON.stringify(lockFollowed))
+				lockView.destroy()
+				lockHost.remove()
 				// 这一轮：沿用主图规则取描边色（不再是白点）、继承尺寸不受主视图地图倍数影响、框与框选矩形的样式
-				const ruleHost = document.createElement('div')
+				const ruleHost = document.createElement('div')
 				ruleHost.style.cssText = 'position:fixed;left:-9999px;top:0;width:420px;height:320px'
 				document.body.appendChild(ruleHost)
 				const ruleView = createGisView(ruleHost, {