Source code

Revision control

Other Tools

1
/* -*- Mode: C++; tab-width: 2; indent-tabs-mode: nil; c-basic-offset: 2 -*-
2
*
3
* This Source Code Form is subject to the terms of the Mozilla Public
4
* License, v. 2.0. If a copy of the MPL was not distributed with this
5
* file, You can obtain one at http://mozilla.org/MPL/2.0/. */
6
7
#include "nsISupports.idl"
8
9
interface nsIURI;
10
11
[scriptable, uuid(249fb5ad-ae29-4e2c-a728-ba5cf464d188)]
12
interface nsIChromeRegistry : nsISupports
13
{
14
const int32_t NONE = 0;
15
const int32_t PARTIAL = 1;
16
const int32_t FULL = 2;
17
18
/**
19
* Resolve a chrome URL to an loadable URI using the information in the
20
* registry. Does not modify aChromeURL.
21
*
22
* Chrome URLs are allowed to be specified in "shorthand", leaving the
23
* "file" portion off. In that case, the URL is expanded to:
24
*
26
*
27
* where "ext" is:
28
*
29
* "xul" for a "content" package,
30
* "css" for a "skin" package, and
31
* "dtd" for a "locale" package.
32
*
33
* @param aChromeURL the URL that is to be converted.
34
*/
35
nsIURI convertChromeURL(in nsIURI aChromeURL);
36
37
/**
38
* refresh the chrome list at runtime, looking for new packages/etc
39
*/
40
void checkForNewChrome();
41
};
42
43
[scriptable, uuid(93251ddf-5e85-4172-ac2a-31780562974f)]
44
interface nsIXULChromeRegistry : nsIChromeRegistry
45
{
46
// Get whether the default writing direction of the locale is RTL
47
// (or may be overridden by intl.uidirection pref)
48
boolean isLocaleRTL(in ACString package);
49
50
/**
51
* Installable skin XBL is not always granted the same privileges as other
52
* chrome. This asks the chrome registry whether scripts are allowed to be
53
* run for a particular chrome URI. Do not pass non-chrome URIs to this
54
* method.
55
*/
56
boolean allowScriptsForPackage(in nsIURI url);
57
58
/**
59
* Content should only be allowed to load chrome JS from certain packages.
60
* This method reflects the contentaccessible flag on packages.
61
* Do not pass non-chrome URIs to this method.
62
*/
63
boolean allowContentToAccess(in nsIURI url);
64
65
/**
66
* Returns true if the passed chrome URL is allowed to be loaded in a remote
67
* process. This reflects the remoteenabled flag on packages.
68
* Do not pass non-chrome URIs to this method.
69
*/
70
boolean canLoadURLRemotely(in nsIURI url);
71
72
/**
73
* Returns true if the passed chrome URL must be loaded in a remote process.
74
* This reflects the remoterequired flag on packages.
75
* Do not pass non-chrome URIs to this method.
76
*/
77
boolean mustLoadURLRemotely(in nsIURI url);
78
};
79
80
%{ C++
81
82
#define NS_CHROMEREGISTRY_CONTRACTID \
83
"@mozilla.org/chrome/chrome-registry;1"
84
85
/**
86
* Chrome registry will notify various caches that all chrome files need
87
* flushing.
88
*/
89
#define NS_CHROME_FLUSH_TOPIC \
90
"chrome-flush-caches"
91
92
%}