卡片布局#

• 更新时间:2025-12-02 10:12:45

卡片布局-card

是布局父类的(XLayout)的子类,因此可以使用XLayout的所有方法,但需要注意卡片布局本身是帧布局的子类，因此建议在卡片布局中加入线性布局来使用。

原生类型:{com.google.android.material.card.MaterialCardView}

一、常用属性#

风格 - 风格#

设置风格

可选值:填充,轮廓,阴影

<卡片 风格="轮廓" />

可点击 - 是否可以点击#

设置是否可以点击

<卡片 可点击="是" />

涟漪颜色 - 涟漪颜色#

设置涟漪颜色

<卡片 涟漪颜色="#FF0000" />

弧度 - 弧度#

设置弧度

单位:dp

<卡片 弧度="10" />

最小宽度 - 最小宽度#

设置最小宽度

单位:dp

<卡片 最小宽度="20" />

最小高度 - 最小高度#

设置最小高度

单位:dp

<卡片 最小高度="20" />

背景颜色 - 背景颜色#

设置背景颜色

<卡片 背景颜色="#57965C" />

填充颜色 - 填充颜色#

设置填充颜色

背景颜色会无视卡片的圆弧角度，填充颜色会填充整个卡片，并且保证卡片的角度和样式

<卡片 填充颜色="#57965C" />

背景图片 - 背景图片#

设置背景图片

<卡片 背景图片="资源/图片01.png" />

内边距 - 内边距#

设置内边距

参数顺序:左,上,右,下(单位:dp)

<卡片 内边距="0,0,0,0" />

重力 - 重力#

设置重力

卡片只能设置前景重力，不要求安卓版本。

<卡片 重力="中" />

二、子控件属性表#

被卡片布局包裹的子控件可以使用如下属性：

三、常用函数#

设置可点击(可点击)#

设置可点击

• 参数 : 可点击 {布尔值} 是否可点击

• 版本 : 1.8.2

//解析布局,获得界面对象
定义 界面 = $界面.解析布局("./资源/主界面.xml");
//获取控件
定义 卡片 = 界面.找控件("我的卡片");
//设置可点击
卡片.设置可点击(是);

设置涟漪色(颜色)#

设置涟漪色

• 参数 : 颜色 {字符串} 颜色字符串

• 版本 : 1.8.2

//解析布局,获得界面对象
定义 界面 = $界面.解析布局("./资源/主界面.xml");
//获取控件
定义 卡片 = 界面.找控件("我的卡片");
//设置涟漪色
卡片.设置涟漪色("#FF0000");

设置涟漪色(颜色)#

设置涟漪色

• 参数 : 颜色 {数字} 颜色值

• 版本 : 1.8.2

//解析布局,获得界面对象
定义 界面 = $界面.解析布局("./资源/主界面.xml");
//获取控件
定义 卡片 = 界面.找控件("我的卡片");
//设置涟漪色
卡片.设置涟漪色($颜色.红色);

设置背景颜色(颜色)#

设置背景颜色

• 参数 : 颜色 {数字} 文本颜色值

• 版本 : 1.8.2

//解析布局,获得界面对象
定义 界面 = $界面.解析布局("./资源/主界面.xml");
//获取控件
定义 卡片 = 界面.找控件("我的卡片");
//设置背景颜色
卡片.设置背景颜色($颜色.红色);

设置背景颜色(颜色)#

设置背景颜色

• 参数 : 颜色 {字符串} 颜色字符串

• 版本 : 1.8.2

//解析布局,获得界面对象
定义 界面 = $界面.解析布局("./资源/主界面.xml");
//获取控件
定义 卡片 = 界面.找控件("我的卡片");
//设置背景颜色
卡片.设置背景颜色("#1E1F22");

设置填充色(颜色)#

设置填充色

• 参数 : 颜色 {数字} 颜色值

• 版本 : 1.8.2

//解析布局,获得界面对象
定义 界面 = $界面.解析布局("./资源/主界面.xml");
//获取控件
定义 卡片 = 界面.找控件("我的卡片");
//设置填充色
卡片.设置填充色($颜色.红色);

设置填充色(颜色)#

设置填充色

• 参数 : 颜色 {字符串} 颜色字符串

• 版本 : 1.8.2

//解析布局,获得界面对象
定义 界面 = $界面.解析布局("./资源/主界面.xml");
//获取控件
定义 卡片 = 界面.找控件("我的卡片");
//设置填充色
卡片.设置填充色("#FF0000");

设置弧度(弧度)#

设置弧度

• 参数 : 弧度 {数字} 弧度(单位:dp)

• 版本 : 1.8.2

//解析布局,获得界面对象
定义 界面 = $界面.解析布局("./资源/主界面.xml");
//获取控件
定义 卡片 = 界面.找控件("我的卡片");
//设置弧度
卡片.设置弧度(15);