From d1bacf55db6b81e5f62f506c69bc7adc8a297958 Mon Sep 17 00:00:00 2001
From: raajkumars <raajkumars@google.com>
Date: Mon, 21 Nov 2022 12:41:34 -0500
Subject: [PATCH] [M3][SearchBar] Added new SearchBar and SearchView components

PiperOrigin-RevId: 490002827
---
 .../assets/search/search-bar-anatomy.png      | Bin 0 -> 78006 bytes
 .../assets/search/search-bar-light.png        | Bin 0 -> 19042 bytes
 .../assets/search/search-view-anatomy.png     | Bin 0 -> 61762 bytes
 lib/build.gradle                              |   1 +
 .../dialog/res/values/themes_base.xml         |   6 +
 .../android/material/search/SearchBar.java    | 873 ++++++++++++++++
 .../search/SearchBarAnimationHelper.java      | 423 ++++++++
 .../android/material/search/SearchView.java   | 942 ++++++++++++++++++
 .../search/SearchViewAnimationHelper.java     | 596 +++++++++++
 .../search/res-public/values/public.xml       |  40 +
 .../res/drawable/ic_arrow_back_black_24.xml   |  26 +
 .../search/res/drawable/ic_clear_black_24.xml |  28 +
 .../res/drawable/ic_search_black_24.xml       |  26 +
 .../search/res/layout/mtrl_search_bar.xml     |  25 +
 .../search/res/layout/mtrl_search_view.xml    | 125 +++
 .../material/search/res/values/attrs.xml      |  96 ++
 .../material/search/res/values/dimens.xml     |  31 +
 .../material/search/res/values/strings.xml    |  39 +
 .../material/search/res/values/styles.xml     |  97 ++
 .../material/search/res/values/tokens.xml     |  73 ++
 .../material/theme/res/values/themes_base.xml |   4 +
 .../android/material/theme/ThemeTest.java     |   2 +
 22 files changed, 3453 insertions(+)
 create mode 100644 docs/components/assets/search/search-bar-anatomy.png
 create mode 100644 docs/components/assets/search/search-bar-light.png
 create mode 100644 docs/components/assets/search/search-view-anatomy.png
 create mode 100644 lib/java/com/google/android/material/search/SearchBar.java
 create mode 100644 lib/java/com/google/android/material/search/SearchBarAnimationHelper.java
 create mode 100644 lib/java/com/google/android/material/search/SearchView.java
 create mode 100644 lib/java/com/google/android/material/search/SearchViewAnimationHelper.java
 create mode 100644 lib/java/com/google/android/material/search/res-public/values/public.xml
 create mode 100644 lib/java/com/google/android/material/search/res/drawable/ic_arrow_back_black_24.xml
 create mode 100644 lib/java/com/google/android/material/search/res/drawable/ic_clear_black_24.xml
 create mode 100644 lib/java/com/google/android/material/search/res/drawable/ic_search_black_24.xml
 create mode 100644 lib/java/com/google/android/material/search/res/layout/mtrl_search_bar.xml
 create mode 100644 lib/java/com/google/android/material/search/res/layout/mtrl_search_view.xml
 create mode 100644 lib/java/com/google/android/material/search/res/values/attrs.xml
 create mode 100644 lib/java/com/google/android/material/search/res/values/dimens.xml
 create mode 100644 lib/java/com/google/android/material/search/res/values/strings.xml
 create mode 100644 lib/java/com/google/android/material/search/res/values/styles.xml
 create mode 100644 lib/java/com/google/android/material/search/res/values/tokens.xml

diff --git a/docs/components/assets/search/search-bar-anatomy.png b/docs/components/assets/search/search-bar-anatomy.png
new file mode 100644
index 0000000000000000000000000000000000000000..8f0817b8872b39a6d9743812f3b9093cbbd24395
GIT binary patch
literal 78006
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

literal 0
HcmV?d00001

diff --git a/docs/components/assets/search/search-bar-light.png b/docs/components/assets/search/search-bar-light.png
new file mode 100644
index 0000000000000000000000000000000000000000..caec7c7bcf1328f49121b35d6e0e99a20a5591d0
GIT binary patch
literal 19042
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
C%ze)Q

literal 0
HcmV?d00001

diff --git a/docs/components/assets/search/search-view-anatomy.png b/docs/components/assets/search/search-view-anatomy.png
new file mode 100644
index 0000000000000000000000000000000000000000..abd27589eada2faab8ce925f7cd2378037cacf16
GIT binary patch
literal 61762
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

literal 0
HcmV?d00001

