1

CustomKeyboard/KeyboardViewController.m

@@ -6,11 +6,16 @@
 //
 
 #import "KeyboardViewController.h"
+#import "KBToolBar.h"
+#import "KBKeyboardView.h"
+#import "KBKey.h"
 
 static CGFloat KEYBOARDHEIGHT = 256;
 
-@interface KeyboardViewController ()
-@property (nonatomic, strong) UIButton *nextKeyboardButton;
+@interface KeyboardViewController () <KBToolBarDelegate, KBKeyboardViewDelegate>
+@property (nonatomic, strong) UIButton *nextKeyboardButton; // 系统“下一个键盘”按钮（可选）
+@property (nonatomic, strong) KBToolBar *topBar;
+@property (nonatomic, strong) KBKeyboardView *keyboardView;
 @end
 
 @implementation KeyboardViewController
@@ -18,7 +23,7 @@ static CGFloat KEYBOARDHEIGHT = 256;
 - (void)updateViewConstraints {
     [super updateViewConstraints];
     
-    // Add custom view sizing constraints here
+    // 可在此添加自定义尺寸约束
 }
 
 - (void)viewDidLoad {
@@ -43,14 +48,29 @@ static CGFloat KEYBOARDHEIGHT = 256;
 
 
 - (void)setupUI {
-    CGFloat toolBarHeight = 40;
-    CGFloat bottom = 5;
-    CGFloat buttonSpace = 8;
-    CGFloat eachButtonHeight = (KEYBOARDHEIGHT - toolBarHeight - 10 - 8 * 3 - bottom) / 4;
-    
-    UIView *view = [[UIView alloc] initWithFrame:CGRectMake(0, 0, SCREEN_WIDTH, 30)];
-    view.backgroundColor = [UIColor redColor];
-    [self.view addSubview:view];
+//    self.view.translatesAutoresizingMaskIntoConstraints = NO;
+    // 固定键盘整体高度
+    [self.view.heightAnchor constraintEqualToConstant:KEYBOARDHEIGHT].active = YES;
+
+    // 顶部栏
+    self.topBar = [[KBToolBar alloc] init];
+    self.topBar.delegate = self;
+    [self.view addSubview:self.topBar];
+    [self.topBar mas_makeConstraints:^(MASConstraintMaker *make) {
+        make.left.right.equalTo(self.view);
+        make.top.equalTo(self.view.mas_top).offset(6);
+        make.height.mas_equalTo(40);
+    }];
+
+    // 键盘区域
+    self.keyboardView = [[KBKeyboardView alloc] init];
+    self.keyboardView.delegate = self;
+    [self.view addSubview:self.keyboardView];
+    [self.keyboardView mas_makeConstraints:^(MASConstraintMaker *make) {
+        make.left.right.equalTo(self.view);
+        make.top.equalTo(self.topBar.mas_bottom).offset(4);
+        make.bottom.equalTo(self.view.mas_bottom).offset(-4);
+    }];
 }
 
 
@@ -61,11 +81,11 @@ static CGFloat KEYBOARDHEIGHT = 256;
 }
 
 - (void)textWillChange:(id<UITextInput>)textInput {
-    // The app is about to change the document's contents. Perform any preparation here.
+    // 文档内容即将变化，可在此做准备
 }
 
 - (void)textDidChange:(id<UITextInput>)textInput {
-    // The app has just changed the document's contents, the document context has been updated.
+    // 文档内容刚发生变化，环境已更新
     
     UIColor *textColor = nil;
     if (self.textDocumentProxy.keyboardAppearance == UIKeyboardAppearanceDark) {
@@ -76,4 +96,46 @@ static CGFloat KEYBOARDHEIGHT = 256;
     [self.nextKeyboardButton setTitleColor:textColor forState:UIControlStateNormal];
 }
 
+#pragma mark - KBToolBarDelegate
+
+- (void)toolBar:(KBToolBar *)toolBar didTapActionAtIndex:(NSInteger)index {
+    // 可根据业务透传或处理。示例：插入占位标记 [A1]..[A4]
+    NSString *placeholder = [NSString stringWithFormat:@"[A%ld]", (long)index+1];
+    [self.textDocumentProxy insertText:placeholder];
+}
+
+- (void)toolBarDidTapSettings:(KBToolBar *)toolBar {
+    // 通常可通过 openURL 或宿主处理打开设置页。
+    // 这里示例仅插入一个标记。
+    [self.textDocumentProxy insertText:@"[settings]"];
+}
+
+#pragma mark - KBKeyboardViewDelegate
+
+- (void)keyboardView:(KBKeyboardView *)keyboard didTapKey:(KBKey *)key {
+    switch (key.type) {
+        case KBKeyTypeCharacter:
+            [self.textDocumentProxy insertText:key.output ?: key.title ?: @""]; break;
+        case KBKeyTypeBackspace:
+            [self.textDocumentProxy deleteBackward]; break;
+        case KBKeyTypeSpace:
+            [self.textDocumentProxy insertText:@" "]; break;
+        case KBKeyTypeReturn:
+            [self.textDocumentProxy insertText:@"\n"]; break;
+        case KBKeyTypeModeChange: {
+            // 切换 字母 <-> 数字 布局
+            keyboard.layoutStyle = (keyboard.layoutStyle == KBKeyboardLayoutStyleLetters) ? KBKeyboardLayoutStyleNumbers : KBKeyboardLayoutStyleLetters;
+            [keyboard reloadKeys];
+        } break;
+        case KBKeyTypeGlobe:
+            [self advanceToNextInputMode]; break;
+        case KBKeyTypeCustom:
+            // 自定义占位：切换语言或其它操作
+            [self.textDocumentProxy insertText:@"[lang]"]; break;
+        case KBKeyTypeShift:
+            // Shift 已在 KBKeyboardView 内部处理
+            break;
+    }
+}
+
 @end

CustomKeyboard/Model/KBKey.h

@@ -0,0 +1,31 @@
+//
+//  KBKey.h
+//  CustomKeyboard
+//
+//  简单的键位数据模型，用于描述键盘上的一个键。
+//
+
+#import <Foundation/Foundation.h>
+#import <UIKit/UIKit.h>
+
+typedef NS_ENUM(NSInteger, KBKeyType) {
+    KBKeyTypeCharacter = 0,   // 普通字符输出
+    KBKeyTypeBackspace,       // 删除
+    KBKeyTypeShift,           // 大小写切换
+    KBKeyTypeModeChange,      // 模式切换（如 123/ABC）
+    KBKeyTypeSpace,           // 空格
+    KBKeyTypeReturn,          // 回车/发送
+    KBKeyTypeGlobe,           // 系统地球键
+    KBKeyTypeCustom           // 自定义功能占位
+};
+
+@interface KBKey : NSObject
+
+@property (nonatomic, assign) KBKeyType type;
+@property (nonatomic, copy) NSString *title;      // 显示标题
+@property (nonatomic, copy) NSString *output;     // 字符键插入的文本
+
++ (instancetype)keyWithTitle:(NSString *)title output:(NSString *)output;
++ (instancetype)keyWithTitle:(NSString *)title type:(KBKeyType)type;
+
+@end

CustomKeyboard/Model/KBKey.m

@@ -0,0 +1,27 @@
+//
+//  KBKey.m
+//  CustomKeyboard
+//
+
+#import "KBKey.h"
+
+@implementation KBKey
+
++ (instancetype)keyWithTitle:(NSString *)title output:(NSString *)output {
+    KBKey *k = [[KBKey alloc] init];
+    k.type = KBKeyTypeCharacter;
+    k.title = title ?: @"";
+    k.output = output ?: title ?: @"";
+    return k;
+}
+
++ (instancetype)keyWithTitle:(NSString *)title type:(KBKeyType)type {
+    KBKey *k = [[KBKey alloc] init];
+    k.type = type;
+    k.title = title ?: @"";
+    k.output = @"";
+    return k;
+}
+
+@end
+

CustomKeyboard/PrefixHeader.pch

@@ -12,7 +12,7 @@
 // You will also need to set the Prefix Header build setting of one or more of your targets to reference this file.
 
 #define SCREEN_WIDTH  [UIScreen mainScreen].bounds.size.width
-#define SCREEN_HEIGHT [UIScreen mainScreen].bounds.size.width
+#define SCREEN_HEIGHT [UIScreen mainScreen].bounds.size.height
 #define imageNamed(s) [UIImage imageNamed:s]
 
 #import "Masonry.h"

CustomKeyboard/View/KBKeyButton.h

@@ -0,0 +1,17 @@
+//
+//  KBKeyButton.h
+//  CustomKeyboard
+//
+
+#import <UIKit/UIKit.h>
+@class KBKey;
+
+/// 自定义键按钮（UIButton 子类）：圆角外观，按下高亮效果。
+@interface KBKeyButton : UIButton
+
+@property (nonatomic, strong) KBKey *key;
+
+/// 配置基础样式（背景、圆角等）。创建按钮时调用。
+- (void)applyDefaultStyle;
+
+@end

CustomKeyboard/View/KBKeyButton.m

@@ -0,0 +1,36 @@
+//
+//  KBKeyButton.m
+//  CustomKeyboard
+//
+
+#import "KBKeyButton.h"
+#import "KBKey.h"
+
+@implementation KBKeyButton
+
+- (instancetype)initWithFrame:(CGRect)frame {
+    if (self = [super initWithFrame:frame]) {
+        [self applyDefaultStyle];
+    }
+    return self;
+}
+
+- (void)applyDefaultStyle {
+    self.titleLabel.font = [UIFont systemFontOfSize:18 weight:UIFontWeightSemibold]; // 字体样式
+    [self setTitleColor:[UIColor blackColor] forState:UIControlStateNormal];
+    [self setTitleColor:[UIColor blackColor] forState:UIControlStateHighlighted];
+    self.backgroundColor = [UIColor whiteColor];
+    self.layer.cornerRadius = 6.0;      // 圆角
+    self.layer.masksToBounds = NO;
+    self.layer.shadowColor = [UIColor colorWithWhite:0 alpha:0.1].CGColor; // 阴影效果
+    self.layer.shadowOpacity = 1.0;
+    self.layer.shadowOffset = CGSizeMake(0, 1);
+    self.layer.shadowRadius = 1.5;
+}
+
+- (void)setHighlighted:(BOOL)highlighted {
+    [super setHighlighted:highlighted];
+    self.alpha = highlighted ? 0.7 : 1.0; // 简单按压反馈
+}
+
+@end

CustomKeyboard/View/KBKeyboardView.h

@@ -0,0 +1,31 @@
+//
+//  KBKeyboardView.h
+//  CustomKeyboard
+//
+//  键盘主容器，内部管理按键行布局。
+//
+
+#import <UIKit/UIKit.h>
+
+@class KBKeyboardView, KBKey;
+
+typedef NS_ENUM(NSInteger, KBKeyboardLayoutStyle) {
+    KBKeyboardLayoutStyleLetters = 0,
+    KBKeyboardLayoutStyleNumbers
+};
+
+@protocol KBKeyboardViewDelegate <NSObject>
+@optional
+/// 键被点击的回调
+- (void)keyboardView:(KBKeyboardView *)keyboard didTapKey:(KBKey *)key;
+@end
+
+@interface KBKeyboardView : UIView
+
+@property (nonatomic, weak) id<KBKeyboardViewDelegate> delegate;
+@property (nonatomic, assign) KBKeyboardLayoutStyle layoutStyle; // 布局样式（字母/数字）
+@property (nonatomic, assign, getter=isShiftOn) BOOL shiftOn;    // 大小写状态
+
+- (void)reloadKeys; // 当布局样式/大小写变化时调用
+
+@end

CustomKeyboard/View/KBKeyboardView.m

@@ -0,0 +1,255 @@
+//
+//  KBKeyboardView.m
+//  CustomKeyboard
+//
+
+#import "KBKeyboardView.h"
+#import "KBKeyButton.h"
+#import "KBKey.h"
+
+@interface KBKeyboardView ()
+@property (nonatomic, strong) UIView *row1;
+@property (nonatomic, strong) UIView *row2;
+@property (nonatomic, strong) UIView *row3;
+@property (nonatomic, strong) UIView *row4;
+@property (nonatomic, strong) NSArray<NSArray<KBKey *> *> *keysForRows;
+@end
+
+@implementation KBKeyboardView
+
+- (instancetype)initWithFrame:(CGRect)frame {
+    if (self = [super initWithFrame:frame]) {
+        self.backgroundColor = [UIColor colorWithWhite:0.95 alpha:1.0];
+        _layoutStyle = KBKeyboardLayoutStyleLetters;
+        _shiftOn = YES; // 初始使用大写，贴近截图效果
+        [self buildBase];
+        [self reloadKeys];
+    }
+    return self;
+}
+
+- (void)buildBase {
+    [self addSubview:self.row1];
+    [self addSubview:self.row2];
+    [self addSubview:self.row3];
+    [self addSubview:self.row4];
+
+    CGFloat vSpacing = 8;
+    [self.row1 mas_makeConstraints:^(MASConstraintMaker *make) {
+        make.top.equalTo(self.mas_top).offset(8);
+        make.left.right.equalTo(self);
+        make.height.mas_equalTo(44);
+    }];
+    [self.row2 mas_makeConstraints:^(MASConstraintMaker *make) {
+        make.top.equalTo(self.row1.mas_bottom).offset(vSpacing);
+        make.left.right.equalTo(self);
+        make.height.equalTo(self.row1);
+    }];
+    [self.row3 mas_makeConstraints:^(MASConstraintMaker *make) {
+        make.top.equalTo(self.row2.mas_bottom).offset(vSpacing);
+        make.left.right.equalTo(self);
+        make.height.equalTo(self.row1);
+    }];
+    [self.row4 mas_makeConstraints:^(MASConstraintMaker *make) {
+        make.top.equalTo(self.row3.mas_bottom).offset(vSpacing);
+        make.left.right.equalTo(self);
+        make.height.equalTo(self.row1);
+        make.bottom.equalTo(self.mas_bottom).offset(-6);
+    }];
+}
+
+- (void)reloadKeys {
+    // 移除旧按钮
+    for (UIView *row in @[self.row1, self.row2, self.row3, self.row4]) {
+        [row.subviews makeObjectsPerformSelector:@selector(removeFromSuperview)];
+    }
+
+    self.keysForRows = [self buildKeysForCurrentLayout];
+    [self buildRow:self.row1 withKeys:self.keysForRows[0]];
+    // 第二行：字母布局时通过左右等宽占位让整行居中
+    CGFloat row2Spacer = (self.layoutStyle == KBKeyboardLayoutStyleLetters) ? 0.5 : 0.0;
+    [self buildRow:self.row2 withKeys:self.keysForRows[1] edgeSpacerMultiplier:row2Spacer];
+    [self buildRow:self.row3 withKeys:self.keysForRows[2]];
+    [self buildRow:self.row4 withKeys:self.keysForRows[3]];
+}
+
+- (NSArray<NSArray<KBKey *> *> *)buildKeysForCurrentLayout {
+    if (self.layoutStyle == KBKeyboardLayoutStyleNumbers) {
+        // 数字/符号布局：3 行主键 + 底部控制行
+        NSArray *r1 = @[
+            [KBKey keyWithTitle:@"1" output:@"1"], [KBKey keyWithTitle:@"2" output:@"2"], [KBKey keyWithTitle:@"3" output:@"3"],
+            [KBKey keyWithTitle:@"4" output:@"4"], [KBKey keyWithTitle:@"5" output:@"5"], [KBKey keyWithTitle:@"6" output:@"6"],
+            [KBKey keyWithTitle:@"7" output:@"7"], [KBKey keyWithTitle:@"8" output:@"8"], [KBKey keyWithTitle:@"9" output:@"9"], [KBKey keyWithTitle:@"0" output:@"0"],
+        ];
+        NSArray *r2 = @[
+            [KBKey keyWithTitle:@"-" output:@"-"], [KBKey keyWithTitle:@"/" output:@"/"], [KBKey keyWithTitle:@":" output:@":"],
+            [KBKey keyWithTitle:@";" output:@";"], [KBKey keyWithTitle:@"(" output:@"("], [KBKey keyWithTitle:@")" output:@")"],
+            [KBKey keyWithTitle:@"$" output:@"$"], [KBKey keyWithTitle:@"&" output:@"&"], [KBKey keyWithTitle:@"@" output:@"@"], [KBKey keyWithTitle:@"\"" output:@"\""],
+        ];
+        NSArray *r3 = @[
+            [KBKey keyWithTitle:@"#+=" type:KBKeyTypeModeChange],
+            [KBKey keyWithTitle:@"," output:@","], [KBKey keyWithTitle:@"." output:@"."], [KBKey keyWithTitle:@"?" output:@"?"],
+            [KBKey keyWithTitle:@"!" output:@"!"], [KBKey keyWithTitle:@"'" output:@"'"],
+            [KBKey keyWithTitle:@"⌫" type:KBKeyTypeBackspace],
+        ];
+        NSArray *r4 = @[
+            [KBKey keyWithTitle:@"ABC" type:KBKeyTypeModeChange],
+            [KBKey keyWithTitle:@"," output:@","],
+            [KBKey keyWithTitle:@"space" type:KBKeyTypeSpace],
+            [KBKey keyWithTitle:@"中/英" type:KBKeyTypeCustom],
+            [KBKey keyWithTitle:@"发送" type:KBKeyTypeReturn],
+        ];
+        return @[r1, r2, r3, r4];
+    }
+
+    // 字母布局（QWERTY）
+    NSArray *r1 = @[ @"Q", @"W", @"E", @"R", @"T", @"Y", @"U", @"I", @"O", @"P" ];
+    NSArray *r2 = @[ @"A", @"S", @"D", @"F", @"G", @"H", @"J", @"K", @"L" ];
+    NSArray *r3chars = @[ @"Z", @"X", @"C", @"V", @"B", @"N", @"M" ];
+
+    NSMutableArray *row1 = [NSMutableArray arrayWithCapacity:r1.count];
+    for (NSString *s in r1) { [row1 addObject:[KBKey keyWithTitle:s output:(self.shiftOn ? s : s.lowercaseString)]]; }
+
+    NSMutableArray *row2 = [NSMutableArray arrayWithCapacity:r2.count];
+    for (NSString *s in r2) { [row2 addObject:[KBKey keyWithTitle:s output:(self.shiftOn ? s : s.lowercaseString)]]; }
+
+    NSMutableArray *row3 = [NSMutableArray array];
+    [row3 addObject:[KBKey keyWithTitle:@"⇧" type:KBKeyTypeShift]];
+    for (NSString *s in r3chars) { [row3 addObject:[KBKey keyWithTitle:s output:(self.shiftOn ? s : s.lowercaseString)]]; }
+    [row3 addObject:[KBKey keyWithTitle:@"⌫" type:KBKeyTypeBackspace]];
+
+    NSArray *row4 = @[ [KBKey keyWithTitle:@"123" type:KBKeyTypeModeChange],
+                       [KBKey keyWithTitle:@"," output:@","],
+                       [KBKey keyWithTitle:@"space" type:KBKeyTypeSpace],
+                       [KBKey keyWithTitle:@"中/英" type:KBKeyTypeCustom],
+                       [KBKey keyWithTitle:@"发送" type:KBKeyTypeReturn] ];
+
+    return @[row1.copy, row2.copy, row3.copy, row4];
+}
+
+- (void)buildRow:(UIView *)row withKeys:(NSArray<KBKey *> *)keys {
+    [self buildRow:row withKeys:keys edgeSpacerMultiplier:0.0];
+}
+
+- (void)buildRow:(UIView *)row withKeys:(NSArray<KBKey *> *)keys edgeSpacerMultiplier:(CGFloat)edgeSpacerMultiplier {
+    CGFloat hInset = 6;   // 行左右内边距
+    CGFloat spacing = 6;  // 键与键之间的间距
+    UIView *previous = nil;
+    UIView *leftSpacer = nil;
+    UIView *rightSpacer = nil;
+    if (edgeSpacerMultiplier > 0.0) {
+        leftSpacer = [UIView new];
+        rightSpacer = [UIView new];
+        leftSpacer.backgroundColor = [UIColor clearColor];
+        rightSpacer.backgroundColor = [UIColor clearColor];
+        [row addSubview:leftSpacer];
+        [row addSubview:rightSpacer];
+        [leftSpacer mas_makeConstraints:^(MASConstraintMaker *make) {
+            make.left.equalTo(row.mas_left).offset(hInset);
+            make.centerY.equalTo(row);
+            make.height.mas_equalTo(1);
+        }];
+        [rightSpacer mas_makeConstraints:^(MASConstraintMaker *make) {
+            make.right.equalTo(row.mas_right).offset(-hInset);
+            make.centerY.equalTo(row);
+            make.height.mas_equalTo(1);
+        }];
+    }
+    for (NSInteger i = 0; i < keys.count; i++) {
+        KBKey *key = keys[i];
+        KBKeyButton *btn = [[KBKeyButton alloc] init];
+        btn.key = key;
+        [btn setTitle:key.title forState:UIControlStateNormal];
+        [btn addTarget:self action:@selector(onKeyTapped:) forControlEvents:UIControlEventTouchUpInside];
+        [row addSubview:btn];
+
+        [btn mas_makeConstraints:^(MASConstraintMaker *make) {
+            make.top.bottom.equalTo(row);
+            if (previous) {
+                make.left.equalTo(previous.mas_right).offset(spacing);
+            } else {
+                if (leftSpacer) {
+                    make.left.equalTo(leftSpacer.mas_right).offset(spacing);
+                } else {
+                    make.left.equalTo(row.mas_left).offset(hInset);
+                }
+            }
+        }];
+
+        // 宽度规则：字符键等宽；特殊键按倍数放大
+        if (key.type == KBKeyTypeCharacter) {
+            if (previous && previous != nil) {
+                if (((KBKeyButton *)previous).key.type == KBKeyTypeCharacter) {
+                    [btn mas_makeConstraints:^(MASConstraintMaker *make) {
+                        make.width.equalTo(previous);
+                    }];
+                }
+            }
+        } else {
+            // special keys: give 1.5x of a character key by deferring constraint equalities after loop
+        }
+
+        previous = btn;
+    }
+    // 右侧使用内边距或右占位
+    [previous mas_makeConstraints:^(MASConstraintMaker *make) {
+        if (rightSpacer) {
+            make.right.equalTo(rightSpacer.mas_left).offset(-spacing);
+        } else {
+            make.right.equalTo(row.mas_right).offset(-hInset);
+        }
+    }];
+
+    // 第二遍：以首个字符键为基准，统一设置特殊键宽度倍数
+    KBKeyButton *firstChar = nil;
+    for (KBKeyButton *b in row.subviews) {
+        if ([b isKindOfClass:[KBKeyButton class]] && b.key.type == KBKeyTypeCharacter) { firstChar = b; break; }
+    }
+    if (firstChar) {
+        for (KBKeyButton *b in row.subviews) {
+            if (![b isKindOfClass:[KBKeyButton class]]) continue;
+            if (b.key.type == KBKeyTypeCharacter) continue;
+            CGFloat multiplier = 1.5;
+            if (b.key.type == KBKeyTypeSpace) multiplier = 4.0;
+            if (b.key.type == KBKeyTypeReturn) multiplier = 1.8;
+            if (b.key.type == KBKeyTypeModeChange || b.key.type == KBKeyTypeGlobe || b.key.type == KBKeyTypeShift || b.key.type == KBKeyTypeBackspace) {
+                multiplier = 1.5;
+            }
+            [b mas_makeConstraints:^(MASConstraintMaker *make) {
+                make.width.equalTo(firstChar).multipliedBy(multiplier);
+            }];
+        }
+        // 如果有左右占位，则把占位宽度设置为字符键宽度的一定倍数，以实现整体居中
+        if (leftSpacer && rightSpacer) {
+            [leftSpacer mas_makeConstraints:^(MASConstraintMaker *make) {
+                make.width.equalTo(firstChar).multipliedBy(edgeSpacerMultiplier);
+            }];
+            [rightSpacer mas_makeConstraints:^(MASConstraintMaker *make) {
+                make.width.equalTo(firstChar).multipliedBy(edgeSpacerMultiplier);
+            }];
+        }
+    }
+}
+
+#pragma mark - Actions
+
+- (void)onKeyTapped:(KBKeyButton *)sender {
+    KBKey *key = sender.key;
+    if (key.type == KBKeyTypeShift) {
+        self.shiftOn = !self.shiftOn;
+        [self reloadKeys];
+        return;
+    }
+    if ([self.delegate respondsToSelector:@selector(keyboardView:didTapKey:)]) {
+        [self.delegate keyboardView:self didTapKey:key];
+    }
+}
+
+#pragma mark - Lazy
+
+- (UIView *)row1 { if (!_row1) _row1 = [UIView new]; return _row1; }
+- (UIView *)row2 { if (!_row2) _row2 = [UIView new]; return _row2; }
+- (UIView *)row3 { if (!_row3) _row3 = [UIView new]; return _row3; }
+- (UIView *)row4 { if (!_row4) _row4 = [UIView new]; return _row4; }
+
+@end

CustomKeyboard/View/KBToolBar.h

@@ -9,8 +9,28 @@
 
 NS_ASSUME_NONNULL_BEGIN
 
+@class KBToolBar;
+
+@protocol KBToolBarDelegate <NSObject>
+@optional
+/// 左侧 4 个功能按钮点击（index: 0~3）
+- (void)toolBar:(KBToolBar *)toolBar didTapActionAtIndex:(NSInteger)index;
+/// 右侧设置按钮点击
+- (void)toolBarDidTapSettings:(KBToolBar *)toolBar;
+@end
+
+/// 顶部工具栏：左侧 4 个按钮，右侧 1 个设置按钮。
 @interface KBToolBar : UIView
 
+@property (nonatomic, weak, nullable) id<KBToolBarDelegate> delegate;
+
+/// 左侧 4 个按钮的标题。默认值：@[@"Item1", @"Item2", @"Item3", @"Item4"]。
+@property (nonatomic, copy) NSArray<NSString *> *leftButtonTitles;
+
+/// 暴露按钮以便外部定制（只读；首次访问时懒加载创建）
+@property (nonatomic, strong, readonly) NSArray<UIButton *> *leftButtons;
+@property (nonatomic, strong, readonly) UIButton *settingsButton;
+
 @end
 
 NS_ASSUME_NONNULL_END

CustomKeyboard/View/KBToolBar.m

@@ -7,15 +7,139 @@
 
 #import "KBToolBar.h"
 
+@interface KBToolBar ()
+@property (nonatomic, strong) UIView *leftContainer;
+@property (nonatomic, strong) NSArray<UIButton *> *leftButtonsInternal;
+@property (nonatomic, strong) UIButton *settingsButtonInternal;
+@end
+
 @implementation KBToolBar
 
 - (instancetype)initWithFrame:(CGRect)frame{
     if (self = [super initWithFrame:frame]) {
-        
+        self.backgroundColor = [UIColor clearColor];
+        _leftButtonTitles = @[@"Item1", @"Item2", @"Item3", @"Item4"]; // 默认标题
+        [self setupUI];
     }
     return self;
 }
 
 
+#pragma mark - Public
+
+- (NSArray<UIButton *> *)leftButtons {
+    return self.leftButtonsInternal;
+}
+
+- (UIButton *)settingsButton {
+    return self.settingsButtonInternal;
+}
+
+- (void)setLeftButtonTitles:(NSArray<NSString *> *)leftButtonTitles {
+    _leftButtonTitles = [leftButtonTitles copy];
+    // Update titles if buttons already exist
+    [self.leftButtonsInternal enumerateObjectsUsingBlock:^(UIButton * _Nonnull obj, NSUInteger idx, BOOL * _Nonnull stop) {
+        if (idx < self.leftButtonTitles.count) {
+            [obj setTitle:self.leftButtonTitles[idx] forState:UIControlStateNormal];
+        }
+    }];
+}
+
+#pragma mark - 视图搭建
+
+- (void)setupUI {
+    [self addSubview:self.leftContainer];
+    [self addSubview:self.settingsButtonInternal];
+
+    // 右侧设置按钮
+    [self.settingsButtonInternal mas_makeConstraints:^(MASConstraintMaker *make) {
+        make.right.equalTo(self.mas_right).offset(-12);
+        make.centerY.equalTo(self.mas_centerY);
+        make.width.height.mas_equalTo(32);
+    }];
+
+    // 左侧容器占用剩余空间
+    [self.leftContainer mas_makeConstraints:^(MASConstraintMaker *make) {
+        make.left.equalTo(self.mas_left).offset(12);
+        make.right.equalTo(self.settingsButtonInternal.mas_left).offset(-12);
+        make.centerY.equalTo(self.mas_centerY);
+        make.height.mas_equalTo(32);
+    }];
+
+    // 在左侧容器中创建 4 个等宽按钮
+    NSMutableArray<UIButton *> *buttons = [NSMutableArray arrayWithCapacity:4];
+    UIView *previous = nil;
+    for (NSInteger i = 0; i < 4; i++) {
+        UIButton *btn = [self buildActionButtonAtIndex:i];
+        [self.leftContainer addSubview:btn];
+        [buttons addObject:btn];
+        [btn mas_makeConstraints:^(MASConstraintMaker *make) {
+            if (previous) {
+                make.left.equalTo(previous.mas_right).offset(8);
+                make.width.equalTo(previous);
+            } else {
+                make.left.equalTo(self.leftContainer.mas_left);
+            }
+            make.top.bottom.equalTo(self.leftContainer);
+        }];
+        previous = btn;
+    }
+    // 最后一个按钮贴右侧
+    [previous mas_makeConstraints:^(MASConstraintMaker *make) {
+        make.right.equalTo(self.leftContainer.mas_right);
+    }];
+    self.leftButtonsInternal = buttons.copy;
+}
+
+- (UIButton *)buildActionButtonAtIndex:(NSInteger)idx {
+    UIButton *btn = [UIButton buttonWithType:UIButtonTypeSystem];
+    btn.layer.cornerRadius = 16;
+    btn.layer.masksToBounds = YES;
+    btn.backgroundColor = [UIColor colorWithWhite:1 alpha:0.9];
+    btn.titleLabel.font = [UIFont systemFontOfSize:14 weight:UIFontWeightMedium];
+    NSString *title = (idx < self.leftButtonTitles.count) ? self.leftButtonTitles[idx] : [NSString stringWithFormat:@"Item%ld", (long)(idx+1)];
+    [btn setTitle:title forState:UIControlStateNormal];
+    [btn setTitleColor:[UIColor blackColor] forState:UIControlStateNormal];
+    btn.tag = idx;
+    [btn addTarget:self action:@selector(onLeftAction:) forControlEvents:UIControlEventTouchUpInside];
+    return btn;
+}
+
+#pragma mark - Actions
+
+- (void)onLeftAction:(UIButton *)sender {
+    if ([self.delegate respondsToSelector:@selector(toolBar:didTapActionAtIndex:)]) {
+        [self.delegate toolBar:self didTapActionAtIndex:sender.tag];
+    }
+}
+
+- (void)onSettings {
+    if ([self.delegate respondsToSelector:@selector(toolBarDidTapSettings:)]) {
+        [self.delegate toolBarDidTapSettings:self];
+    }
+}
+
+#pragma mark - Lazy
+
+- (UIView *)leftContainer {
+    if (!_leftContainer) {
+        _leftContainer = [[UIView alloc] init];
+        _leftContainer.backgroundColor = [UIColor clearColor];
+    }
+    return _leftContainer;
+}
+
+- (UIButton *)settingsButtonInternal {
+    if (!_settingsButtonInternal) {
+        _settingsButtonInternal = [UIButton buttonWithType:UIButtonTypeSystem];
+        _settingsButtonInternal.layer.cornerRadius = 16;
+        _settingsButtonInternal.layer.masksToBounds = YES;
+        _settingsButtonInternal.backgroundColor = [UIColor colorWithWhite:1 alpha:0.9];
+    [_settingsButtonInternal setTitle:@"⚙︎" forState:UIControlStateNormal]; // 简单的齿轮符号
+        [_settingsButtonInternal setTitleColor:[UIColor blackColor] forState:UIControlStateNormal];
+        [_settingsButtonInternal addTarget:self action:@selector(onSettings) forControlEvents:UIControlEventTouchUpInside];
+    }
+    return _settingsButtonInternal;
+}
 
 @end