İpucu, kullanıcılar bir görünüme uzun bastıklarında veya farelerini üzerine getirdiklerinde görünümün yanında görünen küçük, açıklayıcı bir mesajdır. Bu, uygulamanız düzende yer kazanmak için bir işlemi veya bilgi parçasını temsil eden bir simge kullandığında kullanışlıdır. Bu sayfada, Android 8.0 (API düzeyi 26) ve sonraki sürümlerde bu ipuçlarını nasıl ekleyeceğiniz gösterilmektedir.
Üretkenlik uygulamalarındakiler gibi bazı senaryolar, fikirleri ve işlemleri iletmek için açıklayıcı bir yöntem gerektirir. Şekil 1'de gösterildiği gibi açıklayıcı bir mesaj görüntülemek için ipuçlarını kullanabilirsiniz.
Bazı standart widget'lar, title
veya content description
özelliklerinin içeriğine dayalı ipuçları görüntüler. Android 8.0'dan başlayarak, diğer özelliklerin değerinden bağımsız olarak ipucunda görüntülenen metni belirtebilirsiniz.
İpucu metnini ayarlama
setTooltipText()
yöntemini çağırarak View
içindeki ipucu metnini belirtebilirsiniz. İlgili XML özelliğini veya API'yi kullanarak tooltipText
özelliğini ayarlayabilirsiniz.
XML dosyalarınızda ipucu metnini belirtmek için aşağıdaki örnekte gösterildiği gibi android:tooltipText
özelliğini ayarlayın:
<android.support.design.widget.FloatingActionButton
android:id="@+id/fab"
android:tooltipText="Send an email" />
Kodunuzda ipucu metnini belirtmek için aşağıdaki örnekte gösterildiği gibi setTooltipText(CharSequence)
yöntemini kullanın:
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, tooltipText
özelliğinin değerini almak için kullanabileceğiniz bir getTooltipText()
yöntemi de içerir.
Android, kullanıcılar fareleriyle görünümün üzerine geldiğinde veya görünüme uzun bastığında tooltipText
özelliğinin değerini gösterir.