diff --git a/lib/build.gradle b/lib/build.gradle
index cf5ec110c1f..da9db03dcf6 100644
--- a/lib/build.gradle
+++ b/lib/build.gradle
@@ -70,6 +70,7 @@ def srcDirs = [
   'com/google/android/material/radiobutton',
   'com/google/android/material/resources',
   'com/google/android/material/ripple',
+  'com/google/android/material/search',
   'com/google/android/material/shape',
   'com/google/android/material/shadow',
   'com/google/android/material/sidesheet',
diff --git a/lib/java/com/google/android/material/dialog/res/values/themes_base.xml b/lib/java/com/google/android/material/dialog/res/values/themes_base.xml
index 162331e907f..cfc917798c2 100644
--- a/lib/java/com/google/android/material/dialog/res/values/themes_base.xml
+++ b/lib/java/com/google/android/material/dialog/res/values/themes_base.xml
@@ -126,6 +126,8 @@
     <item name="navigationRailStyle">@style/Widget.Material3.NavigationRailView</item>
     <item name="navigationViewStyle">@style/Widget.Material3.NavigationView</item>
     <item name="radioButtonStyle">@style/Widget.Material3.CompoundButton.RadioButton</item>
+    <item name="searchBarStyle">@style/Widget.Material3.SearchBar</item>
+    <item name="searchViewStyle">@style/Widget.Material3.SearchView</item>
     <item name="sliderStyle">@style/Widget.Material3.Slider</item>
     <item name="snackbarStyle">@style/Widget.Material3.Snackbar</item>
     <item name="snackbarButtonStyle">@style/Widget.Material3.Button.TextButton.Snackbar</item>
@@ -363,6 +365,8 @@
     <item name="navigationRailStyle">@style/Widget.Material3.NavigationRailView</item>
     <item name="navigationViewStyle">@style/Widget.Material3.NavigationView</item>
     <item name="radioButtonStyle">@style/Widget.Material3.CompoundButton.RadioButton</item>
+    <item name="searchBarStyle">@style/Widget.Material3.SearchBar</item>
+    <item name="searchViewStyle">@style/Widget.Material3.SearchView</item>
     <item name="sliderStyle">@style/Widget.Material3.Slider</item>
     <item name="snackbarStyle">@style/Widget.Material3.Snackbar</item>
     <item name="snackbarButtonStyle">@style/Widget.Material3.Button.TextButton.Snackbar</item>
@@ -527,6 +531,8 @@
     <item name="navigationViewStyle">@style/Widget.MaterialComponents.NavigationView</item>
     <item name="popupMenuStyle">@style/Widget.MaterialComponents.PopupMenu</item>
     <item name="radioButtonStyle">@style/Widget.MaterialComponents.CompoundButton.RadioButton</item>
+    <item name="searchBarStyle">@style/Widget.Material3.SearchBar</item>
+    <item name="searchViewStyle">@style/Widget.Material3.SearchView</item>
     <item name="snackbarStyle">@style/Widget.MaterialComponents.Snackbar</item>
     <item name="snackbarButtonStyle">@style/Widget.MaterialComponents.Button.TextButton.Snackbar</item>
     <item name="snackbarTextViewStyle">@style/Widget.MaterialComponents.Snackbar.TextView</item>
diff --git a/lib/java/com/google/android/material/search/SearchBar.java b/lib/java/com/google/android/material/search/SearchBar.java
new file mode 100644
index 00000000000..c35ac1a7ff8
--- /dev/null
+++ b/lib/java/com/google/android/material/search/SearchBar.java
@@ -0,0 +1,873 @@
+/*
+ * Copyright 2022 The Android Open Source Project
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     https://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+package com.google.android.material.search;
+
+import com.google.android.material.R;
+
+import static com.google.android.material.theme.overlay.MaterialThemeOverlay.wrap;
+
+import android.animation.AnimatorListenerAdapter;
+import android.content.Context;
+import android.content.res.ColorStateList;
+import android.content.res.Resources;
+import android.content.res.TypedArray;
+import android.graphics.Color;
+import android.graphics.drawable.Drawable;
+import android.graphics.drawable.RippleDrawable;
+import android.os.Build;
+import android.os.Build.VERSION;
+import android.os.Build.VERSION_CODES;
+import android.os.Parcel;
+import android.os.Parcelable;
+import androidx.appcompat.content.res.AppCompatResources;
+import androidx.appcompat.widget.ActionMenuView;
+import androidx.appcompat.widget.Toolbar;
+import android.text.TextUtils;
+import android.util.AttributeSet;
+import android.view.LayoutInflater;
+import android.view.View;
+import android.view.ViewGroup;
+import android.view.accessibility.AccessibilityNodeInfo;
+import android.widget.EditText;
+import android.widget.ImageButton;
+import android.widget.TextView;
+import androidx.annotation.ColorInt;
+import androidx.annotation.Dimension;
+import androidx.annotation.MenuRes;
+import androidx.annotation.NonNull;
+import androidx.annotation.Nullable;
+import androidx.annotation.RequiresApi;
+import androidx.annotation.StringRes;
+import androidx.annotation.StyleRes;
+import androidx.coordinatorlayout.widget.CoordinatorLayout;
+import androidx.core.graphics.drawable.DrawableCompat;
+import androidx.core.view.MarginLayoutParamsCompat;
+import androidx.core.view.ViewCompat;
+import androidx.core.widget.TextViewCompat;
+import androidx.customview.view.AbsSavedState;
+import com.google.android.material.appbar.AppBarLayout;
+import com.google.android.material.color.MaterialColors;
+import com.google.android.material.internal.ThemeEnforcement;
+import com.google.android.material.internal.ToolbarUtils;
+import com.google.android.material.shape.MaterialShapeDrawable;
+import com.google.android.material.shape.MaterialShapeUtils;
+import com.google.android.material.shape.ShapeAppearanceModel;
+import com.google.errorprone.annotations.CanIgnoreReturnValue;
+
+/**
+ * The {@link SearchBar} represents a floating search field with affordances for search and
+ * navigation.
+ *
+ * <p>Note: {@link SearchBar} does not support the {@link #setTitle} and {@link #setSubtitle}
+ * methods, or their corresponding xml attributes. Instead, use {@link #setHint} or {@link
+ * #setText}, or their corresponding xml attributes, to provide a text affordance for your {@link
+ * SearchBar}.
+ */
+public class SearchBar extends Toolbar {
+
+  private static final int DEF_STYLE_RES = R.style.Widget_Material3_SearchBar;
+
+  private static final int DEFAULT_SCROLL_FLAGS =
+      AppBarLayout.LayoutParams.SCROLL_FLAG_SCROLL
+          | AppBarLayout.LayoutParams.SCROLL_FLAG_ENTER_ALWAYS
+          | AppBarLayout.LayoutParams.SCROLL_FLAG_SNAP
+          | AppBarLayout.LayoutParams.SCROLL_FLAG_SNAP_MARGINS;
+  private static final String NAMESPACE_APP = "http://schemas.android.com/apk/res-auto";
+
+  private final TextView textView;
+  private final boolean layoutInflated;
+  private final boolean defaultMarginsEnabled;
+  private final SearchBarAnimationHelper searchBarAnimationHelper;
+  private final Drawable defaultNavigationIcon;
+  private final boolean tintNavigationIcon;
+  private final boolean forceDefaultNavigationOnClickListener;
+
+  @Nullable private View centerView;
+  @Nullable private Integer navigationIconTint;
+  @Nullable private Drawable originalNavigationIconBackground;
+  private int menuResId = -1;
+  private boolean defaultScrollFlagsEnabled;
+  private MaterialShapeDrawable backgroundShape;
+
+  public SearchBar(@NonNull Context context) {
+    this(context, null);
+  }
+
+  public SearchBar(@NonNull Context context, @Nullable AttributeSet attrs) {
+    this(context, attrs, R.attr.searchBarStyle);
+  }
+
+  public SearchBar(@NonNull Context context, @Nullable AttributeSet attrs, int defStyleAttr) {
+    super(wrap(context, attrs, defStyleAttr, DEF_STYLE_RES), attrs, defStyleAttr);
+    // Ensure we are using the correctly themed context rather than the context that was passed in.
+    context = getContext();
+    validateAttributes(attrs);
+
+    defaultNavigationIcon =
+        AppCompatResources.getDrawable(context, R.drawable.ic_search_black_24);
+    searchBarAnimationHelper = new SearchBarAnimationHelper();
+
+    TypedArray a =
+        ThemeEnforcement.obtainStyledAttributes(
+            context, attrs, R.styleable.SearchBar, defStyleAttr, DEF_STYLE_RES);
+
+    ShapeAppearanceModel shapeAppearanceModel =
+        ShapeAppearanceModel.builder(context, attrs, defStyleAttr, DEF_STYLE_RES).build();
+    float elevation = a.getDimension(R.styleable.SearchBar_elevation, 0);
+    defaultMarginsEnabled = a.getBoolean(R.styleable.SearchBar_defaultMarginsEnabled, true);
+    defaultScrollFlagsEnabled = a.getBoolean(R.styleable.SearchBar_defaultScrollFlagsEnabled, true);
+    boolean hideNavigationIcon = a.getBoolean(R.styleable.SearchBar_hideNavigationIcon, false);
+    forceDefaultNavigationOnClickListener =
+        a.getBoolean(R.styleable.SearchBar_forceDefaultNavigationOnClickListener, false);
+    tintNavigationIcon = a.getBoolean(R.styleable.SearchBar_tintNavigationIcon, true);
+    if (a.hasValue(R.styleable.SearchBar_navigationIconTint)) {
+      navigationIconTint = a.getColor(R.styleable.SearchBar_navigationIconTint, -1);
+    }
+    int textAppearanceResId = a.getResourceId(R.styleable.SearchBar_android_textAppearance, -1);
+    String text = a.getString(R.styleable.SearchBar_android_text);
+    String hint = a.getString(R.styleable.SearchBar_android_hint);
+    float strokeWidth = a.getDimension(R.styleable.SearchBar_strokeWidth, -1);
+    int strokeColor = a.getColor(R.styleable.SearchBar_strokeColor, Color.TRANSPARENT);
+
+    a.recycle();
+
+    if (!hideNavigationIcon) {
+      initNavigationIcon();
+    }
+    setClickable(true);
+    setFocusable(true);
+
+    LayoutInflater.from(context).inflate(R.layout.mtrl_search_bar, this);
+    layoutInflated = true;
+
+    textView = findViewById(R.id.search_bar_text_view);
+
+    ViewCompat.setElevation(this, elevation);
+    initTextView(textAppearanceResId, text, hint);
+    initBackground(shapeAppearanceModel, elevation, strokeWidth, strokeColor);
+  }
+
+  private void validateAttributes(@Nullable AttributeSet attributeSet) {
+    if (attributeSet == null) {
+      return;
+    }
+    if (attributeSet.getAttributeValue(NAMESPACE_APP, "title") != null) {
+      throw new UnsupportedOperationException(
+          "SearchBar does not support title. Use hint or text instead.");
+    }
+    if (attributeSet.getAttributeValue(NAMESPACE_APP, "subtitle") != null) {
+      throw new UnsupportedOperationException(
+          "SearchBar does not support subtitle. Use hint or text instead.");
+    }
+  }
+
+  private void initNavigationIcon() {
+    // If no navigation icon, set up the default one; otherwise, re-set it for tinting if needed.
+    setNavigationIcon(getNavigationIcon() == null ? defaultNavigationIcon : getNavigationIcon());
+
+    // Make the navigation icon button decorative (not clickable/focusable) by default so that the
+    // overall search bar handles the click. If a navigation icon click listener is set later on,
+    // the button will be made clickable/focusable.
+    setNavigationIconDecorative(true);
+  }
+
+  private void initTextView(@StyleRes int textAppearanceResId, String text, String hint) {
+    if (textAppearanceResId != -1) {
+      TextViewCompat.setTextAppearance(textView, textAppearanceResId);
+    }
+    setText(text);
+    setHint(hint);
+    if (getNavigationIcon() == null) {
+      MarginLayoutParamsCompat.setMarginStart(
+          (MarginLayoutParams) textView.getLayoutParams(),
+          getResources()
+              .getDimensionPixelSize(R.dimen.m3_searchbar_text_margin_start_no_navigation_icon));
+    }
+  }
+
+  private void initBackground(
+      ShapeAppearanceModel shapeAppearance,
+      float elevation,
+      float strokeWidth,
+      @ColorInt int strokeColor) {
+    backgroundShape = new MaterialShapeDrawable(shapeAppearance);
+    backgroundShape.initializeElevationOverlay(getContext());
+    backgroundShape.setElevation(elevation);
+    if (strokeWidth >= 0) {
+      backgroundShape.setStroke(strokeWidth, strokeColor);
+    }
+
+    int backgroundColor = MaterialColors.getColor(this, R.attr.colorSurface);
+    int rippleColor = MaterialColors.getColor(this, R.attr.colorControlHighlight);
+    Drawable background;
+    if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.LOLLIPOP) {
+      backgroundShape.setFillColor(ColorStateList.valueOf(backgroundColor));
+      background =
+          new RippleDrawable(ColorStateList.valueOf(rippleColor), backgroundShape, backgroundShape);
+    } else {
+      backgroundShape.setFillColor(getCompatBackgroundColorStateList(backgroundColor, rippleColor));
+      background = backgroundShape;
+    }
+
+    ViewCompat.setBackground(this, background);
+  }
+
+  private ColorStateList getCompatBackgroundColorStateList(
+      @ColorInt int backgroundColor, @ColorInt int rippleColor) {
+    int[][] states =
+        new int[][] {
+          new int[] {android.R.attr.state_pressed},
+          new int[] {android.R.attr.state_focused},
+          new int[] {},
+        };
+    int pressedBackgroundColor = MaterialColors.layer(backgroundColor, rippleColor);
+    int[] colors = new int[] {pressedBackgroundColor, pressedBackgroundColor, backgroundColor};
+    return new ColorStateList(states, colors);
+  }
+
+  @Override
+  public void addView(View child, int index, ViewGroup.LayoutParams params) {
+    if (layoutInflated && centerView == null && !(child instanceof ActionMenuView)) {
+      centerView = child;
+      centerView.setAlpha(0);
+    }
+    super.addView(child, index, params);
+  }
+
+  @RequiresApi(VERSION_CODES.LOLLIPOP)
+  @Override
+  public void setElevation(float elevation) {
+    super.setElevation(elevation);
+    if (backgroundShape != null) {
+      backgroundShape.setElevation(elevation);
+    }
+  }
+
+  @Override
+  public void onInitializeAccessibilityNodeInfo(AccessibilityNodeInfo info) {
+    super.onInitializeAccessibilityNodeInfo(info);
+    info.setClassName(EditText.class.getCanonicalName());
+    CharSequence text = getText();
+    boolean isTextEmpty = TextUtils.isEmpty(text);
+    if (VERSION.SDK_INT >= VERSION_CODES.O) {
+      info.setHintText(getHint());
+      info.setShowingHintText(isTextEmpty);
+    }
+
+    if (isTextEmpty) {
+      text = getHint();
+    }
+
+    info.setText(text);
+  }
+
+  @Override
+  public void setNavigationOnClickListener(OnClickListener listener) {
+    if (forceDefaultNavigationOnClickListener) {
+      // Ignore the listener if forcing of the default navigation icon is enabled.
+      return;
+    }
+    super.setNavigationOnClickListener(listener);
+    setNavigationIconDecorative(listener == null);
+  }
+
+  @Override
+  public void setNavigationIcon(@Nullable Drawable navigationIcon) {
+    super.setNavigationIcon(maybeTintNavigationIcon(navigationIcon));
+  }
+
+  @Nullable
+  private Drawable maybeTintNavigationIcon(@Nullable Drawable navigationIcon) {
+    if (!tintNavigationIcon || navigationIcon == null) {
+      return navigationIcon;
+    }
+
+    int navigationIconColor;
+    if (navigationIconTint != null) {
+      navigationIconColor = navigationIconTint;
+    } else {
+      // Navigational icons such as the "hamburger", back arrow, etc. are supposed to be emphasized
+      // with colorOnSurface as opposed to colorOnSurfaceVariant. Here we assume any icon that's not
+      // the default search icon is navigational.
+      int navigationIconColorAttr =
+          navigationIcon == defaultNavigationIcon
+              ? R.attr.colorOnSurfaceVariant
+              : R.attr.colorOnSurface;
+      navigationIconColor = MaterialColors.getColor(this, navigationIconColorAttr);
+    }
+
+    Drawable wrappedNavigationIcon = DrawableCompat.wrap(navigationIcon.mutate());
+    DrawableCompat.setTint(wrappedNavigationIcon, navigationIconColor);
+    return wrappedNavigationIcon;
+  }
+
+  private void setNavigationIconDecorative(boolean decorative) {
+    ImageButton navigationIconButton = ToolbarUtils.getNavigationIconButton(this);
+    if (navigationIconButton == null) {
+      return;
+    }
+
+    navigationIconButton.setClickable(!decorative);
+    navigationIconButton.setFocusable(!decorative);
+
+    Drawable navigationIconBackground = navigationIconButton.getBackground();
+    if (navigationIconBackground != null) {
+      // Save original navigation icon background so we can restore it later if needed.
+      originalNavigationIconBackground = navigationIconBackground;
+    }
+    // Even if the navigation icon is not clickable/focusable, a ripple will still show up when the
+    // parent view (overall search bar) is clicked. So here we set the background to null to avoid
+    // that, and restore the original background when the icon becomes clickable.
+    navigationIconButton.setBackgroundDrawable(
+        decorative ? null : originalNavigationIconBackground);
+  }
+
+  @Override
+  public void inflateMenu(@MenuRes int resId) {
+    super.inflateMenu(resId);
+    this.menuResId = resId;
+  }
+
+  @Override
+  protected void onMeasure(int widthMeasureSpec, int heightMeasureSpec) {
+    super.onMeasure(widthMeasureSpec, heightMeasureSpec);
+
+    measureCenterView(widthMeasureSpec, heightMeasureSpec);
+  }
+
+  @Override
+  protected void onLayout(boolean changed, int left, int top, int right, int bottom) {
+    super.onLayout(changed, left, top, right, bottom);
+
+    layoutCenterView();
+  }
+
+  @Override
+  protected void onAttachedToWindow() {
+    super.onAttachedToWindow();
+
+    MaterialShapeUtils.setParentAbsoluteElevation(this, backgroundShape);
+    setDefaultMargins();
+    setOrClearDefaultScrollFlags();
+  }
+
+  /**
+   * {@link SearchBar} does not support the {@link Toolbar#setTitle} method, or its corresponding
+   * xml attribute. Instead, use {@link #setHint} or {@link #setText}, or their corresponding xml
+   * attributes, to provide a text affordance for your {@link SearchBar}.
+   */
+  @Override
+  public void setTitle(CharSequence title) {
+    // Don't do anything. SearchBar can't have a title.
+    // Note: we can't throw an exception here because setTitle() is called by setSupportActionBar().
+  }
+
+  /**
+   * {@link SearchBar} does not support the {@link Toolbar#setSubtitle} method, or its corresponding
+   * xml attribute. Instead, use {@link #setHint} or {@link #setText}, or their corresponding xml
+   * attributes, to provide a text affordance for your {@link SearchBar}.
+   */
+  @Override
+  public void setSubtitle(CharSequence subtitle) {
+    // Don't do anything. SearchBar can't have a subtitle.
+    // Note: we can't throw an exception here because setSubtitle() is called by
+    // ActionBar#setDisplayShowTitleEnabled().
+  }
+
+  private void setDefaultMargins() {
+    if (defaultMarginsEnabled && getLayoutParams() instanceof MarginLayoutParams) {
+      Resources resources = getResources();
+      int marginHorizontal =
+          resources.getDimensionPixelSize(R.dimen.m3_searchbar_margin_horizontal);
+      int marginVertical = resources.getDimensionPixelSize(R.dimen.m3_searchbar_margin_vertical);
+      MarginLayoutParams lp = (MarginLayoutParams) getLayoutParams();
+      lp.leftMargin = defaultIfZero(lp.leftMargin, marginHorizontal);
+      lp.topMargin = defaultIfZero(lp.topMargin, marginVertical);
+      lp.rightMargin = defaultIfZero(lp.rightMargin, marginHorizontal);
+      lp.bottomMargin = defaultIfZero(lp.bottomMargin, marginVertical);
+    }
+  }
+
+  private int defaultIfZero(int value, int defValue) {
+    return value == 0 ? defValue : value;
+  }
+
+  private void setOrClearDefaultScrollFlags() {
+    if (getLayoutParams() instanceof AppBarLayout.LayoutParams) {
+      AppBarLayout.LayoutParams lp = (AppBarLayout.LayoutParams) getLayoutParams();
+      if (defaultScrollFlagsEnabled) {
+        if (lp.getScrollFlags() == 0) {
+          lp.setScrollFlags(DEFAULT_SCROLL_FLAGS);
+        }
+      } else {
+        if (lp.getScrollFlags() == DEFAULT_SCROLL_FLAGS) {
+          lp.setScrollFlags(0);
+        }
+      }
+    }
+  }
+
+  private void measureCenterView(int widthMeasureSpec, int heightMeasureSpec) {
+    if (centerView != null) {
+      centerView.measure(widthMeasureSpec, heightMeasureSpec);
+    }
+  }
+
+  private void layoutCenterView() {
+    if (centerView == null) {
+      return;
+    }
+
+    int centerViewWidth = centerView.getMeasuredWidth();
+    int left = getMeasuredWidth() / 2 - centerViewWidth / 2;
+    int right = left + centerViewWidth;
+
+    int centerViewHeight = centerView.getMeasuredHeight();
+    int top = getMeasuredHeight() / 2 - centerViewHeight / 2;
+    int bottom = top + centerViewHeight;
+
+    layoutChild(centerView, left, top, right, bottom);
+  }
+
+  private void layoutChild(View child, int left, int top, int right, int bottom) {
+    if (ViewCompat.getLayoutDirection(this) == ViewCompat.LAYOUT_DIRECTION_RTL) {
+      child.layout(getMeasuredWidth() - right, top, getMeasuredWidth() - left, bottom);
+    } else {
+      child.layout(left, top, right, bottom);
+    }
+  }
+
+  /** Returns the optional centered child view of this {@link SearchBar} */
+  @Nullable
+  public View getCenterView() {
+    return centerView;
+  }
+
+  /**
+   * Sets and adds the center view as a child. If you've set a center view and would like to remove
+   * it, pass in null for {@param view}.
+   */
+  public void setCenterView(@Nullable View view) {
+    if (centerView != null) {
+      removeView(centerView);
+      centerView = null;
+    }
+    if (view != null) {
+      addView(view);
+    }
+  }
+
+  /** Returns the main {@link TextView} which can be used for hint and search text. */
+  @NonNull
+  public TextView getTextView() {
+    return textView;
+  }
+
+  /** Returns the text of main {@link TextView}, which usually represents the search text. */
+  @Nullable
+  public CharSequence getText() {
+    return textView.getText();
+  }
+
+  /** Sets the text of main {@link TextView}. */
+  public void setText(@Nullable CharSequence text) {
+    textView.setText(text);
+  }
+
+  /** Sets the text of main {@link TextView}. */
+  public void setText(@StringRes int textResId) {
+    textView.setText(textResId);
+  }
+
+  /** Clears the text of main {@link TextView}. */
+  public void clearText() {
+    textView.setText("");
+  }
+
+  /** Returns the hint of main {@link TextView}. */
+  @Nullable
+  public CharSequence getHint() {
+    return textView.getHint();
+  }
+
+  /** Sets the hint of main {@link TextView}. */
+  public void setHint(@Nullable CharSequence hint) {
+    textView.setHint(hint);
+  }
+
+  /** Sets the hint of main {@link TextView}. */
+  public void setHint(@StringRes int hintResId) {
+    textView.setHint(hintResId);
+  }
+
+  /** Returns the color of the {@link SearchBar} outline stroke. */
+  @ColorInt
+  public int getStrokeColor() {
+    return backgroundShape.getStrokeColor().getDefaultColor();
+  }
+
+  /** Sets the color of the {@link SearchBar} outline stroke. */
+  public void setStrokeColor(@ColorInt int strokeColor) {
+    if (getStrokeColor() != strokeColor) {
+      backgroundShape.setStrokeColor(ColorStateList.valueOf(strokeColor));
+    }
+  }
+
+  /** Returns the width in pixels of the {@link SearchBar} outline stroke. */
+  @Dimension
+  public float getStrokeWidth() {
+    return backgroundShape.getStrokeWidth();
+  }
+
+  /** Sets the width in pixels of the {@link SearchBar} outline stroke. */
+  public void setStrokeWidth(@Dimension float strokeWidth) {
+    if (getStrokeWidth() != strokeWidth) {
+      backgroundShape.setStrokeWidth(strokeWidth);
+    }
+  }
+
+  /** Returns the size in pixels of the {@link SearchBar} corners. */
+  public float getCornerSize() {
+    // Assume all corner sizes are the same.
+    return backgroundShape.getTopLeftCornerResolvedSize();
+  }
+
+  /**
+   * Returns whether the default {@link AppBarLayout} scroll flags are enabled. See {@link
+   * SearchBar#DEFAULT_SCROLL_FLAGS}.
+   */
+  public boolean isDefaultScrollFlagsEnabled() {
+    return defaultScrollFlagsEnabled;
+  }
+
+  /**
+   * Sets whether the default {@link AppBarLayout} scroll flags are enabled. See {@link
+   * SearchBar#DEFAULT_SCROLL_FLAGS}.
+   */
+  public void setDefaultScrollFlagsEnabled(boolean defaultScrollFlagsEnabled) {
+    this.defaultScrollFlagsEnabled = defaultScrollFlagsEnabled;
+    setOrClearDefaultScrollFlags();
+  }
+
+  /**
+   * Starts the on load animation which transitions from the center view to the hint {@link
+   * TextView}.
+   */
+  public void startOnLoadAnimation() {
+    // Use a post() to make sure the SearchBar's menu is inflated before the animation starts.
+    post(() -> searchBarAnimationHelper.startOnLoadAnimation(this));
+  }
+
+  /**
+   * Stops the on load animation which transitions from the center view to the hint {@link
+   * TextView}.
+   */
+  public void stopOnLoadAnimation() {
+    searchBarAnimationHelper.stopOnLoadAnimation(this);
+  }
+
+  /** Returns whether the fade in part is enabled for the on load animation. */
+  public boolean isOnLoadAnimationFadeInEnabled() {
+    return searchBarAnimationHelper.isOnLoadAnimationFadeInEnabled();
+  }
+
+  /** Sets whether the fade in part is enabled for the on load animation. */
+  public void setOnLoadAnimationFadeInEnabled(boolean onLoadAnimationFadeInEnabled) {
+    searchBarAnimationHelper.setOnLoadAnimationFadeInEnabled(onLoadAnimationFadeInEnabled);
+  }
+
+  /**
+   * Registers a callback for the On Load Animation, started and stopped via {@link
+   * #startOnLoadAnimation()} and {@link #stopOnLoadAnimation()}.
+   */
+  public void registerOnLoadAnimationCallback(
+      @NonNull OnLoadAnimationCallback onLoadAnimationCallback) {
+    searchBarAnimationHelper.registerOnLoadAnimationCallback(onLoadAnimationCallback);
+  }
+
+  /**
+   * Unregisters a callback for the On Load Animation, started and stopped via {@link
+   * #startOnLoadAnimation()} and {@link #stopOnLoadAnimation()}.
+   */
+  public boolean unregisterOnLoadAnimationCallback(
+      @NonNull OnLoadAnimationCallback onLoadAnimationCallback) {
+    return searchBarAnimationHelper.unregisterOnLoadAnimationCallback(onLoadAnimationCallback);
+  }
+
+  /**
+   * Clears all registered callbacks for the On Load Animation, started and stopped via {@link
+   * #startOnLoadAnimation()} and {@link #stopOnLoadAnimation()}.
+   */
+  public void clearOnLoadAnimationCallbacks() {
+    searchBarAnimationHelper.clearOnLoadAnimationCallbacks();
+  }
+
+  /** Returns whether the expand animation is running. */
+  public boolean isExpanding() {
+    return searchBarAnimationHelper.isExpanding();
+  }
+
+  /** See {@link SearchBar#expand(View, AppBarLayout, boolean)}. */
+  @CanIgnoreReturnValue
+  public boolean expand(@NonNull View expandedView) {
+    return expand(expandedView, /* appBarLayout= */ null);
+  }
+
+  /** See {@link SearchBar#expand(View, AppBarLayout, boolean)}. */
+  @CanIgnoreReturnValue
+  public boolean expand(@NonNull View expandedView, @Nullable AppBarLayout appBarLayout) {
+    return expand(expandedView, appBarLayout, /* skipAnimation= */ false);
+  }
+
+  /**
+   * Starts an expand animation, if it's not already started, which transitions from the {@link
+   * SearchBar} to the {@code expandedView}, e.g., a contextual {@link Toolbar}.
+   *
+   * <p>Note: If you are using an {@link AppBarLayout} in conjunction with the {@link SearchBar},
+   * you may pass in a reference to your {@link AppBarLayout} so that its visibility and offset can
+   * be taken into account for the animation.
+   *
+   * @return whether or not the expand animation was started
+   */
+  @CanIgnoreReturnValue
+  public boolean expand(
+      @NonNull View expandedView, @Nullable AppBarLayout appBarLayout, boolean skipAnimation) {
+    // Start the expand if the expanded view is not already showing or in the process of expanding,
+    // or if the expanded view is collapsing since the final state should be expanded.
+    if ((expandedView.getVisibility() != View.VISIBLE && !isExpanding()) || isCollapsing()) {
+      searchBarAnimationHelper.startExpandAnimation(
+          this, expandedView, appBarLayout, skipAnimation);
+      return true;
+    }
+    return false;
+  }
+
+  /**
+   * Adds a listener for the expand animation started via {@link #expand(View)} and {@link
+   * #expand(View, AppBarLayout)}.
+   */
+  public void addExpandAnimationListener(@NonNull AnimatorListenerAdapter listener) {
+    searchBarAnimationHelper.addExpandAnimationListener(listener);
+  }
+
+  /**
+   * Removes a listener for the expand animation started via {@link #expand(View)} and {@link
+   * #expand(View, AppBarLayout)}.
+   *
+   * @return true if a listener was removed as a result of this call
+   */
+  public boolean removeExpandAnimationListener(@NonNull AnimatorListenerAdapter listener) {
+    return searchBarAnimationHelper.removeExpandAnimationListener(listener);
+  }
+
+  /**
+   * Removes all expand animation listeners added via {@link
+   * #addExpandAnimationListener(AnimatorListenerAdapter)}.
+   */
+  public void clearExpandAnimationListeners() {
+    searchBarAnimationHelper.clearExpandAnimationListeners();
+  }
+
+  /** Returns whether the collapse animation is running. */
+  public boolean isCollapsing() {
+    return searchBarAnimationHelper.isCollapsing();
+  }
+
+  /** See {@link SearchBar#collapse(View, AppBarLayout, boolean)}. */
+  @CanIgnoreReturnValue
+  public boolean collapse(@NonNull View expandedView) {
+    return collapse(expandedView, /* appBarLayout= */ null);
+  }
+
+  /** See {@link SearchBar#collapse(View, AppBarLayout, boolean)}. */
+  @CanIgnoreReturnValue
+  public boolean collapse(@NonNull View expandedView, @Nullable AppBarLayout appBarLayout) {
+    return collapse(expandedView, /* appBarLayout= */ appBarLayout, /* skipAnimation= */ false);
+  }
+
+  /**
+   * Starts a collapse animation, if it's not already started, which transitions from the {@code
+   * expandedView}, e.g., a contextual {@link Toolbar}, to the {@link SearchBar}.
+   *
+   * <p>Note: If you are using an {@link AppBarLayout} in conjunction with the {@link SearchBar},
+   * you may pass in a reference to your {@link AppBarLayout} so that its visibility and offset can
+   * be taken into account for the animation.
+   *
+   * @return whether or not the collapse animation was started
+   */
+  @CanIgnoreReturnValue
+  public boolean collapse(
+      @NonNull View expandedView, @Nullable AppBarLayout appBarLayout, boolean skipAnimation) {
+    // Start the collapse if the expanded view is showing and not in the process of collapsing, or
+    // if the expanded view is expanding since the final state should be collapsed.
+    if ((expandedView.getVisibility() == View.VISIBLE && !isCollapsing()) || isExpanding()) {
+      searchBarAnimationHelper.startCollapseAnimation(
+          this, expandedView, appBarLayout, skipAnimation);
+      return true;
+    }
+    return false;
+  }
+
+  /**
+   * Adds a listener for the collapse animation started via {@link #collapse(View)} and {@link
+   * #collapse(View, AppBarLayout)}.
+   */
+  public void addCollapseAnimationListener(@NonNull AnimatorListenerAdapter listener) {
+    searchBarAnimationHelper.addCollapseAnimationListener(listener);
+  }
+
+  /**
+   * Removes a listener for the collapse animation started via {@link #collapse(View)} and {@link
+   * #collapse(View, AppBarLayout)}.
+   *
+   * @return true if a listener was removed as a result of this call
+   */
+  public boolean removeCollapseAnimationListener(@NonNull AnimatorListenerAdapter listener) {
+    return searchBarAnimationHelper.removeCollapseAnimationListener(listener);
+  }
+
+  /**
+   * Removes all collapse animation listeners added via {@link
+   * #addCollapseAnimationListener(AnimatorListenerAdapter)}.
+   */
+  public void clearCollapseAnimationListeners() {
+    searchBarAnimationHelper.clearCollapseAnimationListeners();
+  }
+
+  int getMenuResId() {
+    return menuResId;
+  }
+
+  float getCompatElevation() {
+    return backgroundShape != null ? backgroundShape.getElevation() : ViewCompat.getElevation(this);
+  }
+
+  /** Behavior that sets up the scroll-away mode for an {@link SearchBar}. */
+  public static class ScrollingViewBehavior extends AppBarLayout.ScrollingViewBehavior {
+
+    private boolean initialized = false;
+
+    public ScrollingViewBehavior() {}
+
+    public ScrollingViewBehavior(@NonNull Context context, @Nullable AttributeSet attrs) {
+      super(context, attrs);
+    }
+
+    @Override
+    public boolean onDependentViewChanged(
+        @NonNull CoordinatorLayout parent, @NonNull View child, @NonNull View dependency) {
+      boolean changed = super.onDependentViewChanged(parent, child, dependency);
+      if (!initialized && dependency instanceof AppBarLayout) {
+        initialized = true;
+        AppBarLayout appBarLayout = (AppBarLayout) dependency;
+        setAppBarLayoutTransparent(appBarLayout);
+      }
+      return changed;
+    }
+
+    private void setAppBarLayoutTransparent(AppBarLayout appBarLayout) {
+      appBarLayout.setBackgroundColor(Color.TRANSPARENT);
+
+      // Remove AppBarLayout elevation shadow
+      if (Build.VERSION.SDK_INT == VERSION_CODES.LOLLIPOP) {
+        // Workaround for elevation crash that only happens on Android 5.0
+        // Similar to https://stackoverflow.com/q/40928788
+        appBarLayout.setOutlineProvider(null);
+      } else {
+        appBarLayout.setTargetElevation(0);
+      }
+    }
+
+    @Override
+    protected boolean shouldHeaderOverlapScrollingChild() {
+      return true;
+    }
+  }
+
+  /**
+   * Callback for the animation started and stopped via {@link #startOnLoadAnimation()} and {@link
+   * #stopOnLoadAnimation()}.
+   */
+  public abstract static class OnLoadAnimationCallback {
+    public void onAnimationStart() {}
+
+    public void onAnimationEnd() {}
+  }
+
+  @Override
+  @NonNull
+  protected Parcelable onSaveInstanceState() {
+    SavedState savedState = new SavedState(super.onSaveInstanceState());
+    CharSequence text = getText();
+    savedState.text = text == null ? null : text.toString();
+    return savedState;
+  }
+
+  @Override
+  protected void onRestoreInstanceState(Parcelable state) {
+    if (!(state instanceof SavedState)) {
+      super.onRestoreInstanceState(state);
+      return;
+    }
+    SavedState savedState = (SavedState) state;
+    super.onRestoreInstanceState(savedState.getSuperState());
+    setText(savedState.text);
+  }
+
+  static class SavedState extends AbsSavedState {
+
+    String text;
+
+    public SavedState(Parcel source) {
+      this(source, null);
+    }
+
+    public SavedState(Parcel source, @Nullable ClassLoader classLoader) {
+      super(source, classLoader);
+      text = source.readString();
+    }
+
+    public SavedState(Parcelable superState) {
+      super(superState);
+    }
+
+    public static final Parcelable.Creator<SavedState> CREATOR =
+        new ClassLoaderCreator<SavedState>() {
+
+          @Override
+          public SavedState createFromParcel(Parcel source, ClassLoader loader) {
+            return new SavedState(source, loader);
+          }
+
+          @Override
+          public SavedState createFromParcel(Parcel source) {
+            return new SavedState(source);
+          }
+
+          @Override
+          public SavedState[] newArray(int size) {
+            return new SavedState[size];
+          }
+        };
+
+    @Override
+    public void writeToParcel(Parcel dest, int flags) {
+      super.writeToParcel(dest, flags);
+      dest.writeString(text);
+    }
+  }
+}
diff --git a/lib/java/com/google/android/material/search/SearchBarAnimationHelper.java b/lib/java/com/google/android/material/search/SearchBarAnimationHelper.java
new file mode 100644
index 00000000000..5e1a4f1ba46
--- /dev/null
+++ b/lib/java/com/google/android/material/search/SearchBarAnimationHelper.java
@@ -0,0 +1,423 @@
+/*
+ * Copyright 2022 The Android Open Source Project
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     https://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+package com.google.android.material.search;
+
+import android.animation.Animator;
+import android.animation.AnimatorListenerAdapter;
+import android.animation.AnimatorSet;
+import android.animation.ValueAnimator;
+import android.animation.ValueAnimator.AnimatorUpdateListener;
+import androidx.appcompat.widget.ActionMenuView;
+import android.view.View;
+import android.view.ViewGroup;
+import android.widget.TextView;
+import androidx.annotation.NonNull;
+import androidx.annotation.Nullable;
+import androidx.core.view.ViewCompat;
+import com.google.android.material.animation.AnimatableView;
+import com.google.android.material.animation.AnimationUtils;
+import com.google.android.material.appbar.AppBarLayout;
+import com.google.android.material.internal.ExpandCollapseAnimationHelper;
+import com.google.android.material.internal.MultiViewUpdateListener;
+import com.google.android.material.internal.ToolbarUtils;
+import com.google.android.material.internal.ViewUtils;
+import com.google.android.material.search.SearchBar.OnLoadAnimationCallback;
+import com.google.android.material.shape.MaterialShapeDrawable;
+import java.util.ArrayList;
+import java.util.LinkedHashSet;
+import java.util.List;
+import java.util.Set;
+
+/** Helper class for {@link SearchBar} animations. */
+class SearchBarAnimationHelper {
+
+  // On load animation constants
+  private static final long ON_LOAD_ANIM_CENTER_VIEW_DEFAULT_FADE_DURATION_MS = 250;
+  private static final long ON_LOAD_ANIM_CENTER_VIEW_DEFAULT_FADE_IN_START_DELAY_MS = 500;
+  private static final long ON_LOAD_ANIM_CENTER_VIEW_DEFAULT_FADE_OUT_START_DELAY_MS = 750;
+  private static final long ON_LOAD_ANIM_SECONDARY_DURATION_MS = 250;
+  private static final long ON_LOAD_ANIM_SECONDARY_START_DELAY_MS = 250;
+
+  // Expand and collapse animation constants
+  private static final long EXPAND_DURATION_MS = 300;
+  private static final long EXPAND_FADE_OUT_CHILDREN_DURATION_MS = 75;
+  private static final long COLLAPSE_DURATION_MS = 250;
+  private static final long COLLAPSE_FADE_IN_CHILDREN_DURATION_MS = 100;
+
+  private final Set<OnLoadAnimationCallback> onLoadAnimationCallbacks = new LinkedHashSet<>();
+  private final Set<AnimatorListenerAdapter> expandAnimationListeners = new LinkedHashSet<>();
+  private final Set<AnimatorListenerAdapter> collapseAnimationListeners = new LinkedHashSet<>();
+
+  @Nullable private Animator secondaryViewAnimator;
+  @Nullable private Animator defaultCenterViewAnimator;
+  private boolean expanding;
+  private boolean collapsing;
+  private boolean onLoadAnimationFadeInEnabled = true;
+  private Animator runningExpandOrCollapseAnimator = null;
+
+  void startOnLoadAnimation(SearchBar searchBar) {
+    dispatchOnLoadAnimation(OnLoadAnimationCallback::onAnimationStart);
+    TextView textView = searchBar.getTextView();
+    View centerView = searchBar.getCenterView();
+
+    View secondaryActionMenuItemView = ToolbarUtils.getSecondaryActionMenuItemView(searchBar);
+    Animator secondaryViewAnimator =
+        getSecondaryViewAnimator(textView, secondaryActionMenuItemView);
+    secondaryViewAnimator.addListener(
+        new AnimatorListenerAdapter() {
+          @Override
+          public void onAnimationEnd(Animator animation) {
+            dispatchOnLoadAnimation(OnLoadAnimationCallback::onAnimationEnd);
+          }
+        });
+    this.secondaryViewAnimator = secondaryViewAnimator;
+
+    textView.setAlpha(0f);
+    if (secondaryActionMenuItemView != null) {
+      secondaryActionMenuItemView.setAlpha(0f);
+    }
+    if (centerView instanceof AnimatableView) {
+      ((AnimatableView) centerView).startAnimation(secondaryViewAnimator::start);
+    } else if (centerView != null) {
+      centerView.setAlpha(0f);
+      centerView.setVisibility(View.VISIBLE);
+      Animator defaultCenterViewAnimator = getDefaultCenterViewAnimator(centerView);
+      this.defaultCenterViewAnimator = defaultCenterViewAnimator;
+      defaultCenterViewAnimator.addListener(
+          new AnimatorListenerAdapter() {
+            @Override
+            public void onAnimationEnd(Animator animation) {
+              centerView.setVisibility(View.GONE);
+              secondaryViewAnimator.start();
+            }
+          });
+      defaultCenterViewAnimator.start();
+    } else {
+      secondaryViewAnimator.start();
+    }
+  }
+
+  void stopOnLoadAnimation(SearchBar searchBar) {
+    if (secondaryViewAnimator != null) {
+      secondaryViewAnimator.end();
+    }
+    if (defaultCenterViewAnimator != null) {
+      defaultCenterViewAnimator.end();
+    }
+    View centerView = searchBar.getCenterView();
+    if (centerView instanceof AnimatableView) {
+      ((AnimatableView) centerView).stopAnimation();
+    }
+    if (centerView != null) {
+      centerView.setAlpha(0);
+    }
+  }
+
+  boolean isOnLoadAnimationFadeInEnabled() {
+    return onLoadAnimationFadeInEnabled;
+  }
+
+  void setOnLoadAnimationFadeInEnabled(boolean onLoadAnimationFadeInEnabled) {
+    this.onLoadAnimationFadeInEnabled = onLoadAnimationFadeInEnabled;
+  }
+
+  void registerOnLoadAnimationCallback(OnLoadAnimationCallback onLoadAnimationCallback) {
+    onLoadAnimationCallbacks.add(onLoadAnimationCallback);
+  }
+
+  boolean unregisterOnLoadAnimationCallback(OnLoadAnimationCallback onLoadAnimationCallback) {
+    return onLoadAnimationCallbacks.remove(onLoadAnimationCallback);
+  }
+
+  void clearOnLoadAnimationCallbacks() {
+    onLoadAnimationCallbacks.clear();
+  }
+
+  private void dispatchOnLoadAnimation(OnLoadAnimationInvocation invocation) {
+    for (OnLoadAnimationCallback onLoadAnimationCallback : onLoadAnimationCallbacks) {
+      invocation.invoke(onLoadAnimationCallback);
+    }
+  }
+
+  private interface OnLoadAnimationInvocation {
+    void invoke(OnLoadAnimationCallback onLoadAnimationCallback);
+  }
+
+  private Animator getDefaultCenterViewAnimator(@Nullable View centerView) {
+    ValueAnimator fadeInAnimator = ValueAnimator.ofFloat(0, 1);
+    fadeInAnimator.addUpdateListener(MultiViewUpdateListener.alphaListener(centerView));
+    fadeInAnimator.setInterpolator(AnimationUtils.LINEAR_INTERPOLATOR);
+    fadeInAnimator.setDuration(
+        onLoadAnimationFadeInEnabled ? ON_LOAD_ANIM_CENTER_VIEW_DEFAULT_FADE_DURATION_MS : 0);
+    fadeInAnimator.setStartDelay(
+        onLoadAnimationFadeInEnabled ? ON_LOAD_ANIM_CENTER_VIEW_DEFAULT_FADE_IN_START_DELAY_MS : 0);
+
+    ValueAnimator fadeOutAnimator = ValueAnimator.ofFloat(1, 0);
+    fadeOutAnimator.addUpdateListener(MultiViewUpdateListener.alphaListener(centerView));
+    fadeOutAnimator.setInterpolator(AnimationUtils.LINEAR_INTERPOLATOR);
+    fadeOutAnimator.setDuration(ON_LOAD_ANIM_CENTER_VIEW_DEFAULT_FADE_DURATION_MS);
+    fadeOutAnimator.setStartDelay(ON_LOAD_ANIM_CENTER_VIEW_DEFAULT_FADE_OUT_START_DELAY_MS);
+
+    AnimatorSet animatorSet = new AnimatorSet();
+    animatorSet.playSequentially(fadeInAnimator, fadeOutAnimator);
+    return animatorSet;
+  }
+
+  private Animator getSecondaryViewAnimator(
+      TextView textView, @Nullable View secondaryActionMenuItemView) {
+    AnimatorSet animatorSet = new AnimatorSet();
+    animatorSet.setStartDelay(ON_LOAD_ANIM_SECONDARY_START_DELAY_MS);
+    animatorSet.play(getTextViewAnimator(textView));
+    if (secondaryActionMenuItemView != null) {
+      animatorSet.play(getSecondaryActionMenuItemAnimator(secondaryActionMenuItemView));
+    }
+    return animatorSet;
+  }
+
+  private Animator getTextViewAnimator(TextView textView) {
+    ValueAnimator animator = ValueAnimator.ofFloat(0, 1);
+    animator.addUpdateListener(MultiViewUpdateListener.alphaListener(textView));
+    animator.setInterpolator(AnimationUtils.LINEAR_INTERPOLATOR);
+    animator.setDuration(ON_LOAD_ANIM_SECONDARY_DURATION_MS);
+    return animator;
+  }
+
+  private Animator getSecondaryActionMenuItemAnimator(@Nullable View secondaryActionMenuItemView) {
+    ValueAnimator animator = ValueAnimator.ofFloat(0, 1);
+    animator.addUpdateListener(MultiViewUpdateListener.alphaListener(secondaryActionMenuItemView));
+    animator.setInterpolator(AnimationUtils.LINEAR_INTERPOLATOR);
+    animator.setDuration(ON_LOAD_ANIM_SECONDARY_DURATION_MS);
+    return animator;
+  }
+
+  void startExpandAnimation(
+      SearchBar searchBar,
+      View expandedView,
+      @Nullable AppBarLayout appBarLayout,
+      boolean skipAnimation) {
+    // If we are in the middle of an collapse animation we should cancel it before we start the
+    // expand.
+    if (isCollapsing() && runningExpandOrCollapseAnimator != null) {
+      runningExpandOrCollapseAnimator.cancel();
+    }
+    expanding = true;
+    expandedView.setVisibility(View.INVISIBLE);
+    expandedView.post(
+        () -> {
+          AnimatorSet fadeAndExpandAnimatorSet = new AnimatorSet();
+          Animator fadeOutChildrenAnimator = getFadeOutChildrenAnimator(searchBar, expandedView);
+          Animator expandAnimator = getExpandAnimator(searchBar, expandedView, appBarLayout);
+
+          fadeAndExpandAnimatorSet.playSequentially(fadeOutChildrenAnimator, expandAnimator);
+          fadeAndExpandAnimatorSet.addListener(
+              new AnimatorListenerAdapter() {
+                @Override
+                public void onAnimationEnd(Animator animation) {
+                  runningExpandOrCollapseAnimator = null;
+                }
+              });
+          for (AnimatorListenerAdapter listener : expandAnimationListeners) {
+            fadeAndExpandAnimatorSet.addListener(listener);
+          }
+          if (skipAnimation) {
+            fadeAndExpandAnimatorSet.setDuration(0);
+          }
+          fadeAndExpandAnimatorSet.start();
+
+          runningExpandOrCollapseAnimator = fadeAndExpandAnimatorSet;
+        });
+  }
+
+  private Animator getExpandAnimator(
+      SearchBar searchBar, View expandedView, @Nullable AppBarLayout appBarLayout) {
+    return getExpandCollapseAnimationHelper(searchBar, expandedView, appBarLayout)
+        .setDuration(EXPAND_DURATION_MS)
+        .addListener(
+            new AnimatorListenerAdapter() {
+              @Override
+              public void onAnimationStart(Animator animation) {
+                searchBar.setVisibility(View.INVISIBLE);
+              }
+
+              @Override
+              public void onAnimationEnd(Animator animation) {
+                expanding = false;
+              }
+            })
+        .getExpandAnimator();
+  }
+
+  boolean isExpanding() {
+    return expanding;
+  }
+
+  void addExpandAnimationListener(@NonNull AnimatorListenerAdapter listener) {
+    expandAnimationListeners.add(listener);
+  }
+
+  boolean removeExpandAnimationListener(@NonNull AnimatorListenerAdapter listener) {
+    return expandAnimationListeners.remove(listener);
+  }
+
+  void clearExpandAnimationListeners() {
+    expandAnimationListeners.clear();
+  }
+
+  void startCollapseAnimation(
+      SearchBar searchBar,
+      View expandedView,
+      @Nullable AppBarLayout appBarLayout,
+      boolean skipAnimation) {
+    // If we are in the middle of an expand animation we should cancel it before we start the
+    // collapse.
+    if (isExpanding() && runningExpandOrCollapseAnimator != null) {
+      runningExpandOrCollapseAnimator.cancel();
+    }
+
+    collapsing = true;
+    AnimatorSet collapseAndFadeAnimatorSet = new AnimatorSet();
+    Animator collapseAnimator = getCollapseAnimator(searchBar, expandedView, appBarLayout);
+    Animator fadeInChildrenAnimator = getFadeInChildrenAnimator(searchBar);
+
+    collapseAndFadeAnimatorSet.playSequentially(collapseAnimator, fadeInChildrenAnimator);
+    collapseAndFadeAnimatorSet.addListener(
+        new AnimatorListenerAdapter() {
+          @Override
+          public void onAnimationEnd(Animator animation) {
+            runningExpandOrCollapseAnimator = null;
+          }
+        });
+    for (AnimatorListenerAdapter listener : collapseAnimationListeners) {
+      collapseAndFadeAnimatorSet.addListener(listener);
+    }
+    if (skipAnimation) {
+      collapseAndFadeAnimatorSet.setDuration(0);
+    }
+    collapseAndFadeAnimatorSet.start();
+
+    runningExpandOrCollapseAnimator = collapseAndFadeAnimatorSet;
+  }
+
+  private Animator getCollapseAnimator(
+      SearchBar searchBar, View expandedView, AppBarLayout appBarLayout) {
+    return getExpandCollapseAnimationHelper(searchBar, expandedView, appBarLayout)
+        .setDuration(COLLAPSE_DURATION_MS)
+        .addListener(
+            new AnimatorListenerAdapter() {
+              @Override
+              public void onAnimationStart(Animator animation) {
+                searchBar.stopOnLoadAnimation();
+              }
+
+              @Override
+              public void onAnimationEnd(Animator animation) {
+                searchBar.setVisibility(View.VISIBLE);
+                collapsing = false;
+              }
+            })
+        .getCollapseAnimator();
+  }
+
+  boolean isCollapsing() {
+    return collapsing;
+  }
+
+  void addCollapseAnimationListener(@NonNull AnimatorListenerAdapter listener) {
+    collapseAnimationListeners.add(listener);
+  }
+
+  boolean removeCollapseAnimationListener(@NonNull AnimatorListenerAdapter listener) {
+    return collapseAnimationListeners.remove(listener);
+  }
+
+  void clearCollapseAnimationListeners() {
+    collapseAnimationListeners.clear();
+  }
+
+  private ExpandCollapseAnimationHelper getExpandCollapseAnimationHelper(
+      SearchBar searchBar, View expandedView, @Nullable AppBarLayout appBarLayout) {
+    return new ExpandCollapseAnimationHelper(searchBar, expandedView)
+        .setAdditionalUpdateListener(
+            getExpandedViewBackgroundUpdateListener(searchBar, expandedView))
+        .setCollapsedViewOffsetY(appBarLayout != null ? appBarLayout.getTop() : 0)
+        .addEndAnchoredViews(getEndAnchoredViews(expandedView));
+  }
+
+  private AnimatorUpdateListener getExpandedViewBackgroundUpdateListener(
+      SearchBar searchBar, View expandedView) {
+    MaterialShapeDrawable expandedViewBackground =
+        MaterialShapeDrawable.createWithElevationOverlay(expandedView.getContext());
+    expandedViewBackground.setCornerSize(searchBar.getCornerSize());
+    expandedViewBackground.setElevation(ViewCompat.getElevation(searchBar));
+
+    return valueAnimator -> {
+      expandedViewBackground.setInterpolation(1 - valueAnimator.getAnimatedFraction());
+      ViewCompat.setBackground(expandedView, expandedViewBackground);
+
+      // Ensures that the expanded view is visible, in the case where ActionMode is used.
+      expandedView.setAlpha(1);
+    };
+  }
+
+  private Animator getFadeOutChildrenAnimator(SearchBar searchBar, View expandedView) {
+    List<View> children = getFadeChildren(searchBar);
+    ValueAnimator animator = ValueAnimator.ofFloat(1, 0);
+    animator.addUpdateListener(MultiViewUpdateListener.alphaListener(children));
+    animator.addUpdateListener(
+        animation -> {
+          // Ensures that the expanded view is not visible while the children are fading out, in
+          // the case where ActionMode is used.
+          expandedView.setAlpha(0);
+        });
+    animator.setDuration(EXPAND_FADE_OUT_CHILDREN_DURATION_MS);
+    animator.setInterpolator(AnimationUtils.LINEAR_INTERPOLATOR);
+    return animator;
+  }
+
+  private Animator getFadeInChildrenAnimator(SearchBar searchBar) {
+    List<View> children = getFadeChildren(searchBar);
+    ValueAnimator animator = ValueAnimator.ofFloat(0, 1);
+    animator.addUpdateListener(MultiViewUpdateListener.alphaListener(children));
+    animator.setDuration(COLLAPSE_FADE_IN_CHILDREN_DURATION_MS);
+    animator.setInterpolator(AnimationUtils.LINEAR_INTERPOLATOR);
+    return animator;
+  }
+
+  private List<View> getFadeChildren(SearchBar searchBar) {
+    List<View> children = ViewUtils.getChildren(searchBar);
+    if (searchBar.getCenterView() != null) {
+      children.remove(searchBar.getCenterView());
+    }
+    return children;
+  }
+
+  private List<View> getEndAnchoredViews(View expandedView) {
+    boolean isRtl = ViewUtils.isLayoutRtl(expandedView);
+    List<View> endAnchoredViews = new ArrayList<>();
+    if (expandedView instanceof ViewGroup) {
+      ViewGroup viewGroup = (ViewGroup) expandedView;
+      for (int i = 0; i < viewGroup.getChildCount(); i++) {
+        View child = viewGroup.getChildAt(i);
+        if ((!isRtl && child instanceof ActionMenuView)
+            || (isRtl && !(child instanceof ActionMenuView))) {
+          endAnchoredViews.add(child);
+        }
+      }
+    }
+    return endAnchoredViews;
+  }
+}
diff --git a/lib/java/com/google/android/material/search/SearchView.java b/lib/java/com/google/android/material/search/SearchView.java
new file mode 100644
index 00000000000..a980ce6d61e
--- /dev/null
+++ b/lib/java/com/google/android/material/search/SearchView.java
@@ -0,0 +1,942 @@
+/*
+ * Copyright 2022 The Android Open Source Project
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     https://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+package com.google.android.material.search;
+
+import com.google.android.material.R;
+
+import static com.google.android.material.theme.overlay.MaterialThemeOverlay.wrap;
+
+import android.annotation.SuppressLint;
+import android.app.Activity;
+import android.content.Context;
+import android.content.res.TypedArray;
+import android.graphics.drawable.Drawable;
+import android.os.Build;
+import android.os.Build.VERSION;
+import android.os.Build.VERSION_CODES;
+import android.os.Parcel;
+import android.os.Parcelable;
+import androidx.appcompat.content.res.AppCompatResources;
+import androidx.appcompat.graphics.drawable.DrawerArrowDrawable;
+import androidx.appcompat.widget.Toolbar;
+import androidx.appcompat.widget.Toolbar.OnMenuItemClickListener;
+import android.text.Editable;
+import android.text.TextUtils;
+import android.text.TextWatcher;
+import android.util.AttributeSet;
+import android.view.LayoutInflater;
+import android.view.View;
+import android.view.ViewGroup;
+import android.view.Window;
+import android.view.WindowManager;
+import android.widget.EditText;
+import android.widget.FrameLayout;
+import android.widget.ImageButton;
+import android.widget.TextView;
+import androidx.annotation.MenuRes;
+import androidx.annotation.NonNull;
+import androidx.annotation.Nullable;
+import androidx.annotation.Px;
+import androidx.annotation.RequiresApi;
+import androidx.annotation.StringRes;
+import androidx.annotation.StyleRes;
+import androidx.coordinatorlayout.widget.CoordinatorLayout;
+import androidx.core.graphics.ColorUtils;
+import androidx.core.graphics.drawable.DrawableCompat;
+import androidx.core.view.ViewCompat;
+import androidx.core.view.WindowInsetsCompat;
+import androidx.core.widget.TextViewCompat;
+import androidx.customview.view.AbsSavedState;
+import com.google.android.material.appbar.MaterialToolbar;
+import com.google.android.material.color.MaterialColors;
+import com.google.android.material.elevation.ElevationOverlayProvider;
+import com.google.android.material.internal.ClippableRoundedCornerLayout;
+import com.google.android.material.internal.ContextUtils;
+import com.google.android.material.internal.FadeThroughDrawable;
+import com.google.android.material.internal.ThemeEnforcement;
+import com.google.android.material.internal.ToolbarUtils;
+import com.google.android.material.internal.TouchObserverFrameLayout;
+import com.google.android.material.internal.ViewUtils;
+import com.google.android.material.shape.MaterialShapeUtils;
+import java.util.HashMap;
+import java.util.LinkedHashSet;
+import java.util.Map;
+import java.util.Set;
+
+/** Layout that provides a full screen search view and can be used with {@link SearchBar}. */
+@SuppressWarnings("RestrictTo")
+public class SearchView extends FrameLayout implements CoordinatorLayout.AttachedBehavior {
+
+  private static final int DEF_STYLE_RES = R.style.Widget_Material3_SearchView;
+
+  final View scrim;
+  final ClippableRoundedCornerLayout rootView;
+  final View backgroundView;
+  final View statusBarSpacer;
+  final FrameLayout headerContainer;
+  final FrameLayout toolbarContainer;
+  final MaterialToolbar toolbar;
+  final Toolbar dummyToolbar;
+  final TextView searchPrefix;
+  final EditText editText;
+  final ImageButton clearButton;
+  final View divider;
+  final TouchObserverFrameLayout contentContainer;
+
+  private final boolean layoutInflated;
+  private final SearchViewAnimationHelper searchViewAnimationHelper;
+  private final ElevationOverlayProvider elevationOverlayProvider;
+  private final Set<TransitionListener> transitionListeners = new LinkedHashSet<>();
+
+  @Nullable private SearchBar searchBar;
+  private int softInputMode = WindowManager.LayoutParams.SOFT_INPUT_ADJUST_RESIZE;
+  private boolean animatedNavigationIcon;
+  private boolean animatedMenuItems;
+  private boolean autoShowKeyboard;
+  private boolean useWindowInsetsController;
+  @NonNull private TransitionState currentTransitionState = TransitionState.HIDDEN;
+  private Map<View, Integer> childImportantForAccessibilityMap;
+
+  public SearchView(@NonNull Context context) {
+    this(context, null);
+  }
+
+  public SearchView(@NonNull Context context, @Nullable AttributeSet attrs) {
+    this(context, attrs, R.attr.searchViewStyle);
+  }
+
+  public SearchView(@NonNull Context context, @Nullable AttributeSet attrs, int defStyleAttr) {
+    super(wrap(context, attrs, defStyleAttr, DEF_STYLE_RES), attrs, defStyleAttr);
+    // Ensure we are using the correctly themed context rather than the context that was passed in.
+    context = getContext();
+
+    TypedArray a =
+        ThemeEnforcement.obtainStyledAttributes(
+            context, attrs, R.styleable.SearchView, defStyleAttr, DEF_STYLE_RES);
+
+    int headerLayoutResId = a.getResourceId(R.styleable.SearchView_headerLayout, -1);
+    int textAppearanceResId = a.getResourceId(R.styleable.SearchView_android_textAppearance, -1);
+    String text = a.getString(R.styleable.SearchView_android_text);
+    String hint = a.getString(R.styleable.SearchView_android_hint);
+    String searchPrefixText = a.getString(R.styleable.SearchView_searchPrefixText);
+    boolean useDrawerArrowDrawable =
+        a.getBoolean(R.styleable.SearchView_useDrawerArrowDrawable, false);
+    animatedNavigationIcon = a.getBoolean(R.styleable.SearchView_animateNavigationIcon, true);
+    animatedMenuItems = a.getBoolean(R.styleable.SearchView_animateMenuItems, true);
+    boolean hideNavigationIcon = a.getBoolean(R.styleable.SearchView_hideNavigationIcon, false);
+    autoShowKeyboard = a.getBoolean(R.styleable.SearchView_autoShowKeyboard, true);
+
+    a.recycle();
+
+    LayoutInflater.from(context).inflate(R.layout.mtrl_search_view, this);
+    layoutInflated = true;
+
+    scrim = findViewById(R.id.search_view_scrim);
+    rootView = findViewById(R.id.search_view_root);
+    backgroundView = findViewById(R.id.search_view_background);
+    statusBarSpacer = findViewById(R.id.search_view_status_bar_spacer);
+    headerContainer = findViewById(R.id.search_view_header_container);
+    toolbarContainer = findViewById(R.id.search_view_toolbar_container);
+    toolbar = findViewById(R.id.search_view_toolbar);
+    dummyToolbar = findViewById(R.id.search_view_dummy_toolbar);
+    searchPrefix = findViewById(R.id.search_view_search_prefix);
+    editText = findViewById(R.id.search_view_edit_text);
+    clearButton = findViewById(R.id.search_view_clear_button);
+    divider = findViewById(R.id.search_view_divider);
+    contentContainer = findViewById(R.id.search_view_content_container);
+
+    searchViewAnimationHelper = new SearchViewAnimationHelper(this);
+    elevationOverlayProvider = new ElevationOverlayProvider(context);
+
+    setUpRootView();
+    setUpBackgroundViewElevationOverlay();
+    setUpHeaderLayout(headerLayoutResId);
+    setSearchPrefixText(searchPrefixText);
+    setUpEditText(textAppearanceResId, text, hint);
+    setUpBackButton(useDrawerArrowDrawable, hideNavigationIcon);
+    setUpClearButton();
+    setUpDivider();
+    setUpContentOnTouchListener();
+    setUpInsetListeners();
+  }
+
+  @Override
+  public void addView(View child, int index, ViewGroup.LayoutParams params) {
+    if (layoutInflated) {
+      contentContainer.addView(child, index, params);
+    } else {
+      super.addView(child, index, params);
+    }
+  }
+
+  @Override
+  protected void onFinishInflate() {
+    super.onFinishInflate();
+
+    Activity activity = ContextUtils.getActivity(getContext());
+    if (activity != null) {
+      Window window = activity.getWindow();
+      setSoftInputMode(window);
+      setStatusBarSpacerEnabled(shouldShowStatusBarSpacer(window));
+    }
+  }
+
+  @RequiresApi(VERSION_CODES.LOLLIPOP)
+  @Override
+  public void setElevation(float elevation) {
+    super.setElevation(elevation);
+    setUpBackgroundViewElevationOverlay(elevation);
+  }
+
+  @Override
+  protected void onAttachedToWindow() {
+    super.onAttachedToWindow();
+
+    MaterialShapeUtils.setParentAbsoluteElevation(this);
+  }
+
+  @Override
+  @NonNull
+  public CoordinatorLayout.Behavior<SearchView> getBehavior() {
+    return new SearchView.Behavior();
+  }
+
+  @SuppressLint("ClickableViewAccessibility") // Will be handled by accessibility delegate.
+  private void setUpRootView() {
+    rootView.setOnTouchListener((v, event) -> true);
+  }
+
+  private void setUpBackgroundViewElevationOverlay() {
+    setUpBackgroundViewElevationOverlay(getOverlayElevation());
+  }
+
+  private void setUpBackgroundViewElevationOverlay(float elevation) {
+    if (elevationOverlayProvider == null || backgroundView == null) {
+      return;
+    }
+    int backgroundColor =
+        elevationOverlayProvider.compositeOverlayWithThemeSurfaceColorIfNeeded(elevation);
+    backgroundView.setBackgroundColor(backgroundColor);
+  }
+
+  private float getOverlayElevation() {
+    if (searchBar != null) {
+      return searchBar.getCompatElevation();
+    } else {
+      return getResources().getDimension(R.dimen.m3_searchview_elevation);
+    }
+  }
+
+  private void setUpHeaderLayout(int headerLayoutResId) {
+    if (headerLayoutResId != -1) {
+      View headerView =
+          LayoutInflater.from(getContext()).inflate(headerLayoutResId, headerContainer, false);
+      addHeaderView(headerView);
+    }
+  }
+
+  private void setUpEditText(@StyleRes int textAppearanceResId, String text, String hint) {
+    if (textAppearanceResId != -1) {
+      TextViewCompat.setTextAppearance(editText, textAppearanceResId);
+    }
+    editText.setText(text);
+    editText.setHint(hint);
+  }
+
+  private void setUpBackButton(boolean useDrawerArrowDrawable, boolean hideNavigationIcon) {
+    if (hideNavigationIcon) {
+      toolbar.setNavigationIcon(null);
+      return;
+    }
+
+    toolbar.setNavigationOnClickListener(v -> hide());
+
+    if (useDrawerArrowDrawable) {
+      DrawerArrowDrawable drawerArrowDrawable = new DrawerArrowDrawable(getContext());
+      drawerArrowDrawable.setColor(MaterialColors.getColor(this, R.attr.colorOnSurface));
+      toolbar.setNavigationIcon(drawerArrowDrawable);
+    }
+  }
+
+  private void setUpClearButton() {
+    clearButton.setOnClickListener(
+        v -> {
+          clearText();
+          requestFocusAndShowKeyboardIfNeeded();
+        });
+
+    editText.addTextChangedListener(
+        new TextWatcher() {
+          @Override
+          public void beforeTextChanged(CharSequence s, int start, int count, int after) {}
+
+          @Override
+          public void onTextChanged(CharSequence s, int start, int before, int count) {
+            clearButton.setVisibility(s.length() > 0 ? VISIBLE : GONE);
+          }
+
+          @Override
+          public void afterTextChanged(Editable s) {}
+        });
+  }
+
+  private void setUpDivider() {
+    int colorOnSurface = MaterialColors.getColor(this, R.attr.colorOnSurface);
+    int dividerColor = ColorUtils.setAlphaComponent(colorOnSurface, Math.round(0.12f * 255));
+    divider.setBackgroundColor(dividerColor);
+  }
+
+  @SuppressLint("ClickableViewAccessibility") // Will be handled by accessibility delegate.
+  private void setUpContentOnTouchListener() {
+    contentContainer.setOnTouchListener(
+        (v, event) -> {
+          if (isAdjustNothingSoftInputMode()) {
+            clearFocusAndHideKeyboard();
+          }
+          return false;
+        });
+  }
+
+  private void setUpStatusBarSpacer(@Px int height) {
+    if (statusBarSpacer.getLayoutParams().height != height) {
+      statusBarSpacer.getLayoutParams().height = height;
+      statusBarSpacer.requestLayout();
+    }
+  }
+
+  @Px
+  private int getStatusBarHeight() {
+    @SuppressLint({
+      "DiscouragedApi",
+      "InternalInsetResource"
+    }) // Used for initial value. A WindowInsetsListener will apply correct insets later.
+    int resourceId = getResources().getIdentifier("status_bar_height", "dimen", "android");
+    if (resourceId > 0) {
+      return getResources().getDimensionPixelSize(resourceId);
+    } else {
+      return 0;
+    }
+  }
+
+  /**
+   * Note: DrawerArrowDrawable supports RTL, so there is no need to update the navigation icon for
+   * RTL if it is a DrawerArrowDrawable.
+   */
+  private void updateNavigationIconIfNeeded() {
+    if (toolbar == null) {
+      return;
+    }
+
+    if (isNavigationIconDrawerArrowDrawable(toolbar)) {
+      return;
+    }
+
+    int navigationIcon = R.drawable.ic_arrow_back_black_24;
+    if (searchBar == null) {
+      toolbar.setNavigationIcon(navigationIcon);
+    } else {
+      Drawable navigationIconDrawable =
+          DrawableCompat.wrap(
+              AppCompatResources.getDrawable(getContext(), navigationIcon).mutate());
+      if (toolbar.getNavigationIconTint() != null) {
+        DrawableCompat.setTint(navigationIconDrawable, toolbar.getNavigationIconTint());
+      }
+      toolbar.setNavigationIcon(
+          new FadeThroughDrawable(searchBar.getNavigationIcon(), navigationIconDrawable));
+      updateNavigationIconProgressIfNeeded();
+    }
+  }
+
+  private boolean isNavigationIconDrawerArrowDrawable(@NonNull Toolbar toolbar) {
+    return DrawableCompat.unwrap(toolbar.getNavigationIcon()) instanceof DrawerArrowDrawable;
+  }
+
+  /**
+   * Listens to {@link WindowInsetsCompat} and adjusts layouts accordingly.
+   *
+   * <p><b>NOTE</b>: window insets are only delivered if no other layout consumed them before. E.g.:
+   *
+   * <ul>
+   *   <li>by declaring {@code fitsSystemWindows=true}
+   *   <li>by consuming insets via specific consume-methods (e.g. {@link
+   *       WindowInsetsCompat#consumeSystemWindowInsets()}
+   * </ul>
+   */
+  private void setUpInsetListeners() {
+    setUpToolbarInsetListener();
+    setUpDividerInsetListener();
+    setUpStatusBarSpacerInsetListener();
+  }
+
+  private void setUpToolbarInsetListener() {
+    ViewUtils.doOnApplyWindowInsets(
+        toolbar,
+        (view, insets, initialPadding) -> {
+          boolean isRtl = ViewUtils.isLayoutRtl(toolbar);
+          int paddingLeft = isRtl ? initialPadding.end : initialPadding.start;
+          int paddingRight = isRtl ? initialPadding.start : initialPadding.end;
+          toolbar.setPadding(
+              paddingLeft + insets.getSystemWindowInsetLeft(), initialPadding.top,
+              paddingRight + insets.getSystemWindowInsetRight(), initialPadding.bottom);
+          return insets;
+        });
+  }
+
+  private void setUpStatusBarSpacerInsetListener() {
+    // Set an initial height based on the default system value to support pre-L behavior.
+    setUpStatusBarSpacer(getStatusBarHeight());
+
+    // Listen to system window insets on L+ and adjusts status bar height based on the top inset.
+    ViewCompat.setOnApplyWindowInsetsListener(
+        statusBarSpacer,
+        (v, insets) -> {
+          setUpStatusBarSpacer(insets.getSystemWindowInsetTop());
+          return insets;
+        });
+  }
+
+  private void setUpDividerInsetListener() {
+    MarginLayoutParams layoutParams = (MarginLayoutParams) divider.getLayoutParams();
+    int leftMargin = layoutParams.leftMargin;
+    int rightMargin = layoutParams.rightMargin;
+    ViewCompat.setOnApplyWindowInsetsListener(
+        divider,
+        (v, insets) -> {
+          layoutParams.leftMargin = leftMargin + insets.getSystemWindowInsetLeft();
+          layoutParams.rightMargin = rightMargin + insets.getSystemWindowInsetRight();
+          return insets;
+        });
+  }
+
+  /** Returns whether or not this {@link SearchView} is set up with an {@link SearchBar}. */
+  public boolean isSetUpWithSearchBar() {
+    return this.searchBar != null;
+  }
+
+  /**
+   * Sets up this {@link SearchView} with an {@link SearchBar}, which will result in the {@link
+   * SearchView} being shown when the {@link SearchBar} is clicked. This behavior will be set up
+   * automatically if the {@link SearchBar} and {@link SearchView} are in a {@link
+   * CoordinatorLayout} and the {@link SearchView} is anchored to the {@link SearchBar}.
+   */
+  public void setUpWithSearchBar(@Nullable SearchBar searchBar) {
+    this.searchBar = searchBar;
+    searchViewAnimationHelper.setSearchBar(searchBar);
+    if (searchBar != null) {
+      searchBar.setOnClickListener(v -> show());
+    }
+    updateNavigationIconIfNeeded();
+    setUpBackgroundViewElevationOverlay();
+  }
+
+  /**
+   * Add a header view to this {@link SearchView}, which will be placed above the search text area.
+   *
+   * <p>Note: due to complications with the expand/collapse animation, a header view is intended to
+   * be used with a standalone {@link SearchView} which slides up/down instead of morphing from an
+   * {@link SearchBar}.
+   */
+  public void addHeaderView(@NonNull View headerView) {
+    headerContainer.addView(headerView);
+    headerContainer.setVisibility(VISIBLE);
+  }
+
+  /** Remove a header view from the section above the search text area. */
+  public void removeHeaderView(@NonNull View headerView) {
+    headerContainer.removeView(headerView);
+    if (headerContainer.getChildCount() == 0) {
+      headerContainer.setVisibility(GONE);
+    }
+  }
+
+  /** Remove all header views from the section above the search text area. */
+  public void removeAllHeaderViews() {
+    headerContainer.removeAllViews();
+    headerContainer.setVisibility(GONE);
+  }
+
+  /**
+   * Sets whether the navigation icon should be animated from the {@link SearchBar} to {@link
+   * SearchView}.
+   */
+  public void setAnimatedNavigationIcon(boolean animatedNavigationIcon) {
+    this.animatedNavigationIcon = animatedNavigationIcon;
+  }
+
+  /**
+   * Returns whether the navigation icon should be animated from the {@link SearchBar} to {@link
+   * SearchView}.
+   */
+  public boolean isAnimatedNavigationIcon() {
+    return animatedNavigationIcon;
+  }
+
+  /**
+   * Sets whether the menu items should be animated from the {@link SearchBar} to {@link
+   * SearchView}.
+   */
+  public void setAnimatedMenuItems(boolean animatedMenuItems) {
+    this.animatedMenuItems = animatedMenuItems;
+  }
+
+  /**
+   * Returns whether the menu items should be animated from the {@link SearchBar} to {@link
+   * SearchView}.
+   */
+  public boolean isAnimatedMenuItems() {
+    return animatedMenuItems;
+  }
+
+  /** Sets whether the soft keyboard should be shown when the {@link SearchView} is shown. */
+  public void setAutoShowKeyboard(boolean autoShowKeyboard) {
+    this.autoShowKeyboard = autoShowKeyboard;
+  }
+
+  /** Returns whether the soft keyboard should be shown when the {@link SearchView} is shown. */
+  public boolean isAutoShowKeyboard() {
+    return autoShowKeyboard;
+  }
+
+  /** Sets whether the soft keyboard should be shown with {@code WindowInsetsController}. */
+  public void setUseWindowInsetsController(boolean useWindowInsetsController) {
+    this.useWindowInsetsController = useWindowInsetsController;
+  }
+
+  /** Returns whether the soft keyboard should be shown with {@code WindowInsetsController}. */
+  public boolean isUseWindowInsetsController() {
+    return useWindowInsetsController;
+  }
+
+  /** Adds a listener to handle {@link SearchView} transitions such as showing and closing. */
+  public void addTransitionListener(@NonNull TransitionListener transitionListener) {
+    transitionListeners.add(transitionListener);
+  }
+
+  /** Removes a listener to handle {@link SearchView} transitions such as showing and closing. */
+  public void removeTransitionListener(@NonNull TransitionListener transitionListener) {
+    transitionListeners.remove(transitionListener);
+  }
+
+  /** Inflate a menu to provide additional options. */
+  public void inflateMenu(@MenuRes int menuResId) {
+    toolbar.inflateMenu(menuResId);
+  }
+
+  /** Set a listener to handle menu item clicks. */
+  public void setOnMenuItemClickListener(
+      @Nullable OnMenuItemClickListener onMenuItemClickListener) {
+    toolbar.setOnMenuItemClickListener(onMenuItemClickListener);
+  }
+
+  /** Returns the search prefix {@link TextView}, which appears before the main {@link EditText}. */
+  @NonNull
+  public TextView getSearchPrefix() {
+    return searchPrefix;
+  }
+
+  /** Sets the search prefix text. */
+  public void setSearchPrefixText(@Nullable CharSequence searchPrefixText) {
+    searchPrefix.setText(searchPrefixText);
+    searchPrefix.setVisibility(TextUtils.isEmpty(searchPrefixText) ? GONE : VISIBLE);
+  }
+
+  /** Returns the search prefix text. */
+  @Nullable
+  public CharSequence getSearchPrefixText() {
+    return searchPrefix.getText();
+  }
+
+  /** Returns the {@link Toolbar} used by the {@link SearchView}. */
+  @NonNull
+  public Toolbar getToolbar() {
+    return toolbar;
+  }
+
+  /** Returns the main {@link EditText} which can be used for hint and search text. */
+  @NonNull
+  public EditText getEditText() {
+    return editText;
+  }
+
+  /** Returns the text of main {@link EditText}, which usually represents the search text. */
+  @SuppressLint("KotlinPropertyAccess") // Editable extends CharSequence.
+  @Nullable
+  public Editable getText() {
+    return editText.getText();
+  }
+
+  /** Sets the text of main {@link EditText}. */
+  @SuppressLint("KotlinPropertyAccess") // Editable extends CharSequence.
+  public void setText(@Nullable CharSequence text) {
+    editText.setText(text);
+  }
+
+  /** Sets the text of main {@link EditText}. */
+  public void setText(@StringRes int textResId) {
+    editText.setText(textResId);
+  }
+
+  /** Clears the text of main {@link EditText}. */
+  public void clearText() {
+    editText.setText("");
+  }
+
+  /** Returns the hint of main {@link EditText}. */
+  @Nullable
+  public CharSequence getHint() {
+    return editText.getHint();
+  }
+
+  /** Sets the hint of main {@link EditText}. */
+  public void setHint(@Nullable CharSequence hint) {
+    editText.setHint(hint);
+  }
+
+  /** Sets the hint of main {@link EditText}. */
+  public void setHint(@StringRes int hintResId) {
+    editText.setHint(hintResId);
+  }
+
+  /** Returns the current value of this {@link SearchView}'s soft input mode. */
+  @SuppressLint("KotlinPropertyAccess") // This is a not property.
+  public int getSoftInputMode() {
+    return softInputMode;
+  }
+
+  /**
+   * Sets the soft input mode for this {@link SearchView}. This is important because the {@link
+   * SearchView} will use this to determine whether the keyboard should be shown/hidden at the same
+   * time as the expand/collapse animation, or if the keyboard should be staggered with the
+   * animation to avoid glitchiness due to a resize of the screen. This will be set automatically by
+   * the {@link SearchView} during initial render but make sure to invoke this if you are changing
+   * the soft input mode at runtime.
+   */
+  public void setSoftInputMode(@Nullable Window window) {
+    if (window != null) {
+      this.softInputMode = window.getAttributes().softInputMode;
+    }
+  }
+
+  /**
+   * Enables/disables the status bar spacer, which can be used in cases where the status bar is
+   * translucent and the {@link SearchView} should not overlap the status bar area. This will be set
+   * automatically by the {@link SearchView} during initial render based on {@link
+   * #shouldShowStatusBarSpacer(Window)}, but make sure to invoke this if you would like to override
+   * the default behavior.
+   */
+  public void setStatusBarSpacerEnabled(boolean enabled) {
+    statusBarSpacer.setVisibility(enabled ? VISIBLE : GONE);
+  }
+
+  /** Returns the current {@link TransitionState} for this {@link SearchView}. */
+  @NonNull
+  public TransitionState getCurrentTransitionState() {
+    return currentTransitionState;
+  }
+
+  void setTransitionState(@NonNull TransitionState state) {
+    if (currentTransitionState.equals(state)) {
+      return;
+    }
+
+    TransitionState previousState = currentTransitionState;
+    currentTransitionState = state;
+    Set<TransitionListener> listeners = new LinkedHashSet<>(transitionListeners);
+    for (TransitionListener listener : listeners) {
+      listener.onStateChanged(this, previousState, state);
+    }
+  }
+
+  /** Returns whether the {@link SearchView}'s main content view is shown or showing. */
+  public boolean isShowing() {
+    return currentTransitionState.equals(TransitionState.SHOWN)
+        || currentTransitionState.equals(TransitionState.SHOWING);
+  }
+
+  /**
+   * Shows the {@link SearchView} with an animation.
+   *
+   * <p>Note: the show animation will not be started if the {@link SearchView} is currently shown or
+   * showing.
+   */
+  public void show() {
+    if (currentTransitionState.equals(TransitionState.SHOWN)
+        || currentTransitionState.equals(TransitionState.SHOWING)) {
+      return;
+    }
+    searchViewAnimationHelper.show();
+    setModalForAccessibility(true);
+  }
+
+  /**
+   * Hides the {@link SearchView} with an animation.
+   *
+   * <p>Note: the hide animation will not be started if the {@link SearchView} is currently hidden
+   * or hiding.
+   */
+  public void hide() {
+    if (currentTransitionState.equals(TransitionState.HIDDEN)
+        || currentTransitionState.equals(TransitionState.HIDING)) {
+      return;
+    }
+    searchViewAnimationHelper.hide();
+    setModalForAccessibility(false);
+  }
+
+  /** Updates the visibility of the {@link SearchView} without an animation. */
+  public void setVisible(boolean visible) {
+    boolean wasVisible = rootView.getVisibility() == VISIBLE;
+    rootView.setVisibility(visible ? VISIBLE : GONE);
+    updateNavigationIconProgressIfNeeded();
+    if (wasVisible != visible) {
+      setModalForAccessibility(visible);
+    }
+    setTransitionState(visible ? TransitionState.SHOWN : TransitionState.HIDDEN);
+  }
+
+  private void updateNavigationIconProgressIfNeeded() {
+    ImageButton backButton = ToolbarUtils.getNavigationIconButton(toolbar);
+    if (backButton == null) {
+      return;
+    }
+
+    int progress = rootView.getVisibility() == VISIBLE ? 1 : 0;
+    Drawable drawable = DrawableCompat.unwrap(backButton.getDrawable());
+    if (drawable instanceof DrawerArrowDrawable) {
+      ((DrawerArrowDrawable) drawable).setProgress(progress);
+    }
+    if (drawable instanceof FadeThroughDrawable) {
+      ((FadeThroughDrawable) drawable).setProgress(progress);
+    }
+  }
+
+  /**
+   * Requests focus on the main {@link EditText} and shows the soft keyboard if automatic showing of
+   * the keyboard is enabled.
+   */
+  void requestFocusAndShowKeyboardIfNeeded() {
+    if (autoShowKeyboard) {
+      requestFocusAndShowKeyboard();
+    }
+  }
+
+  /** Requests focus on the main {@link EditText} and shows the soft keyboard. */
+  public void requestFocusAndShowKeyboard() {
+    editText.post(
+        () -> {
+          editText.requestFocus();
+          ViewUtils.showKeyboard(editText, useWindowInsetsController);
+        });
+  }
+
+  /** Clears focus on the main {@link EditText} and hides the soft keyboard. */
+  public void clearFocusAndHideKeyboard() {
+    editText.clearFocus();
+    ViewUtils.hideKeyboard(editText, useWindowInsetsController);
+  }
+
+  private static boolean shouldShowStatusBarSpacer(@Nullable Window window) {
+    if (window == null) {
+      return false;
+    }
+    WindowManager.LayoutParams lp = window.getAttributes();
+    boolean translucentStatus =
+        VERSION.SDK_INT >= VERSION_CODES.KITKAT
+            && (lp.flags & WindowManager.LayoutParams.FLAG_TRANSLUCENT_STATUS)
+                == WindowManager.LayoutParams.FLAG_TRANSLUCENT_STATUS;
+    boolean layoutNoLimits =
+        (lp.flags & WindowManager.LayoutParams.FLAG_LAYOUT_NO_LIMITS)
+            == WindowManager.LayoutParams.FLAG_LAYOUT_NO_LIMITS;
+    boolean edgeToEdge =
+        VERSION.SDK_INT >= VERSION_CODES.JELLY_BEAN
+            && (window.getDecorView().getSystemUiVisibility() & ViewUtils.EDGE_TO_EDGE_FLAGS)
+                == ViewUtils.EDGE_TO_EDGE_FLAGS;
+    return translucentStatus || layoutNoLimits || edgeToEdge;
+  }
+
+  boolean isAdjustNothingSoftInputMode() {
+    return softInputMode == WindowManager.LayoutParams.SOFT_INPUT_ADJUST_NOTHING;
+  }
+
+  /**
+   * Sets whether the {@link SearchView} is modal for accessibility, i.e., whether views that are
+   * not nested within the {@link SearchView} are important for accessibility.
+   */
+  public void setModalForAccessibility(boolean isSearchViewModal) {
+    ViewGroup rootView = (ViewGroup) this.getRootView();
+
+    if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.JELLY_BEAN && isSearchViewModal) {
+      childImportantForAccessibilityMap = new HashMap<>(rootView.getChildCount());
+    }
+    updateChildImportantForAccessibility(rootView, isSearchViewModal);
+
+    if (!isSearchViewModal) {
+      // When SearchView is not modal, reset the important for accessibility map.
+      childImportantForAccessibilityMap = null;
+    }
+  }
+
+  /**
+   * Sets the 'touchscreenBlocksFocus' attribute of the nested toolbar. The attribute defaults to
+   * 'true' for API level 26+. We need to set it to 'false' if keyboard navigation is needed for the
+   * search results.
+   */
+  public void setToolbarTouchscreenBlocksFocus(boolean touchscreenBlocksFocus) {
+    if (Build.VERSION.SDK_INT >= VERSION_CODES.LOLLIPOP) {
+      toolbar.setTouchscreenBlocksFocus(touchscreenBlocksFocus);
+    }
+  }
+
+  @SuppressLint("InlinedApi") // View Compat will handle the differences.
+  private void updateChildImportantForAccessibility(ViewGroup parent, boolean isSearchViewModal) {
+    for (int i = 0; i < parent.getChildCount(); i++) {
+      final View child = parent.getChildAt(i);
+      if (child == this) {
+        continue;
+      }
+
+      if (child.findViewById(this.rootView.getId()) != null) {
+        // If this child node contains SearchView, look at this node's children instead.
+        updateChildImportantForAccessibility((ViewGroup) child, isSearchViewModal);
+        continue;
+      }
+
+      if (!isSearchViewModal) {
+        if (childImportantForAccessibilityMap != null
+            && childImportantForAccessibilityMap.containsKey(child)) {
+          // Restores the original important for accessibility value of the child view.
+          ViewCompat.setImportantForAccessibility(
+              child, childImportantForAccessibilityMap.get(child));
+        }
+      } else {
+        // Saves the important for accessibility value of the child view.
+        if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.JELLY_BEAN) {
+          childImportantForAccessibilityMap.put(child, child.getImportantForAccessibility());
+        }
+
+        ViewCompat.setImportantForAccessibility(
+            child, ViewCompat.IMPORTANT_FOR_ACCESSIBILITY_NO_HIDE_DESCENDANTS);
+      }
+    }
+  }
+
+  /** Behavior that sets up an {@link SearchView} with an {@link SearchBar}. */
+  public static class Behavior extends CoordinatorLayout.Behavior<SearchView> {
+
+    public Behavior() {}
+
+    public Behavior(@NonNull Context context, @Nullable AttributeSet attrs) {
+      super(context, attrs);
+    }
+
+    @Override
+    public boolean onDependentViewChanged(
+        @NonNull CoordinatorLayout parent, @NonNull SearchView child, @NonNull View dependency) {
+      if (!child.isSetUpWithSearchBar() && dependency instanceof SearchBar) {
+        child.setUpWithSearchBar((SearchBar) dependency);
+      }
+      return false;
+    }
+  }
+
+  /** Callback interface that provides important transition events for a {@link SearchView}. */
+  public interface TransitionListener {
+
+    /** Called when the given {@link SearchView SearchView's} transition state has changed. */
+    void onStateChanged(
+        @NonNull SearchView searchView,
+        @NonNull TransitionState previousState,
+        @NonNull TransitionState newState);
+  }
+
+  /** Enum that defines the possible transition states of an {@link SearchView}. */
+  public enum TransitionState {
+    HIDING,
+    HIDDEN,
+    SHOWING,
+    SHOWN,
+  }
+
+  @Override
+  @NonNull
+  protected Parcelable onSaveInstanceState() {
+    SavedState savedState = new SavedState(super.onSaveInstanceState());
+    CharSequence text = getText();
+    savedState.text = text == null ? null : text.toString();
+    savedState.visibility = rootView.getVisibility();
+    return savedState;
+  }
+
+  @Override
+  protected void onRestoreInstanceState(Parcelable state) {
+    if (!(state instanceof SavedState)) {
+      super.onRestoreInstanceState(state);
+      return;
+    }
+
+    SavedState savedState = (SavedState) state;
+    super.onRestoreInstanceState(savedState.getSuperState());
+    setText(savedState.text);
+    setVisible(savedState.visibility == VISIBLE);
+  }
+
+  static class SavedState extends AbsSavedState {
+
+    String text;
+    int visibility;
+
+    public SavedState(Parcel source) {
+      this(source, null);
+    }
+
+    public SavedState(Parcel source, @Nullable ClassLoader classLoader) {
+      super(source, classLoader);
+      text = source.readString();
+      visibility = source.readInt();
+    }
+
+    public SavedState(Parcelable superState) {
+      super(superState);
+    }
+
+    public static final Parcelable.Creator<SavedState> CREATOR =
+        new ClassLoaderCreator<SavedState>() {
+
+          @Override
+          public SavedState createFromParcel(Parcel source, ClassLoader loader) {
+            return new SavedState(source, loader);
+          }
+
+          @Override
+          public SavedState createFromParcel(Parcel source) {
+            return new SavedState(source);
+          }
+
+          @Override
+          public SavedState[] newArray(int size) {
+            return new SavedState[size];
+          }
+        };
+
+    @Override
+    public void writeToParcel(Parcel dest, int flags) {
+      super.writeToParcel(dest, flags);
+      dest.writeString(text);
+      dest.writeInt(visibility);
+    }
+  }
+}
diff --git a/lib/java/com/google/android/material/search/SearchViewAnimationHelper.java b/lib/java/com/google/android/material/search/SearchViewAnimationHelper.java
new file mode 100644
index 00000000000..f0a830fff30
--- /dev/null
+++ b/lib/java/com/google/android/material/search/SearchViewAnimationHelper.java
@@ -0,0 +1,596 @@
+/*
+ * Copyright 2022 The Android Open Source Project
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     https://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+package com.google.android.material.search;
+
+import android.animation.Animator;
+import android.animation.AnimatorListenerAdapter;
+import android.animation.AnimatorSet;
+import android.animation.TimeInterpolator;
+import android.animation.ValueAnimator;
+import android.graphics.Rect;
+import android.graphics.drawable.Drawable;
+import androidx.appcompat.graphics.drawable.DrawerArrowDrawable;
+import androidx.appcompat.widget.ActionMenuView;
+import androidx.appcompat.widget.Toolbar;
+import android.view.Menu;
+import android.view.View;
+import android.view.ViewGroup.MarginLayoutParams;
+import android.widget.EditText;
+import android.widget.FrameLayout;
+import android.widget.ImageButton;
+import android.widget.TextView;
+import androidx.core.graphics.drawable.DrawableCompat;
+import androidx.core.view.MarginLayoutParamsCompat;
+import androidx.core.view.ViewCompat;
+import com.google.android.material.animation.AnimationUtils;
+import com.google.android.material.internal.ClippableRoundedCornerLayout;
+import com.google.android.material.internal.FadeThroughDrawable;
+import com.google.android.material.internal.FadeThroughUpdateListener;
+import com.google.android.material.internal.MultiViewUpdateListener;
+import com.google.android.material.internal.RectEvaluator;
+import com.google.android.material.internal.ReversableAnimatedValueInterpolator;
+import com.google.android.material.internal.ToolbarUtils;
+import com.google.android.material.internal.TouchObserverFrameLayout;
+import com.google.android.material.internal.ViewUtils;
+
+/** Helper class for {@link SearchView} animations. */
+@SuppressWarnings("RestrictTo")
+class SearchViewAnimationHelper {
+
+  // Constants for show expand animation
+  private static final long SHOW_DURATION_MS = 300;
+  private static final long SHOW_CLEAR_BUTTON_ALPHA_DURATION_MS = 50;
+  private static final long SHOW_CLEAR_BUTTON_ALPHA_START_DELAY_MS = 250;
+  private static final long SHOW_CONTENT_ALPHA_DURATION_MS = 150;
+  private static final long SHOW_CONTENT_ALPHA_START_DELAY_MS = 75;
+  private static final long SHOW_CONTENT_SCALE_DURATION_MS = SHOW_DURATION_MS;
+
+  // Constants for hide collapse animation
+  private static final long HIDE_DURATION_MS = 250;
+  private static final long HIDE_CLEAR_BUTTON_ALPHA_DURATION_MS = 42;
+  private static final long HIDE_CLEAR_BUTTON_ALPHA_START_DELAY_MS = 0;
+  private static final long HIDE_CONTENT_ALPHA_DURATION_MS = 83;
+  private static final long HIDE_CONTENT_ALPHA_START_DELAY_MS = 0;
+  private static final long HIDE_CONTENT_SCALE_DURATION_MS = HIDE_DURATION_MS;
+
+  private static final float CONTENT_FROM_SCALE = 0.95f;
+
+  // Constants for show translate animation
+  private static final long SHOW_TRANSLATE_DURATION_MS = 350;
+  private static final long SHOW_TRANSLATE_KEYBOARD_START_DELAY_MS = 150;
+
+  // Constants for hide translate animation
+  private static final long HIDE_TRANSLATE_DURATION_MS = 300;
+
+  private final SearchView searchView;
+  private final View scrim;
+  private final ClippableRoundedCornerLayout rootView;
+  private final FrameLayout headerContainer;
+  private final FrameLayout toolbarContainer;
+  private final Toolbar toolbar;
+  private final Toolbar dummyToolbar;
+  private final TextView searchPrefix;
+  private final EditText editText;
+  private final ImageButton clearButton;
+  private final View divider;
+  private final TouchObserverFrameLayout contentContainer;
+
+  private SearchBar searchBar;
+
+  SearchViewAnimationHelper(SearchView searchView) {
+    this.searchView = searchView;
+    this.scrim = searchView.scrim;
+    this.rootView = searchView.rootView;
+    this.headerContainer = searchView.headerContainer;
+    this.toolbarContainer = searchView.toolbarContainer;
+    this.toolbar = searchView.toolbar;
+    this.dummyToolbar = searchView.dummyToolbar;
+    this.searchPrefix = searchView.searchPrefix;
+    this.editText = searchView.editText;
+    this.clearButton = searchView.clearButton;
+    this.divider = searchView.divider;
+    this.contentContainer = searchView.contentContainer;
+  }
+
+  void setSearchBar(SearchBar searchBar) {
+    this.searchBar = searchBar;
+  }
+
+  void show() {
+    if (searchBar != null) {
+      startShowAnimationExpand();
+    } else {
+      startShowAnimationTranslate();
+    }
+  }
+
+  void hide() {
+    if (searchBar != null) {
+      startHideAnimationCollapse();
+    } else {
+      startHideAnimationTranslate();
+    }
+  }
+
+  private void startShowAnimationExpand() {
+    if (searchView.isAdjustNothingSoftInputMode()) {
+      searchView.requestFocusAndShowKeyboardIfNeeded();
+    }
+    searchView.setTransitionState(SearchView.TransitionState.SHOWING);
+    setUpDummyToolbarIfNeeded();
+    editText.setText(searchBar.getText());
+    editText.setSelection(editText.getText().length());
+    rootView.setVisibility(View.INVISIBLE);
+    rootView.post(
+        () -> {
+          AnimatorSet animatorSet = getExpandCollapseAnimatorSet(true);
+          animatorSet.addListener(
+              new AnimatorListenerAdapter() {
+                @Override
+                public void onAnimationStart(Animator animation) {
+                  rootView.setVisibility(View.VISIBLE);
+                  searchBar.stopOnLoadAnimation();
+                }
+
+                @Override
+                public void onAnimationEnd(Animator animation) {
+                  if (!searchView.isAdjustNothingSoftInputMode()) {
+                    searchView.requestFocusAndShowKeyboardIfNeeded();
+                  }
+                  searchView.setTransitionState(SearchView.TransitionState.SHOWN);
+                }
+              });
+          animatorSet.start();
+        });
+  }
+
+  private void startHideAnimationCollapse() {
+    if (searchView.isAdjustNothingSoftInputMode()) {
+      searchView.clearFocusAndHideKeyboard();
+    }
+    AnimatorSet animatorSet = getExpandCollapseAnimatorSet(false);
+    animatorSet.addListener(
+        new AnimatorListenerAdapter() {
+          @Override
+          public void onAnimationStart(Animator animation) {
+            searchView.setTransitionState(SearchView.TransitionState.HIDING);
+          }
+
+          @Override
+          public void onAnimationEnd(Animator animation) {
+            rootView.setVisibility(View.GONE);
+            if (!searchView.isAdjustNothingSoftInputMode()) {
+              searchView.clearFocusAndHideKeyboard();
+            }
+            searchView.setTransitionState(SearchView.TransitionState.HIDDEN);
+          }
+        });
+    animatorSet.start();
+  }
+
+  private void startShowAnimationTranslate() {
+    if (searchView.isAdjustNothingSoftInputMode()) {
+      searchView.postDelayed(
+          searchView::requestFocusAndShowKeyboardIfNeeded,
+          SHOW_TRANSLATE_KEYBOARD_START_DELAY_MS);
+    }
+    rootView.setVisibility(View.INVISIBLE);
+    rootView.post(
+        () -> {
+          rootView.setTranslationY(rootView.getHeight());
+          AnimatorSet animatorSet = getTranslateAnimatorSet(true);
+          animatorSet.addListener(
+              new AnimatorListenerAdapter() {
+                @Override
+                public void onAnimationStart(Animator animation) {
+                  rootView.setVisibility(View.VISIBLE);
+                  searchView.setTransitionState(SearchView.TransitionState.SHOWING);
+                }
+
+                @Override
+                public void onAnimationEnd(Animator animation) {
+                  if (!searchView.isAdjustNothingSoftInputMode()) {
+                    searchView.requestFocusAndShowKeyboardIfNeeded();
+                  }
+                  searchView.setTransitionState(SearchView.TransitionState.SHOWN);
+                }
+              });
+          animatorSet.start();
+        });
+  }
+
+  private void startHideAnimationTranslate() {
+    if (searchView.isAdjustNothingSoftInputMode()) {
+      searchView.clearFocusAndHideKeyboard();
+    }
+    AnimatorSet animatorSet = getTranslateAnimatorSet(false);
+    animatorSet.addListener(
+        new AnimatorListenerAdapter() {
+          @Override
+          public void onAnimationStart(Animator animation) {
+            searchView.setTransitionState(SearchView.TransitionState.HIDING);
+          }
+
+          @Override
+          public void onAnimationEnd(Animator animation) {
+            rootView.setVisibility(View.GONE);
+            if (!searchView.isAdjustNothingSoftInputMode()) {
+              searchView.clearFocusAndHideKeyboard();
+            }
+            searchView.setTransitionState(SearchView.TransitionState.HIDDEN);
+          }
+        });
+    animatorSet.start();
+  }
+
+  private AnimatorSet getTranslateAnimatorSet(boolean show) {
+    AnimatorSet animatorSet = new AnimatorSet();
+    animatorSet.playTogether(getTranslationYAnimator());
+    addBackButtonProgressAnimatorIfNeeded(animatorSet);
+    animatorSet.setInterpolator(
+        ReversableAnimatedValueInterpolator.of(show, AnimationUtils.FAST_OUT_SLOW_IN_INTERPOLATOR));
+    animatorSet.setDuration(show ? SHOW_TRANSLATE_DURATION_MS : HIDE_TRANSLATE_DURATION_MS);
+    return animatorSet;
+  }
+
+  private Animator getTranslationYAnimator() {
+    ValueAnimator animator = ValueAnimator.ofFloat(rootView.getHeight(), 0);
+    animator.addUpdateListener(MultiViewUpdateListener.translationYListener(rootView));
+    return animator;
+  }
+
+  private AnimatorSet getExpandCollapseAnimatorSet(boolean show) {
+    AnimatorSet animatorSet = new AnimatorSet();
+    animatorSet.playTogether(
+        getScrimAlphaAnimator(show),
+        getRootViewAnimator(show),
+        getClearButtonAnimator(show),
+        getContentAnimator(show),
+        getButtonsAnimator(show),
+        getHeaderContainerAnimator(show),
+        getDummyToolbarAnimator(show),
+        getActionMenuViewsAlphaAnimator(show),
+        getEditTextAnimator(show),
+        getSearchPrefixAnimator(show));
+    animatorSet.addListener(
+        new AnimatorListenerAdapter() {
+          @Override
+          public void onAnimationStart(Animator animation) {
+            setContentViewsAlpha(show ? 0 : 1);
+          }
+
+          @Override
+          public void onAnimationEnd(Animator animation) {
+            setContentViewsAlpha(show ? 1 : 0);
+            if (show) {
+              // After expanding, we should reset the clip bounds so it can react to screen or
+              // layout changes. Otherwise it will result in wrong clipping on the layout.
+              rootView.resetClipBoundsAndCornerRadius();
+            }
+          }
+        });
+    return animatorSet;
+  }
+
+  private void setContentViewsAlpha(float alpha) {
+    clearButton.setAlpha(alpha);
+    divider.setAlpha(alpha);
+    contentContainer.setAlpha(alpha);
+    setActionMenuViewAlphaIfNeeded(alpha);
+  }
+
+  private void setActionMenuViewAlphaIfNeeded(float alpha) {
+    if (searchView.isAnimatedMenuItems()) {
+      ActionMenuView actionMenuView = ToolbarUtils.getActionMenuView(toolbar);
+      if (actionMenuView != null) {
+        actionMenuView.setAlpha(alpha);
+      }
+    }
+  }
+
+  private Animator getScrimAlphaAnimator(boolean show) {
+    TimeInterpolator interpolator =
+        show ? AnimationUtils.LINEAR_INTERPOLATOR : AnimationUtils.FAST_OUT_SLOW_IN_INTERPOLATOR;
+
+    ValueAnimator animator = ValueAnimator.ofFloat(0, 1);
+    animator.setDuration(show ? SHOW_DURATION_MS : HIDE_DURATION_MS);
+    animator.setInterpolator(ReversableAnimatedValueInterpolator.of(show, interpolator));
+    animator.addUpdateListener(MultiViewUpdateListener.alphaListener(scrim));
+    return animator;
+  }
+
+  private Animator getRootViewAnimator(boolean show) {
+    Rect toClipBounds = ViewUtils.calculateRectFromBounds(searchView);
+    Rect fromClipBounds = calculateFromClipBounds();
+    Rect clipBounds = new Rect(fromClipBounds);
+
+    float initialCornerRadius = searchBar.getCornerSize();
+
+    ValueAnimator animator =
+        ValueAnimator.ofObject(new RectEvaluator(clipBounds), fromClipBounds, toClipBounds);
+    animator.addUpdateListener(
+        valueAnimator -> {
+          float cornerRadius = initialCornerRadius * (1 - valueAnimator.getAnimatedFraction());
+          rootView.updateClipBoundsAndCornerRadius(clipBounds, cornerRadius);
+        });
+    animator.setDuration(show ? SHOW_DURATION_MS : HIDE_DURATION_MS);
+    animator.setInterpolator(
+        ReversableAnimatedValueInterpolator.of(show, AnimationUtils.FAST_OUT_SLOW_IN_INTERPOLATOR));
+    return animator;
+  }
+
+  private Rect calculateFromClipBounds() {
+    int[] searchBarAbsolutePosition = new int[2];
+    searchBar.getLocationOnScreen(searchBarAbsolutePosition);
+    int searchBarAbsoluteLeft = searchBarAbsolutePosition[0];
+    int searchBarAbsoluteTop = searchBarAbsolutePosition[1];
+
+    // Use rootView to handle potential fitsSystemWindows padding applied to parent searchView.
+    int[] searchViewAbsolutePosition = new int[2];
+    rootView.getLocationOnScreen(searchViewAbsolutePosition);
+    int searchViewAbsoluteLeft = searchViewAbsolutePosition[0];
+    int searchViewAbsoluteTop = searchViewAbsolutePosition[1];
+
+    int fromLeft = searchBarAbsoluteLeft - searchViewAbsoluteLeft;
+    int fromTop = searchBarAbsoluteTop - searchViewAbsoluteTop;
+    int fromRight = fromLeft + searchBar.getWidth();
+    int fromBottom = fromTop + searchBar.getHeight();
+
+    return new Rect(fromLeft, fromTop, fromRight, fromBottom);
+  }
+
+  private Animator getClearButtonAnimator(boolean show) {
+    ValueAnimator animator = ValueAnimator.ofFloat(0, 1);
+    animator.setDuration(
+        show ? SHOW_CLEAR_BUTTON_ALPHA_DURATION_MS : HIDE_CLEAR_BUTTON_ALPHA_DURATION_MS);
+    animator.setStartDelay(
+        show ? SHOW_CLEAR_BUTTON_ALPHA_START_DELAY_MS : HIDE_CLEAR_BUTTON_ALPHA_START_DELAY_MS);
+    animator.setInterpolator(
+        ReversableAnimatedValueInterpolator.of(show, AnimationUtils.LINEAR_INTERPOLATOR));
+    animator.addUpdateListener(MultiViewUpdateListener.alphaListener(clearButton));
+    return animator;
+  }
+
+  private Animator getButtonsAnimator(boolean show) {
+    AnimatorSet animatorSet = new AnimatorSet();
+    addBackButtonTranslationAnimatorIfNeeded(animatorSet);
+    addBackButtonProgressAnimatorIfNeeded(animatorSet);
+    addActionMenuViewAnimatorIfNeeded(animatorSet);
+    animatorSet.setDuration(show ? SHOW_DURATION_MS : HIDE_DURATION_MS);
+    animatorSet.setInterpolator(
+        ReversableAnimatedValueInterpolator.of(show, AnimationUtils.FAST_OUT_SLOW_IN_INTERPOLATOR));
+    return animatorSet;
+  }
+
+  private void addBackButtonTranslationAnimatorIfNeeded(AnimatorSet animatorSet) {
+    ImageButton backButton = ToolbarUtils.getNavigationIconButton(toolbar);
+    if (backButton == null) {
+      return;
+    }
+
+    ValueAnimator backButtonAnimatorX =
+        ValueAnimator.ofFloat(getFromTranslationXStart(backButton), 0);
+    backButtonAnimatorX.addUpdateListener(MultiViewUpdateListener.translationXListener(backButton));
+
+    ValueAnimator backButtonAnimatorY = ValueAnimator.ofFloat(getFromTranslationY(), 0);
+    backButtonAnimatorY.addUpdateListener(MultiViewUpdateListener.translationYListener(backButton));
+
+    animatorSet.playTogether(backButtonAnimatorX, backButtonAnimatorY);
+  }
+
+  private void addBackButtonProgressAnimatorIfNeeded(AnimatorSet animatorSet) {
+    ImageButton backButton = ToolbarUtils.getNavigationIconButton(toolbar);
+    if (backButton == null) {
+      return;
+    }
+
+    Drawable drawable = DrawableCompat.unwrap(backButton.getDrawable());
+    if (searchView.isAnimatedNavigationIcon()) {
+      addDrawerArrowDrawableAnimatorIfNeeded(animatorSet, drawable);
+      addFadeThroughDrawableAnimatorIfNeeded(animatorSet, drawable);
+    } else {
+      setFullDrawableProgressIfNeeded(drawable);
+    }
+  }
+
+  private void addDrawerArrowDrawableAnimatorIfNeeded(AnimatorSet animatorSet, Drawable drawable) {
+    if (drawable instanceof DrawerArrowDrawable) {
+      DrawerArrowDrawable drawerArrowDrawable = (DrawerArrowDrawable) drawable;
+      ValueAnimator animator = ValueAnimator.ofFloat(0, 1);
+      animator.addUpdateListener(
+          animation -> drawerArrowDrawable.setProgress(animation.getAnimatedFraction()));
+      animatorSet.playTogether(animator);
+    }
+  }
+
+  private void addFadeThroughDrawableAnimatorIfNeeded(AnimatorSet animatorSet, Drawable drawable) {
+    if (drawable instanceof FadeThroughDrawable) {
+      FadeThroughDrawable fadeThroughDrawable = (FadeThroughDrawable) drawable;
+      ValueAnimator animator = ValueAnimator.ofFloat(0, 1);
+      animator.addUpdateListener(
+          animation -> fadeThroughDrawable.setProgress(animation.getAnimatedFraction()));
+      animatorSet.playTogether(animator);
+    }
+  }
+
+  private void setFullDrawableProgressIfNeeded(Drawable drawable) {
+    if (drawable instanceof DrawerArrowDrawable) {
+      ((DrawerArrowDrawable) drawable).setProgress(1);
+    }
+    if (drawable instanceof FadeThroughDrawable) {
+      ((FadeThroughDrawable) drawable).setProgress(1);
+    }
+  }
+
+  private void addActionMenuViewAnimatorIfNeeded(AnimatorSet animatorSet) {
+    ActionMenuView actionMenuView = ToolbarUtils.getActionMenuView(toolbar);
+    if (actionMenuView == null) {
+      return;
+    }
+
+    ValueAnimator actionMenuViewAnimatorX =
+        ValueAnimator.ofFloat(getFromTranslationXEnd(actionMenuView), 0);
+    actionMenuViewAnimatorX.addUpdateListener(
+        MultiViewUpdateListener.translationXListener(actionMenuView));
+
+    ValueAnimator actionMenuViewAnimatorY = ValueAnimator.ofFloat(getFromTranslationY(), 0);
+    actionMenuViewAnimatorY.addUpdateListener(
+        MultiViewUpdateListener.translationYListener(actionMenuView));
+
+    animatorSet.playTogether(actionMenuViewAnimatorX, actionMenuViewAnimatorY);
+  }
+
+  private Animator getDummyToolbarAnimator(boolean show) {
+    return getTranslationAnimator(show, false, dummyToolbar);
+  }
+
+  private Animator getHeaderContainerAnimator(boolean show) {
+    return getTranslationAnimator(show, false, headerContainer);
+  }
+
+  private Animator getActionMenuViewsAlphaAnimator(boolean show) {
+    ValueAnimator animator = ValueAnimator.ofFloat(0, 1);
+    animator.setDuration(show ? SHOW_DURATION_MS : HIDE_DURATION_MS);
+    animator.setInterpolator(
+        ReversableAnimatedValueInterpolator.of(show, AnimationUtils.FAST_OUT_SLOW_IN_INTERPOLATOR));
+
+    if (searchView.isAnimatedMenuItems()) {
+      ActionMenuView dummyActionMenuView = ToolbarUtils.getActionMenuView(dummyToolbar);
+      ActionMenuView actionMenuView = ToolbarUtils.getActionMenuView(toolbar);
+      animator.addUpdateListener(
+          new FadeThroughUpdateListener(dummyActionMenuView, actionMenuView));
+    }
+
+    return animator;
+  }
+
+  private Animator getSearchPrefixAnimator(boolean show) {
+    return getTranslationAnimator(show, true, searchPrefix);
+  }
+
+  private Animator getEditTextAnimator(boolean show) {
+    return getTranslationAnimator(show, true, editText);
+  }
+
+  private Animator getContentAnimator(boolean show) {
+    AnimatorSet animatorSet = new AnimatorSet();
+    animatorSet.playTogether(
+        getContentAlphaAnimator(show), getDividerAnimator(show), getContentScaleAnimator(show));
+    return animatorSet;
+  }
+
+  private Animator getContentAlphaAnimator(boolean show) {
+    ValueAnimator animatorAlpha = ValueAnimator.ofFloat(0, 1);
+    animatorAlpha.setDuration(
+        show ? SHOW_CONTENT_ALPHA_DURATION_MS : HIDE_CONTENT_ALPHA_DURATION_MS);
+    animatorAlpha.setStartDelay(
+        show ? SHOW_CONTENT_ALPHA_START_DELAY_MS : HIDE_CONTENT_ALPHA_START_DELAY_MS);
+    animatorAlpha.setInterpolator(
+        ReversableAnimatedValueInterpolator.of(show, AnimationUtils.LINEAR_INTERPOLATOR));
+    animatorAlpha.addUpdateListener(
+        MultiViewUpdateListener.alphaListener(divider, contentContainer));
+    return animatorAlpha;
+  }
+
+  private Animator getDividerAnimator(boolean show) {
+    float dividerTranslationY =
+        (float) contentContainer.getHeight() * (1f - CONTENT_FROM_SCALE) / 2f;
+
+    ValueAnimator animatorDivider = ValueAnimator.ofFloat(dividerTranslationY, 0);
+    animatorDivider.setDuration(
+        show ? SHOW_CONTENT_SCALE_DURATION_MS : HIDE_CONTENT_SCALE_DURATION_MS);
+    animatorDivider.setInterpolator(
+        ReversableAnimatedValueInterpolator.of(show, AnimationUtils.FAST_OUT_SLOW_IN_INTERPOLATOR));
+    animatorDivider.addUpdateListener(MultiViewUpdateListener.translationYListener(divider));
+    return animatorDivider;
+  }
+
+  private Animator getContentScaleAnimator(boolean show) {
+    ValueAnimator animatorScale = ValueAnimator.ofFloat(CONTENT_FROM_SCALE, 1);
+    animatorScale.setDuration(
+        show ? SHOW_CONTENT_SCALE_DURATION_MS : HIDE_CONTENT_SCALE_DURATION_MS);
+    animatorScale.setInterpolator(
+        ReversableAnimatedValueInterpolator.of(show, AnimationUtils.FAST_OUT_SLOW_IN_INTERPOLATOR));
+    animatorScale.addUpdateListener(MultiViewUpdateListener.scaleListener(contentContainer));
+    return animatorScale;
+  }
+
+  private Animator getTranslationAnimator(boolean show, boolean anchoredToStart, View view) {
+    int startX = anchoredToStart ? getFromTranslationXStart(view) : getFromTranslationXEnd(view);
+    ValueAnimator animatorX = ValueAnimator.ofFloat(startX, 0);
+    animatorX.addUpdateListener(MultiViewUpdateListener.translationXListener(view));
+
+    ValueAnimator animatorY = ValueAnimator.ofFloat(getFromTranslationY(), 0);
+    animatorY.addUpdateListener(MultiViewUpdateListener.translationYListener(view));
+
+    AnimatorSet animatorSet = new AnimatorSet();
+    animatorSet.playTogether(animatorX, animatorY);
+    animatorSet.setDuration(show ? SHOW_DURATION_MS : HIDE_DURATION_MS);
+    animatorSet.setInterpolator(
+        ReversableAnimatedValueInterpolator.of(show, AnimationUtils.FAST_OUT_SLOW_IN_INTERPOLATOR));
+    return animatorSet;
+  }
+
+  private int getFromTranslationXStart(View view) {
+    int marginStart =
+        MarginLayoutParamsCompat.getMarginStart((MarginLayoutParams) view.getLayoutParams());
+    int paddingStart = ViewCompat.getPaddingStart(searchBar);
+    return ViewUtils.isLayoutRtl(searchBar)
+        ? searchBar.getWidth() - searchBar.getRight() + marginStart - paddingStart
+        : searchBar.getLeft() - marginStart + paddingStart;
+  }
+
+  private int getFromTranslationXEnd(View view) {
+    int marginEnd =
+        MarginLayoutParamsCompat.getMarginEnd((MarginLayoutParams) view.getLayoutParams());
+    return ViewUtils.isLayoutRtl(searchBar)
+        ? searchBar.getLeft() - marginEnd
+        : searchBar.getRight() - searchView.getWidth() + marginEnd;
+  }
+
+  private int getFromTranslationY() {
+    int toolbarMiddleY = (toolbarContainer.getTop() + toolbarContainer.getBottom()) / 2;
+    int searchBarMiddleY = (searchBar.getTop() + searchBar.getBottom()) / 2;
+    return searchBarMiddleY - toolbarMiddleY;
+  }
+
+  private void setUpDummyToolbarIfNeeded() {
+    Menu menu = dummyToolbar.getMenu();
+    if (menu != null) {
+      menu.clear();
+    }
+    if (searchBar.getMenuResId() != -1 && searchView.isAnimatedMenuItems()) {
+      dummyToolbar.inflateMenu(searchBar.getMenuResId());
+      setMenuItemsNotClickable(dummyToolbar);
+      dummyToolbar.setVisibility(View.VISIBLE);
+    } else {
+      dummyToolbar.setVisibility(View.GONE);
+    }
+  }
+
+  private void setMenuItemsNotClickable(Toolbar toolbar) {
+    ActionMenuView actionMenuView = ToolbarUtils.getActionMenuView(toolbar);
+    if (actionMenuView != null) {
+      for (int i = 0; i < actionMenuView.getChildCount(); i++) {
+        View menuItem = actionMenuView.getChildAt(i);
+        menuItem.setClickable(false);
+        menuItem.setFocusable(false);
+        menuItem.setFocusableInTouchMode(false);
+      }
+    }
+  }
+}
diff --git a/lib/java/com/google/android/material/search/res-public/values/public.xml b/lib/java/com/google/android/material/search/res-public/values/public.xml
new file mode 100644
index 00000000000..38a2c814d4f
--- /dev/null
+++ b/lib/java/com/google/android/material/search/res-public/values/public.xml
@@ -0,0 +1,40 @@
+<?xml version="1.0" encoding="utf-8"?>
+<!--
+  ~ Copyright 2022 The Android Open Source Project
+  ~
+  ~ Licensed under the Apache License, Version 2.0 (the "License");
+  ~ you may not use this file except in compliance with the License.
+  ~ You may obtain a copy of the License at
+  ~
+  ~     https://www.apache.org/licenses/LICENSE-2.0
+  ~
+  ~ Unless required by applicable law or agreed to in writing, software
+  ~ distributed under the License is distributed on an "AS IS" BASIS,
+  ~ WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+  ~ See the License for the specific language governing permissions and
+  ~ limitations under the License.
+  -->
+
+<!-- Definitions of attributes to be exposed as public -->
+<resources>
+  <public name="searchBarStyle" type="attr"/>
+  <public name="searchViewStyle" type="attr"/>
+  <public name="searchViewPrefixStyle" type="attr"/>
+  <public name="defaultMarginsEnabled" type="attr"/>
+  <public name="defaultScrollFlagsEnabled" type="attr"/>
+  <public name="hideNavigationIcon" type="attr"/>
+  <public name="forceDefaultNavigationOnClickListener" type="attr"/>
+  <public name="tintNavigationIcon" type="attr"/>
+  <public name="Widget.Material3.SearchBar" type="style"/>
+  <public name="Widget.Material3.SearchBar.Outlined" type="style"/>
+  <public name="Widget.Material3.SearchView" type="style"/>
+  <public name="Widget.Material3.SearchView.Toolbar" type="style"/>
+  <public name="TextAppearance.Material3.SearchBar" type="style"/>
+  <public name="TextAppearance.Material3.SearchView" type="style"/>
+  <public name="Widget.Material3.SearchView.Prefix" type="style"/>
+  <public name="TextAppearance.Material3.SearchView.Prefix" type="style"/>
+  <public name="ShapeAppearanceOverlay.Material3.SearchBar" type="style"/>
+  <public name="ThemeOverlay.Material3.Search" type="style"/>
+  <public name="Widget.Material3.Search.ActionButton.Overflow" type="style"/>
+  <public name="Widget.Material3.Search.Toolbar.Button.Navigation" type="style"/>
+</resources>
diff --git a/lib/java/com/google/android/material/search/res/drawable/ic_arrow_back_black_24.xml b/lib/java/com/google/android/material/search/res/drawable/ic_arrow_back_black_24.xml
new file mode 100644
index 00000000000..8bcc10ec26b
--- /dev/null
+++ b/lib/java/com/google/android/material/search/res/drawable/ic_arrow_back_black_24.xml
@@ -0,0 +1,26 @@
+<?xml version="1.0" encoding="utf-8"?>
+<!--
+  ~ Copyright (C) 2022 The Android Open Source Project
+  ~
+  ~ Licensed under the Apache License, Version 2.0 (the "License");
+  ~ you may not use this file except in compliance with the License.
+  ~ You may obtain a copy of the License at
+  ~
+  ~      http://www.apache.org/licenses/LICENSE-2.0
+  ~
+  ~ Unless required by applicable law or agreed to in writing, software
+  ~ distributed under the License is distributed on an "AS IS" BASIS,
+  ~ WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+  ~ See the License for the specific language governing permissions and
+  ~ limitations under the License.
+-->
+<vector xmlns:android="http://schemas.android.com/apk/res/android"
+        xmlns:tools="http://schemas.android.com/tools" tools:ignore="NewApi"
+        android:width="24dp"
+        android:height="24dp"
+        android:viewportWidth="24.0"
+        android:viewportHeight="24.0">
+    <path
+        android:fillColor="#FF000000"
+        android:pathData="M20,11H7.83l5.59,-5.59L12,4l-8,8 8,8 1.41,-1.41L7.83,13H20v-2z"/>
+</vector>
diff --git a/lib/java/com/google/android/material/search/res/drawable/ic_clear_black_24.xml b/lib/java/com/google/android/material/search/res/drawable/ic_clear_black_24.xml
new file mode 100644
index 00000000000..6d123d5a262
--- /dev/null
+++ b/lib/java/com/google/android/material/search/res/drawable/ic_clear_black_24.xml
@@ -0,0 +1,28 @@
+<?xml version="1.0" encoding="utf-8"?>
+<!--
+  ~ Copyright (C) 2022 The Android Open Source Project
+  ~
+  ~ Licensed under the Apache License, Version 2.0 (the "License");
+  ~ you may not use this file except in compliance with the License.
+  ~ You may obtain a copy of the License at
+  ~
+  ~      http://www.apache.org/licenses/LICENSE-2.0
+  ~
+  ~ Unless required by applicable law or agreed to in writing, software
+  ~ distributed under the License is distributed on an "AS IS" BASIS,
+  ~ WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+  ~ See the License for the specific language governing permissions and
+  ~ limitations under the License.
+-->
+<vector xmlns:android="http://schemas.android.com/apk/res/android"
+    xmlns:tools="http://schemas.android.com/tools"
+    android:width="24dp"
+    android:height="24dp"
+    android:viewportWidth="24"
+    android:viewportHeight="24"
+    android:tint="?attr/colorControlNormal"
+    tools:ignore="NewApi">
+  <path
+      android:fillColor="@android:color/white"
+      android:pathData="M19,6.41L17.59,5 12,10.59 6.41,5 5,6.41 10.59,12 5,17.59 6.41,19 12,13.41 17.59,19 19,17.59 13.41,12z"/>
+</vector>
diff --git a/lib/java/com/google/android/material/search/res/drawable/ic_search_black_24.xml b/lib/java/com/google/android/material/search/res/drawable/ic_search_black_24.xml
new file mode 100644
index 00000000000..432276eb5e4
--- /dev/null
+++ b/lib/java/com/google/android/material/search/res/drawable/ic_search_black_24.xml
@@ -0,0 +1,26 @@
+<?xml version="1.0" encoding="utf-8"?>
+<!--
+  ~ Copyright (C) 2022 The Android Open Source Project
+  ~
+  ~ Licensed under the Apache License, Version 2.0 (the "License");
+  ~ you may not use this file except in compliance with the License.
+  ~ You may obtain a copy of the License at
+  ~
+  ~      http://www.apache.org/licenses/LICENSE-2.0
+  ~
+  ~ Unless required by applicable law or agreed to in writing, software
+  ~ distributed under the License is distributed on an "AS IS" BASIS,
+  ~ WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+  ~ See the License for the specific language governing permissions and
+  ~ limitations under the License.
+-->
+<vector xmlns:android="http://schemas.android.com/apk/res/android"
+        xmlns:tools="http://schemas.android.com/tools" tools:ignore="NewApi"
+        android:width="24dp"
+        android:height="24dp"
+        android:viewportWidth="24.0"
+        android:viewportHeight="24.0">
+    <path
+        android:fillColor="#FF000000"
+        android:pathData="M15.5,14h-0.79l-0.28,-0.27C15.41,12.59 16,11.11 16,9.5 16,5.91 13.09,3 9.5,3S3,5.91 3,9.5 5.91,16 9.5,16c1.61,0 3.09,-0.59 4.23,-1.57l0.27,0.28v0.79l5,4.99L20.49,19l-4.99,-5zM9.5,14C7.01,14 5,11.99 5,9.5S7.01,5 9.5,5 14,7.01 14,9.5 11.99,14 9.5,14z"/>
+</vector>
diff --git a/lib/java/com/google/android/material/search/res/layout/mtrl_search_bar.xml b/lib/java/com/google/android/material/search/res/layout/mtrl_search_bar.xml
new file mode 100644
index 00000000000..c3b6dee3e71
--- /dev/null
+++ b/lib/java/com/google/android/material/search/res/layout/mtrl_search_bar.xml
@@ -0,0 +1,25 @@
+<?xml version="1.0" encoding="utf-8"?>
+<!--
+  ~ Copyright (C) 2022 The Android Open Source Project
+  ~
+  ~ Licensed under the Apache License, Version 2.0 (the "License");
+  ~ you may not use this file except in compliance with the License.
+  ~ You may obtain a copy of the License at
+  ~
+  ~      http://www.apache.org/licenses/LICENSE-2.0
+  ~
+  ~ Unless required by applicable law or agreed to in writing, software
+  ~ distributed under the License is distributed on an "AS IS" BASIS,
+  ~ WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+  ~ See the License for the specific language governing permissions and
+  ~ limitations under the License.
+-->
+<!-- This text view isn't exposed to accessibility because its attributes are mirrored on the
+     parent container to more closely resemble the behavior of an EditText. -->
+<TextView xmlns:android="http://schemas.android.com/apk/res/android"
+    android:id="@+id/search_bar_text_view"
+    android:layout_width="wrap_content"
+    android:layout_height="wrap_content"
+    android:ellipsize="end"
+    android:importantForAccessibility="no"
+    android:maxLines="1"/>
diff --git a/lib/java/com/google/android/material/search/res/layout/mtrl_search_view.xml b/lib/java/com/google/android/material/search/res/layout/mtrl_search_view.xml
new file mode 100644
index 00000000000..b79469a9c36
--- /dev/null
+++ b/lib/java/com/google/android/material/search/res/layout/mtrl_search_view.xml
@@ -0,0 +1,125 @@
+<?xml version="1.0" encoding="utf-8"?>
+<!--
+  ~ Copyright (C) 2022 The Android Open Source Project
+  ~
+  ~ Licensed under the Apache License, Version 2.0 (the "License");
+  ~ you may not use this file except in compliance with the License.
+  ~ You may obtain a copy of the License at
+  ~
+  ~      http://www.apache.org/licenses/LICENSE-2.0
+  ~
+  ~ Unless required by applicable law or agreed to in writing, software
+  ~ distributed under the License is distributed on an "AS IS" BASIS,
+  ~ WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+  ~ See the License for the specific language governing permissions and
+  ~ limitations under the License.
+-->
+<merge xmlns:android="http://schemas.android.com/apk/res/android"
+    xmlns:app="http://schemas.android.com/apk/res-auto"
+    xmlns:tools="http://schemas.android.com/tools">
+
+  <View
+      android:id="@+id/search_view_scrim"
+      android:layout_width="match_parent"
+      android:layout_height="match_parent"
+      android:alpha="0"
+      android:background="?attr/scrimBackground"/>
+
+  <com.google.android.material.internal.ClippableRoundedCornerLayout
+      android:id="@+id/search_view_root"
+      android:layout_width="match_parent"
+      android:layout_height="match_parent"
+      android:focusable="true"
+      android:focusableInTouchMode="true"
+      android:visibility="gone">
+
+    <LinearLayout
+        android:id="@+id/search_view_background"
+        android:layout_width="match_parent"
+        android:layout_height="match_parent"
+        android:orientation="vertical">
+
+      <View
+          android:id="@+id/search_view_status_bar_spacer"
+          android:layout_width="match_parent"
+          android:layout_height="wrap_content"
+          android:visibility="gone"/>
+
+      <FrameLayout
+          android:id="@+id/search_view_header_container"
+          android:layout_width="match_parent"
+          android:layout_height="wrap_content"
+          android:visibility="gone"/>
+
+      <FrameLayout
+          android:id="@+id/search_view_toolbar_container"
+          android:layout_width="match_parent"
+          android:layout_height="wrap_content">
+
+        <com.google.android.material.appbar.MaterialToolbar
+            android:id="@+id/search_view_dummy_toolbar"
+            style="@style/Widget.Material3.SearchView.Toolbar"
+            android:layout_width="wrap_content"
+            android:layout_height="wrap_content"
+            android:layout_gravity="end"
+            android:visibility="gone"/>
+
+        <com.google.android.material.appbar.MaterialToolbar
+            android:id="@+id/search_view_toolbar"
+            style="@style/Widget.Material3.SearchView.Toolbar"
+            android:layout_width="match_parent"
+            android:layout_height="wrap_content"
+            android:clipChildren="false"
+            app:navigationContentDescription="@string/searchview_navigation_content_description"
+            app:navigationIcon="@drawable/ic_arrow_back_black_24">
+
+          <LinearLayout
+              android:layout_width="match_parent"
+              android:layout_height="@dimen/m3_searchbar_height"
+              android:gravity="center_vertical"
+              android:orientation="horizontal">
+
+            <TextView
+                android:id="@+id/search_view_search_prefix"
+                style="?attr/searchViewPrefixStyle"
+                android:layout_width="wrap_content"
+                android:layout_height="wrap_content"
+                android:visibility="gone"/>
+
+            <EditText
+                android:id="@+id/search_view_edit_text"
+                android:layout_width="0dp"
+                android:layout_height="match_parent"
+                android:layout_weight="1"
+                android:background="@null"
+                android:imeOptions="flagNoExtractUi|actionSearch"
+                android:importantForAutofill="no"
+                android:inputType="textNoSuggestions"
+                android:textDirection="firstStrong"
+                tools:ignore="LabelFor"/>
+
+            <ImageButton
+                android:id="@+id/search_view_clear_button"
+                android:layout_width="wrap_content"
+                android:layout_height="wrap_content"
+                android:padding="16dp"
+                android:background="?attr/actionBarItemBackground"
+                android:contentDescription="@string/searchview_clear_text_content_description"
+                android:visibility="gone"
+                app:srcCompat="@drawable/ic_clear_black_24"/>
+          </LinearLayout>
+        </com.google.android.material.appbar.MaterialToolbar>
+      </FrameLayout>
+
+      <View
+          android:id="@+id/search_view_divider"
+          android:layout_width="match_parent"
+          android:layout_height="@dimen/m3_searchview_divider_size"/>
+
+      <com.google.android.material.internal.TouchObserverFrameLayout
+          android:id="@+id/search_view_content_container"
+          android:layout_width="match_parent"
+          android:layout_height="match_parent"/>
+    </LinearLayout>
+  </com.google.android.material.internal.ClippableRoundedCornerLayout>
+</merge>
diff --git a/lib/java/com/google/android/material/search/res/values/attrs.xml b/lib/java/com/google/android/material/search/res/values/attrs.xml
new file mode 100644
index 00000000000..fa046f89f03
--- /dev/null
+++ b/lib/java/com/google/android/material/search/res/values/attrs.xml
@@ -0,0 +1,96 @@
+<?xml version="1.0" encoding="utf-8"?>
+<!--
+  ~ Copyright (C) 2022 The Android Open Source Project
+  ~
+  ~ Licensed under the Apache License, Version 2.0 (the "License");
+  ~ you may not use this file except in compliance with the License.
+  ~ You may obtain a copy of the License at
+  ~
+  ~      http://www.apache.org/licenses/LICENSE-2.0
+  ~
+  ~ Unless required by applicable law or agreed to in writing, software
+  ~ distributed under the License is distributed on an "AS IS" BASIS,
+  ~ WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+  ~ See the License for the specific language governing permissions and
+  ~ limitations under the License.
+-->
+<resources>
+
+  <!-- Style to use for SearchBars in this theme. -->
+  <attr name="searchBarStyle" format="reference"/>
+  <!-- Style to use for SearchViews in this theme. -->
+  <attr name="searchViewStyle" format="reference"/>
+  <!-- Style to use for SearchView prefixes in this theme. -->
+  <attr name="searchViewPrefixStyle" format="reference"/>
+  <!-- Attribute to use for hiding the navigation icon in search bar and search view. -->
+  <attr name="hideNavigationIcon" format="boolean"/>
+
+  <declare-styleable name="SearchBar">
+    <!-- Text appearance for the main search TextView. -->
+    <attr name="android:textAppearance"/>
+    <!-- Text for the main search TextView. -->
+    <attr name="android:text"/>
+    <!-- Hint for the main search TextView. -->
+    <attr name="android:hint"/>
+    <!-- Elevation of the SearchBar. -->
+    <attr name="elevation"/>
+    <!-- Whether the default margins should be applied to the SearchBar.
+         Default is true. -->
+    <attr name="defaultMarginsEnabled" format="boolean"/>
+    <!-- Whether the default AppBarLayout scroll flags should be applied to the SearchBar.
+         Default is true. -->
+    <attr name="defaultScrollFlagsEnabled" format="boolean"/>
+    <!-- Whether the navigation icon, which defaults to a magnifying glass
+         icon, should be hidden. Default is false. -->
+    <attr name="hideNavigationIcon"/>
+    <!-- Whether the default navigation icon click listener should be enforced.
+         This could be useful when setting up the SearchBar as an Activity's
+         ActionBar, which implicitly sets a navigation icon click listener.
+         Default is false. -->
+    <attr name="forceDefaultNavigationOnClickListener" format="boolean" />
+    <!-- Whether the navigation icon should be tinted. Default is true. -->
+    <attr name="tintNavigationIcon" format="boolean"/>
+    <!-- The color the navigation icon should be tinted with. Default is null
+         as SearchBar tints programmatically with colorOnSurfaceVariant for
+         default search icon and colorOnSurface for other icons. -->
+    <attr name="navigationIconTint"/>
+    <!-- Color of the SearchBar outline stroke. -->
+    <attr name="strokeColor"/>
+    <!-- Width of the SearchBar outline stroke. -->
+    <attr name="strokeWidth"/>
+  </declare-styleable>
+
+  <declare-styleable name="SearchView">
+    <!-- Text appearance for the main search EditText. -->
+    <attr name="android:textAppearance"/>
+    <!-- Text for the main search EditText. -->
+    <attr name="android:text"/>
+    <!-- Hint for the main search EditText. -->
+    <attr name="android:hint"/>
+    <!-- Text for the search prefix which appears before the main search EditText. -->
+    <attr name="searchPrefixText" format="string"/>
+    <!-- Whether a DrawerArrowDrawable should be used for the navigation icon,
+         which provides a "hamburger" menu to back arrow animation when the
+         SearchView expands/collapses. Default is false. Consider setting
+         to true when using a "hamburger" menu icon for the associated
+         SearchBar's navigation icon. -->
+    <attr name="useDrawerArrowDrawable" format="boolean"/>
+    <!-- Whether the navigation icon should be animated from the SearchBar
+         to the SearchView. Default is true. Set to false if using the
+         same navigation icon for both the SearchBar and SearchView. -->
+    <attr name="animateNavigationIcon" format="boolean"/>
+    <!-- Whether the menu items should be animated from the SearchBar
+         to the SearchView. Default is true. Set to false if inflating the
+         same menu for both the SearchBar and SearchView. -->
+    <attr name="animateMenuItems" format="boolean"/>
+    <!-- Whether the navigation icon, which defaults to a back arrow icon,
+         should be hidden. Default is false. -->
+    <attr name="hideNavigationIcon"/>
+    <!-- Whether the soft keyboard should be shown when the SearchView is
+         shown. Default is true. -->
+    <attr name="autoShowKeyboard" format="boolean"/>
+    <!-- Layout resource to inflate as the header. -->
+    <attr name="headerLayout"/>
+  </declare-styleable>
+
+</resources>
diff --git a/lib/java/com/google/android/material/search/res/values/dimens.xml b/lib/java/com/google/android/material/search/res/values/dimens.xml
new file mode 100644
index 00000000000..b783e6be371
--- /dev/null
+++ b/lib/java/com/google/android/material/search/res/values/dimens.xml
@@ -0,0 +1,31 @@
+<?xml version="1.0" encoding="utf-8"?>
+<!--
+  ~ Copyright (C) 2022 The Android Open Source Project
+  ~
+  ~ Licensed under the Apache License, Version 2.0 (the "License");
+  ~ you may not use this file except in compliance with the License.
+  ~ You may obtain a copy of the License at
+  ~
+  ~      http://www.apache.org/licenses/LICENSE-2.0
+  ~
+  ~ Unless required by applicable law or agreed to in writing, software
+  ~ distributed under the License is distributed on an "AS IS" BASIS,
+  ~ WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+  ~ See the License for the specific language governing permissions and
+  ~ limitations under the License.
+-->
+<resources>
+
+  <dimen name="m3_searchbar_height">48dp</dimen>
+  <dimen name="m3_searchbar_elevation">3dp</dimen>
+  <dimen name="m3_searchbar_radius">8dp</dimen>
+  <dimen name="m3_searchbar_text_size">16sp</dimen>
+  <dimen name="m3_searchbar_text_margin_start_no_navigation_icon">16dp</dimen>
+  <dimen name="m3_searchbar_margin_horizontal">16dp</dimen>
+  <dimen name="m3_searchbar_margin_vertical">8dp</dimen>
+  <dimen name="m3_searchbar_padding_start">4dp</dimen>
+
+  <dimen name="m3_searchview_elevation">6dp</dimen>
+  <dimen name="m3_searchview_divider_size">1dp</dimen>
+
+</resources>
diff --git a/lib/java/com/google/android/material/search/res/values/strings.xml b/lib/java/com/google/android/material/search/res/values/strings.xml
new file mode 100644
index 00000000000..aaf98dd8c5e
--- /dev/null
+++ b/lib/java/com/google/android/material/search/res/values/strings.xml
@@ -0,0 +1,39 @@
+<?xml version="1.0" encoding="utf-8"?>
+<!--
+  ~ Copyright (C) 2022 The Android Open Source Project
+  ~
+  ~ Licensed under the Apache License, Version 2.0 (the "License");
+  ~ you may not use this file except in compliance with the License.
+  ~ You may obtain a copy of the License at
+  ~
+  ~      http://www.apache.org/licenses/LICENSE-2.0
+  ~
+  ~ Unless required by applicable law or agreed to in writing, software
+  ~ distributed under the License is distributed on an "AS IS" BASIS,
+  ~ WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+  ~ See the License for the specific language governing permissions and
+  ~ limitations under the License.
+-->
+<resources>
+  <!-- The class name for the ScrollingChildBehavior for SearchBar. Similar to
+       @string/appbar_scrolling_view_behavior, results in the SearchBar scrolling
+       away/back on scroll up/down. -->
+  <string name="searchbar_scrolling_view_behavior" translatable="false">
+    com.google.android.material.search.SearchBar$ScrollingViewBehavior
+  </string>
+  <!-- The class name for the Behavior that sets up an SearchView with an SearchBar.
+       This is SearchView's default Behavior and it will result in the SearchView
+       being shown when the SearchBar is clicked, as long as the SearchView is also
+       anchored to the SearchBar. -->
+  <string name="searchview_behavior" translatable="false">
+    com.google.android.libraries.material.search.SearchView$Behavior
+  </string>
+
+  <!-- Default content description for the navigation button (i.e. the back arrow) for
+       SearchView. -->
+  <string name="searchview_navigation_content_description"
+          description="Content description for the navigation button to return to the previous screen [CHAR_LIMIT=NONE]">Back</string>
+  <!-- Content description for the clear text button (i.e. the X button) for SearchView. -->
+  <string name="searchview_clear_text_content_description"
+          description="Content description for the X button to clear text [CHAR_LIMIT=NONE]">Clear text</string>
+</resources>
diff --git a/lib/java/com/google/android/material/search/res/values/styles.xml b/lib/java/com/google/android/material/search/res/values/styles.xml
new file mode 100644
index 00000000000..79827908fcd
--- /dev/null
+++ b/lib/java/com/google/android/material/search/res/values/styles.xml
@@ -0,0 +1,97 @@
+<?xml version="1.0" encoding="utf-8"?>
+<!--
+  ~ Copyright (C) 2022 The Android Open Source Project
+  ~
+  ~ Licensed under the Apache License, Version 2.0 (the "License");
+  ~ you may not use this file except in compliance with the License.
+  ~ You may obtain a copy of the License at
+  ~
+  ~      http://www.apache.org/licenses/LICENSE-2.0
+  ~
+  ~ Unless required by applicable law or agreed to in writing, software
+  ~ distributed under the License is distributed on an "AS IS" BASIS,
+  ~ WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+  ~ See the License for the specific language governing permissions and
+  ~ limitations under the License.
+-->
+<resources xmlns:tools="http://schemas.android.com/tools" tools:ignore="NewApi">
+
+  <style name="Widget.Material3.SearchBar" parent="android:Widget">
+    <item name="enforceMaterialTheme">true</item>
+    <item name="android:minHeight">@dimen/m3_searchbar_height</item>
+    <item name="android:paddingStart">@dimen/m3_searchbar_padding_start</item>
+    <item name="android:textAppearance">@style/TextAppearance.Material3.SearchBar</item>
+    <item name="elevation">@dimen/m3_searchbar_elevation</item>
+    <item name="maxButtonHeight">@dimen/m3_searchbar_height</item>
+    <item name="defaultMarginsEnabled">true</item>
+    <item name="defaultScrollFlagsEnabled">true</item>
+    <item name="hideNavigationIcon">false</item>
+    <item name="shapeAppearance">?attr/shapeAppearanceMediumComponent</item>
+    <item name="shapeAppearanceOverlay">@style/ShapeAppearanceOverlay.Material3.SearchBar</item>
+    <item name="materialThemeOverlay">@style/ThemeOverlay.Material3.Search</item>
+  </style>
+
+  <style name="Widget.Material3.SearchBar.Outlined">
+    <item name="elevation">0dp</item>
+    <item name="strokeWidth">1dp</item>
+    <item name="strokeColor">?attr/colorOutline</item>
+  </style>
+
+  <style name="Widget.Material3.SearchView" parent="android:Widget">
+    <item name="enforceMaterialTheme">true</item>
+    <item name="android:elevation">@dimen/m3_searchview_elevation</item>
+    <item name="android:textAppearance">@style/TextAppearance.Material3.SearchView</item>
+    <item name="materialThemeOverlay">@style/ThemeOverlay.Material3.Search</item>
+  </style>
+
+  <style name="Widget.Material3.SearchView.Toolbar" parent="Widget.AppCompat.Toolbar">
+    <!-- Set these padding and inset values to 0dp on all screen sizes because the extra spacing is
+         not needed and it conflicts with the expand/collapse animations. -->
+    <item name="android:paddingLeft">0dp</item>
+    <item name="android:paddingRight">0dp</item>
+    <item name="contentInsetStartWithNavigation">0dp</item>
+    <item name="navigationIconTint">?attr/colorOnSurface</item>
+  </style>
+
+  <style name="Base.TextAppearance.Material3.Search" parent="TextAppearance.MaterialComponents.Headline6">
+    <item name="android:textColor">?attr/colorOnSurface</item>
+    <item name="android:textColorHint">?attr/colorOnSurfaceVariant</item>
+    <item name="android:textSize">@dimen/m3_searchbar_text_size</item>
+  </style>
+
+  <style name="TextAppearance.Material3.SearchBar" parent="Base.TextAppearance.Material3.Search"/>
+
+  <style name="TextAppearance.Material3.SearchView" parent="Base.TextAppearance.Material3.Search"/>
+
+  <style name="Widget.Material3.SearchView.Prefix" parent="android:Widget.TextView">
+    <item name="android:textAppearance">@style/TextAppearance.Material3.SearchView.Prefix</item>
+    <item name="android:paddingTop">8dp</item>
+    <item name="android:paddingBottom">8dp</item>
+    <item name="android:paddingEnd">16dp</item>
+    <item name="android:paddingRight">16dp</item>
+  </style>
+
+  <style name="TextAppearance.Material3.SearchView.Prefix">
+    <item name="android:textColor">?android:attr/textColorTertiary</item>
+  </style>
+
+  <style name="ShapeAppearanceOverlay.Material3.SearchBar" parent="">
+    <item name="cornerSize">@dimen/m3_searchbar_radius</item>
+  </style>
+
+  <style name="ThemeOverlay.Material3.Search" parent="">
+    <item name="actionMenuTextColor">?attr/colorOnSurfaceVariant</item>
+    <item name="colorControlNormal">?attr/colorOnSurfaceVariant</item>
+    <item name="actionOverflowButtonStyle">@style/Widget.Material3.Search.ActionButton.Overflow</item>
+    <item name="toolbarNavigationButtonStyle">@style/Widget.Material3.Search.Toolbar.Button.Navigation</item>
+  </style>
+
+  <style name="Widget.Material3.Search.ActionButton.Overflow" parent="Widget.AppCompat.ActionButton.Overflow">
+    <item name="android:minWidth">@dimen/mtrl_min_touch_target_size</item>
+  </style>
+
+  <style name="Widget.Material3.Search.Toolbar.Button.Navigation" parent="Widget.AppCompat.Toolbar.Button.Navigation">
+    <item name="android:minWidth">@dimen/mtrl_min_touch_target_size</item>
+  </style>
+
+</resources>
diff --git a/lib/java/com/google/android/material/search/res/values/tokens.xml b/lib/java/com/google/android/material/search/res/values/tokens.xml
new file mode 100644
index 00000000000..aed42b28332
--- /dev/null
+++ b/lib/java/com/google/android/material/search/res/values/tokens.xml
@@ -0,0 +1,73 @@
+<?xml version="1.0" encoding="utf-8"?>
+<!--
+  ~ Copyright (C) 2022 The Android Open Source Project
+  ~
+  ~ Licensed under the Apache License, Version 2.0 (the "License");
+  ~ you may not use this file except in compliance with the License.
+  ~ You may obtain a copy of the License at
+  ~
+  ~      http://www.apache.org/licenses/LICENSE-2.0
+  ~
+  ~ Unless required by applicable law or agreed to in writing, software
+  ~ distributed under the License is distributed on an "AS IS" BASIS,
+  ~ WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+  ~ See the License for the specific language governing permissions and
+  ~ limitations under the License.
+-->
+<!-- AUTOGENERATED FILE. DO NOT MODIFY. -->
+<!-- Version: v0.126 -->
+
+<resources>
+  <!-- Generated from token set (md.comp.search-bar) in default context. -->
+  <!-- Enabled - Avatar -->
+  <style name="ShapeAppearance.M3.Comp.SearchBar.Avatar.Shape" parent="ShapeAppearance.M3.Sys.Shape.Corner.Full"/>
+  <dimen name="m3_comp_search_bar_avatar_size">30dp</dimen>
+  <!-- Enabled - Container -->
+  <macro name="m3_comp_search_bar_container_color">?attr/colorSurface</macro>
+  <dimen name="m3_comp_search_bar_container_elevation">@dimen/m3_sys_elevation_level3</dimen>
+  <macro name="m3_comp_search_bar_container_surface_tint_layer_color">?attr/elevationOverlayColor</macro>
+  <style name="ShapeAppearance.M3.Comp.SearchBar.Container.Shape" parent="ShapeAppearance.M3.Sys.Shape.Corner.Full"/>
+  <dimen name="m3_comp_search_bar_container_height">56dp</dimen>
+  <!-- Enabled - Leading icon -->
+  <macro name="m3_comp_search_bar_leading_icon_color">?attr/colorOnSurface</macro>
+  <!-- Enabled - Trailing icon -->
+  <macro name="m3_comp_search_bar_trailing_icon_color">?attr/colorOnSurfaceVariant</macro>
+  <!-- Enabled - Supporting text -->
+  <macro name="m3_comp_search_bar_supporting_text_color">?attr/colorOnSurfaceVariant</macro>
+  <macro name="m3_comp_search_bar_supporting_text_type">?attr/textAppearanceBodyLarge</macro>
+  <!-- Enabled - Input text -->
+  <macro name="m3_comp_search_bar_input_text_color">?attr/colorOnSurface</macro>
+  <macro name="m3_comp_search_bar_input_text_type">?attr/textAppearanceBodyLarge</macro>
+  <!-- Hovered - State layer -->
+  <macro name="m3_comp_search_bar_hover_state_layer_color">?attr/colorOnSurface</macro>
+  <dimen name="m3_comp_search_bar_hover_state_layer_opacity">@dimen/m3_sys_state_hover_state_layer_opacity</dimen>
+  <!-- Hovered - Supporting text -->
+  <macro name="m3_comp_search_bar_hover_supporting_text_color">?attr/colorOnSurfaceVariant</macro>
+  <!-- Pressed (rippple) - State layer -->
+  <macro name="m3_comp_search_bar_pressed_state_layer_color">?attr/colorOnSurface</macro>
+  <dimen name="m3_comp_search_bar_pressed_state_layer_opacity">@dimen/m3_sys_state_pressed_state_layer_opacity</dimen>
+  <!-- Pressed (rippple) - Supporting text -->
+  <macro name="m3_comp_search_bar_pressed_supporting_text_color">?attr/colorOnSurfaceVariant</macro>
+
+  <!-- Generated from token set (md.comp.search-view) in default context. -->
+  <!-- Enabled - Container -->
+  <macro name="m3_comp_search_view_container_color">?attr/colorSurface</macro>
+  <style name="ShapeAppearance.M3.Comp.SearchView.FullScreen.Container.Shape" parent="ShapeAppearance.M3.Sys.Shape.Corner.None"/>
+  <macro name="m3_comp_search_view_docked_container_shape">?attr/shapeAppearanceCornerExtraLarge</macro>
+  <dimen name="m3_comp_search_view_container_elevation">@dimen/m3_sys_elevation_level3</dimen>
+  <macro name="m3_comp_search_view_container_surface_tint_layer_color">?attr/elevationOverlayColor</macro>
+  <dimen name="m3_comp_search_view_full_screen_header_container_height">72dp</dimen>
+  <dimen name="m3_comp_search_view_docked_header_container_height">56dp</dimen>
+  <!-- Enabled - Leading icon -->
+  <macro name="m3_comp_search_view_header_leading_icon_color">?attr/colorOnSurface</macro>
+  <!-- Enabled - Trailing icon -->
+  <macro name="m3_comp_search_view_header_trailing_icon_color">?attr/colorOnSurfaceVariant</macro>
+  <!-- Enabled - Divider -->
+  <macro name="m3_comp_search_view_divider_color">?attr/colorOutline</macro>
+  <!-- Enabled - Supporting text -->
+  <macro name="m3_comp_search_view_header_supporting_text_color">?attr/colorOnSurfaceVariant</macro>
+  <macro name="m3_comp_search_view_header_supporting_text_type">?attr/textAppearanceBodyLarge</macro>
+  <!-- Enabled - Input text -->
+  <macro name="m3_comp_search_view_header_input_text_color">?attr/colorOnSurface</macro>
+  <macro name="m3_comp_search_view_header_input_text_type">?attr/textAppearanceBodyLarge</macro>
+</resources>
diff --git a/lib/java/com/google/android/material/theme/res/values/themes_base.xml b/lib/java/com/google/android/material/theme/res/values/themes_base.xml
index 212e02b3f60..e3f86bea303 100644
--- a/lib/java/com/google/android/material/theme/res/values/themes_base.xml
+++ b/lib/java/com/google/android/material/theme/res/values/themes_base.xml
@@ -140,6 +140,8 @@
     <item name="materialSwitchStyle">@style/Widget.Material3.CompoundButton.MaterialSwitch</item>
     <item name="navigationRailStyle">@style/Widget.Material3.NavigationRailView</item>
     <item name="navigationViewStyle">@style/Widget.Material3.NavigationView</item>
