Bokeh 3.4.2 版本更新详解TapTool 默认切换选择模式与系列修复【免费下载链接】bokehInteractive Data Visualization in the browser, from Python项目地址: https://gitcode.com/GitHub_Trending/bo/bokeh导读Bokeh 3.4.22024 年 6 月发布是一个补丁patch版本主要修复了一批较小的 bug/回归问题与文档问题其中最值得关注的变化是为TapTool新增了toggle选择模式并将其设为默认行为同时让字形glyph的投影计算能够感知继承属性。本文以官方发布说明 docs/bokeh/source/docs/releases/3.4.2.rst 为骨架结合仓库中 Python 与 BokehJS 双端源码深入解读这些变化的原理、使用方式与迁移影响帮助你快速判断升级到 3.4.2 后哪些代码行为会发生变化、哪些可以安全忽略。版本定位一个聚焦稳定性的补丁版本在 Bokeh 的版本节奏中3.4.2属于3.4.x系列内的补丁版本这意味着它不引入大规模的新特性而是围绕以下三个方向收敛修复 bug 与回归问题regressions保证 3.4 系列的行为一致性修复文档docs问题并改进文档基础设施加固 bokeh/bokehjs 的测试及其基础设施提升回归防护能力。从发布说明的改动清单可以清晰看到这一稳定化定位——没有任何新增大模块全部改动都在修 bug、补文档、加固测试。对于正在使用 3.4 系列的用户这是值得平滑升级的版本。核心变化一TapTool 新增并默认使用 toggle 选择模式3.4.2 之前的行为默认 replace在 3.4.2 之前TapTool的mode属性默认值为replace。这意味着每次单击tap都会清空上一次的选择结果然后写入新的选中项。如果你想用点击来累积选择多个点必须手动传入modeappend之类的参数。3.4.2 之后的行为默认 toggle发布说明中的第一条改动对应 PR13808是为TapTool增加toggle选择模式并将其设为默认值。toggle语义很直观再次点击一个已选中的点会将其取消选中点击未选中的点则将其加入选中集合。这在交互上非常接近日常开关的心智模型也与其他数据可视化工具的常见交互一致。从仓库源码可以完整印证这一改动。Python 端 src/bokeh/models/tools.py 中TapTool.mode的定义如下mode Enum(SelectionMode, defaulttoggle, help Defines what should happen when a new selection is made. The default is to toggle the existing selection. Other options are to replace the selection, append to it, intersect with it, subtract from it or compute a symmetric difference with it. )而枚举定义位于 src/bokeh/core/enums.pytype RegionSelectionModeType Literal[replace, append, intersect, subtract, xor] RegionSelectionMode _string_enumeration(RegionSelectionModeType) type SelectionModeType Literal[RegionSelectionModeType, toggle] SelectionMode _string_enumeration(SelectionModeType)注意这里的类型设计细节SelectionMode在RegionSelectionModereplace/append/intersect/subtract/xor的基础上扩展出toggle值。也就是说toggle是专为TapTool这类点选工具新增的语义区域选择工具如BoxSelectTool并不使用它。在 BokehJS 端TapTool的实现位于 bokehjs/src/lib/models/tools/gestures/tap_tool.ts其Props中同样声明了mode: p.PropertySelectionMode与 Python 端一一对应。toggle 在底层是如何执行的理解toggle的底层执行路径有助于判断它与你现有回调、联动逻辑的兼容性。在 bokehjs/src/lib/models/tools/gestures/tap_tool.ts 中_handle_tap处理一次点击事件先检查modifiers是否满足TapTool.modifiers配置不满足直接忽略判断点击坐标是否落在绘图 frame 范围内根据behavior是select还是inspect分别走_select或_inspect分支_select中通过各 renderer 的 selection manager 执行sm.select(r_views, geometry, final, mode)其中mode就是本次点击生效的选择模式。而无修饰键时使用工具自身 mode、按下修饰键时切换到对应语义的规则在 bokehjs/src/lib/models/tools/gestures/select_tool.ts 的_select_mode中实现不按任何修饰键使用this.model.mode3.4.2 默认即toggle仅Shiftappend追加到现有选择仅Ctrlintersect与现有选择取交集Shift Ctrlsubtract从现有选择中减去。这一点与TapTool类 docstring 中的提示src/bokeh/models/tools.py相互印证按住SHIFT键进行选择即可把新选择追加到已有选择之上。迁移影响与注意事项如果你从未显式设置TapTool.mode升级到 3.4.2 后默认行为从每次点击替换选择变为点击切换选中/取消。若你的业务逻辑依赖每次点击只选中一个点的旧行为需要在升级后显式设置modereplace以保持原状。如果你显式设置过mode不受影响显式值优先于默认值。联动行为不变选择selection结果仍然通过 selection manager 传播到 data source触发selected属性变化并通知Selection字形selected/unselected 样式及其他组件更新这一点与模式无关。如何在自己的代码中使用 toggle最直接的使用方式是不设置mode让默认值生效也可以显式写出以表明意图from bokeh.models import TapTool # 显式声明 toggle 模式3.4.2 起即默认值 tool TapTool(modetoggle) # 若希望保留旧版点击即替换行为可显式指定 tool TapTool(modereplace)TapTool其余常用配置在升级语境下同样值得回顾定义见 src/bokeh/models/tools.pybehaviorselect默认选择会传播给 data source 及 Selection 字形或inspect仅触发callback不改变选择状态gesturetap默认单击触发或doubletap双击触发modifiers要求按下指定修饰键才生效例如TapTool(modifiersctrlshift)renderers继承自SelectToolsrc/bokeh/models/tools.py默认auto表示对图上所有 renderer 做命中测试。核心变化二字形投影计算感知继承属性发布说明第二条PR13832让字形glyph中的投影projection计算能够感知继承属性inherited properties。在 Bokeh 中字形共享的视觉属性如fill_color、line_color等常常来自 glyph spec 中通过继承链下发的属性。此前的投影projection即将数据坐标变换到屏幕坐标逻辑在某些继承场景下未能正确处理这些属性导致投影结果与渲染结果不一致。3.4.2 修复了这一类问题确保投影计算与最终渲染使用一致的属性解析结果。从源码结构看projection相关的计算分布在 BokehJS 的坐标系与变换模块中涉及core下的坐标/缩放实现以及各 glyph 的视图逻辑本次改动属于对既有计算的健壮性修复不改变任何公开 API 签名因此对普通用户而言是透明修复升级后投影结果与渲染结果的一致性更高尤其是那些通过共享 glyph spec、继承属性定义视觉样式的图。文档与基础设施改进发布说明第三条PR13823、13876、13901、13903是纯文档性质的变化包括修复文档中的错误表述与失效示例改进文档构建基础设施减少文档构建失败的概率。文档源码位于 docs/bokeh/source/docs 目录下含 270 余个.rst文件发布说明本身也属于该文档体系的一部分版本发布说明集中在releases子目录。本次改动不涉及任何运行时行为不影响功能代码。测试基础设施加固发布说明第四条PR13843、13851针对 bokeh/bokejs 的测试与其基础设施做了健壮化处理。仓库中的测试体系非常庞大与本次加固直接相关的部分包括BokehJS 端bokehjs/test 目录下包含 unit、integration、baselines、devtools、framework 等子套件其中integration/tools下有专门的工具交互测试Python 端tests/unit/bokeh/models 包含各模型含工具的单元测试tests/cross/cases 包含跨语言一致性测试用例默认值一致性测试tests/test_defaults.py 专门校验 Python 模型默认值与 BokehJS 端默认值的一致性——这保证了TapTool.mode默认值toggle这类改动在双端不会出现漂移。这类加固的直接收益是后续版本对工具、选择等关键路径的改动会被更早、更全面地捕获回归3.4.2 的行为变更尤其是 TapTool 默认模式切换因此有了更强的质量保障。升级建议与影响面小结综合发布说明与源码分析升级到 Bokeh 3.4.2 时可按以下清单核对改动项是否影响运行时行为升级动作TapTool新增toggle模式并设为默认是若未显式设置过mode需要 toggle 语义则无需操作需保留旧行为则显式设modereplace字形投影计算感知继承属性是透明修复无需操作投影与渲染一致性提升文档与文档基础设施改进否无需操作bokeh/bokejs 测试与基础设施加固否仅影响开发/CI无需操作版本号可通过bokeh.__version__获取见 src/bokeh/init.py。如果你的应用依赖 TapTool 的默认选择行为建议在升级后重点回归连续点击多个数据点的交互路径其余改动均可视为无感修复可以放心升级。【免费下载链接】bokehInteractive Data Visualization in the browser, from Python项目地址: https://gitcode.com/GitHub_Trending/bo/bokeh创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
Bokeh 3.4.2 版本更新详解：TapTool 默认切换选择模式与系列修复
Bokeh 3.4.2 版本更新详解TapTool 默认切换选择模式与系列修复【免费下载链接】bokehInteractive Data Visualization in the browser, from Python项目地址: https://gitcode.com/GitHub_Trending/bo/bokeh导读Bokeh 3.4.22024 年 6 月发布是一个补丁patch版本主要修复了一批较小的 bug/回归问题与文档问题其中最值得关注的变化是为TapTool新增了toggle选择模式并将其设为默认行为同时让字形glyph的投影计算能够感知继承属性。本文以官方发布说明 docs/bokeh/source/docs/releases/3.4.2.rst 为骨架结合仓库中 Python 与 BokehJS 双端源码深入解读这些变化的原理、使用方式与迁移影响帮助你快速判断升级到 3.4.2 后哪些代码行为会发生变化、哪些可以安全忽略。版本定位一个聚焦稳定性的补丁版本在 Bokeh 的版本节奏中3.4.2属于3.4.x系列内的补丁版本这意味着它不引入大规模的新特性而是围绕以下三个方向收敛修复 bug 与回归问题regressions保证 3.4 系列的行为一致性修复文档docs问题并改进文档基础设施加固 bokeh/bokehjs 的测试及其基础设施提升回归防护能力。从发布说明的改动清单可以清晰看到这一稳定化定位——没有任何新增大模块全部改动都在修 bug、补文档、加固测试。对于正在使用 3.4 系列的用户这是值得平滑升级的版本。核心变化一TapTool 新增并默认使用 toggle 选择模式3.4.2 之前的行为默认 replace在 3.4.2 之前TapTool的mode属性默认值为replace。这意味着每次单击tap都会清空上一次的选择结果然后写入新的选中项。如果你想用点击来累积选择多个点必须手动传入modeappend之类的参数。3.4.2 之后的行为默认 toggle发布说明中的第一条改动对应 PR13808是为TapTool增加toggle选择模式并将其设为默认值。toggle语义很直观再次点击一个已选中的点会将其取消选中点击未选中的点则将其加入选中集合。这在交互上非常接近日常开关的心智模型也与其他数据可视化工具的常见交互一致。从仓库源码可以完整印证这一改动。Python 端 src/bokeh/models/tools.py 中TapTool.mode的定义如下mode Enum(SelectionMode, defaulttoggle, help Defines what should happen when a new selection is made. The default is to toggle the existing selection. Other options are to replace the selection, append to it, intersect with it, subtract from it or compute a symmetric difference with it. )而枚举定义位于 src/bokeh/core/enums.pytype RegionSelectionModeType Literal[replace, append, intersect, subtract, xor] RegionSelectionMode _string_enumeration(RegionSelectionModeType) type SelectionModeType Literal[RegionSelectionModeType, toggle] SelectionMode _string_enumeration(SelectionModeType)注意这里的类型设计细节SelectionMode在RegionSelectionModereplace/append/intersect/subtract/xor的基础上扩展出toggle值。也就是说toggle是专为TapTool这类点选工具新增的语义区域选择工具如BoxSelectTool并不使用它。在 BokehJS 端TapTool的实现位于 bokehjs/src/lib/models/tools/gestures/tap_tool.ts其Props中同样声明了mode: p.PropertySelectionMode与 Python 端一一对应。toggle 在底层是如何执行的理解toggle的底层执行路径有助于判断它与你现有回调、联动逻辑的兼容性。在 bokehjs/src/lib/models/tools/gestures/tap_tool.ts 中_handle_tap处理一次点击事件先检查modifiers是否满足TapTool.modifiers配置不满足直接忽略判断点击坐标是否落在绘图 frame 范围内根据behavior是select还是inspect分别走_select或_inspect分支_select中通过各 renderer 的 selection manager 执行sm.select(r_views, geometry, final, mode)其中mode就是本次点击生效的选择模式。而无修饰键时使用工具自身 mode、按下修饰键时切换到对应语义的规则在 bokehjs/src/lib/models/tools/gestures/select_tool.ts 的_select_mode中实现不按任何修饰键使用this.model.mode3.4.2 默认即toggle仅Shiftappend追加到现有选择仅Ctrlintersect与现有选择取交集Shift Ctrlsubtract从现有选择中减去。这一点与TapTool类 docstring 中的提示src/bokeh/models/tools.py相互印证按住SHIFT键进行选择即可把新选择追加到已有选择之上。迁移影响与注意事项如果你从未显式设置TapTool.mode升级到 3.4.2 后默认行为从每次点击替换选择变为点击切换选中/取消。若你的业务逻辑依赖每次点击只选中一个点的旧行为需要在升级后显式设置modereplace以保持原状。如果你显式设置过mode不受影响显式值优先于默认值。联动行为不变选择selection结果仍然通过 selection manager 传播到 data source触发selected属性变化并通知Selection字形selected/unselected 样式及其他组件更新这一点与模式无关。如何在自己的代码中使用 toggle最直接的使用方式是不设置mode让默认值生效也可以显式写出以表明意图from bokeh.models import TapTool # 显式声明 toggle 模式3.4.2 起即默认值 tool TapTool(modetoggle) # 若希望保留旧版点击即替换行为可显式指定 tool TapTool(modereplace)TapTool其余常用配置在升级语境下同样值得回顾定义见 src/bokeh/models/tools.pybehaviorselect默认选择会传播给 data source 及 Selection 字形或inspect仅触发callback不改变选择状态gesturetap默认单击触发或doubletap双击触发modifiers要求按下指定修饰键才生效例如TapTool(modifiersctrlshift)renderers继承自SelectToolsrc/bokeh/models/tools.py默认auto表示对图上所有 renderer 做命中测试。核心变化二字形投影计算感知继承属性发布说明第二条PR13832让字形glyph中的投影projection计算能够感知继承属性inherited properties。在 Bokeh 中字形共享的视觉属性如fill_color、line_color等常常来自 glyph spec 中通过继承链下发的属性。此前的投影projection即将数据坐标变换到屏幕坐标逻辑在某些继承场景下未能正确处理这些属性导致投影结果与渲染结果不一致。3.4.2 修复了这一类问题确保投影计算与最终渲染使用一致的属性解析结果。从源码结构看projection相关的计算分布在 BokehJS 的坐标系与变换模块中涉及core下的坐标/缩放实现以及各 glyph 的视图逻辑本次改动属于对既有计算的健壮性修复不改变任何公开 API 签名因此对普通用户而言是透明修复升级后投影结果与渲染结果的一致性更高尤其是那些通过共享 glyph spec、继承属性定义视觉样式的图。文档与基础设施改进发布说明第三条PR13823、13876、13901、13903是纯文档性质的变化包括修复文档中的错误表述与失效示例改进文档构建基础设施减少文档构建失败的概率。文档源码位于 docs/bokeh/source/docs 目录下含 270 余个.rst文件发布说明本身也属于该文档体系的一部分版本发布说明集中在releases子目录。本次改动不涉及任何运行时行为不影响功能代码。测试基础设施加固发布说明第四条PR13843、13851针对 bokeh/bokejs 的测试与其基础设施做了健壮化处理。仓库中的测试体系非常庞大与本次加固直接相关的部分包括BokehJS 端bokehjs/test 目录下包含 unit、integration、baselines、devtools、framework 等子套件其中integration/tools下有专门的工具交互测试Python 端tests/unit/bokeh/models 包含各模型含工具的单元测试tests/cross/cases 包含跨语言一致性测试用例默认值一致性测试tests/test_defaults.py 专门校验 Python 模型默认值与 BokehJS 端默认值的一致性——这保证了TapTool.mode默认值toggle这类改动在双端不会出现漂移。这类加固的直接收益是后续版本对工具、选择等关键路径的改动会被更早、更全面地捕获回归3.4.2 的行为变更尤其是 TapTool 默认模式切换因此有了更强的质量保障。升级建议与影响面小结综合发布说明与源码分析升级到 Bokeh 3.4.2 时可按以下清单核对改动项是否影响运行时行为升级动作TapTool新增toggle模式并设为默认是若未显式设置过mode需要 toggle 语义则无需操作需保留旧行为则显式设modereplace字形投影计算感知继承属性是透明修复无需操作投影与渲染一致性提升文档与文档基础设施改进否无需操作bokeh/bokejs 测试与基础设施加固否仅影响开发/CI无需操作版本号可通过bokeh.__version__获取见 src/bokeh/init.py。如果你的应用依赖 TapTool 的默认选择行为建议在升级后重点回归连续点击多个数据点的交互路径其余改动均可视为无感修复可以放心升级。【免费下载链接】bokehInteractive Data Visualization in the browser, from Python项目地址: https://gitcode.com/GitHub_Trending/bo/bokeh创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
