[Carousel][Catalog] Add option for snapping with multi-browse carouse…

…l demo PiperOrigin-RevId: 529818471
material-components · May 8, 2023 · 26c3779 · 26c3779
1 parent 8938da8
commit 26c3779
Show file tree

Hide file tree

Showing 3 changed files with 25 additions and 0 deletions.
diff --git a/catalog/java/io/material/catalog/carousel/MultiBrowseDemoFragment.java b/catalog/java/io/material/catalog/carousel/MultiBrowseDemoFragment.java
@@ -27,6 +27,7 @@
 import androidx.annotation.NonNull;
 import androidx.annotation.Nullable;
 import com.google.android.material.carousel.CarouselLayoutManager;
+import com.google.android.material.carousel.CarouselSnapHelper;
 import com.google.android.material.carousel.MultiBrowseCarouselStrategy;
 import com.google.android.material.divider.MaterialDividerItemDecoration;
 import com.google.android.material.materialswitch.MaterialSwitch;
@@ -61,6 +62,7 @@ public void onViewCreated(@NonNull View view, @Nullable Bundle bundle) {
     MaterialSwitch debugSwitch = view.findViewById(R.id.debug_switch);
     MaterialSwitch forceCompactSwitch = view.findViewById(R.id.force_compact_arrangement_switch);
     MaterialSwitch drawDividers = view.findViewById(R.id.draw_dividers_switch);
+    MaterialSwitch snapSwitch = view.findViewById(R.id.snap_switch);
     AutoCompleteTextView itemCountDropdown = view.findViewById(R.id.item_count_dropdown);
     Slider positionSlider = view.findViewById(R.id.position_slider);
 
@@ -95,6 +97,16 @@ public void onViewCreated(@NonNull View view, @Nullable Bundle bundle) {
           }
         });
 
+    CarouselSnapHelper snapHelper = new CarouselSnapHelper();
+    snapSwitch.setOnCheckedChangeListener(
+        (buttonView, isChecked) -> {
+          if (isChecked) {
+            snapHelper.attachToRecyclerView(multiBrowseStartRecyclerView);
+          } else {
+            snapHelper.attachToRecyclerView(null);
+          }
+        });
+
     CarouselAdapter adapter =
         new CarouselAdapter(
             (item, position) -> multiBrowseStartRecyclerView.scrollToPosition(position),

diff --git a/catalog/java/io/material/catalog/carousel/res/layout/cat_carousel_multi_browse_fragment.xml b/catalog/java/io/material/catalog/carousel/res/layout/cat_carousel_multi_browse_fragment.xml
@@ -69,6 +69,17 @@
       android:textAppearance="?attr/textAppearanceBodyLarge"
       android:text="@string/cat_carousel_draw_dividers_label"/>
 
+    <com.google.android.material.materialswitch.MaterialSwitch
+      android:id="@+id/snap_switch"
+      android:layout_width="match_parent"
+      android:layout_height="wrap_content"
+      android:checked="false"
+      android:layout_marginHorizontal="16dp"
+      android:layout_marginVertical="8dp"
+      android:textAppearance="?attr/textAppearanceBodyLarge"
+      android:contentDescription="@string/cat_carousel_snap_switch_description"
+      android:text="@string/cat_carousel_enable_snap_label"/>
+
     <com.google.android.material.textfield.TextInputLayout
       style="?attr/textInputFilledExposedDropdownMenuStyle"
       android:layout_width="match_parent"

diff --git a/catalog/java/io/material/catalog/carousel/res/values/strings.xml b/catalog/java/io/material/catalog/carousel/res/values/strings.xml
@@ -19,8 +19,10 @@
   <string name="cat_carousel_debug_mode_label" translatable="false">Debug mode</string>
   <string name="cat_carousel_force_compact_arrangement_label" translatable="false">Force compact arrangement</string>
   <string name="cat_carousel_draw_dividers_label" translatable="false">Draw dividers</string>
+  <string name="cat_carousel_enable_snap_label" description="The title of a switch to enable snapping to carousel items.[CHAR_LIMIT=NONE]">Enable Snap</string>
   <string name="cat_carousel_adapter_item_count_hint_label" translatable="false">Item count</string>
   <string name="cat_carousel_position_slider_label" translatable="false">Scroll position</string>
+  <string name="cat_carousel_snap_switch_description" description="Content description of a switch to enable snapping.[CHAR_LIMIT=NONE]">Enable snapping to carousel items</string>
   <string name="cat_carousel_position_slider_content_description" translatable="false">Scroll position slider</string>
 
   <string-array name="cat_carousel_adapter_count_content" translatable="false">