自动化助手

    小片

    • 更新时间:2026-03-14 11:42:28

    小片-chip

    原生类型:{com.google.android.material.chip.Chip}

    可以当作小按钮来使用，也可以当作多选框来使用

    小片：可以用来显示一些小标签什么的，还是蛮好看的。

    不过，也可以用来作为按钮使用。

    一、常用属性

    文本 - 文本

    设置文本

    <界面>
    <状态条 />
    <小片 文本="我是文本" />
</界面>

    图标 - 图标

    设置图标

    <界面>
    <状态条 />
    <小片 图标="ic_access_alarms_fill" 文本="看我图标" />
</界面>

    图标颜色 - 图标颜色

    设置图标颜色

    <界面>
    <状态条 />
    <小片 图标="ic_access_alarms_fill" 图标颜色="#57965C" 文本="看我图标颜色" />
</界面>

    文本颜色 - 文本颜色

    设置文本颜色

    <界面>
    <状态条 />
    <小片 文本="看我颜色" 文本颜色="#C94F4F" />
</界面>

    文本尺寸 - 文本尺寸

    设置文本尺寸

    <界面>
    <状态条 />
    <小片 文本="看我尺寸" 文本尺寸="10" />
    <小片 文本="看我尺寸" 文本尺寸="15" />
    <小片 文本="看我尺寸" 文本尺寸="18" />
</界面>

    弧度 - 弧度

    设置弧度

    <界面>
    <状态条 />
    <小片 弧度="5" 文本="看我弧度" />
    <小片 弧度="8" 文本="看我弧度" />
    <小片 弧度="11" 文本="看我弧度" />
</界面>

    可选中 - 可选中

    设置可选中

    <界面>
    <状态条 />
    <小片 可选中="是" 文本="我可以选中" />
</界面>

    选中 - 是否选中

    设置是否选中

    <界面>
    <状态条 />
    <小片 可选中="是" 文本="我被选中了" 选中="是" />
    <小片 可选中="是" 文本="我没被选中" 选中="否" />
</界面>

    显示选中图标 - 显示选中图标

    设置显示选中图标

    <界面>
    <状态条 />
    <小片 可选中="是" 文本="我可以选中" 显示选中图标="是" 选中="是" />
</界面>

    选中图标颜色 - 选中图标颜色

    设置选中图标颜色

    <界面>
    <状态条 />
    <小片 可选中="是" 文本="我可以选中" 显示选中图标="是" 选中="是"
        选中图标颜色="#C94F4F" />
</界面>

    可点击 - 是否可以点击

    设置是否可以点击

    <界面>
    <状态条 />
    <小片 可点击="是" 文本="我可以被点击" />
    <小片 可点击="否" 文本="我不能被点击" />
</界面>

    显示关闭按钮 - 是否显示关闭按钮

    设置是否显示关闭按钮

    <界面>
    <状态条 />
    <小片 文本="我可以被点击" 显示关闭按钮="是" />
</界面>

    关闭按钮颜色 - 关闭按钮的颜色

    设置关闭按钮的颜色

    <界面>
    <状态条 />
    <小片 关闭按钮颜色="#C94F4F" 文本="我可以被点击" 显示关闭按钮="是" />
</界面>

    涟漪颜色 - 涟漪颜色

    设置涟漪颜色

    <界面>
    <状态条 />
    <小片 可点击="是" 文本="涟漪颜色" 涟漪颜色="#3574F0" />
</界面>

    主题颜色 - 主题颜色

    设置主题颜色

    <界面>
    <状态条 />
    <小片 主题颜色="#3574F0" 文本="主题颜色" />
    <小片 主题颜色="#57965C" 文本="主题颜色" />
    <小片 主题颜色="#C94F4F" 文本="主题颜色" />
</界面>

    最小宽度 - 最小宽度

    设置最小宽度

    单位:dp

    <界面>
    <状态条 />
    <小片 文本="60" 最小宽度="60" />
    <小片 文本="100" 最小宽度="100" />
    <小片 文本="130" 最小宽度="130" />
