自动化助手

    编辑框

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

    编辑框-edit

    原生类型:{androidx.appcompat.widget.AppCompatEditText}

    这是一种小巧的输入框

    edit比input输入框更加小巧一些，是安卓原生拓展库的组件，而input输入框是M3风格的组件。

    <ui>
    <statusbar />
    <linear dir="h" w="max">
        <edit text="我是" textColor="#57965C" />
        <edit text="一个" />
        <edit text="简约的" textColor="#C94F4F" />
        <edit text="编辑框" textColor="#3574F0" />
    </linear>
</ui>

    一、常用属性

    提示 - 提示文本

    设置提示文本

    <界面>
    <状态条 />
    <编辑框 提示="提示文本" 宽="最大" />
</界面>

    文本 - 文本

    设置文本

    <界面>
    <状态条 />
    <编辑框 文本="我是文本" 宽="最大" />
</界面>

    文本颜色 - 文本颜色

    设置文本颜色

    <界面>
    <状态条 />
    <编辑框 文本="我是文本" 文本颜色="#C94F4F" 宽="最大" />
</界面>

    默认 - 默认文本

    设置默认文本

    <界面>
    <状态条 />
    <编辑框 默认="默认文本" 宽="最大" />
</界面>

    类型 - 输入内容的类型

    输入内容的类型

    可选值: 密码:密码, 数字:数字, 手机号:手机号

    <界面>
    <状态条 />
    <!--密码类型-->
    <编辑框 文本="123456???" 类型="密码" 宽="最大" />
    <!--数字类型-->
    <编辑框 文本="123" 类型="数字" 宽="最大" />
    <!--手机号码类型-->
    <编辑框 文本="15047070177" 类型="电话" 宽="最大" />
</界面>

    尺寸 - 文本尺寸

    设置文本尺寸

    <界面>
    <状态条 />
    <编辑框 文本="文本尺寸:10" 文本尺寸="10" 宽="最大" />
    <编辑框 文本="文本尺寸:15" 文本尺寸="15" 宽="最大" />
</界面>

    最小宽度 - 最小宽度

    设置最小宽度

    单位:dp

    <界面>
    <状态条 />
    <编辑框 背景颜色="#5557965C" 最小宽度="200" 文本="最小宽度:200" />
    <编辑框 背景颜色="#55C94F4F" 最小宽度="250" 文本="最小宽度:250" />
</界面>

    最小高度 - 最小高度

    设置最小高度

    单位:dp

    <界面>
    <状态条 />
    <线性布局 方向="横向" 重力="中间" 宽="最大">
        <编辑框 背景颜色="#5557965C" 最小高度="100" 文本="最小高度:100" />
        <编辑框 背景颜色="#55C94F4F" 最小高度="150" 文本="最小高度:150" />
    </线性布局>
</界面>

    重力 - 布局重力

    设置布局重力

    <界面>
    <状态条 />
    <!--为了演示效果，宽度设置到最大 w=max -->
    <编辑框 重力="开始|中间" 文本="我在左边" 宽="最大" />
    <编辑框 重力="中间" 文本="我在中间" 宽="最大" />
    <编辑框 重力="结束|中间" 文本="我在右边" 宽="最大" />
</界面>

    内边距 - 布局内边距

    设置布局内边距

    <界面>
    <状态条 />
    <编辑框 背景颜色="#5557965C" 内边距="10,0,20,30" 文本="看我内边距" />
</界面>

    背景颜色 - 背景颜色

    设置背景颜色

    <界面>
    <状态条 />
    <编辑框 背景颜色="#5557965C" 文本="看我背景颜色" 宽="最大" />
    <编辑框 背景颜色="#55C94F4F" 文本="看我背景颜色" 宽="最大" />
    <编辑框 背景颜色="#553574F0" 文本="看我背景颜色" 宽="最大" />
</界面>

    背景图片 - 背景图片

    设置背景图片

    <界面>
    <状态条 />
    <编辑框 背景图片="example/$ui - 交互界面/06.edit-编辑框/img/bg-edit.png"
        文本="看我背景图片" 文本颜色="#FFFFFF" 宽="最大" />
</界面>

    二、常用函数

    获取文字()

    获取输入框内容

    • 返回 : {string} 内容
    //解析布局,获得界面对象
