ツールチップ

TooltipArea コンポーザブルを使用すると、任意のコンポーネントにツールチップを追加できます。TooltipArea は Box コンポーネントに似ており、ツールチップを表示できます。

undefined

TooltipArea コンポーザブルには、以下の主なパラメータがあります。

tooltip: ツールチップのコンポーザブルなコンテンツ。
tooltipPlacement: ツールチップの位置を定義します。アンカー（マウスカーソルまたはコンポーネント）、オフセット、アライメントを指定できます。
delayMillis: ツールチップが表示されるまでの時間（ミリ秒単位）。デフォルト値は 500 ms です。

以下の例は、ボタンのリストを含み、各ボタンが TooltipArea でラップされたシンプルなウィンドウを作成する方法を示しています。ボタンの上にマウスを置くと、そのボタンの名前が表示されたツールチップが表示されます。このコードを jvmMain/kotlin にある main.kt ファイルに追加してください。

kotlin

import androidx.compose.foundation.ExperimentalFoundationApi
import androidx.compose.foundation.TooltipArea
import androidx.compose.foundation.TooltipPlacement
import androidx.compose.foundation.layout.Arrangement
import androidx.compose.foundation.layout.Column
import androidx.compose.foundation.layout.fillMaxSize
import androidx.compose.foundation.layout.padding
import androidx.compose.foundation.shape.RoundedCornerShape
import androidx.compose.material.Button
import androidx.compose.material.Surface
import androidx.compose.material.Text
import androidx.compose.ui.Alignment
import androidx.compose.ui.Modifier
import androidx.compose.ui.draw.shadow
import androidx.compose.ui.graphics.Color
import androidx.compose.ui.unit.DpOffset
import androidx.compose.ui.unit.dp
import androidx.compose.ui.window.WindowState
import androidx.compose.ui.window.singleWindowApplication

@OptIn(ExperimentalFoundationApi::class)
fun main() = singleWindowApplication(
    WindowState(width = 300.dp, height = 350.dp),
    title = "Tooltip Example"
) {
    val buttons = listOf("Button A", "Button B", "Button C", "Button D", "Button E", "Button F")
    Column(Modifier.fillMaxSize(), Arrangement.spacedBy(5.dp)) {
        buttons.forEachIndexed { index, name ->
            // ボタンを TooltipArea でラップする
            TooltipArea(
                tooltip = {
                    // コンポーザブルなツールチップのコンテンツ:
                    Surface(
                        modifier = Modifier.shadow(4.dp),
                        color = Color(255, 255, 210),
                        shape = RoundedCornerShape(4.dp)
                    ) {
                        Text(
                            text = "Tooltip for $name",
                            modifier = Modifier.padding(10.dp)
                        )
                    }
                },
                modifier = Modifier.padding(start = 40.dp),
                delayMillis = 600, // ミリ秒単位
                tooltipPlacement = TooltipPlacement.CursorPoint(
                    alignment = Alignment.BottomEnd,
                    offset = if (index % 2 == 0) DpOffset(
                        (-16).dp,
                        0.dp
                    ) else DpOffset.Zero // ツールチップのオフセット
                )
            ) {
                Button(onClick = {}) { Text(text = name) }
            }
        }
    }
}

次のステップ

他のデスクトップコンポーネントに関するチュートリアルを確認してください。

ツールチップ ​

次のステップ ​

ツールチップ

次のステップ