提交

TUIKit/TUIChat/UI_Classic/Input/TUIInputBar.h

@@ -0,0 +1,177 @@
+
+//  Created by Tencent on 2023/06/09.
+//  Copyright © 2023 Tencent. All rights reserved.
+/**
+ *  This file declares the TUIInputBarDelegate protocol and the TUIInputBar class.
+ *  TUI input bar, a UI component used to detect and obtain user input.
+ *  TUIInputBar, the UI component at the bottom of the chat message. Includes text input box, emoji button, voice button, and "+" button ("More" button)
+ *  TUIInputBarDelegate provides callbacks for various situations of the input bar, including the callback for the emoticon of clicking the input bar, the
+ * "more" view, and the voice button. And callbacks to send message, send voice, change input height.
+ */
+
+#import <TIMCommon/TIMCommonModel.h>
+#import <TUICore/TUIThemeManager.h>
+#import <UIKit/UIKit.h>
+#import "TUIResponderTextView.h"
+
+#define kTUIInputNoramlFont [UIFont systemFontOfSize:16.0]
+#define kTUIInputNormalTextColor TUIChatDynamicColor(@"chat_input_text_color", @"#000000")
+
+@class TUIInputBar;
+
+/////////////////////////////////////////////////////////////////////////////////
+//
+//                            TUIInputBarDelegate
+//
+/////////////////////////////////////////////////////////////////////////////////
+
+@protocol TUIInputBarDelegate <NSObject>
+
+/**
+ *  Callback after clicking the emoji button - "smiley" button.
+ *  You can use this callback to achieve: After clicking the emoticon button, the corresponding emoticon view is displayed.
+ */
+- (void)inputBarDidTouchFace:(TUIInputBar *)textView;
+
+/**
+ *  Callback after more button - "+" is clicked.
+ *  You can use this callback to achieve: corresponding user's click operation to display more corresponding views.
+ */
+- (void)inputBarDidTouchMore:(TUIInputBar *)textView;
+
+/**
+ *  Callback after clicking the voice button - "Sound Wave" icon .
+ *  You can use this callback to display the corresponding operation prompt view and start voice recording
+ */
+- (void)inputBarDidTouchVoice:(TUIInputBar *)textView;
+
+/**
+ *  Callback when input bar height changes
+ *  This callback is fired when the InputBar height changes when you click the voice button, emoji button, "+" button, or call out/retract the keyboard
+ *  You can use this callback to achieve: UI layout adjustment when InputBar height changes through this callback function.
+ *  In the default implementation of TUIKit, this callback function further calls the didChangeHeight delegate in TUIInputController to adjust the height of the
+ * UI layout after processing the appearance of the expression view and more views.
+ */
+- (void)inputBar:(TUIInputBar *)textView didChangeInputHeight:(CGFloat)offset;
+
+/**
+ *  Callback when sending a text message.
+ *  This callback is fired when you send a text message through the InputBar (click the send button from the keyboard).
+ *  You can use this callback to get the content of the InputBar and send the message.
+ *  In the default implementation of TUIKit, this callback further calls the didSendMessage delegate in TUIInputController for further logical processing of
+ * message sending after processing the appearance of the expression view and more views.
+ */
+- (void)inputBar:(TUIInputBar *)textView didSendText:(NSString *)text;
+
+/**
+ *  Callback when sending voice
+ *  This callback is triggered when you long press and release the voice button.
+ *  You can use this callback to process the recorded voice information and send the voice message.
+ *  In the default implementation of TUIKit, this callback function further calls the didSendMessage delegate in TUIInputController for further logical
+ * processing of message sending after processing the appearance of the expression view and more views.
+ */
+- (void)inputBar:(TUIInputBar *)textView didSendVoice:(NSString *)path;
+
+/**
+ *  Callback after entering text containing the @ character
+ */
+- (void)inputBarDidInputAt:(TUIInputBar *)textView;
+
+/**
+ *  Callback after removing text containing @ characters (e.g. removing @xxx)
+ */
+- (void)inputBar:(TUIInputBar *)textView didDeleteAt:(NSString *)text;
+
+/**
+ *  Callback after keyboard button click
+ *  After clicking the emoticon button, the "smiley face" icon at the corresponding position will become the "keyboard" icon, which is the keyboard button at
+ * this time. You can use this callback to: hide the currently displayed emoticon view or more views, and open the keyboard.
+ */
+- (void)inputBarDidTouchKeyboard:(TUIInputBar *)textView;
+
+/**
+ * Callback after clicking delete button on keyboard
+ */
+- (void)inputBarDidDeleteBackward:(TUIInputBar *)textView;
+
+- (void)inputTextViewShouldBeginTyping:(UITextView *)textView;
+
+- (void)inputTextViewShouldEndTyping:(UITextView *)textView;
+
+@end
+
+/////////////////////////////////////////////////////////////////////////////////
+//
+//                              TUIInputBar
+//
+/////////////////////////////////////////////////////////////////////////////////
+
+@interface TUIInputBar : UIView
+
+/**
+ *  Separtor
+ */
+@property(nonatomic, strong) UIView *lineView;
+
+/**
+ *  Voice button
+ *  Switch to voice input state after clicking
+ */
+@property(nonatomic, strong) UIButton *micButton;
+
+/**
+ *  Keyboard button
+ *  Switch to keyboard input state after clicking
+ */
+@property(nonatomic, strong) UIButton *keyboardButton;
+
+/**
+ *  Input view
+ */
+@property(nonatomic, strong) TUIResponderTextView *inputTextView;
+
+/**
+ *  Emoticon button
+ *  Switch to emoji input state after clicking
+ */
+@property(nonatomic, strong) UIButton *faceButton;
+
+/**
+ *  More  button
+ *  A button that, when clicked, opens up more menu options
+ */
+@property(nonatomic, strong) UIButton *moreButton;
+
+/**
+ *  Record button, long press the button to start recording
+ */
+@property(nonatomic, strong) UIButton *recordButton;
+
+@property(nonatomic, weak) id<TUIInputBarDelegate> delegate;
+
+@property(nonatomic, copy) void (^inputBarTextChanged)(UITextView * textview);
+
+@property(nonatomic, assign) BOOL isFromReplyPage;
+
+- (void)defaultLayout;
+/**
+ *  Add emoticon text
+ *  Used to input emoticon text in the current text input box
+ *
+ *  @param emoji The string representation of the emoticon to be entered.
+ */
+- (void)addEmoji:(TUIFaceCellData *)emoji;
+
+- (void)backDelete;
+
+- (void)clearInput;
+
+- (NSString *)getInput;
+
+- (void)updateTextViewFrame;
+
+- (void)changeToKeyboard;
+
+- (void)addDraftToInputBar:(NSAttributedString *)draft;
+- (void)addWordsToInputBar:(NSAttributedString *)words;
+@end