Android开发中如何通过XML为Button设置自定义边框样式

你的现有代码没法稳定实现预期的自定义边框效果，有几个必踩的坑，调整后才能正常显示。

现存问题 #

• 自定义shape缺少填充配置
  你写的button_border.xml只定义了圆角和描边，没加<solid>填充标签，这种情况下shape内部默认是完全透明的，最终显示只会剩下10dp粗的白边，按钮中间会透出下层布局的内容，没有正常按钮的填充底色。
• Material主题默认染色会覆盖自定义背景
  现在Android项目默认用的AppCompat/Material主题下，Button默认带backgroundTint属性，会自动给你设置的自定义背景叠上主题色，直接把你写的描边、透明效果盖掉，这是自定义Button背景最常见的坑。
• 描边参数不合理
  你设置的描边宽度是10dp，对应圆角半径只有15dp，大宽度描边配小圆角会出现边角裁切毛边、显示不规整的问题；而且10dp的描边过粗，会大量挤占按钮内部的文字显示空间，视觉效果非常怪异。

调整方法 #

1. 修改shape边框文件 #

补上<solid>填充标签，要空心透明按钮就填透明色，要实心按钮就填对应底色，同时把描边宽度调到合理范围，示例：

<?xml version="1.0" encoding="utf-8"?>
<shape android:shape="rectangle"  xmlns:android="http://schemas.android.com/apk/res/android">
    <!-- 空心按钮填@android:color/transparent，实心按钮替换成你要的底色 -->
    <solid android:color="@android:color/transparent"/>
    <corners android:radius="15dp"/>
    <!-- 常规按钮描边建议1-2dp即可 -->
    <stroke android:width="2dp" android:color="@color/white"/>
</shape>

2. 修改布局中的Button配置 #

给Button加上app:backgroundTint="@null"关掉默认的主题染色，同时补充水平内边距避免文字被描边遮挡：

<Button
   android:id="@+id/clearSelectionButton"
   android:layout_width="147dp"
   android:layout_height="match_parent"
   android:background="@drawable/button_border"
   android:text="@string/clear_selection"
   android:textColor="@color/white"
   app:backgroundTint="@null"
   android:paddingHorizontal="12dp"/>

如果加了backgroundTint属性还是不生效，可以直接把布局里的Button替换为androidx.appcompat.widget.AppCompatButton，绕开MaterialButton的默认样式干扰。

内容的提问来源于stack exchange，提问作者Apimar