Android shape corners topLeftRadius如何实现XML左上角圆角效果

在Android的XML drawable资源中，我们可以通过shape标签定义各种形状背景，其中corners节点的topLeftRadius属性就是用来单独设置左上角圆角半径的核心属性，无需依赖其他圆角属性就能实现仅左上角带圆角的效果。

topLeftRadius基础使用语法

topLeftRadius属性的值需要是尺寸单位，常用的单位有dp、px，推荐使用dp单位保证不同屏幕密度的显示一致性。基础的使用结构如下：

<?xml version="1.0" encoding="utf-8"?>
<shape xmlns:android="http://schemas.android.com/apk/res/android"
    android:shape="rectangle">
    <!-- 设置左上角圆角半径 -->
    <corners android:topLeftRadius="8dp" />
    <!-- 设置背景颜色 -->
    <solid android:color="#FF6200EE" />
</shape>

上述代码定义了一个矩形shape，仅左上角设置了8dp的圆角，其余三个角都是直角，背景色为紫色。如果只需要左上角圆角，不需要设置其他corners属性，避免默认值覆盖topLeftRadius的效果。

属性的搭配注意事项

corners节点还有其他三个圆角属性：android:topRightRadius、android:bottomLeftRadius、android:bottomRightRadius，如果同时设置多个属性，可以灵活组合出不同圆角效果：

• 仅设置topLeftRadius：只有左上角圆角，其余直角
• 设置topLeftRadius和topRightRadius：顶部两个角圆角，底部直角
• 设置topLeftRadius和bottomLeftRadius：左侧两个角圆角，右侧直角

需要注意的是，如果设置了android:radius属性，这个属性会统一设置四个角的圆角半径，会覆盖单独设置的其他圆角属性值，因此如果需要单独设置左上角圆角，不要添加radius属性。

常见问题排查

很多开发者会遇到设置了topLeftRadius但没有生效的情况，常见原因有以下几点：

• 同时设置了radius属性，导致topLeftRadius被覆盖，去掉radius属性即可
• shape的shape属性不是rectangle，topLeftRadius只对矩形形状生效，其他形状如oval不需要设置圆角
• 控件设置了padding或者背景的层级问题，检查控件是否还有其他背景覆盖了这个shape

完整使用示例

下面是一个完整的左上角圆角背景示例，应用到TextView上：

<!-- res/drawable/left_top_radius_bg.xml -->
<?xml version="1.0" encoding="utf-8"?>
<shape xmlns:android="http://schemas.android.com/apk/res/android"
    android:shape="rectangle">
    <corners android:topLeftRadius="12dp" />
    <solid android:color="#FF03DAC5" />
    <stroke
        android:width="1dp"
        android:color="#FF000000" />
</shape>

在布局文件中引用这个drawable作为TextView的背景：

<TextView
    android:layout_width="200dp"
    android:layout_height="80dp"
    android:background="@drawable/left_top_radius_bg"
    android:gravity="center"
    android:text="左上角圆角背景"
    android:textColor="#FFFFFFFF" />

运行后可以看到TextView只有左上角是12dp的圆角，其余三个角保持直角，边框为1dp黑色，背景为青色，符合预期效果。

Android_shapecornerstopLeftRadiusXML_drawable修改时间：2026-06-22 13:00:55