工具提示 (Tooltip)

源：Tooltips

工具提示在用户长按或将鼠标悬停在某个元素上时，提供简短的文本描述。

辅助功能

工具提示主要用于向用户解释图标按钮的功能，对于视障用户（TalkBack），它们会自动与对应的 View 关联。

---

代码实现

在 Material Components 中，Tooltip 通常通过 TooltipDrawable 或在 XML 中通过 tooltipText 属性实现（API 26+ 支持）。

1. 基础用法 (XML)

<com.google.android.material.button.MaterialButton
    android:layout_width="wrap_content"
    android:layout_height="wrap_content"
    app:icon="@drawable/ic_edit"
    android:contentDescription="编辑"
    android:tooltipText="点击修改个人资料" />

2. 编程式控制 (TooltipDrawable)

如果你想在更低版本或更复杂的场景下使用：

val tooltip = TooltipDrawable.createFromAttributes(context, null, 0, 0)
tooltip.text = "这是一个工具提示"

// 绑定到 View
TooltipCompat.setTooltipText(myView, "这是一个工具提示")

---

核心属性

属性	描述	默认值
android:tooltipText	提示文本内容	null
app:backgroundTint	气泡背景色	?attr/colorSurfaceInverse
app:hideDelay	消失延迟时间	1500ms

---

交互准则

1. 简短性: 只包含核心信息，避免长难句。
2. 非必须性: 核心操作不应仅依靠工具提示来解释。
3. 触发方式: 手机端为长按，PC/平板为悬停。