</界面>

    最小高度 - 最小高度

    设置最小高度

    单位:dp

    <界面>
    <状态条 />
    <线性布局 宽="最大" 方向="横向" 重力="中间|下">
        <!--对于小片而言，重力属性几乎没有任何效果-->
        <小片 文本="60" 最小高度="60" 重力="下" />
        <小片 文本="100" 最小高度="100" 重力="下" />
        <小片 文本="130" 最小高度="130" 重力="下" />
    </线性布局>
</界面>

    内边距 - 内边距

    设置内边距

    单位:dp

    <界面>
    <状态条 />
    <线性布局 宽="最大" 方向="横向">
        <小片 内边距="10" 文本="10" />
        <小片 内边距="20" 文本="20" />
        <小片 内边距="30" 文本="30" />
    </线性布局>
</界面>

    二、常用函数

    设置选中(状态)

    设置选中状态

    • 参数 : 状态 {布尔值} 选中状态
    //解析布局,获取ui界面对象
定义 界面 = $界面.解析布局("./主界面.xml");
//获取控件
定义 小片 = 界面.找控件("我的小片");
//设置选中状态
小片.设置选中(真);

    是选中的()

    判断是否选中

    • 返回 : {布尔值} 是否选中
    //解析布局,获取ui界面对象
定义 界面 = $界面.解析布局("./主界面.xml");
//获取控件
定义 小片 = 界面.找控件("我的小片");
//判断是否选中
如果 (小片.是选中的()) {
    信息("选中");
}否则{
    信息("未选中");
}

    关闭事件(回调)

    监听关闭事件

    • 参数 : 回调 {(视图)=>{}} 关闭回调
    //解析布局,获取ui界面对象
定义 界面 = $界面.解析布局("./主界面.xml");
//获取控件
定义 小片 = 界面.找控件("我的小片");
//监听关闭事件
小片.关闭事件(函数(){
    信息("我被关闭了");
});

    选中事件(回调)

    监听选中事件

    • 参数 : 回调 {(选中状态)=>{}} 选中回调
    //解析布局,获取ui界面对象
定义 界面 = $界面.解析布局("./主界面.xml");
//获取控件
定义 小片 = 界面.找控件("我的小片");
//监听选中事件
小片.选中事件((选中状态)=>{
    如果 (选中状态) {
        信息("选中");
    }否则{
        信息("未选中");
    }
});

    设置文本(文本)

    设置文本

    • 参数 : 文本 {字符串} 文字
    //解析布局,获取ui界面对象
定义 界面 = $界面.解析布局("./主界面.xml");
//获取控件
定义 小片 = 界面.找控件("我的小片");
//设置文本
小片.设置文本("新的名字");

    获取文本()

    获得文本

    • 返回 : {字符串} 文本
    //解析布局,获取ui界面对象
定义 界面 = $界面.解析布局("./主界面.xml");
//获取控件
定义 小片 = 界面.找控件("我的小片");
//获得文本
定义 文本 = 小片.获取文本();
信息(文本);

    设置文本颜色(颜色)

    设置文本颜色

    • 参数 : 颜色 {字符串} 颜色
    //解析布局,获取ui界面对象
定义 界面 = $界面.解析布局("./主界面.xml");
//获取控件
定义 小片 = 界面.找控件("我的小片");
//设置文本颜色
小片.设置文本颜色("#3574F0");

    设置文本尺寸(尺寸)

    设置文本尺寸

    • 参数 : 尺寸 {数字} 尺寸
    //解析布局,获取ui界面对象
定义 界面 = $界面.解析布局("./主界面.xml");
//获取控件
定义 小片 = 界面.找控件("我的小片");
//设置文本尺寸
小片.设置文本尺寸(15);

    设置弧度(弧度)

    设置弧度

    • 参数 : 弧度 {数字} 弧度
    //解析布局,获取ui界面对象
定义 界面 = $界面.解析布局("./主界面.xml");
//获取控件
定义 小片 = 界面.找控件("我的小片");
//设置弧度
小片.设置弧度(15);

    设置图标(图标)

    设置图标

    • 参数 : 图标 {字符串} 图标
    //解析布局,获取ui界面对象
定义 界面 = $界面.解析布局("./主界面.xml");
//获取控件
定义 小片 = 界面.找控件("我的小片");
//设置图标
小片.设置图标("ic_favorite_border_fill");

    设置图标颜色(颜色)

    设置图标颜色

    • 参数 : 颜色 {字符串} 颜色
    //解析布局,获取ui界面对象
