Bits-UI 中 Tooltip 组件默认值设置问题解析

问题背景

Bits-UI 是一个基于 Svelte 的 UI 组件库，其中的 Tooltip 组件提供了一个 Provider 组件用于设置默认值。然而在实际使用中，开发者发现 Provider 并不能为所有 Tooltip.Root 的配置项设置默认值。

核心问题分析

Tooltip.Provider 组件虽然文档说明可以提供共享状态，但实际上只能有效设置 delayDuration 和 disableHoverableContent 两个属性的默认值。这是因为在 Tooltip.Root 组件内部，大多数属性都有硬编码的默认值，如：

disableCloseOnTriggerClick = false,
ignoreNonKeyboardFocus = false,
controlledOpen = false

这些默认值会覆盖 Provider 中设置的默认值，导致 Provider 的功能受限。从技术实现上看，只有当属性值为 null 或 undefined 时才会回退到 Provider 的值，但大多数属性都有明确的默认值。

解决方案

Bits-UI 团队在 1.0.0-next.44 版本中修复了这个问题。修复后，Tooltip.Provider 现在可以正确地为所有 Tooltip.Root 配置项设置默认值。

使用建议

1. 设置全局默认值：现在可以通过 Tooltip.Provider 统一设置所有 Tooltip 的默认行为
2. 交互行为控制：对于需要保持打开的 Tooltip，建议同时设置 interactOutsideBehavior="ignore"
3. 组件组合：当 Tooltip 内部包含交互元素时，注意测试各种交互场景

技术实现细节

修复的核心在于调整了 Tooltip.Root 组件的属性初始化逻辑，使其能够正确继承 Provider 的默认值。这种模式遵循了 React Context 的设计理念，为组件树提供统一的配置能力。

最佳实践

对于需要自定义 Tooltip 行为的场景，建议：

1. 在应用顶层设置全局默认值
2. 在特定场景下覆盖默认值
3. 对于复杂交互场景，测试各种边界条件

这个改进使得 Bits-UI 的 Tooltip 组件更加灵活和易用，特别是在需要统一管理大量 Tooltip 行为的大型应用中。