Dolibarr工具提示固定功能技术解析

功能背景

在Dolibarr ERP/CRM系统中，工具提示(Tooltips)作为辅助信息展示的重要组件，其默认行为是鼠标悬停时显示、移开时消失。但在实际业务场景中，用户经常需要长时间查看工具提示内容进行数据比对或信息录入，此时默认的瞬时显示模式反而会影响操作效率。

技术实现方案

通过监听键盘Alt键的按下/释放事件，实现了工具提示的持久化展示控制：

1. 触发机制：当用户按住Alt键时，系统将当前激活的工具提示转为固定模式
2. 释放机制：Alt键释放后恢复默认的悬停触发模式
3. 状态保持：固定期间工具提示不受鼠标位置影响，保持可见状态

实现原理

该功能基于JavaScript事件监听实现：

document.addEventListener('keydown', (e) => {
  if(e.key === 'Alt') {
    // 锁定当前活跃的tooltip元素
    activeTooltip.classList.add('fixed-mode');
  }
});

document.addEventListener('keyup', (e) => {
  if(e.key === 'Alt') {
    // 释放tooltip固定状态
    activeTooltip.classList.remove('fixed-mode');
  }
});

用户体验优化

1. 符合直觉：采用Alt键作为触发键符合主流软件操作习惯
2. 无侵入性：不影响原有工具提示的基础功能
3. 状态可见性：可通过CSS添加固定状态下的视觉反馈（如边框高亮）

技术价值

1. 提升表单处理效率：财务人员在核对订单明细时，可固定金额计算说明
2. 辅助数据校验：库存管理员能同时查看多个产品的规格参数
3. 增强可访问性：为行动不便的用户提供更长的信息阅读时间

扩展应用

该模式可进一步扩展为：

1. 自定义触发快捷键（支持用户配置）
2. 多工具提示堆叠显示（适合复杂业务场景）
3. 与屏幕阅读器集成（提升无障碍访问能力）

该功能已作为标准特性集成到Dolibarr最新版本中，显著提升了企业用户在处理复杂业务数据时的操作体验。