编辑框

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

编辑框-edit

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

这是一种小巧的输入框

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

一、常用属性

提示 - 提示文本

设置提示文本

<编辑框 提示="请输入内容" />

文本 - 文本

设置文本

<编辑框 文本="默认内容" />

文本颜色 - 文本颜色

设置文本颜色

<编辑框 文本颜色="#FF0000" />

默认 - 默认文本

设置默认文本

<编辑框 默认="请输入内容" />

类型 - 输入内容的类型

输入内容的类型

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

<编辑框 类型="密码" />

尺寸 - 文本尺寸

设置文本尺寸

<编辑框 尺寸="16" />

最小宽度 - 最小宽度

设置最小宽度

单位:dp

<编辑框 最小宽度="100" />

最小高度 - 最小高度

设置最小高度

单位:dp

<编辑框 最小高度="100" />

重力 - 布局重力

设置布局重力

<编辑框 重力="" />

内边距 - 布局内边距

设置布局内边距

<编辑框 内边距="0,0,0,0" />

背景颜色 - 背景颜色

设置背景颜色

<编辑框 背景颜色="#FF0000" />

背景图片 - 背景图片

设置背景图片

<编辑框 背景图片="/资源/图片01.png" />

二、常用函数

获取文字()

获取输入框内容

  • 返回 : {string} 内容

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

设置错误(提示)

设置错误提示

  • 参数 : 提示 {string} 错误提示信息

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

设置文字(文本)

设置文字

  • 参数 : 文本 {string} 文字内容

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

监听文本改变(回调)

监听文本改变

  • 参数 : 回调 {(文本,开始,之前,数量)=>{}} 监听回调

  • 版本 : 1.8.0

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

监听文本改变后(回调)

监听文本改变后

  • 参数 : 回调 {(文本,开始,之前,数量)=>{}} 监听回调

  • 版本 : 1.8.0

//解析布局,获得界面对象
定义 界面 = $界面.解析布局("./主界面.xml");
//获取控件
定义 输入框 = 界面.找控件("我的输入框");
//监听文本改变后
输入框.监听文本改变后((文本)=>{
    日志("文本改变了:"+文本);
});

监听文本改变前(回调)

监听文本改变前

  • 参数 : 回调 {(文本,开始,数量,之前)=>{}} 监听回调

  • 版本 : 1.8.0

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