File: bookmark_bar.mojom

package info (click to toggle)
chromium 142.0.7444.175-1
  • links: PTS, VCS
  • area: main
  • in suites: forky, sid
  • size: 6,295,352 kB
  • sloc: cpp: 35,488,378; ansic: 7,479,680; javascript: 4,259,373; python: 1,466,843; xml: 757,444; asm: 710,716; pascal: 187,980; sh: 89,247; perl: 88,690; objc: 79,984; sql: 56,984; cs: 42,192; fortran: 24,137; makefile: 22,913; tcl: 15,277; php: 14,018; yacc: 9,005; ruby: 7,553; awk: 3,720; lisp: 3,096; lex: 1,330; ada: 727; jsp: 228; sed: 36
file content (71 lines) | stat: -rw-r--r-- 2,242 bytes parent folder | download | duplicates (4)
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
// Copyright 2025 The Chromium Authors
// Use of this source code is governed by a BSD-style license that can be
// found in the LICENSE file.

module bookmark_bar.mojom;

import "url/mojom/url.mojom";

// Bookmark Type
// Copied from components/bookmarks/browser/bookmark_node.h
enum BookmarkType {
  URL = 0,
  FOLDER,
  BOOKMARK_BAR,
  OTHER_NODE,
  MOBILE
};

// Data of a bookmark node
struct BookmarkData {
  int64 id;
  string title;
  BookmarkType type;
  // Set to the URL of the page when the favicon is ready.
  url.mojom.Url? page_url_for_favicon;
};

// Used by the WebUI page to bootstrap bidirectional communication.
interface PageHandlerFactory {
  // The WebUI calls this method when the page is first initialized.
  CreatePageHandler(pending_remote<Page> page,
                    pending_receiver<PageHandler> handler);
};

// Browser-side handler for requests from WebUI page.
interface PageHandler {
  // Get all the tabs info from the current browser window.
  GetBookmarkBar() => (array<BookmarkData> bookmarks);

  // TODO(webium): Operations to alter the bookmarks will be needed. They
  // will likely need to pass an entire array of IDs going from bookmark bar
  // to the entry being operated on. An alternative is to use UUIDs, but
  // the BookmarkModel docs discourage their use.

  // TODO(webium): additional variations on open, such as in new window,
  // and multiple tabs, may be desired, if available via bookmark bar.
  OpenInNewTab(int64 node_id);
};

// WebUI-side handler for requests from the browser.
interface Page {
  // Bookmark model finished loading. From now on it can be used to query
  // information about the bookmarks.
  BookmarkLoaded();

  // Bookmark model favicons finish loading.
  FavIconChanged(BookmarkData bookmark_data);

  // TODO(webium): Add additional events about changes to bookmark model.
  // These should largely follow
  // components/bookmarks/browser/bookmark_model_observer.h, but with int64
  // node ids instead of pointers. They should probably be limited to the
  // things under the bookmark bar; further it may also make sense to only
  // care about folder contents when they're opened.

  // Show Bookmark bar
  Show();

  // Hide bookmark bar
  Hide();
};