``悬浮提示

出现的场景还是蛮多的,是否可以作为一个通用的功能,在各处可以接入? 且展示格式可以支持自定义,如下的🎈气泡:

image.pngimage.png image.png
还有文字溢出省略的时候,hover 悬浮提示。

可以参考 Tooltip。

使用

  1. import { Poptip } from '@antv/GUI';

API

  1. poptip = new Poptip({attrs});
  2. // 获取、设置names
  3. poptip.getNames();
  4. poptip.setNames();
  5. // 交互
  6. poptip.showTip(x?: number, y?: number, text?: string); 显示弹出框
  7. poptip.hideTip(); 隐藏弹出框
  8. // 更新配置
  9. poptip.update(option);
  10. // 获取内部数据
  11. poptip.getContainer(); 获取创建的 element 容器
  12. poptip.bind(element,options); 绑定需要触发的元素
  13. poptip.unbind(element); 解除绑定的元素

配置

  1. interface PoptipCfg {
  2. /**
  3. * @title 是否可见。
  4. * @description 控制 poptip 默认是否可见。
  5. */
  6. visibility?: 'visible' | 'hidden';
  7. /**
  8. * @title 文本内容
  9. * @description 默认配置下的文本内容
  10. */
  11. text?: string;
  12. /**
  13. * @title 偏移量
  14. * @description 在位置方向上的偏移量
  15. */
  16. offset?: [number, number];
  17. /**
  18. * @title 气泡框位置
  19. * @description 可选。top left right bottom top-left top-right bottom-left bottom-right left-top left-bottom right-top right-bottom
  20. */
  21. position?: PoptipPosition;
  22. /**
  23. * @title 箭头是否指向元素中心
  24. */
  25. arrowPointAtCenter?: boolean;
  26. /**
  27. * @title 是否跟随鼠标
  28. * @description 是否跟随鼠标。当设置为 true 时,会忽略 position 的设置
  29. */
  30. follow?: boolean;
  31. /**
  32. * @title 内容模版
  33. * @description 可以添加容器模版 背景模版 和 文本模版
  34. */
  35. template?: {
  36. container?: string | HTMLElement;
  37. text?: string | HTMLElement;
  38. };
  39. /**
  40. * @title 样式
  41. * @description 所有内容模版都可以通过 '.className': cssStyle 的方式,来改变 poptip 的样式
  42. */
  43. style?: {
  44. [key: string]: {
  45. [key: string]: string;
  46. };
  47. };
  48. }