编辑框

更新时间:2026-06-15 07:53:03

编辑框-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" 宽="最大" />
</界面>

存储关键字 - 应用内存储

应用内存储

通过storeKey(存储关键字)指定一个存储字符串的关键字，获取值时可以直接通过$storage($存储)获取字符串。

注意：不同的控件存储的类型不同，对于本控件(编辑框)则存储的是字符串类型，表达当前输入的内容

<!-- 你必须在ui(界面)节点中通过store(存储)指定$storage($存储)的命名空间，等价于使用代码：let storage = $storage.create("MyAppEdit"); -->
<界面 存储="MyAppEdit">
    <状态栏 />
    <!-- 使用storeKey(存储关键字)属性，指定关键字，等价于使用代码：let data = $storage.create("MyAppEdit").getStr("我爱吃饭"); -->
    <!-- 使用storeDef(存储默认值)属性，指定关键字，等价于使用代码：let data = $storage.create("MyAppEdit").getStr("我爱吃饭","吃饭"); -->
    <编辑框 存储关键字="eatFoodStr" 存储默认值="我爱吃饭" 文本="吃饭" />
    <编辑框 存储关键字="playGameStr" 存储默认值="我爱游戏" 文本="游戏" />
</界面>

如果我们已经配置好了应用内存储，则可以直接获取数据：

注意：一、要使用应用内存储，必须在ui(界面)节点指定属性store(存储)的值，该值指定存储的命名空间；二、不是所有的控件都支持应用内存储；三、不同的控件存储的数据类型可能都不一致，例如：输入类型的控件存储的是字符串类型，开关、多选框存储的就是布尔类型的数据。

//创建(或者加载)存储对象
let storage = $storage.create("MyAppEdit");//名称要一致
//获取数据
let data = storage.getStr("我爱吃饭","未必");//数据类型是字符串

二、常用函数

获取文字()

获取输入框内容

返回 : {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");

#编辑框

#一、常用属性

#提示 - 提示文本

#文本 - 文本

#文本颜色 - 文本颜色

#默认 - 默认文本

#类型 - 输入内容的类型

#尺寸 - 文本尺寸

#最小宽度 - 最小宽度

#最小高度 - 最小高度

#重力 - 布局重力

#内边距 - 布局内边距

#背景颜色 - 背景颜色

#背景图片 - 背景图片

#存储关键字 - 应用内存储

#二、常用函数

#获取文字()

#设置错误(提示)

#设置文字(文本)

#监听文本改变(回调)

#监听文本改变后(回调)

#监听文本改变前(回调)

#设置提示(提示)

#设置文本颜色(颜色)

#设置文本尺寸(尺寸)

#设置文字尺寸(尺寸)

#设置最小宽度(宽度)

#设置最小高度(高度)

#设置重力(重力)

#设置背景颜色(颜色)

编辑框