FlutterTextInputPlugin Class Reference

#include <FlutterTextInputPlugin.h>

Inheritance diagram for FlutterTextInputPlugin:

Instance Methods
(instancetype)	- NS_UNAVAILABLE
(instancetype)	- initWithDelegate:
(void)	- handleMethodCall:result:
(void)	- reset
(UIView< UITextInput > *)	- textInputView
(void)	- setUpIndirectScribbleInteraction:
(void)	- resetViewResponder
(BOOL)	- showEditMenu:
(ios(16.0)	- API_AVAILABLE
(instancetype)	- initWithDelegate:
(BOOL)	- isFirstResponder
(BOOL)	- handleKeyEvent:
(NSRect)	- firstRectForCharacterRange:actualRange:
(NSDictionary *)	- editingState

Class Methods
(instancetype)	+ NS_UNAVAILABLE

Protected Attributes
	: NSObject <FlutterKeySecondaryResponder

Properties
UIIndirectScribbleInteractionDelegate UIViewController *	viewController
id< FlutterIndirectScribbleDelegate >	indirectScribbleDelegate
NSMutableDictionary< UIScribbleElementIdentifier, NSValue * > *	scribbleElements
FlutterTextField *	client
FlutterViewController *	currentViewController
NSTextInputContext *	textInputContext
NSString *	customRunLoopMode

Detailed Description

A plugin to handle text input.

Responsible for bridging the native macOS text input system with the Flutter framework text editing classes, via system channels.

This is not an FlutterPlugin since it needs access to FlutterViewController internals, so needs to be managed differently.

When accessibility is on, accessibility bridge creates a NSTextField, i.e. FlutterTextField, for every text field in the Flutter. This plugin acts as a field editor for those NSTextField[s].

Definition at line 33 of file FlutterTextInputPlugin.h.

Method Documentation

API_AVAILABLE

- (ios(16.0) API_AVAILABLE

editingState

- (NSDictionary *) editingState

Provided by category FlutterTextInputPlugin(TestMethods).

Referenced by flutter::testing::TEST(), and flutter::testing::TEST().

firstRectForCharacterRange:actualRange:

- (NSRect) firstRectForCharacterRange:		(NSRange)	range
actualRange:		(NSRangePointer)	actualRange

Provided by category FlutterTextInputPlugin(TestMethods).

handleKeyEvent:

- (BOOL) handleKeyEvent:

(NSEvent*)

event

Handles key down events received from the view controller, responding YES if the event was handled.

Note, the Apple docs suggest that clients should override essentially all the mouse and keyboard event-handling methods of NSResponder. However, experimentation indicates that only key events are processed by the native layer; Flutter processes mouse events. Additionally, processing both keyUp and keyDown results in duplicate processing of the same keys.

Definition at line 349 of file FlutterTextInputPlugin.mm.

                      :(NSEvent*)event {
  if (event.type == NSEventTypeKeyUp ||
      (event.type == NSEventTypeFlagsChanged && event.modifierFlags < _previouslyPressedFlags)) {
    return NO;
  }
  _previouslyPressedFlags = event.modifierFlags;
  if (!_shown) {
    return NO;
  }
 
  _eventProducedOutput = NO;
  BOOL res = [_textInputContext handleEvent:event];
  // NSTextInputContext#handleEvent returns YES if the context handles the event. One of the reasons
  // the event is handled is because it's a key equivalent. But a key equivalent might produce a
  // text command (indicated by calling doCommandBySelector) or might not (for example, Cmd+Q). In
  // the latter case, this command somehow has not been executed yet and Flutter must dispatch it to
  // the next responder. See https://github.com/flutter/flutter/issues/106354 .
  // The event is also not redispatched if there is IME composition active, because it might be
  // handled by the IME. See https://github.com/flutter/flutter/issues/134699
 
  // both NSEventModifierFlagNumericPad and NSEventModifierFlagFunction are set for arrow keys.
  bool is_navigation = event.modifierFlags & NSEventModifierFlagFunction &&
                       event.modifierFlags & NSEventModifierFlagNumericPad;
  bool is_navigation_in_ime = is_navigation && self.hasMarkedText;
 
  if (event.isKeyEquivalent && !is_navigation_in_ime && !_eventProducedOutput) {
    return NO;
  }
  return res;
}

References _channel, FlutterMethodChannel::methodChannelWithName:binaryMessenger:codec:, and self.

handleMethodCall:result:

- (void) handleMethodCall:		(FlutterMethodCall*)	call
result:		(FlutterResult)	result

Provided by category FlutterTextInputPlugin(TestMethods).

Definition at line 2546 of file FlutterTextInputPlugin.mm.

                        :(FlutterMethodCall*)call result:(FlutterResult)result {
  NSString* method = call.method;
  id args = call.arguments;
  if ([method isEqualToString:kShowMethod]) {
    [self showTextInput];
    result(nil);
  } else if ([method isEqualToString:kHideMethod]) {
    [self hideTextInput];
    result(nil);
  } else if ([method isEqualToString:kSetClientMethod]) {
    [self setTextInputClient:[args[0] intValue] withConfiguration:args[1]];
    result(nil);
  } else if ([method isEqualToString:kSetPlatformViewClientMethod]) {
    // This method call has a `platformViewId` argument, but we do not need it for iOS for now.
    [self setPlatformViewTextInputClient];
    result(nil);
  } else if ([method isEqualToString:kSetEditingStateMethod]) {
    [self setTextInputEditingState:args];
    result(nil);
  } else if ([method isEqualToString:kClearClientMethod]) {
    [self clearTextInputClient];
    result(nil);
  } else if ([method isEqualToString:kSetEditableSizeAndTransformMethod]) {
    [self setEditableSizeAndTransform:args];
    result(nil);
  } else if ([method isEqualToString:kSetMarkedTextRectMethod]) {
    [self updateMarkedRect:args];
    result(nil);
  } else if ([method isEqualToString:kFinishAutofillContextMethod]) {
    [self triggerAutofillSave:[args boolValue]];
    result(nil);
    // TODO(justinmc): Remove the TextInput method constant when the framework has
    // finished transitioning to using the Scribble channel.
    // https://github.com/flutter/flutter/pull/104128
  } else if ([method isEqualToString:kDeprecatedSetSelectionRectsMethod]) {
    [self setSelectionRects:args];
    result(nil);
  } else if ([method isEqualToString:kSetSelectionRectsMethod]) {
    [self setSelectionRects:args];
    result(nil);
  } else if ([method isEqualToString:kStartLiveTextInputMethod]) {
    [self startLiveTextInput];
    result(nil);
  } else if ([method isEqualToString:kUpdateConfigMethod]) {
    [self updateConfig:args];
    result(nil);
  } else if ([method isEqualToString:kOnInteractiveKeyboardPointerMoveMethod]) {
    CGFloat pointerY = (CGFloat)[args[@"pointerY"] doubleValue];
    [self handlePointerMove:pointerY];
    result(nil);
  } else if ([method isEqualToString:kOnInteractiveKeyboardPointerUpMethod]) {
    CGFloat pointerY = (CGFloat)[args[@"pointerY"] doubleValue];
    [self handlePointerUp:pointerY];
    result(nil);
  } else {
    result(FlutterMethodNotImplemented);
  }
}

Referenced by flutter::testing::TEST(), flutter::testing::TEST(), flutter::testing::TEST(), flutter::testing::TEST(), and flutter::testing::TEST().

initWithDelegate: [1/2]

- (instancetype) initWithDelegate:

(id<FlutterTextInputDelegate>)

NS_DESIGNATED_INITIALIZER

Definition at line 2546 of file FlutterTextInputPlugin.mm.

                                :(id<FlutterTextInputDelegate>)textInputDelegate {
  self = [super init];
  if (self) {
    // `_textInputDelegate` is a weak reference because it should retain FlutterTextInputPlugin.
    _textInputDelegate = textInputDelegate;
    _autofillContext = [[NSMutableDictionary alloc] init];
    _inputHider = [[FlutterTextInputViewAccessibilityHider alloc] init];
    _scribbleElements = [[NSMutableDictionary alloc] init];
    _keyboardViewContainer = [[UIView alloc] init];
 
    [[NSNotificationCenter defaultCenter] addObserver:self
                                             selector:@selector(handleKeyboardWillShow:)
                                                 name:UIKeyboardWillShowNotification
                                               object:nil];
  }
 
  return self;
}

initWithDelegate: [2/2]

- (instancetype) initWithDelegate:

(id<FlutterTextInputPluginDelegate>)

delegate

Initializes a text input plugin that coordinates key event handling with |viewController|.

Definition at line 349 of file FlutterTextInputPlugin.mm.

                                :(id<FlutterTextInputPluginDelegate>)delegate {
  // The view needs an empty frame otherwise it is visible on dark background.
  // https://github.com/flutter/flutter/issues/118504
  self = [super initWithFrame:NSZeroRect];
  self.clipsToBounds = YES;
  if (self != nil) {
    _delegate = delegate;
    _channel = [FlutterMethodChannel methodChannelWithName:kTextInputChannel
                                           binaryMessenger:_delegate.binaryMessenger
                                                     codec:[FlutterJSONMethodCodec sharedInstance]];
    _shown = FALSE;
    // NSTextView does not support _weak reference, so this class has to
    // use __unsafe_unretained and manage the reference by itself.
    //
    // Since the dealloc removes the handler, the pointer should
    // be valid if the handler is ever called.
    __unsafe_unretained FlutterTextInputPlugin* unsafeSelf = self;
    [_channel setMethodCallHandler:^(FlutterMethodCall* call, FlutterResult result) {
      [unsafeSelf handleMethodCall:call result:result];
    }];
    _textInputContext = [[NSTextInputContext alloc] initWithClient:unsafeSelf];
    _previouslyPressedFlags = 0;
 
    // Initialize with the zero matrix which is not
    // an affine transform.
    _editableTransform = CATransform3D();
    _caretRect = CGRectNull;
  }
  return self;
}

isFirstResponder

- (BOOL) isFirstResponder

Whether this plugin is the first responder of this NSWindow.

When accessibility is on, this plugin is set as the first responder to act as the field editor for FlutterTextFields.

Returns false if accessibility is off.

Definition at line 349 of file FlutterTextInputPlugin.mm.

                         {
  if (!_currentViewController.viewLoaded) {
    return false;
  }
  return [_currentViewController.view.window firstResponder] == self;
}

NS_UNAVAILABLE [1/2]

- (instancetype) NS_UNAVAILABLE

NS_UNAVAILABLE [2/2]

+ (instancetype) NS_UNAVAILABLE

reset

- (void) reset

Reset the text input plugin to prepare for a hot restart.

This hides the software keyboard and text editing context menu.

Definition at line 2546 of file FlutterTextInputPlugin.mm.

              {
  [_autofillContext removeAllObjects];
  [self clearTextInputClient];
  [self hideTextInput];
}

resetViewResponder

- (void) resetViewResponder

Definition at line 2546 of file FlutterTextInputPlugin.mm.

                           {
  _viewResponder = nil;
}

setUpIndirectScribbleInteraction:

- (void) setUpIndirectScribbleInteraction:

(id<FlutterViewResponder>)

viewResponder

These are used by the UIIndirectScribbleInteractionDelegate methods to handle focusing on the correct element.

Definition at line 2546 of file FlutterTextInputPlugin.mm.

                                        :(id<FlutterViewResponder>)viewResponder {
  if (_viewResponder != viewResponder) {
    if (@available(iOS 14.0, *)) {
      UIView* parentView = viewResponder.view;
      if (parentView != nil) {
        UIIndirectScribbleInteraction* scribbleInteraction = [[UIIndirectScribbleInteraction alloc]
            initWithDelegate:(id<UIIndirectScribbleInteractionDelegate>)self];
        [parentView addInteraction:scribbleInteraction];
      }
    }
  }
  _viewResponder = viewResponder;
}

showEditMenu:

- (BOOL) showEditMenu:

(ios(16.0))

API_AVAILABLE

Definition at line 2546 of file FlutterTextInputPlugin.mm.

                    :(NSDictionary*)args API_AVAILABLE(ios(16.0)) {
  if (!self.activeView.isFirstResponder) {
    return NO;
  }
  NSDictionary<NSString*, NSNumber*>* encodedTargetRect = args[@"targetRect"];
  CGRect globalTargetRect = CGRectMake(
      [encodedTargetRect[@"x"] doubleValue], [encodedTargetRect[@"y"] doubleValue],
      [encodedTargetRect[@"width"] doubleValue], [encodedTargetRect[@"height"] doubleValue]);
  CGRect localTargetRect = [self.hostView convertRect:globalTargetRect toView:self.activeView];
  [self.activeView showEditMenuWithTargetRect:localTargetRect items:args[@"items"]];
  return YES;
}

textInputView

- (UIView< UITextInput > *) textInputView

The UITextInput implementation used to control text entry.

This is used by AccessibilityBridge to forward interactions with iOS' accessibility system.

Definition at line 2546 of file FlutterTextInputPlugin.mm.

                                      {
  return _activeView;
}

Member Data Documentation

__pad0__

- __pad0__

protected

Definition at line 187 of file FlutterTextInputPlugin.h.

Property Documentation

client

- (FlutterTextField*) client

readwritenonatomicweak

The NSTextField that currently has this plugin as its field editor.

Must be nil if accessibility is off.

Definition at line 48 of file FlutterTextInputPlugin.h.

currentViewController

- (FlutterViewController*) currentViewController

readnonatomicweak

Returns the view controller text input plugin is currently attached to, nil if not attached to any view controller.

In case of popup windows, this will be the view controller of the closest window in hierarchy above that can receive keyboard input.

Definition at line 57 of file FlutterTextInputPlugin.h.

Referenced by flutter::testing::TEST(), and flutter::testing::TEST().

customRunLoopMode

- (NSString*) customRunLoopMode

readwritenonatomicassign

Provided by category FlutterTextInputPlugin(TestMethods).

Definition at line 94 of file FlutterTextInputPlugin.h.

indirectScribbleDelegate

- (id<FlutterIndirectScribbleDelegate>) indirectScribbleDelegate

readwritenonatomicweak

Definition at line 37 of file FlutterTextInputPlugin.h.

scribbleElements

- (NSMutableDictionary<UIScribbleElementIdentifier, NSValue*>*) scribbleElements

readwritenonatomicstrong

Definition at line 39 of file FlutterTextInputPlugin.h.

textInputContext

- (NSTextInputContext*) textInputContext

readwritenonatomicassign

Provided by category FlutterTextInputPlugin(TestMethods).

Definition at line 93 of file FlutterTextInputPlugin.h.

viewController

- (UIIndirectScribbleInteractionDelegate UIViewController*) viewController

readwritenonatomicweak

Definition at line 36 of file FlutterTextInputPlugin.h.

---

The documentation for this class was generated from the following files:

• shell/platform/darwin/ios/framework/Source/FlutterTextInputPlugin.h
• shell/platform/darwin/macos/framework/Source/FlutterTextInputPlugin.h
• shell/platform/darwin/ios/framework/Source/FlutterTextInputPlugin.mm
• shell/platform/darwin/macos/framework/Source/FlutterTextInputPlugin.mm