Android常规视图设置Tooltip无显示？求解决方法及库推荐

原生Tooltip正确设置方法 #

如果你的设备系统版本低于Android 8.0（API 26），直接使用tooltipText属性是无效的，这是最常见的失效原因。针对不同版本，正确设置方式如下：

1. 全版本兼容的代码设置 #

使用AndroidX Core库的ViewCompat工具类，自动适配高低版本：

ViewCompat.setTooltipText(container, "Send an email")

需确保项目依赖了androidx.core:core-ktx（或对应Java版本依赖）。

2. XML设置注意事项 #

在XML中添加属性时，需同时保证View具备可交互性：

<androidx.constraintlayout.widget.ConstraintLayout
    android:id="@+id/container"
    android:layout_width="match_parent"
    android:layout_height="match_parent"
    android:tooltipText="Send an email"
    android:clickable="true"
    android:focusable="true">
    <!-- 子View内容 -->
</androidx.constraintlayout.widget.ConstraintLayout>

ConstraintLayout默认不可点击/聚焦，添加android:clickable="true"和android:focusable="true"后，长按容器才会触发Tooltip显示。

3. 手动触发Tooltip（API 26+可选） #

若需通过点击而非长按触发，可手动调用显示逻辑：

container.setOnClickListener {
    val tooltip = TooltipCompat.createTooltipText(container.context, "Send an email")
    tooltip.show(container, Gravity.BOTTOM, 0, 0)
}

推荐的第三方Tooltip库 #

如果需要更灵活的样式、触发方式或低版本完美兼容，可考虑以下几个较新的库：

• Material Components Tooltip：Google官方Material Design库，提供统一的Tooltip样式，支持自定义背景、文字颜色、显示位置，兼容低版本。依赖com.google.android.material:material后，通过MaterialTooltip或TooltipCompat调用即可。
• TooltipPopup：轻量级库，支持自定义触发事件（点击/长按/触摸）、动画效果、显示时长，代码侵入性低，适合快速集成。
• BubblePopup：模仿原生气泡样式，支持圆角、阴影、箭头方向自定义，还可添加点击事件，适合需要高度自定义UI的场景。

内容的提问来源于stack exchange，提问作者Bob Redity