定义 界面 = $界面.解析布局("./主界面.xml");
//获取控件
定义 小片 = 界面.找控件("我的小片");
//设置图标颜色
小片.设置图标颜色("#3574F0");

    设置可选(可选)

    设置可选

    • 参数 : 可选 {布尔值} 是否可选
    //解析布局,获取ui界面对象
定义 界面 = $界面.解析布局("./主界面.xml");
//获取控件
定义 小片 = 界面.找控件("我的小片");
//设置可选
小片.设置可选(是);

    设置显示选中图标(显示)

    设置显示选中图标

    • 参数 : 显示 {布尔值} 是否显示
    //解析布局,获取ui界面对象
定义 界面 = $界面.解析布局("./主界面.xml");
//获取控件
定义 小片 = 界面.找控件("我的小片");
//设置显示选中图标
小片.设置显示选中图标(是);

    设置选中图标颜色(颜色)

    设置选中图标颜色

    • 参数 : 颜色 {字符串} 图标颜色
    //解析布局,获取ui界面对象
定义 界面 = $界面.解析布局("./主界面.xml");
//获取控件
定义 小片 = 界面.找控件("我的小片");
//设置选中图标颜色
小片.设置选中图标颜色("#57965C");

    设置可点击(可点击)

    设置可点击

    • 参数 : 可点击 {布尔值} 是否可以被点击
    //解析布局,获取ui界面对象
定义 界面 = $界面.解析布局("./主界面.xml");
//获取控件
定义 小片 = 界面.找控件("我的小片");
//设置可点击
小片.设置可点击(是);

    设置显示关闭按钮(显示)

    设置显示关闭按钮

    • 参数 : 显示 {布尔值} 是否显示关闭按钮
    //解析布局,获取ui界面对象
定义 界面 = $界面.解析布局("./主界面.xml");
//获取控件
定义 小片 = 界面.找控件("我的小片");
//设置显示关闭按钮
小片.设置显示关闭按钮(是);

    设置关闭图标颜色(颜色)

    设置关闭图标颜色

    • 参数 : 颜色 {字符串} 图标颜色
    //解析布局,获取ui界面对象
定义 界面 = $界面.解析布局("./主界面.xml");
//获取控件
定义 小片 = 界面.找控件("我的小片");
//设置关闭图标颜色
小片.设置关闭图标颜色("#57965C");

    设置涟漪颜色(颜色)

    设置涟漪颜色

    • 参数 : 颜色 {字符串} 涟漪颜色
    //解析布局,获取ui界面对象
定义 界面 = $界面.解析布局("./主界面.xml");
//获取控件
定义 小片 = 界面.找控件("我的小片");
//设置涟漪颜色
小片.设置涟漪颜色("#57965C");

    设置主题颜色(颜色)

    设置主题颜色

    • 参数 : 颜色 {字符串} 主题颜色
    //解析布局,获取ui界面对象
定义 界面 = $界面.解析布局("./主界面.xml");
//获取控件
定义 小片 = 界面.找控件("我的小片");
//设置主题颜色
小片.设置主题颜色("#57965C");

    设置最小宽度(宽度)

    设置最小宽度

    • 参数 : 宽度 {数字} 最小宽度
    //解析布局,获取ui界面对象
定义 界面 = $界面.解析布局("./主界面.xml");
//获取控件
定义 小片 = 界面.找控件("我的小片");
//设置最小宽度
小片.设置最小宽度(15);

    设置最小高度(高度)

    设置最小高度

    • 参数 : 高度 {数字} 最小宽度
    //解析布局,获取ui界面对象
定义 界面 = $界面.解析布局("./主界面.xml");
//获取控件
定义 小片 = 界面.找控件("我的小片");
//设置最小高度
小片.设置最小高度(15);

    设置内边距(左, 上, 右, 下)

    设置内边距

    • 参数 : 左 {数字} 左边距
    • 参数 : 上 {数字} 上边距
    • 参数 : 右 {数字} 右边距
    • 参数 : 下 {数字} 下边距
    //解析布局,获取ui界面对象
定义 界面 = $界面.解析布局("./主界面.xml");
//获取控件
定义 小片 = 界面.找控件("我的小片");
//设置内边距
小片.设置内边距(15,15,15,15);