Add setContentDescription API to AttributionPlugin for accessibility (#4896)

Fixes https://mapbox.atlassian.net/browse/MAPSAND-2183

* Add setContentDescription() method to AttributionPlugin and
AttributionView interfaces with default implementations for backward
compatibility
* Implement setContentDescription() in AttributionPluginImpl and
AttributionViewImpl to support programmatic accessibility content
description setting
* Set default content description "Powered by Mapbox Maps" for
attribution button to improve screen reader experience

cc @mapbox/maps-android

GitOrigin-RevId: 223903afed0e3e84ca2b266e112d301324dda800

Author: pengdev

CHANGELOG.md

@@ -3,6 +3,9 @@
 Mapbox welcomes participation and contributions from everyone.
 
 # main
+# 11.14.0-rc.1
+## Features ✨ and improvements 🏁
+* Added `setContentDescription()` method to `AttributionPlugin` and `AttributionView` interfaces to programmatically set accessibility content description for the attribution button.
 
 # 11.14.0-beta.1 July 02, 2025
 

app/src/main/java/com/mapbox/maps/testapp/examples/CustomAttributionActivity.kt

@@ -46,6 +46,8 @@ class CustomAttributionActivity : AppCompatActivity() {
       checkedTextView.setOnClickListener { checkedTextView.toggle() }
     }
     val attributionPlugin = binding.mapView.attribution
+    // set custom content description for the attribution plugin.
+    attributionPlugin.setContentDescription("Show Mapbox Attributions")
     binding.customAttributionFab.setOnClickListener {
       Toast.makeText(this, R.string.custom_attribution_custom, Toast.LENGTH_LONG).show()
       val config = AttributionParserConfig(

plugin-attribution/api/plugin-attribution.api

@@ -16,6 +16,7 @@ public final class com/mapbox/maps/plugin/attribution/AttributionViewImpl : andr
 	public fun <init> (Landroid/content/Context;Landroid/util/AttributeSet;I)V
 	public synthetic fun <init> (Landroid/content/Context;Landroid/util/AttributeSet;IILkotlin/jvm/internal/DefaultConstructorMarker;)V
 	public fun setAttributionMargins (IIII)V
+	public fun setContentDescription (Ljava/lang/CharSequence;)V
 	public fun setEnable (Z)V
 	public fun setGravity (I)V
 	public fun setIconColor (I)V

plugin-attribution/src/main/java/com/mapbox/maps/plugin/attribution/AttributionPluginImpl.kt

@@ -58,6 +58,17 @@ internal class AttributionPluginImpl(
     dialogManager.showAttribution(mapAttributionDelegate)
   }
 
+  /**
+   * Set the content description for the attribution view.
+   *
+   * @param contentDescription the content description text
+   */
+  override fun setContentDescription(contentDescription: CharSequence?) {
+    if (::attributionView.isInitialized) {
+      attributionView.setContentDescription(contentDescription)
+    }
+  }
+
   /**
    * Set a custom AttributionDialogManager that is invoked when the attribution view is clicked.
    */

plugin-attribution/src/main/java/com/mapbox/maps/plugin/attribution/AttributionViewImpl.kt

@@ -27,6 +27,8 @@ class AttributionViewImpl @JvmOverloads constructor(
       ViewGroup.LayoutParams.WRAP_CONTENT,
       ViewGroup.LayoutParams.WRAP_CONTENT
     )
+    // Set default content description for accessibility
+    contentDescription = context.getString(R.string.mapbox_attributionsDialogTitle)
   }
 
   /**
@@ -79,6 +81,15 @@ class AttributionViewImpl @JvmOverloads constructor(
     }
   }
 
+  /**
+   * Set the content description for accessibility.
+   *
+   * @param contentDescription the content description text
+   */
+  override fun setContentDescription(contentDescription: CharSequence?) {
+    super<AppCompatImageView>.setContentDescription(contentDescription)
+  }
+
   /**
    * Set an [View.OnClickListener] to AttributionView
    */

plugin-attribution/src/test/java/com/mapbox/maps/plugin/attribution/AttributionPluginImplImplTest.kt

@@ -105,4 +105,17 @@ class AttributionPluginImplImplTest {
   fun mapAttributionDelegate() {
     assertEquals(mapAttributionDelegate, attributionPlugin.getMapAttributionDelegate())
   }
+
+  @Test
+  fun setContentDescription() {
+    val customDescription = "Custom attribution content description"
+    attributionPlugin.setContentDescription(customDescription)
+    verify { attributionView.setContentDescription(customDescription) }
+  }
+
+  @Test
+  fun setContentDescriptionWithNull() {
+    attributionPlugin.setContentDescription(null)
+    verify { attributionView.setContentDescription(null) }
+  }
 }

plugin-attribution/src/test/java/com/mapbox/maps/plugin/attribution/AttributionViewImplTest.kt

@@ -72,4 +72,24 @@ class AttributionViewImplTest {
     attributionView.setViewOnClickListener(mockk())
     assertTrue(attributionView.hasOnClickListeners())
   }
+
+  @Test
+  fun setContentDescription() {
+    val customDescription = "Custom attribution description"
+    attributionView.setContentDescription(customDescription)
+    assertEquals(customDescription, attributionView.contentDescription)
+  }
+
+  @Test
+  fun setContentDescriptionWithNull() {
+    attributionView.setContentDescription(null)
+    assertNull(attributionView.contentDescription)
+  }
+
+  @Test
+  fun defaultContentDescription() {
+    // Default content description should be set from string resource
+    assertNotNull(attributionView.contentDescription)
+    assertTrue(attributionView.contentDescription.isNotEmpty())
+  }
 }

sdk-base/api/Release/metalava.txt

@@ -1748,12 +1748,14 @@ package com.mapbox.maps.plugin.attribution {
 
   public interface AttributionPlugin extends com.mapbox.maps.plugin.ViewPlugin com.mapbox.maps.plugin.attribution.generated.AttributionSettingsInterface com.mapbox.maps.plugin.LifecyclePlugin {
     method public com.mapbox.maps.plugin.delegates.MapAttributionDelegate getMapAttributionDelegate();
+    method public default void setContentDescription(CharSequence? contentDescription);
     method public void setCustomAttributionDialogManager(com.mapbox.maps.plugin.attribution.AttributionDialogManager dialogManager);
   }
 
   public interface AttributionView {
     method public void requestLayout();
     method public void setAttributionMargins(@Px int left, @Px int top, @Px int right, @Px int bottom);
+    method public default void setContentDescription(CharSequence? contentDescription);
     method public void setEnable(boolean enabled);
     method public void setGravity(int gravity);
     method public void setIconColor(@ColorInt int color);

sdk-base/api/sdk-base.api

@@ -1790,6 +1790,7 @@ public final class com/mapbox/maps/plugin/attribution/AttributionParserConfig {
 
 public abstract interface class com/mapbox/maps/plugin/attribution/AttributionPlugin : com/mapbox/maps/plugin/LifecyclePlugin, com/mapbox/maps/plugin/ViewPlugin, com/mapbox/maps/plugin/attribution/generated/AttributionSettingsInterface {
 	public abstract fun getMapAttributionDelegate ()Lcom/mapbox/maps/plugin/delegates/MapAttributionDelegate;
+	public abstract fun setContentDescription (Ljava/lang/CharSequence;)V
 	public abstract fun setCustomAttributionDialogManager (Lcom/mapbox/maps/plugin/attribution/AttributionDialogManager;)V
 }
 
@@ -1800,17 +1801,23 @@ public final class com/mapbox/maps/plugin/attribution/AttributionPlugin$DefaultI
 	public static fun onPluginView (Lcom/mapbox/maps/plugin/attribution/AttributionPlugin;Landroid/view/View;)V
 	public static fun onStart (Lcom/mapbox/maps/plugin/attribution/AttributionPlugin;)V
 	public static fun onStop (Lcom/mapbox/maps/plugin/attribution/AttributionPlugin;)V
+	public static fun setContentDescription (Lcom/mapbox/maps/plugin/attribution/AttributionPlugin;Ljava/lang/CharSequence;)V
 }
 
 public abstract interface class com/mapbox/maps/plugin/attribution/AttributionView {
 	public abstract fun requestLayout ()V
 	public abstract fun setAttributionMargins (IIII)V
+	public abstract fun setContentDescription (Ljava/lang/CharSequence;)V
 	public abstract fun setEnable (Z)V
 	public abstract fun setGravity (I)V
 	public abstract fun setIconColor (I)V
 	public abstract fun setViewOnClickListener (Landroid/view/View$OnClickListener;)V
 }
 
+public final class com/mapbox/maps/plugin/attribution/AttributionView$DefaultImpls {
+	public static fun setContentDescription (Lcom/mapbox/maps/plugin/attribution/AttributionView;Ljava/lang/CharSequence;)V
+}
+
 public abstract interface class com/mapbox/maps/plugin/attribution/OnAttributionClickListener {
 	public abstract fun onAttributionClick ()V
 }

sdk-base/src/main/java/com/mapbox/maps/plugin/attribution/AttributionPlugin.kt

@@ -15,6 +15,15 @@ interface AttributionPlugin : ViewPlugin, LifecyclePlugin, AttributionSettingsIn
    */
   fun setCustomAttributionDialogManager(dialogManager: AttributionDialogManager)
 
+  /**
+   * Set the content description for the attribution view.
+   *
+   * @param contentDescription the content description text
+   */
+  fun setContentDescription(contentDescription: CharSequence?) {
+    // Default empty implementation for backward compatibility
+  }
+
   /**
    * Get the instance of MapAttributionDelegate
    */