+    <item name="searchBarStyle">@style/Widget.Material3.SearchBar</item>
+    <item name="searchViewStyle">@style/Widget.Material3.SearchView</item>
     <item name="radioButtonStyle">@style/Widget.Material3.CompoundButton.RadioButton</item>
     <item name="sliderStyle">@style/Widget.Material3.Slider</item>
     <item name="snackbarStyle">@style/Widget.Material3.Snackbar</item>
@@ -380,6 +382,8 @@
     <item name="materialSwitchStyle">@style/Widget.Material3.CompoundButton.MaterialSwitch</item>
     <item name="navigationRailStyle">@style/Widget.Material3.NavigationRailView</item>
     <item name="navigationViewStyle">@style/Widget.Material3.NavigationView</item>
+    <item name="searchBarStyle">@style/Widget.Material3.SearchBar</item>
+    <item name="searchViewStyle">@style/Widget.Material3.SearchView</item>
     <item name="radioButtonStyle">@style/Widget.Material3.CompoundButton.RadioButton</item>
     <item name="sliderStyle">@style/Widget.Material3.Slider</item>
     <item name="snackbarStyle">@style/Widget.Material3.Snackbar</item>
diff --git a/lib/javatests/com/google/android/material/theme/ThemeTest.java b/lib/javatests/com/google/android/material/theme/ThemeTest.java
index 9bedfdd454a..4d26a5e5b1f 100644
--- a/lib/javatests/com/google/android/material/theme/ThemeTest.java
+++ b/lib/javatests/com/google/android/material/theme/ThemeTest.java
@@ -384,6 +384,8 @@ public class ThemeTest {
           R.attr.materialCardViewElevatedStyle,
           R.attr.materialSwitchStyle,
           R.attr.radioButtonStyle,
+          R.attr.searchBarStyle,
+          R.attr.searchViewStyle,
           R.attr.sliderStyle,
           R.attr.snackbarStyle,
           R.attr.snackbarButtonStyle,