İpucu, kullanıcılar görünüme uzun bastığında veya fareleriyle bir görünümün üzerine geldiğinde görünümün yanında görünen küçük bir açıklayıcı 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 faydalıdır. Bu sayfada, Android 8.0 (API düzeyi) ve sonraki sürümlerde bu ipuçlarını nasıl ekleyeceğiniz gösterilmektedir.
Üretkenlik uygulamalarındakiler gibi bazı senaryolarda, fikirleri ve eylemleri paylaşmak için açıklayıcı bir yöntem gerekir. Ş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österir. Android 8.0'dan itibaren, 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çinde 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 farelerini görünümün üzerine getirdiğinde veya görünüme uzun bastığında tooltipText
özelliğinin değerini gösterir.