Add paddingBottomSystemWindowInsets to public attrs and update documentation

PiperOrigin-RevId: 281120848

Author: cketcham

docs/components/BottomAppBar.md

@@ -72,14 +72,16 @@ style="@style/Widget.MaterialComponents.BottomAppBar"
 
 ### Bottom App Bar Attributes
 
-Feature                  | Relevant attributes
-:----------------------- | :---------------------------------
-Background Tint          | `app:backgroundTint`
-FAB Alignment Mode       | `app:fabAlignmentMode`
-FAB Cradle Margin        | `app:fabCradleMargin`
-FAB Cradle Corner Radius | `app:fabCradleRoundedCornerRadius`
-FAB Vertical Offset      | `app:fabCradleVerticalOffset`
-Hide on scroll           | `app:hideOnScroll`
+Feature                       | Relevant attributes
+:---------------------------- | :------------------------------------
+Background Tint               | `app:backgroundTint`
+FAB Alignment Mode            | `app:fabAlignmentMode`
+FAB Animation Mode            | `app:fabAnimationMode`
+FAB Cradle Margin             | `app:fabCradleMargin`
+FAB Cradle Corner Radius      | `app:fabCradleRoundedCornerRadius`
+FAB Vertical Offset           | `app:fabCradleVerticalOffset`
+Hide on scroll                | `app:hideOnScroll`
+Add Padding for Bottom Insets | `app:paddingBottomSystemWindowInsets`
 
 #### Background Tint
 
@@ -89,13 +91,14 @@ means that you shouldn't call `setBackground()` or use the `android:background`
 attribute in xml. Instead, the `app:backgroundTint` attribute will allow you to
 set a tint.
 
-#### `FloatingActionButton` Alignment Modes
+#### `FloatingActionButton` Alignment/Animation Modes
 
 The `FloatingActionButton` can be aligned either to the center
 (`FAB_ALIGNMENT_MODE_CENTER`) or to the end (`FAB_ALIGNMENT_MODE_END`) by
-calling `setFabAlignmentMode(int)`. The default animation will automatically be
-run. This can be coordinated with a `Fragment` transition to allow for a smooth
-animation from a primary screen to a secondary screen.
+calling `setFabAlignmentMode(int)`. The animation specified by
+`fabAnimationMode` will automatically be run. The fab animation can be set to
+`scale` or `slide`. This can be coordinated with a `Fragment` transition to
+allow for a smooth animation from a primary screen to a secondary screen.
 
 #### `FloatingActionButton` Attributes
 
@@ -118,6 +121,11 @@ is in a `NestedScrollView`. There's no need to wrap the `BottomAppBar` in an
 `AppBarLayout` or use any of the scroll flags associated with `AppBarLayout`
 such as `app:layout_scrollFlags`.
 
+#### Add Padding for Bottom insets
+
+The `BottomAppBar` can be set to automatically add insets for system navigation
+that appears on the bottom of the screen. By default, padding will be added.
+
 ### Handling Menu Options
 
 There are two ways to handle menu options. The first way is to directly call

lib/java/com/google/android/material/bottomappbar/BottomAppBar.java

@@ -105,6 +105,7 @@
  * @attr ref
  *     com.google.android.material.R.styleable#BottomAppBar_fabCradleVerticalOffset
  * @attr ref com.google.android.material.R.styleable#BottomAppBar_hideOnScroll
+ * @attr ref com.google.android.material.R.styleable#BottomAppBar_paddingBottomSystemWindowInsets
  */
 public class BottomAppBar extends Toolbar implements AttachedBehavior {
 

lib/java/com/google/android/material/bottomappbar/res-public/values/public.xml

@@ -22,6 +22,7 @@
   <public name="fabCradleRoundedCornerRadius" type="attr"/>
   <public name="fabCradleVerticalOffset" type="attr"/>
   <public name="hideOnScroll" type="attr"/>
+  <public name="paddingBottomSystemWindowInsets" type="attr"/>
   <public name="Widget.MaterialComponents.BottomAppBar" type="style"/>
   <public name="Widget.MaterialComponents.BottomAppBar.Colored" type="style"/>
   <public name="Widget.MaterialComponents.BottomAppBar.PrimarySurface" type="style"/>