เคล็ดลับเครื่องมือ

ลองใช้วิธีการเขียน
Jetpack Compose เป็นชุดเครื่องมือ UI ที่แนะนำสำหรับ Android ดูวิธีเพิ่มคอมโพเนนต์ใน Compose

เคล็ดลับเครื่องมือคือข้อความอธิบายขนาดเล็กที่ปรากฏใกล้กับมุมมองเมื่อผู้ใช้ กดค้างที่มุมมองหรือวางเมาส์เหนือมุมมอง วิธีนี้มีประโยชน์เมื่อแอปของคุณ ใช้ไอคอนแสดงการทำงานหรือส่วนของข้อมูลเพื่อประหยัดพื้นที่ เลย์เอาต์ หน้านี้แสดงวิธีเพิ่มเคล็ดลับเครื่องมือเหล่านี้ใน Android 8.0 (ระดับ API 26) ขึ้นไป

บางสถานการณ์ เช่น เหตุการณ์ในแอปเพื่อการทำงาน ต้องใช้วิธีการที่สื่อความหมาย ในการสื่อสารแนวคิดและการกระทำ คุณสามารถใช้เคล็ดลับเครื่องมือเพื่อแสดง ข้อความอธิบายที่แสดงในรูปที่ 1

ภาพหน้าจอเคล็ดลับเครื่องมือ

รูปที่ 1 เคล็ดลับเครื่องมือที่แสดงในแอป Android

วิดเจ็ตมาตรฐานบางรายการจะแสดงเคล็ดลับเครื่องมือตามเนื้อหาของ title หรือ พร็อพเพอร์ตี้ content description รายการ เริ่มตั้งแต่ Android 8.0 คุณสามารถระบุ ข้อความที่แสดงในเคล็ดลับเครื่องมือ โดยไม่คำนึงถึงค่าของพร็อพเพอร์ตี้อื่นๆ

การตั้งค่าข้อความเคล็ดลับเครื่องมือ

คุณสามารถระบุข้อความเคล็ดลับเครื่องมือใน View โดยเรียกเมธอด setTooltipText() วิธี คุณสามารถกำหนด พร็อพเพอร์ตี้ tooltipText โดยใช้แอตทริบิวต์ XML หรือ API ที่เกี่ยวข้อง

หากต้องการระบุข้อความเคล็ดลับเครื่องมือในไฟล์ 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"

Java

FloatingActionButton fab = (FloatingActionButton) findViewById(R.id.fab);
fab.setTooltipText("Send an email");

API ยังมีเมธอด getTooltipText() ที่ คุณสามารถใช้เพื่อดึงค่าของพร็อพเพอร์ตี้ tooltipText

Android จะแสดงค่าของพร็อพเพอร์ตี้ tooltipText เมื่อผู้ใช้วางเมาส์เหนือพร็อพเพอร์ตี้ วางเมาส์เหนือมุมมองหรือกดมุมมองค้างไว้