window.ag

点击查看window的Demo

继承关系

window extends View

简介

特定的全局视图变量，作为当前lua界面的根视图

生命周期方法调用顺序为： 1.onSizeChanged 2.onAppear 3.onDisappear 4.onDestroy

API

onAppear(function callback)

设置页面显示时回调

⚠️ 建议写在lua代码的最后，这样所有的调用方法都已加载

onDisappear(function callback)

设置页面隐藏时回调

⚠️ 建议写在lua代码的最后，这样所有的调用方法都已加载

onSizeChanged(function callback)

设置页面宽或高变化时的回调

onDestroy(function callback)

设置页面销毁前的回调

getExtra()

获取在原生业务中为lua设置的拓展参数

getLuaVersion()

获取当前加载的lua业务的版本号，版本号0为预埋包

⚠️ 需要在加载lua处去给window赋值，调用instance的setLuaVersion方法赋值。

getLuaSource()

获取当前加载的lua文件来源

statusBarHeight()

获取电池栏（状态栏）高度

⚠️ 建议在非全屏，即展示状态栏的情况下使用，否则会返回0

statusBarMode()

获取状态栏模式

statusBarMode(StatusMode mode)

设置状态栏模式

statusBarColor(Color color)

设置状态栏颜色

statusBarColor()

获取状态栏颜色

getStatusBarStyle()

获取状态栏颜色样式

setStatusBarStyle(StatusBarStyle style)

设置状态栏样式

⚠️ 记得设置后在视图消失时置回设置前的样式

navBarHeight()

获取导航条高度

tabBarHeight()

获取tab bar高度

⚠️ 在Android和iOS两端是不一样的

homeBarHeight()

获取home虚拟按键高度

⚠️ 建议在非全屏，即有虚拟按键时，使用该方法最为准确

backKeyPressed(function callback)

设置返回键监听方法

⚠️ 仅Android有效，IOS空实现安卓原生端需要做如下处理：

Activity或ViewGroup中此方法可生效，Fragment中暂时还不会生效;
在显示LuaView的Activity中 dispatchKeyEvent() 方法添加如下代码：

if (event.getKeyCode() == KeyEvent.KEYCODE_BACK && event.getAction() != KeyEvent.ACTION_UP) { MLSInstance.dispatchKeyEvent(event);}

backKeyEnabled(boolean isEnable)

是否执行返回到上一个页面的操作，默认值为true，当不传递参数时，是获取是否可以执行返回键操作的boolean值

⚠️ 安卓支持，ios空实现

safeArea(number safeArea)

设置安全区域

safeAreaInsetsTop()

获取顶部安全填充距离

safeAreaInsetsBottom()

获取底部安全填充距离

safeAreaInsetsLeft()

获取左侧全填充距离

safeAreaInsetsRight()

获取右侧安全填充距离

safeAreaAdapter(SafeAreaAdapter adapter)

安全区域适配器,主要用于自定义安全区域的偏移

keyboardShowing(function callback)

设置监听键盘的展示和隐藏

keyboardOffset(number offset)

对window整体上移，让当前焦点的输入框位于键盘上方

watchKeyboard(function callback)

监听键盘回调，自定义交互

keyboardDismiss(boolean auto)

收起键盘