toolkit/components/satchel/nsIFormFillController.idl

Fri, 16 Jan 2015 18:13:44 +0100

author
Michael Schloh von Bennewitz <michael@schloh.com>
date
Fri, 16 Jan 2015 18:13:44 +0100
branch
TOR_BUG_9701
changeset 14
925c144e1f1f
permissions
-rw-r--r--

Integrate suggestion from review to improve consistency with existing code.

michael@0 1 /* This Source Code Form is subject to the terms of the Mozilla Public
michael@0 2 * License, v. 2.0. If a copy of the MPL was not distributed with this
michael@0 3 * file, You can obtain one at http://mozilla.org/MPL/2.0/. */
michael@0 4
michael@0 5 #include "nsISupports.idl"
michael@0 6
michael@0 7 interface nsIDocShell;
michael@0 8 interface nsIAutoCompletePopup;
michael@0 9 interface nsIDOMHTMLInputElement;
michael@0 10
michael@0 11 /*
michael@0 12 * nsIFormFillController is an interface for controlling form fill behavior
michael@0 13 * on HTML documents. Any number of docShells can be controller concurrently.
michael@0 14 * While a docShell is attached, all HTML documents that are loaded within it
michael@0 15 * will have a focus listener attached that will listen for when a text input
michael@0 16 * is focused. When this happens, the input will be bound to the
michael@0 17 * global nsIAutoCompleteController service.
michael@0 18 */
michael@0 19
michael@0 20 [scriptable, uuid(07f0a0dc-f6e9-4cdd-a55f-56d770523a4c)]
michael@0 21 interface nsIFormFillController : nsISupports
michael@0 22 {
michael@0 23 /*
michael@0 24 * Start controlling form fill behavior for the given browser
michael@0 25 *
michael@0 26 * @param docShell - The docShell to attach to
michael@0 27 * @param popup - The popup to show when autocomplete results are available
michael@0 28 */
michael@0 29 void attachToBrowser(in nsIDocShell docShell, in nsIAutoCompletePopup popup);
michael@0 30
michael@0 31 /*
michael@0 32 * Stop controlling form fill behavior for the given browser
michael@0 33 *
michael@0 34 * @param docShell - The docShell to detach from
michael@0 35 */
michael@0 36 void detachFromBrowser(in nsIDocShell docShell);
michael@0 37
michael@0 38 /*
michael@0 39 * Mark the specified <input> element as being managed by password manager.
michael@0 40 * Autocomplete requests will be handed off to the password manager, and will
michael@0 41 * not be stored in form history.
michael@0 42 *
michael@0 43 * @param aInput - The HTML <input> element to tag
michael@0 44 */
michael@0 45 void markAsLoginManagerField(in nsIDOMHTMLInputElement aInput);
michael@0 46 };

mercurial