logo

iMAG移动应用开发指南

Menu

Android系统菜单控件(不建议使用

标签

标签名 描述 说明 子标签
menu 菜单标签 显示当前页面的系统菜单 item

属性

属性名 取值 描述
id 文本 id编码
adapter ios:适配iOS adapter默认为空,即默认在iOS上不显示菜单,当设置adapter="ios"时将在iOS上显示菜单
items Array 返回item的数组

方法

方法名 参数 返回值 描述
open() None None 打开菜单
close() None None 关闭菜单
add(item:Object) item:MenuItem对象 None 增加一个菜单项
remove(item:Object) item:MenuItem对象 None 移除一个菜单项
clear() None None 移除所有菜单项

MenuItem

菜单项

标签名 描述 说明
item 菜单项子标签 显示菜单项

属性

属性名 取值 描述
id 文本 id编码
res home:主页
refresh:刷新
attachment:附件
source:源码
setting:设置
about:关于
exit:退出
内置的默认菜单项
label 文本 菜单项显示的文本
icon 文件名 菜单项显示的图标,iOS上没有icon属性
onclick Javascript脚本 点击菜单项时触发的脚本

控件详解

Menu控件用来显示系统菜单,这里主要是Android的系统菜单,因为iOS上没有物理菜单键。
设置完Android的Menu之后,可以加上属性adapter="ios"用来兼容iOS,iOS上的Menu将会以上拉菜单(ActionSheet)的形式来展示。

说明:系统菜单是Android系统上特有的设计,由于系统菜单处于隐藏状态,对用户不友好,因此不建议使用。

标签示例

● 默认菜单项

<page>
	<menu>
	  <item res="home"/>
	  <item res="refresh"/>
	  <item res="source"/>
	  <item res="attachment"/>
	  <item res="setting"/>
	  <item res="about"/>
	  <item res="exit"/>
	</menu>
    <title>
        <center>
            <label>默认菜单项</label>
        </center>
    </title>
</page>

iMAG内置了7个默认的菜单项,只需设置res属性就可以显示这些菜单项,使用这些功能。

● 自定义菜单项

<menu>
  <item label="提示" icon="ic_menu_notifications.png" onclick="hint('提示信息');"></item>
  <item label="查找" icon="ic_menu_search.png" onclick="$page.open('script_ui_list_search.jsp');"/>
</menu>

自定义的菜单功能需要设置label, icon, onclick这三个属性。

脚本示例

● 打开菜单

$('test_menu').open();

● 关闭菜单

$('test_menu').close();

● 增加菜单项

$('test_menu').add($C('menu-item', {label:'提示', icon:'ic_menu_notifications.png', onclick:function(){
    hint('提示信息');
}}));

● 删除菜单项

var menu = $('test_menu');
menu.remove(menu.items[2]);