Skip to content

Doc upate#2855

Merged
lzxue merged 13 commits into
masterfrom
doc_upate
May 11, 2026
Merged

Doc upate#2855
lzxue merged 13 commits into
masterfrom
doc_upate

Conversation

@lzxue
Copy link
Copy Markdown
Contributor

@lzxue lzxue commented May 11, 2026

[English Template / 英文模板]

🤔 这个变动的性质是?

  • 新特性提交
  • 日常 bug 修复
  • 站点、文档改进
  • 演示代码改进
  • 组件样式/交互改进
  • TypeScript 定义更新
  • 包体积优化
  • 性能优化
  • 功能增强
  • 国际化改进
  • 重构
  • 代码风格优化
  • 测试用例
  • 分支合并
  • 工作流程
  • 版本更新
  • 其他改动(是关于什么的改动?)

🔗 相关 Issue

💡 需求背景和解决方案

📝 更新日志

语言 更新描述
🇺🇸 英文
🇨🇳 中文

☑️ 请求合并前的自查清单

⚠️ 请自检并全部勾选全部选项⚠️

  • 文档已补充或无须补充
  • 代码演示已提供或无须提供
  • TypeScript 定义已补充或无须补充
  • Changelog 已提供或无须提供

lzxue added 2 commits May 7, 2026 18:15
- 修复 layer_ctr: setMaxZoom 示例代码错误,补充 getMinZoom/getMaxZoom/destroy 方法
- 修复 mask_method: enableMask 示例代码错误
- 修复 mouse_event: 补充 mouseenter 事件,去除重复 dblclick
- 补充 layer_encode: 新增 rotate() 和 label() 方法文档
- 补充 common/map.zh: 新增 bearing/pitch/interactive 等 13 个地图配置项
- 补充 source.en: 新增 map/filter transforms、getClusters、updateClusterData 等方法
- 补充 marker.zh/en: 完善所有方法文档,添加参数签名和示例
- 完善 pointlayer.zh: 修复 new 关键字缺失,嵌入所有子文档
- 完善 linelayer.zh: 嵌入所有子文档(含 texture)
- 完善 polygonlayer.zh: 嵌入所有子文档
- 完善 heatmap.zh: 补充 shape 类型表格,嵌入所有子文档
- 完善 heatmap/shape.zh: 补充各聚合形状详细说明
- 完善 imagelayer.zh: 嵌入所有子文档
- 完善 raster.zh: 重写简介,嵌入三种栅格模式子文档
- site/.dumirc.ts: 新增 /api -> /api/scene 路由重定向
1. map.init()未完成时this.map为undefined导致on/off崩溃
   - BaseMap/BaseMapService基类添加pendingHandlers缓存
   - 所有地图on()增加this.map空值守卫,未初始化时缓存事件
   - 所有地图off()增加this.map空值守卫,从缓存中移除
   - 所有地图init()末尾调用bindPendingEvents()重放

2. SceneService中map.init()缺少错误处理导致Promise挂死
   - 添加.catch(reject)捕获init异步失败

3. SceneService.init()缺少防重复调用guard
   - 添加inited/rendering检查,防止hooks重复注册

4. SceneService.destroy()后重新初始化支持
   - destroy()中重置hooks/loaded/destroyed状态
   - init()中重置destroyed标志

5. 高德地图BMapService重命名为AMapService避免报错混淆
@changeset-bot
Copy link
Copy Markdown

changeset-bot Bot commented May 11, 2026

⚠️ No Changeset found

Latest commit: bed15ab

Merging this PR will not cause a version bump for any packages. If these changes should not result in a new version, you're good to go. If these changes should result in a version bump, you need to add a changeset.

This PR includes no changesets

When changesets are added to this PR, you'll see the packages that this PR includes changesets for and the associated semver types

Click here to learn what changesets are, and how to add one.

Click here if you're a maintainer who wants to add a changeset to this PR

Copy link
Copy Markdown
Contributor

@gemini-code-assist gemini-code-assist Bot left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Code Review

This pull request introduces a comprehensive API reference document and significantly enhances the library's documentation across all core modules. Technically, it improves the Scene lifecycle management by preventing duplicate initializations and ensuring proper state resets during destruction. Additionally, it implements a robust event caching mechanism across all map services, allowing event listeners to be registered before the map instance is fully initialized. Review feedback highlighted several inconsistencies in the new documentation, such as duplicate configuration entries and non-standard shape values in the PointLayer, PolygonLayer, and HeatmapLayer sections.

Comment thread L7_API_Reference.md Outdated
Comment thread L7_API_Reference.md Outdated
Comment thread L7_API_Reference.md
Comment thread L7_API_Reference.md Outdated
lzxue and others added 9 commits May 11, 2026 10:42
- 将index.less入口改为index.css,由transform-import-css-l7插件构建时内联为JS
- 添加prebuild:css脚本,构建前自动用lessc编译less为css
- 用户安装@antv/l7-component后不再需要less依赖
- 新增tile-raster.md、source-raster.md、layer-popup.md、marker-layer.md文档
- 更新SKILL.md和index.md导航
- 更新L7_API_Reference.md
- 清理临时分析报告文件
Co-authored-by: gemini-code-assist[bot] <176961590+gemini-code-assist[bot]@users.noreply.github.com>
Co-authored-by: gemini-code-assist[bot] <176961590+gemini-code-assist[bot]@users.noreply.github.com>
Co-authored-by: gemini-code-assist[bot] <176961590+gemini-code-assist[bot]@users.noreply.github.com>
Co-authored-by: gemini-code-assist[bot] <176961590+gemini-code-assist[bot]@users.noreply.github.com>
- 将iconfont.js(iconfont.cn生成的脚本)重写为标准TS模块iconfont.ts
- 移除基于document.getElementsByTagName('script')的不可靠SVG注入逻辑
- 新增ensureSvgSprite()函数,支持按需和预注入双重模式
- createL7Icon()创建图标前自动调用ensureSvgSprite()确保SVG sprite已注入
- 处理SSR环境(typeof document === 'undefined')安全跳过
- 处理document.body未就绪时延迟注入(DOMContentLoaded)
- 更新sideEffects配置,防止tree-shaking移除副作用模块
- 更新index.ts import路径移除.js后缀
@lzxue
Copy link
Copy Markdown
Contributor Author

lzxue commented May 11, 2026

@copilot resolve the merge conflicts in this pull request

Copy link
Copy Markdown
Contributor

Copilot AI commented May 11, 2026

@copilot resolve the merge conflicts in this pull request

已解决并推送冲突处理,当前分支已成功合并 origin/master,请以提交 cb6501b(冲突解决)和 bed15ab(格式化修正)为准。

Copilot finished work on behalf of lzxue May 11, 2026 06:15
@lzxue lzxue merged commit 6ae1e72 into master May 11, 2026
1 check passed
@lzxue lzxue deleted the doc_upate branch May 11, 2026 06:15
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants