[#638] Update bottom bars documentation

Orange-OpenSource · Oct 9, 2023 · acfc568 · acfc568
1 parent 41360c0
commit acfc568
Showing 1 changed file with 1 addition and 125 deletions.
diff --git a/docs/components/AppBarsBottom.md b/docs/components/AppBarsBottom.md
@@ -19,7 +19,6 @@ description: A bottom app bar displays navigation and key actions at the bottom
 
 - [Design System Manager - App bars](https://system.design.orange.com/0c1af118d/p/23e0e6-app-bars/b/620966)
 - [Material Design - App bars: bottom](https://material.io/components/app-bars-bottom)
-- *Technical documentation soon available*
 
 ## Accessibility
 
@@ -35,132 +34,9 @@ When using icons for navigation icons, action items and other elements of bottom
 app bars, you should set a content description on them so that screen readers
 like TalkBack are able to announce their purpose or action, if any.
 
-For an overall content description of the bottom app bar, set an
-`android:contentDescription` or use the `setContentDescription` method on the
-`BottomAppBar`.
-
-For the navigation icon, this can be achieved via the
-`app:navigationContentDescription` attribute or
-`setNavigationContentDescription` method.
-
-For action items and items within the overflow menu, the content description
-needs to be set in the menu:
-
-```xml
-<menu>
-    <item
-          android:contentDescription="@string/content_description_one" />
-    <item
-          android:contentDescription="@string/content_description_two" />
-</menu>
-```
-
 ## Implementation
 
-Bottom app bars provide access to a bottom navigation drawer and up to four
-actions, including the floating action button.
-
-> **Jetpack Compose implementation**
-
-*Not available yet*
-
-> **XML implementation**
-
-API and source code:
-
-*   `CoordinatorLayout`: [Class definition](https://developer.android.com/reference/androidx/coordinatorlayout/widget/CoordinatorLayout)
-*   `BottomAppBar`: [Class definition](https://developer.android.com/reference/com/google/android/material/bottomappbar/BottomAppBar), [Class source](https://github.com/material-components/material-components-android/tree/master/lib/java/com/google/android/material/bottomappbar/BottomAppBar.java)
-*   `FloatingActionButton`: [Class definition](https://developer.android.com/reference/com/google/android/material/floatingactionbutton/FloatingActionButton), [Class source](https://github.com/material-components/material-components-android/tree/master/lib/java/com/google/android/material/floatingactionbutton/FloatingActionButton.java)
-
-In the layout:
-
-```xml
-<androidx.coordinatorlayout.widget.CoordinatorLayout
-    android:layout_width="match_parent"
-    android:layout_height="match_parent">
-
-    <!-- Note: A RecyclerView can also be used -->
-    <androidx.core.widget.NestedScrollView
-        android:layout_width="match_parent"
-        android:layout_height="match_parent"
-        android:paddingBottom="100dp"
-        android:clipToPadding="false">
-
-        <!-- Scrollable content -->
-
-    </androidx.core.widget.NestedScrollView>
-
-    <com.google.android.material.bottomappbar.BottomAppBar
-        android:id="@+id/bottomAppBar"
-        android:layout_width="match_parent"
-        android:layout_height="wrap_content"
-        android:layout_gravity="bottom"
-        app:navigationIcon="@drawable/ic_menu_24dp"
-        app:menu="@menu/bottom_app_bar"
-        />
-
-    <com.google.android.material.floatingactionbutton.FloatingActionButton
-        android:layout_width="wrap_content"
-        android:layout_height="wrap_content"
-        app:srcCompat="@drawable/ic_add_24dp"
-        app:layout_anchor="@id/bottomAppBar"
-        />
-
-</androidx.coordinatorlayout.widget.CoordinatorLayout>
-```
-
-In `menu/bottom_app_bar.xml`:
-
-```xml
-<menu>
-
-    <item
-        android:id="@+id/search"
-        android:icon="@drawable/ic_search_24dp"
-        android:title="@string/search"
-        android:contentDescription="@string/content_description_search"
-        app:showAsAction="ifRoom"
-        />
-
-    <item
-        android:id="@+id/more"
-        android:title="@string/more"
-        android:contentDescription="@string/content_description_more"
-        app:showAsAction="never"
-        />
-
-</menu>
-```
-
-In menu/navigation icon drawables:
-
-```xml
-<vector
-    android:tint="?attr/colorControlNormal">
-</vector>
-```
-
-In code:
-
-```kotlin
-bottomAppBar.setNavigationOnClickListener {
-    // Handle navigation icon press
-}
-
-bottomAppBar.setOnMenuItemClickListener { menuItem ->
-    when (menuItem.itemId) {
-        R.id.search -> {
-            // Handle search icon press
-            true
-        }
-        R.id.more -> {
-            // Handle more item (inside overflow menu) press
-            true
-        }
-        else -> false
-    }
-}
-```
+_Not available yet in ODS library_
 
 ## Component specific tokens