AIGame
API英文文档
API中文文档
UI英文文档
UI中文文档
API英文文档
API中文文档
UI英文文档
UI中文文档

输入框

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

输入框-input

组件原生类型:{com.google.android.material.textfield.TextInputEditText}

布局原生类型:{com.google.android.material.textfield.TextInputLayout}

输入框：一个可以输入文字的地方。

一、基础用法

二、常用属性

风格 - 样式

设置样式

可选:填充,轮廓

<输入框 风格="轮廓" 文本="轮廓样式" 宽="最大" />
<输入框 风格="填充" 文本="填充样式" 宽="最大" />

提示 - 提示文本

提示文本

<输入框 提示="请输入内容" 宽="最大" />

文本 - 文本

设置文本

<输入框 文本="默认内容" 宽="最大" />

默认 - 文本

设置文本

<输入框 默认="默认内容" 宽="最大" />

字数 - 字数限制

设置字数限制

<输入框 字数="50" 宽="最大" />

最大行数 - 最大行数

最大行数

<输入框 最大行数="3" 宽="最大" />

最小行数 - 最少行数

最少行数

<输入框 最小行数="3" 宽="最大" />

帮助 - 帮助文字

帮助文字

<输入框 帮助="可以输入中文" 宽="最大" />

前缀 - 前缀

设置前缀

<输入框 前缀="电话:" 文本="110" 宽="最大" />

后缀 - 后缀

设置后缀

<输入框 后缀="@qq.com" 文本="2450099002" 宽="最大" />

类型 - 输入类型

设置输入类型

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

<输入框 文本="123456" 类型="密码" 宽="最大" />

背景颜色 - 背景颜色

设置背景颜色

<输入框 背景颜色="#55C94F4F" 宽="最大" />

背景图片 - 背景图片

设置背景图片

<输入框 背景图片="/资源/图片01.png" 宽="最大" />

主题颜色 - 主题颜色

设置主题颜色

<输入框 主题颜色="#553574F0" 文本="主题颜色" 宽="最大" />

文本颜色 - 文本颜色

设置文本颜色

<输入框 文本="文本颜色" 文本颜色="#C94F4F" 宽="最大" />

边框颜色 - 边框颜色

设置边框颜色

<输入框 边框颜色="#FF0000" 宽="最大" />

边框宽度 - 边框宽度

设置边框宽度

<输入框 边框宽度="5" 宽="最大" />

弧度 - 弧度

设置弧度

<输入框 弧度="16" 宽="最大" />
<输入框 弧度="0,16" 宽="最大" />
<!--上左,上右,下左,下右-->
<输入框 弧度="20,5,5,20" 宽="最大" />

内边距 - 布局内边距

设置布局内边距

<输入框 内边距="20,5,5,20" 宽="最大" />

重力 - 布局重力

布局重力

<输入框 重力="中" 宽="最大" />

三、常用函数

设置提示(提示)

设置预提示

  • 参数 : 提示 {string} 提示文本

//解析布局,获得界面对象
定义 界面 = $界面.解析布局("./主界面.xml");
//获取控件
定义 输入框 = 界面.找控件("我的输入框");
//设置预提示
输入框.设置提示("请输入名字");

设置背景颜色(颜色)

设置背景颜色

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

//解析布局,获得界面对象
定义 界面 = $界面.解析布局("./主界面.xml");
//获取控件
定义 输入框 = 界面.找控件("我的输入框");
//设置背景颜色
输入框.设置背景颜色("#ff0000");//也可以是M3主题动态色，例如:主题主颜色

设置边框颜色(颜色)

设置边框颜色

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

  • 版本 : 1.5.3

//解析布局,获得界面对象
定义 界面 = $界面.解析布局("./主界面.xml");
//获取控件
定义 输入框 = 界面.找控件("我的输入框");
//设置边框颜色
输入框.设置边框颜色("#ff0000");//也可以是M3主题动态色，例如:主题主颜色

设置边框宽度(宽度)

设置边框宽度

  • 参数 : 宽度 {int} 边框宽度

  • 版本 : 1.5.3

//解析布局,获得界面对象
定义 界面 = $界面.解析布局("./主界面.xml");
//获取控件
定义 输入框 = 界面.找控件("我的输入框");
//设置边框宽度
输入框.设置边框宽度(5);//单位:dp

设置弧度(左上, 上右, 左下, 右下)

设置弧度

  • 参数 : 左上 {float} 左上角弧度

  • 参数 : 上右 {float} 右上角弧度

  • 参数 : 左下 {float} 左下角弧度

  • 参数 : 右下 {float} 右下角弧度

  • 版本 : 1.5.3

//解析布局,获得界面对象
定义 界面 = $界面.解析布局("./主界面.xml");
//获取控件
定义 输入框 = 界面.找控件("我的输入框");
//设置边框弧度
输入框.设置弧度(20,20,5,5);//单位:dp

设置文字(文本)

设置文字

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

//解析布局,获得界面对象
定义 界面 = $界面.解析布局("./主界面.xml");
//获取控件
定义 输入框 = 界面.找控件("我的输入框");
//设置文本
输入框.设置文字("我是文字");

获取文字()

获取输入框内容

  • 返回 : {string} 内容

//解析布局,获得界面对象
定义 界面 = $界面.解析布局("./主界面.xml");
//获取控件
定义 输入框 = 界面.找控件("我的输入框");
//获得文本
定义 文本 = 输入框.获取文字();

设置错误(提示)

设置异常信息提示

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

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

获取编辑框()

获取文本输入编辑框对象

  • 返回 : {TextInputEditText} 编辑框对象

//解析布局,获得界面对象
定义 界面 = $界面.解析布局("./主界面.xml");
//获取控件
定义 输入框 = 界面.找控件("我的输入框");
//获得文本输入编辑框对象
定义 编辑框 = 输入框.获取编辑框();

监听文本改变(回调)

监听文本改变

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

  • 版本 : 1.8.0

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

监听文本改变后(回调)

监听文本改变后

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

  • 版本 : 1.8.0

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

监听文本改变前(回调)

监听文本改变前

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

  • 版本 : 1.8.0

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

监听焦点改变(回调)

监听焦点改变

  • 参数 : 回调 {(有焦点)=>{}} 监听回调

  • 版本 : 1.8.2

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