summaryrefslogtreecommitdiffstats
path: root/widget/nsITouchBarHelper.idl
blob: 62d2e8593bb9ec7aebff57c1c0b94b2b896a0af1 (plain)
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
/* 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 "nsIArray.idl"
#include "nsISupports.idl"
#include "nsITouchBarInput.idl"

webidl Document;

/**
 * Back-to-frontend communication for the Touch Bar
 */
[scriptable, uuid(ea109912-3acc-48de-b679-c23b6a122da5)]
interface nsITouchBarHelper : nsISupports
{
  /**
   * Returns the active browser's URL.
   */
  readonly attribute AString activeUrl;

  /**
   * Return the active browser's page title.
   */
  readonly attribute AString activeTitle;

  /**
   * Return true if the Urlbar has focus.
   */
  readonly attribute boolean isUrlbarFocused;

  /**
   * Toggles Urlbar focus.
   */
  void toggleFocusUrlbar();

  /**
   * Unfocuses the Urlbar.
   */
  void unfocusUrlbar();

  /**
   * Returns all available Touch Bar Inputs in an nsIArray
   * of nsITouchBarInput objects.
   */
  attribute nsIArray allItems;

  /**
   * The context in which this nsITouchBarHelper exists. Required to create
   * an imgLoader to load our SVG icons.
   */
  readonly attribute Document document;

  /**
   * Returns the requested TouchBarInput.
   * Exposed for testing.
   */
  nsITouchBarInput getTouchBarInput(in string aInputName);

  /**
   * Inserts a search restriction string in the Urlbar.
   * Exposed for testing.
   */
  void insertRestrictionInUrlbar(in string aToken);
};