$ui - 界面交互#

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

UI交互界面

界面线程(回调函数)#

界面线程

一般修改界面元素的时候需要用到界面线程，由于本应用已经自动把所有控件操作都放到了界面线程中，所以不需要额外调用。

• 参数 : 回调函数 {()=>{}} 回调函数

• 版本 : 1.5.8

//在界面线程中执行
$界面.界面线程(()=>{
    //在界面线程中执行的代码
});
//或者下面的方式更加直观:先定义要执行的函数
定义 要执行的函数 = 函数(){
    //要执行的内容
}
//然后把这个函数传进去,那么这个函数就会在界面线程中执行
$界面.界面线程(要执行的函数);

解析布局(xml内容或者路径)#

解析全屏布局

创建一个界面(ui)对象,并且解析布局,最终返回这个界面(ui)对象

• 参数 : xml内容或者路径 {string} xml内容或者xml路径

• 返回 : {UI} ui对象

• 版本 : 1.5.8

定义 我的界面 = $界面.解析布局("./资源/主界面.xml");

创建底部弹窗(活动对象)#

显示底部弹窗

• 参数 : 活动对象 {activity} 需要显示底部弹窗的活动对象

• 返回 : {Sheet} 弹窗对象

• 版本 : 1.5.8

//假如已经显示了一个ui了
定义 界面 = $界面.解析界面("主界面.xml");
界面.显示();//显示界面(ui)
//当界面(ui)显示之后就可以获取对应界面的活动对象(activity)了
定义 底部弹窗 = $界面.创建底部弹窗(界面.获得活动对象());//创建目标活动的底部弹窗对象
底部弹窗.解析布局("底部对话框.xml"); //解析底部弹窗(sheet)布局
底部弹窗.找控件("我的按钮"); //绑定底部弹窗(sheet)中的组件事件
底部弹窗.显示(); //显示底部弹窗

土司(文本)#

悬浮土司

悬浮土司是基于悬浮窗来实现的，因此在显示的时候会处于界面顶层。

• 参数 : 文本 {string} 文本

• 版本 : 1.5.8

$界面.土司("文本");

土司(文本, 重力)#

悬浮土司

悬浮土司是基于悬浮窗来实现的，因此在显示的时候会处于界面顶层。

• 参数 : 文本 {string} 文本

• 参数 : 重力 {string} 位置

• 版本 : 1.5.8

$界面.土司("文本","中");

转px(dp)#

dp转px

• 参数 : dp {数字} dp(虚拟长度单位)

• 返回 : {数字} 转换后的px(像素值)

• 版本 : 1.8.2

//获取10dp的真实像素单位
定义 像素 = $界面.转px(10);

转dp(像素)#

px转dp

• 参数 : 像素 {数字} 要转换的px(像素值)

• 返回 : {数字} 转换后的(dp)虚拟像素单位

• 版本 : 1.8.2

//获取10像素的(dp)虚拟单位值
定义 dp = $界面.转dp(10);