[Button] Add getters and setters for left/right insets to MaterialButton

Currently `MaterialButton` has getters and setters for top/bottom insets, but not for left/right. Which makes it impossible to change left/right insets programmatically at runtime.

Note that left/right essentially act like start/end in `MaterialButton` already, since `setPaddingRelative` is used. Keeping consistent here with the naming to avoid confusion.

Resolves #1770

Resolves #1790

PiperOrigin-RevId: 897807490

Author: Material Design Team

lib/java/com/google/android/material/button/MaterialButton.java

@@ -1610,7 +1610,7 @@ public void setInsetBottom(@Dimension int insetBottom) {
    * Gets the bottom inset for this button
    *
    * @attr ref com.google.android.material.R.styleable#MaterialButton_android_insetBottom
-   * @see #setInsetTop(int)
+   * @see #setInsetBottom(int)
    */
   @Dimension
   public int getInsetBottom() {
@@ -1621,7 +1621,7 @@ public int getInsetBottom() {
    * Sets the button top inset
    *
    * @attr ref com.google.android.material.R.styleable#MaterialButton_android_insetTop
-   * @see #getInsetBottom()
+   * @see #getInsetTop()
    */
   public void setInsetTop(@Dimension int insetTop) {
     materialButtonHelper.setInsetTop(insetTop);
@@ -1638,6 +1638,61 @@ public int getInsetTop() {
     return materialButtonHelper.getInsetTop();
   }
 
+  /**
+   * Sets the button left inset.
+   *
+   * <p>This acts like the start inset in RTL layouts. It's using the "left" naming convention
+   * instead of "start" to be consistent with the android:insetLeft attribute.
+   *
+   * @attr ref com.google.android.material.R.styleable#MaterialButton_android_insetLeft
+   * @see #getInsetLeft()
+   */
+  public void setInsetLeft(@Dimension int insetLeft) {
+    materialButtonHelper.setInsetLeft(insetLeft);
+  }
+
+  /**
+   * Gets the left inset for this button.
+   *
+   * <p>This acts like the start inset in RTL layouts. It's using the "left" naming convention
+   * instead of "start" to be consistent with the android:insetLeft attribute.
+   *
+   * @attr ref com.google.android.material.R.styleable#MaterialButton_android_insetLeft
+   * @see #setInsetLeft(int)
+   */
+  @Dimension
+  public int getInsetLeft() {
+    return materialButtonHelper.getInsetLeft();
+  }
+
+  /**
+   * Sets the button right inset.
+   *
+   * <p>This acts like the end inset in RTL layouts. It's using the "right" naming convention
+   * instead of "end" to be consistent with the inset to be consistent with the android:insetRight
+   * attribute.
+   *
+   * @attr ref com.google.android.material.R.styleable#MaterialButton_android_insetRight
+   * @see #getInsetRight()
+   */
+  public void setInsetRight(@Dimension int insetRight) {
+    materialButtonHelper.setInsetRight(insetRight);
+  }
+
+  /**
+   * Gets the right inset for this button.
+   *
+   * <p>This acts like the end inset in RTL layouts. It's using the "right" naming convention
+   * instead of "end" to be consistent with the android:insetRight attribute.
+   *
+   * @attr ref com.google.android.material.R.styleable#MaterialButton_android_insetRight
+   * @see #setInsetRight(int)
+   */
+  @Dimension
+  public int getInsetRight() {
+    return materialButtonHelper.getInsetRight();
+  }
+
   @Override
   protected int[] onCreateDrawableState(int extraSpace) {
     final int[] drawableState = super.onCreateDrawableState(extraSpace + 2);

lib/java/com/google/android/material/button/MaterialButtonHelper.java

@@ -251,8 +251,7 @@ private Drawable createBackground() {
         new RippleDrawable(
             RippleUtils.sanitizeRippleDrawableColor(rippleColor),
             wrapDrawableWithInset(
-                new LayerDrawable(
-                    new Drawable[] {surfaceColorStrokeDrawable, backgroundDrawable})),
+                new LayerDrawable(new Drawable[] {surfaceColorStrokeDrawable, backgroundDrawable})),
             maskDrawable);
     FocusRingDrawable.layer(context, rippleDrawable);
     return rippleDrawable;
@@ -467,39 +466,69 @@ ShapeAppearanceModel getShapeAppearanceModel() {
   }
 
   public void setInsetBottom(@Dimension int newInsetBottom) {
-    setVerticalInsets(insetTop, newInsetBottom);
+    setInsets(insetLeft, insetTop, insetRight, newInsetBottom);
   }
 
   public int getInsetBottom() {
     return insetBottom;
   }
 
   public void setInsetTop(@Dimension int newInsetTop) {
-    setVerticalInsets(newInsetTop, insetBottom);
+    setInsets(insetLeft, newInsetTop, insetRight, insetBottom);
   }
 
-  private void setVerticalInsets(@Dimension int newInsetTop, @Dimension int newInsetBottom) {
+  public int getInsetTop() {
+    return insetTop;
+  }
+
+  public void setInsetLeft(@Dimension int newInsetLeft) {
+    setInsets(newInsetLeft, insetTop, insetRight, insetBottom);
+  }
+
+  public int getInsetLeft() {
+    return insetLeft;
+  }
+
+  public void setInsetRight(@Dimension int newInsetRight) {
+    setInsets(insetLeft, insetTop, newInsetRight, insetBottom);
+  }
+
+  public int getInsetRight() {
+    return insetRight;
+  }
+
+  private void setInsets(
+      @Dimension int newInsetLeft,
+      @Dimension int newInsetTop,
+      @Dimension int newInsetRight,
+      @Dimension int newInsetBottom) {
+
     // Store padding before setting background, since background overwrites padding values
     int paddingStart = materialButton.getPaddingStart();
     int paddingTop = materialButton.getPaddingTop();
     int paddingEnd = materialButton.getPaddingEnd();
     int paddingBottom = materialButton.getPaddingBottom();
+
+    int oldInsetLeft = insetLeft;
     int oldInsetTop = insetTop;
+    int oldInsetRight = insetRight;
     int oldInsetBottom = insetBottom;
-    insetBottom = newInsetBottom;
+
+    insetLeft = newInsetLeft;
     insetTop = newInsetTop;
+    insetRight = newInsetRight;
+    insetBottom = newInsetBottom;
+
     if (!backgroundOverwritten) {
       updateBackground();
     }
-    // Set the stored padding values
+
+    // Set the stored padding values. Left is used as start and right is used as end to be
+    // consistent with the left/right XML layout attributes.
     materialButton.setPaddingRelative(
-        paddingStart,
+        paddingStart + newInsetLeft - oldInsetLeft,
         paddingTop + newInsetTop - oldInsetTop,
-        paddingEnd,
+        paddingEnd + newInsetRight - oldInsetRight,
         paddingBottom + newInsetBottom - oldInsetBottom);
   }
-
-  public int getInsetTop() {
-    return insetTop;
-  }
 }