Android MaterialButton

原文链接：Android 组件
更多文档：橘柚主页

MaterialButton 是 Android Jetpack 组件库中的一个部分，它是一个按钮控件，遵循 Google 的 Material Design 规范。Material Design 是一种用户界面设计语言，旨在提供一致、直观和美观的用户界面体验。
要使用 MaterialButton 控件，你需要执行以下步骤：

1. 添加依赖：确保你的 Android 项目中已经添加了 Material Components 库的依赖。你可以在项目的 build.gradle 文件中添加以下依赖：

   implementation 'com.google.android.material:material:1.4.0'
   

   然后同步项目以确保依赖被正确引入。

2. 在布局文件中添加 MaterialButton：在你的布局文件中添加一个 MaterialButton 控件。你可以使用 XML 布局或者通过代码创建控件。以下是一个 XML 布局的示例：

   <com.google.android.material.button.MaterialButton
       android:id="@+id/material_button"
       android:layout_width="wrap_content"
       android:layout_height="wrap_content"
       android:text="MaterialButton"
       app:cornerRadius="4dp" <!-- 设置圆角半径 -->
       app:backgroundTint="@color/colorPrimary" <!-- 设置按钮颜色 -->
       app:icon="@drawable/ic_button_icon" <!-- 设置按钮图标 -->
       app:iconGravity="textStart" <!-- 设置图标位置 -->
       app:iconPadding="8dp" <!-- 设置图标内边距 -->
       app:iconTint="@android:color/white" <!-- 设置图标颜色 -->
       <!-- 其他按钮属性 -->
   />
   

3. 设置样式和属性：你可以使用 app 命名空间中的属性来设置按钮的样式、颜色、图标等。在示例中，app:cornerRadius 设置了按钮的圆角半径，app:backgroundTint 设置了按钮的颜色，app:icon 设置了按钮的图标等等。

4. 在代码中操作按钮：你可以在 Java 或 Kotlin 代码中获取按钮的引用，并添加相应的点击事件监听器等。示例：

   MaterialButton materialButton = findViewById(R.id.material_button);
   
   materialButton.setOnClickListener(new View.OnClickListener() {
       @Override
       public void onClick(View v) {
           // 处理按钮点击事件
       }
   });
   

MaterialButton 控件具有许多可用于自定义按钮外观和行为的属性。以下是一些常见的 MaterialButton 属性：

1. Text相关属性：

   • android:text：按钮上显示的文本。
   • android:textSize：文本字体大小。
   • android:textColor：文本颜色。
   • android:textStyle：文本样式（例如，粗体、斜体）。

2. 背景和形状：

   • app:backgroundTint：按钮的背景颜色。
   • app:cornerRadius：按钮的圆角半径。
   • app:icon：按钮上的图标。
   • app:iconGravity：图标的位置（例如，文本的左边、右边、上方、下方）。
   • app:iconTint：图标的颜色。
   • app:iconPadding：图标和文本之间的内边距。

3. 按钮类型：

   • app:style：按钮的样式，可以是 @style/Widget.MaterialComponents.Button 或其他自定义样式。

4. 点击事件：

   • android:clickable：指定按钮是否可以点击。
   • android:enabled：指定按钮是否可用。
   • android:onClick：指定点击按钮时要调用的方法。

5. 阴影：

   • app:strokeColor：按钮的边框颜色。
   • app:strokeWidth：按钮的边框宽度。
   • app:elevation：按钮的海拔高度（用于阴影效果）。

6. 大小和内边距：

   • android:layout_width：按钮的宽度。
   • android:layout_height：按钮的高度。
   • android:padding：按钮的内边距。
   • android:paddingStart 和 android:paddingEnd：按钮的起始和结束内边距。