定义 界面 = $界面.解析布局("./主界面.xml");
//获取控件
定义 编辑框 = 界面.找控件("我的编辑框");
//获取输入框内容
定义 内容 = 编辑框.获取文字();
//注意:'获得文字()'函数也可以写成'获得文本()'函数

    设置错误(提示)

    设置错误提示

    • 参数 : 提示 {string} 错误提示信息
    //解析布局,获得界面对象
定义 界面 = $界面.解析布局("./主界面.xml");
//获取控件
定义 编辑框 = 界面.找控件("我的编辑框");
//设置错误提示
编辑框.设置错误("输入内容不能为空");

    设置文字(文本)

    设置文字

    • 参数 : 文本 {string} 文字内容
    //解析布局,获得界面对象
定义 界面 = $界面.解析布局("./主界面.xml");
//获取控件
定义 编辑框 = 界面.找控件("我的编辑框");
//设置文字
编辑框.设置文字("新的内容");
//注意:'设置文字()'函数也可以写成'设置文本()'函数

    监听文本改变(回调)

    监听文本改变

    • 参数 : 回调 {(文本,开始,之前,数量)=>{}} 监听回调
    • 版本 : 1.8.0
    //解析布局,获得界面对象
定义 界面 = $界面.解析布局("./主界面.xml");
//获取控件
定义 输入框 = 界面.找控件("我的输入框");
//监听文本改变
输入框.监听文本改变((文本,开始,之前,数量)=>{
    日志("文本改变了:"+文本);
});

    监听文本改变后(回调)

    监听文本改变后

    • 参数 : 回调 {(文本,开始,之前,数量)=>{}} 监听回调
    • 版本 : 1.8.0
    //解析布局,获得界面对象
定义 界面 = $界面.解析布局("./主界面.xml");
//获取控件
定义 输入框 = 界面.找控件("我的输入框");
//监听文本改变后
输入框.监听文本改变后((文本)=>{
    日志("文本改变了:"+文本);
});

    监听文本改变前(回调)

    监听文本改变前

    • 参数 : 回调 {(文本,开始,数量,之前)=>{}} 监听回调
    • 版本 : 1.8.0
    //解析布局,获得界面对象
定义 界面 = $界面.解析布局("./主界面.xml");
//获取控件
定义 输入框 = 界面.找控件("我的输入框");
//监听文本改变前
输入框.监听文本改变前((文本,开始,数量,之前)=>{
    日志("文本改变了:"+文本);
});

    设置提示(提示)

    设置提示

    • 参数 : 提示 {字符串} 提示文本
    • 版本 : 1.9.3
    //解析布局,获得界面对象
定义 界面 = $界面.解析布局("./主界面.xml");
//获取控件
定义 输入框 = 界面.找控件("我的输入框");
//设置提示
输入框.设置提示("提示信息");

    设置文本颜色(颜色)

    设置文本颜色

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

    设置文本尺寸(尺寸)

    设置文本尺寸

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

    设置文字尺寸(尺寸)

    设置最小宽度(宽度)

    设置最小宽度

    • 参数 : 宽度 {数字} 最小宽度
    • 版本 : 1.9.3
    //解析布局,获得界面对象
定义 界面 = $界面.解析布局("./主界面.xml");
//获取控件
定义 输入框 = 界面.找控件("我的输入框");
//设置最小宽度
输入框.设置最小宽度(100);

    设置最小高度(高度)

    设置最小高度

    • 参数 : 高度 {数字} 最小高度
    • 版本 : 1.9.3
    //解析布局,获得界面对象
定义 界面 = $界面.解析布局("./主界面.xml");
//获取控件
定义 输入框 = 界面.找控件("我的输入框");
//设置最小高度
输入框.设置最小高度(100);

    设置重力(重力)

    设置重力

    • 参数 : 重力 {字符串} 重力
    • 版本 : 1.9.3
    //解析布局,获得界面对象
定义 界面 = $界面.解析布局("./主界面.xml");
//获取控件
定义 输入框 = 界面.找控件("我的输入框");
//设置重力
输入框.设置重力("结束|中间");

    设置背景颜色(颜色)

    设置背景颜色

    • 参数 : 颜色 {字符串} 背景颜色
    • 版本 : 1.9.3
    //解析布局,获得界面对象
定义 界面 = $界面.解析布局("./主界面.xml");
//获取控件
定义 输入框 = 界面.找控件("我的输入框");
//设置背景颜色
输入框.设置背景颜色("#3574F0");