add: more descriptive text for BarChart.java

add: support for user generated description

Author: ish-joshi

MPChartLib/src/main/java/com/github/mikephil/charting/charts/BarChart.java

@@ -15,6 +15,8 @@
 import com.github.mikephil.charting.interfaces.datasets.IBarDataSet;
 import com.github.mikephil.charting.renderer.BarChartRenderer;
 
+import java.util.Locale;
+
 /**
  * Chart that draws bars.
  *
@@ -298,9 +300,10 @@ public String getAccessibilityDescription() {
 
         // Format the values of min and max; to recite them back
 
-        String description = String.format("The bar chart has %d %s. " +
-                        "The minimum value is %s and maximum value is %s",
-                entryCount, entries, minVal, maxVal);
+        String description = String.format(Locale.getDefault(), "The bar chart has %d %s. " +
+                        "The minimum value is %s and maximum value is %s." +
+                        "Data ranges from %s to %s.",
+                entryCount, entries, minVal, maxVal, minRange, maxRange);
 
         return description;
     }

MPChartLib/src/main/java/com/github/mikephil/charting/charts/Chart.java

@@ -175,6 +175,11 @@ public abstract class Chart<T extends ChartData<? extends IDataSet<? extends Ent
      */
     private String TAG = "abilityTag";
 
+    /**
+     * Additional data on top of dynamically generated description. This can be set by the user.
+     */
+    private String accessibilitySummaryDescription = "";
+
     /**
 	 * default constructor for initialization in code
 	 */
@@ -1666,6 +1671,14 @@ public void setUnbindEnabled(boolean enabled) {
      */
     public abstract String getAccessibilityDescription();
 
+    public String getAccessibilitySummaryDescription() {
+        return accessibilitySummaryDescription;
+    }
+
+    public void setAccessibilitySummaryDescription(String accessibilitySummaryDescription) {
+        this.accessibilitySummaryDescription = accessibilitySummaryDescription;
+    }
+
     @Override
     public boolean dispatchPopulateAccessibilityEvent(AccessibilityEvent event) {
 
@@ -1674,6 +1687,11 @@ public boolean dispatchPopulateAccessibilityEvent(AccessibilityEvent event) {
 
         event.getText().add(getAccessibilityDescription());
 
+        // Add the user generated summary after the dynamic summary is complete.
+        if (!TextUtils.isEmpty(this.getAccessibilitySummaryDescription())) {
+            event.getText().add(this.getAccessibilitySummaryDescription());
+        }
+
         return true;
     }