blob: cb219eb24ffcefffe3e0ff7f0b0076a65cfab56c [file] [log] [blame]
// Copyright 2014 The Chromium Authors. All rights reserved.
// Use of this source code is governed by a BSD-style license that can be
// found in the LICENSE file.
#import <UIKit/UIKit.h>
#import "ios/chrome/browser/autofill/form_input_accessory_view_delegate.h"
#import "ios/web/public/web_state/web_state_observer_bridge.h"
@protocol CRWWebViewProxy;
namespace autofill {
extern NSString* const kFormSuggestionAssistButtonPreviousElement;
extern NSString* const kFormSuggestionAssistButtonNextElement;
extern NSString* const kFormSuggestionAssistButtonDone;
extern CGFloat const kInputAccessoryHeight;
} // namespace autofill
@protocol FormInputAccessoryViewProvider;
@class FormInputAccessoryViewController;
// Block type to indicate that a FormInputAccessoryViewProvider has an accessory
// view to provide.
typedef void (^AccessoryViewAvailableCompletion)(
BOOL inputAccessoryViewAvailable);
// Block type to provide an accessory view asynchronously.
typedef void (^AccessoryViewReadyCompletion)(
UIView* view,
id<FormInputAccessoryViewProvider> provider);
// Represents an object that can provide a custom keyboard input accessory view.
@protocol FormInputAccessoryViewProvider<NSObject>
// A delegate for form navigation.
@property(nonatomic, assign)
id<FormInputAccessoryViewDelegate> accessoryViewDelegate;
// Determines asynchronously if this provider has a view available for the
// specified form/field and invokes |completionHandler| with the answer.
- (void)
checkIfAccessoryViewIsAvailableForForm:(const web::FormActivityParams&)params
// Asynchronously retrieves an accessory view from this provider for the
// specified form/field and returns it via |accessoryViewUpdateBlock|.
- (void)retrieveAccessoryViewForForm:(const web::FormActivityParams&)params
// Notifies this provider that the accessory view is going away.
- (void)inputAccessoryViewControllerDidReset:
// Notifies this provider that the accessory view frame is changing. If the
// view provided by this provider needs to change, the updated view should be
// set using |accessoryViewUpdateBlock|.
- (void)resizeAccessoryView;
// Returns YES if UMA metrics for keyboard accessory button presses should be
// logged for this provider.
- (BOOL)getLogKeyboardAccessoryMetrics;
// Creates and manages a custom input accessory view while the user is
// interacting with a form. Also handles hiding and showing the default
// accessory view elements.
@interface FormInputAccessoryViewController
: NSObject<CRWWebStateObserver, FormInputAccessoryViewDelegate>
// The current web view proxy.
// TODO( This property should not be a part of the public
// interface, it is used in tests as a backdoor.
@property(nonatomic, readonly) id<CRWWebViewProxy> webViewProxy;
// Initializes a new controller with the specified |providers| of input
// accessory views.
- (instancetype)initWithWebState:(web::WebState*)webState
// Notifies the controller that the owning tab was shown.
- (void)wasShown;
// Notifies the controller that the owning tab was hidden.
- (void)wasHidden;
// Instructs the controller to detach itself from the WebState.
- (void)detachFromWebState;
// Hides the default input accessory view and replaces it with one that shows
// |customView| and form navigation controls.
- (void)showCustomInputAccessoryView:(UIView*)customView;
// Restores the default input accessory view, removing (if necessary) any
// previously-added custom view.
- (void)restoreDefaultInputAccessoryView;