도움말
컬렉션을 사용해 정리하기
내 환경설정을 기준으로 콘텐츠를 저장하고 분류하세요.
Compose 방식으로 시도
Jetpack Compose는 Android에 권장되는 UI 도구 키트입니다. Compose에서 구성요소를 추가하는 방법을 알아봅니다.
도움말은 사용자가 보기를 길게 누르거나 마우스를 올려놓으면 보기 근처에 표시되는 작은 설명 메시지입니다. 이 기능은 레이아웃의 공간을 절약하기 위해 앱에서 아이콘을 사용하여 작업이나 정보를 표시할 때 유용합니다. 이 페이지에서는 Android 8.0(API 수준 26) 이상의 도움말을 추가하는 방법을 설명합니다.
생산성 앱과 같은 시나리오에서는 아이디어와 작업을 교환하는 설명적인 메서드가 있어야 합니다. 그림 1에 표시된 대로 도움말을 사용하여 설명 메시지를 표시할 수 있습니다.

그림 1. Android 앱에 도움말이 표시됩니다.
일부 표준 위젯에서는 title
또는 content description
속성의 콘텐츠를 기반으로 도움말을 표시합니다. Android 8.0부터 다른 속성의 값에 관계없이 도움말에 표시되는 텍스트를 지정할 수 있습니다.
도움말 텍스트 설정
setTooltipText()
메서드를 호출하여 View
에 도움말 텍스트를 지정할 수 있습니다. 해당 XML 속성 또는 API를 사용하여 tooltipText
속성을 설정할 수 있습니다.
XML 파일에서 도움말 텍스트를 지정하려면 다음 예에 표시된 대로 android:tooltipText
속성을 설정합니다.
<android.support.design.widget.FloatingActionButton
android:id="@+id/fab"
android:tooltipText="Send an email" />
코드에 도움말 텍스트를 지정하려면 다음 예에 표시된 대로 setTooltipText(CharSequence)
메서드를 호출합니다.
Kotlin
val fab: FloatingActionButton = findViewById(R.id.fab)
fab.tooltipText = "Send an email"
자바
FloatingActionButton fab = (FloatingActionButton) findViewById(R.id.fab);
fab.setTooltipText("Send an email");
API에는 tooltipText
속성의 값을 검색하는 데 사용할 수 있는 getTooltipText()
메서드도 포함되어 있습니다.
사용자가 보기 위로 마우스를 이동하거나 보기를 길게 누르면 Android에서 tooltipText
속성의 값을 표시합니다.
이 페이지에 나와 있는 콘텐츠와 코드 샘플에는 콘텐츠 라이선스에서 설명하는 라이선스가 적용됩니다. 자바 및 OpenJDK는 Oracle 및 Oracle 계열사의 상표 또는 등록 상표입니다.
최종 업데이트: 2025-08-26(UTC)
[[["이해하기 쉬움","easyToUnderstand","thumb-up"],["문제가 해결됨","solvedMyProblem","thumb-up"],["기타","otherUp","thumb-up"]],[["필요한 정보가 없음","missingTheInformationINeed","thumb-down"],["너무 복잡함/단계 수가 너무 많음","tooComplicatedTooManySteps","thumb-down"],["오래됨","outOfDate","thumb-down"],["번역 문제","translationIssue","thumb-down"],["샘플/코드 문제","samplesCodeIssue","thumb-down"],["기타","otherDown","thumb-down"]],["최종 업데이트: 2025-08-26(UTC)"],[],[],null,["Try the Compose way \nJetpack Compose is the recommended UI toolkit for Android. Learn how to add components in Compose. \n[Tooltip →](/develop/ui/compose/components/tooltip) \n\n\u003cbr /\u003e\n\nA tooltip is a small descriptive message that appears near a view when users\nlong press the view or hover their mouse over it. This is useful when your app\nuses an icon to represent an action or piece of information to save space in the\nlayout. This page shows you how to add these tooltips on Android 8.0 (API level\n26) and higher.\n\nSome scenarios, such as those in productivity apps, require a descriptive method\nof communicating ideas and actions. You can use tooltips to display a\ndescriptive message, as shown in figure 1.\n\n**Figure 1.** Tooltip displayed in an Android app.\n\nSome standard widgets display tooltips based on the content of the `title` or\n`content description` properties. Starting in Android 8.0, you can specify the\ntext displayed in the tooltip regardless of the value of other properties.\n\nSetting the tooltip text\n\nYou can specify the tooltip text in a [View](/reference/android/view/View) by calling the\n[setTooltipText()](/reference/android/view/View#setTooltipText(java.lang.CharSequence)) method. You can set\nthe `tooltipText` property using the corresponding XML attribute or API.\n\nTo specify the tooltip text in your XML files, set the [android:tooltipText](/reference/android/R.styleable#View_tooltipText) attribute, as shown\nin the following example: \n\n \u003candroid.support.design.widget.FloatingActionButton\n android:id=\"@+id/fab\"\n android:tooltipText=\"Send an email\" /\u003e\n\nTo specify the tooltip text in your code, use the [setTooltipText(CharSequence)](/reference/android/view/View#setTooltipText(java.lang.CharSequence)) method, as shown in the following example: \n\nKotlin \n\n```kotlin\nval fab: FloatingActionButton = findViewById(R.id.fab)\nfab.tooltipText = \"Send an email\"\n```\n\nJava \n\n```java\nFloatingActionButton fab = (FloatingActionButton) findViewById(R.id.fab);\nfab.setTooltipText(\"Send an email\");\n```\n\nThe API also includes a [getTooltipText()](/reference/android/view/View#getTooltipText()) method that\nyou can use to retrieve the value of the `tooltipText` property.\n\nAndroid displays the value of the `tooltipText` property when users hover their\nmouse over the view or long press the view."]]