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

下拉框

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

下拉框-drop

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

下拉框类似于一个小菜单，点一下才会展开让你选，核心用途就是帮你方便、规范地挑东西。

一、基础用法

<ui>
    <statusbar />
    <linear w="max" padding="15" gravity="center" h="max">
        <drop id="mDrop" w="max">
            <!-- 添加选项 -->
            <item text="吃饭" />
            <item text="睡觉" />
            <item text="电影" />
        </drop>
    </linear>
</ui>
//解析布局
let ui = $ui.layout("ui.xml");
ui.show();//显示界面
//为下拉框添加选中事件
ui.id("mDrop").onCheck((value, index) => {
    info("选中下标为:" + index + "的元素:" + value);
});

二、常用属性

风格 - 样式

设置样式

可选:填充,边框(或轮廓)

<下拉框 风格="填充" />

提示 - 提示文字

设置提示文字

<下拉框 提示="请输入内容" />

默认 - 默认文字

设置默认文字

<下拉框 默认="请选择" />

项目 - 子选项

设置子选项

子选项使用项目标签，只有文本一个属性

<下拉框 宽="最大">
    <项目 文本="选项1" />
    <项目 文本="选项2" />
    <项目 文本="选项3" />
</下拉框>

主题颜色 - 主题颜色

设置主题颜色

<下拉框 主题颜色="#FF0000" />

文本颜色 - 文字的颜色

设置文字的颜色

<下拉框 文本颜色="#FF0000" />

隐藏图标 - 是否隐藏后面的倒三角图标

是否隐藏后面的倒三角图标

<下拉框 隐藏图标="是" />

重力 - 布局重力

设置布局重力

<下拉框 重力="中" />

内边距 - 布局内边距

设置布局内边距

单位:dp

<下拉框 内边距="0,0,0,0" />

背景颜色 - 背景颜色

设置背景颜色

<下拉框 背景颜色="#FF0000" />

背景图片 - 背景图片

设置背景图片

<下拉框 背景图片="/资源/图片01.png" />

三、常用函数

监听选中(回调)

事件监听

  • 参数 : 回调 {(标题,下标)=>{}} 回调函数

//解析布局,获得界面对象
定义 界面 = $界面.解析布局("./主界面.xml");
//获取控件
定义 下拉框 = 界面.找控件("我的下拉框");
//监听选中事件
下拉框.监听选中((标题,下标)=>{
    土司(标题);
});

设置文字(文本)

设置文字

  • 参数 : 文本 {string} 文字

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

获取文字()

获得文字

  • 返回 : {string} 文字

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

刷新(数据)

刷新数据

  • 参数 : 数据 {string[]} 数据集合

//解析布局,获得界面对象
定义 界面 = $界面.解析布局("./主界面.xml");
//获取控件
定义 下拉框 = 界面.找控件("我的下拉框");
//刷新数据
下拉框.刷新(["张三","李四","王五"]);
ON THIS PAGE