操作项

这是对操作项最常见用法的概述。有关可用属性、方法或事件的更多信息,请查看 ActionItem 的完整 API 文档。

<ActionItem> 是一个 UI 组件,允许您将操作按钮添加到 <ActionBar> 组件。


基本用法

<ActionBar title="My App">
  <ActionItem @tap="onTapShare"
    ios.systemIcon="9" ios.position="left"
    android.systemIcon="ic_menu_share" android.position="actionBar" />
  <ActionItem @tap="onTapDelete"
    ios.systemIcon="16" ios.position="right"
    text="delete" android.position="popup" />
</ActionBar>

有条件地显示操作项

您可以使用 v-show 指令根据条件显示 <ActionItem> 组件。

<ActionBar title="My App">
  <ActionItem @tap="onTapEdit"
    v-show="!isEditing"
    ios.systemIcon="2" ios.position="right"
    android.systemIcon="ic_menu_edit" />
  <ActionItem @tap="onTapSave"
    v-show="isEditing"
    ios.systemIcon="3" ios.position="right"
    android.systemIcon="ic_menu_save" />
  <ActionItem @tap="onTapCancel"
    v-show="isEditing"
    ios.systemIcon="1"
    android.systemIcon="ic_menu_close_clear_cancel" />
</ActionBar>

属性

名称类型描述
ios.systemIcon数字获取或设置 iOS 上 ActionItem 的图标。该值必须来自 UIBarButtonSystemItem 枚举
android.systemIcon字符串获取或设置 Android 上 ActionItem 的图标。该值必须是 可绘制资源 的名称。
ios.position字符串获取或设置 iOS 上 ActionBarActionItem 的位置。
有效值:leftright
默认值为 left
android.position字符串获取或设置 Android 上 ActionBarActionItem 的位置。
有效值
actionBar(将项目放置在操作栏中)
popup(将项目放置在选项菜单中;将项目呈现为文本)
actionBarIfRoom(如果操作栏有足够的空间,则将项目放置在操作栏中;否则,将其放置在选项菜单中)
默认值为 actionBar

事件

名称描述
tap当点击 ActionItem 时发出。

原生组件

AndroidiOS
android.widget.ToolbarUINavigationItem
贡献者