GMenuController 使用教程

GMenuController 使用教程

项目介绍

GMenuController 是一个开源项目，旨在提供一个与 UIMenuController 一致的 UI 和交互行为的菜单控制器。它支持 MenuItem 指定 target，具有高度定制化的 UI，并且对外 API 与原生 UIMenuController 一致。GMenuController 的使用方式更加简单和友好，无需对添加 MenuController 的控件添加 canBecomeFirstResponder 等行为。

项目快速启动

安装

首先，通过 Git 克隆项目到本地：

git clone https://github.com/GIKICoder/GMenuController.git

基本用法

以下是一个基本的 GMenuController 使用示例：

#import "GMenuController.h"

// 创建 GMenuItem 实例
GMenuItem *item1 = [[GMenuItem alloc] initWithTitle:@"选择" target:self action:@selector(test)];
GMenuItem *item2 = [[GMenuItem alloc] initWithTitle:@"复制" target:self action:@selector(test)];
GMenuItem *item3 = [[GMenuItem alloc] initWithTitle:@"全选" target:self action:@selector(test)];
GMenuItem *item4 = [[GMenuItem alloc] initWithTitle:@"收藏" target:self action:@selector(test)];
GMenuItem *item5 = [[GMenuItem alloc] initWithTitle:@"更多" target:self action:@selector(test)];

// 将 GMenuItem 实例添加到数组中
NSArray *items = @[item1, item2, item3, item4, item5];

// 设置 GMenuController 的菜单项
[GMenuController sharedMenuController].menuItems = items;

应用案例和最佳实践

自定义菜单项

GMenuController 支持自定义菜单项的图标和位置，以下是一个自定义菜单项的示例：

GMenuItem *customItem = [[GMenuItem alloc] initWithTitle:@"自定义" image:[UIImage imageNamed:@"custom_icon"] target:self action:@selector(customAction)];
customItem.iconPosition = GMenuItemIconPositionLeft;

更改菜单视图外观

GMenuController 允许更改菜单视图的外观设置，以下是一个更改外观的示例：

GMenuController *menuController = [GMenuController sharedMenuController];
menuController.menuViewAppearance.backgroundColor = [UIColor darkGrayColor];
menuController.menuViewAppearance.textColor = [UIColor whiteColor];

典型生态项目

GMenuController 可以与其他文本处理相关的开源项目结合使用，例如：

• GRichLabel: 一个支持富文本显示的标签控件，可以与 GMenuController 结合使用，实现文本选择复制功能。
• GTextEditor: 一个文本编辑器控件，可以与 GMenuController 结合使用，实现文本编辑时的菜单控制。

通过这些生态项目的结合使用，可以进一步提升应用的文本处理能力和用户体验。