File: nsIFormFillController.idl

package info (click to toggle)
thunderbird 1%3A68.10.0-1~deb9u1
  • links: PTS, VCS
  • area: main
  • in suites: stretch
  • size: 2,754,812 kB
  • sloc: cpp: 5,411,679; javascript: 4,161,772; ansic: 2,639,702; python: 763,064; java: 346,606; xml: 266,623; asm: 265,884; sh: 117,270; lisp: 41,340; makefile: 23,560; perl: 18,042; objc: 5,277; yacc: 1,778; ada: 1,681; pascal: 1,673; lex: 1,417; cs: 879; exp: 527; awk: 495; php: 436; ruby: 221; sed: 69; csh: 27
file content (75 lines) | stat: -rw-r--r-- 2,552 bytes parent folder | download | duplicates (2)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
/* This Source Code Form is subject to the terms of the Mozilla Public
 * License, v. 2.0. If a copy of the MPL was not distributed with this
 * file, You can obtain one at http://mozilla.org/MPL/2.0/. */

#include "nsISupports.idl"

interface nsIDocShell;
interface nsIAutoCompletePopup;

webidl Element;
webidl HTMLInputElement;

/*
 * nsIFormFillController is an interface for controlling form fill behavior
 * on HTML documents.  Any number of docShells can be controller concurrently.
 * While a docShell is attached, all HTML documents that are loaded within it
 * will have a focus listener attached that will listen for when a text input
 * is focused.  When this happens, the input will be bound to the
 * global nsIAutoCompleteController service.
 */

[scriptable, uuid(07f0a0dc-f6e9-4cdd-a55f-56d770523a4c)]
interface nsIFormFillController : nsISupports
{
  /*
   * The input element the form fill controller is currently bound to.
   */
  readonly attribute HTMLInputElement focusedInput;

  /*
   * Whether the autocomplete popup on a password field was automatically opened
   * by the form fill controller (upon focus).
   */
  readonly attribute boolean passwordPopupAutomaticallyOpened;

  /*
   * Start controlling form fill behavior for the given browser
   *
   * @param docShell - The docShell to attach to
   * @param popup - The popup to show when autocomplete results are available
   */
  [can_run_script]
  void attachToBrowser(in nsIDocShell docShell, in nsIAutoCompletePopup popup);
  [can_run_script]
  void attachPopupElementToBrowser(in nsIDocShell docShell, in Element popup);

  /*
   * Stop controlling form fill behavior for the given browser
   *
   * @param docShell - The docShell to detach from
   */
  [can_run_script] void detachFromBrowser(in nsIDocShell docShell);

  /*
   * Mark the specified <input> element as being managed by password manager.
   * Autocomplete requests will be handed off to the password manager, and will
   * not be stored in form history.
   *
   * @param aInput - The HTML <input> element to tag
   */
  [can_run_script] void markAsLoginManagerField(in HTMLInputElement aInput);

  /*
   * Mark the specified <input> element as being managed by a form autofill component.
   * Autocomplete requests will be handed off to the autofill component.
   *
   * @param aInput - The HTML <input> element to mark
   */
  [can_run_script] void markAsAutofillField(in HTMLInputElement aInput);

  /*
   * Open the autocomplete popup, if possible.
   */
  [can_run_script] void showPopup();
};