From a065e04d529da1d847b5062a12c46d916408bf32 Mon Sep 17 00:00:00 2001 From: Peter Bengtsson Date: Tue, 8 Dec 2020 21:46:22 -0500 Subject: update based on https://github.com/mdn/yari/issues/2028 --- files/de/codeschnipsel/cookies/index.html | 45 -- files/de/codeschnipsel/index.html | 28 -- files/de/codeschnipsel/on_page_load/index.html | 124 ------ files/de/codeschnipsel/scrollbar/index.html | 32 -- files/de/codeschnipsel/tabbed_browser/index.html | 517 ----------------------- files/de/codeschnipsel/tree/index.html | 69 --- files/de/codeschnipsel/windows/index.html | 60 --- 7 files changed, 875 deletions(-) delete mode 100644 files/de/codeschnipsel/cookies/index.html delete mode 100644 files/de/codeschnipsel/index.html delete mode 100644 files/de/codeschnipsel/on_page_load/index.html delete mode 100644 files/de/codeschnipsel/scrollbar/index.html delete mode 100644 files/de/codeschnipsel/tabbed_browser/index.html delete mode 100644 files/de/codeschnipsel/tree/index.html delete mode 100644 files/de/codeschnipsel/windows/index.html (limited to 'files/de/codeschnipsel') diff --git a/files/de/codeschnipsel/cookies/index.html b/files/de/codeschnipsel/cookies/index.html deleted file mode 100644 index 555505f616..0000000000 --- a/files/de/codeschnipsel/cookies/index.html +++ /dev/null @@ -1,45 +0,0 @@ ---- -title: Cookies -slug: Codeschnipsel/Cookies -tags: - - Add-ons - - Codeschnipsel - - Cookies - - Erweiterungen -translation_of: Archive/Add-ons/Code_snippets/Cookies ---- -

Existierende Cookies lesen

- -

Cookies für einen gegebenen Host, repräsentiert als nsICookie2 Objekte, können so nummeriert werden:

- -
let enum = Services.cookies.getCookiesFromHost("example.com");
-while (enum.hasMoreElements()) {
-  var cookie = e.getNext().QueryInterface(Ci.nsICookie2);
-  dump(cookie.host + ";" + cookie.name + "=" + cookie.value + "\n");
-}
-
- -

Alle Cookies, regardless vom Host, kann man mit Services.cookies.enumerator rather than getCookiesFromHost().

- -

nummerieren.

- - - -

Der folgende Code zeigt, wie man in Firefox ein Cookie einstellt.

- -
Services.cookies.add(".host.example.com", "/cookie-path", "cookie_name", "cookie_value", is_secure, is_http_only, is_session, expiry_date);
-
- -

Siehe auch

- - - -

{{ languages( { "fr": "fr/Extraits_de_code/Cookies", "ja": "ja/Code_snippets/Cookies", "pl": "pl/Fragmenty_kodu/Ciasteczka" } ) }}

diff --git a/files/de/codeschnipsel/index.html b/files/de/codeschnipsel/index.html deleted file mode 100644 index 31c6bc8bf3..0000000000 --- a/files/de/codeschnipsel/index.html +++ /dev/null @@ -1,28 +0,0 @@ ---- -title: Codeschnipsel -slug: Codeschnipsel -tags: - - Add-ons - - Erweiterungen -translation_of: Archive/Add-ons/Code_snippets ---- -

Dies ist eine Liste mit nützlichen Codeschnipseln (kleine Code-Beispiele) für Entwickler von Erweiterungen für verschiedene Mozilla Anwendungen. Viele dieser Beispiele können sowohl in XULRunner als auch im aktuellen Mozilla-Code benutzt werden.

-

Diese Beispiele zeigen, wie grundlegende Aufgaben bewältigt werden können, deren Lösung nicht offensichtlich ist.

-

Allgemein

-
Windows
Fenster öffnen und bearbeiten.
Toolbar
Code im Bezug zur Toolbar.
Sidebar
Code im Bezug zur Sidebar.
XML
Beispielcode, um XML zu parsen, zu schreiben und zu verändern.
File I/O
Beispielcode, um Dateien zu lesen und zu schreiben.
Drag & Drop
Beispielcode, um "Drag und Drop" Ereignisse zu verwalten
Dialoge
Beispielcode, um Dialogboxen und Eingabeaufforderungen anzuzeigen.
Warnungen und Meldungen
Modale und nicht-modale Wege den Benutzer zu benachrichtigen.
Einstellungen
Beispielcode, um Einstellungen zu lesen, zu schreiben und zu verändern.
JS XPCOM
Beispielcode, um XPCOM Komponenten in JavaScript aufzurufen
Anwendungen starten
Beispielcode, um andere Anwendungen zu starten.
<canvas>
Auf Canvas bezogener Code.
Signierung einer XPI
Wie eine XPI mit PKI signiert wird.
Threads
Hintergrundoperationen ausführen und die Ausführung verzögern, während Hintergrundoperationen beendet werden.
Diverses
Diverse nützliche Codefragmente.
HTML zu DOM
Verwendung eines versteckten Browserelements, um HTML zu DOM zu parsen.
-
-

Browser-orientierter Code

-
Tabbed Browser (Firefox/SeaMonkey)
Grundlegende Operationen, wie das Laden von Seiten mit dem Tabbed Browser, welche das Herz von Mozilla's Browser Anwendungen darstellen.
Cookies
Lesen, Schreiben, Verändern und Entfernen von Cookies.
Seitenaufbau
Beispielcode, um Seiten zu laden und neu zu laden.
Interaktion zwischen priviligierten und nicht-priviligierten Seiten
Wie man zwischen Erweiterungen und Webseiten kommuniziert.
Dateien herunterladen
Beispielcode, um Dateien und Bilder herunter zu laden und den Downloadfortschritt zu überwachen.
Passwort Manager
Beispielcode, um Passwörter aus/zum integriertem Passwortmanager zu speichern oder auszulesen.
Lesezeichen
Beispielcode, um Lesezeichen auszulesen und zu speichern.
JavaScript Debugger Service
Interaktionen mit dem JavaScript Debugger Service
-
-

SVG

-
Allgemein
Allgemeine Informationen und Werkzeuge.
SVG Animation
Animiertes SVG über JavaScript und SMIL
Interaktives SVG mit JavaScript
Verwendung von JavaScript und DOM Ereignissen, um interaktives SVG zu erstellen.
SVG in HTML und XUL einbetten
Verwendung von SVG, um HTML oder XUL Markup aufzuwerten.
-
-

XUL Widgets

-
HTML Tooltips in XUL
Dynamische Einbettung von HTML in ein XUL Element, um einen Tooltip mit Markup zu versehen.
Beschriftungen und Beschreibungen
Spezielle Verwendungen und Beispiele zu Zeilenumbrüchen.
Tree
Erstellung und Veränderung von Trees mit XUL und JS.
Scrollbar
Das Aussehen der Scrollbar vom Browser sowie Iframes verändern.
Autovervollständigung
Beispielcode, um Autovervollständigung im Browser zu aktivieren.
Boxen
Tipps und Tricks zur Verwendung von Boxen als Container.
Tabbox
Entfernen und Verändern von Tabs in Tabboxen.
-
-

Windows-spezifisch

-
Window Handler (HWND) auffinden (Firefox)
Wie man die Windows API aufruft, um Mozilla Window Handler zu finden. Window Handler können für IPC und Zugänglichkeit gebraucht werden.
Zugang zur Windows Registrierung über XPCOM
Wie man Registrierungschlüssel und -werte auslesen, schreiben, verändern, löschen, aufzählen, und beobachten kann.
-
- -

Die Inhalte auf MozillaZine Example Code werden nach und nach auf diese Seite umgezogen, aber es gibt dort noch einige nützliche Beispiele.

-

{{ languages( { "en": "en/Code_snippets", "fr": "fr/Extraits_de_code", "ja": "ja/Code_snippets", "ko": "ko/Code_snippets", "pl": "pl/Fragmenty_kodu" } ) }}

diff --git a/files/de/codeschnipsel/on_page_load/index.html b/files/de/codeschnipsel/on_page_load/index.html deleted file mode 100644 index ffc64be436..0000000000 --- a/files/de/codeschnipsel/on_page_load/index.html +++ /dev/null @@ -1,124 +0,0 @@ ---- -title: On page load -slug: Codeschnipsel/On_page_load -translation_of: Archive/Add-ons/Code_snippets/On_page_load ---- -

Dieser Artikel ist für XUL / JavaScript-Entwickler, die benutzerdefinierte Code haben wollen jedes Mal eine neue Seite wird im Browser / Mail geladen ausgeführt. Wenn Sie genauere Kontrolle über benutzerdefinierte Code-Ausführung, zum Beispiel benötigen, wie Dokumente Laden oder wenn Registerkarten schalteten sehen Fortschritt Hörer.

- -

Fortschritte Zuhörern ermöglichen Erweiterungen der Ereignisse mit Dokumenten Laden in den Browser und mit Tab Umschalten Ereignissen benachrichtigt werden. Fortschritte Zuhörer Umsetzung der nsIWebProgressListener Schnittstelle.

- -

Erstellen eines Overlays

- -

Zuerst müssen Sie einen erstellen, Überlagerung, um eine (oder mehrere, je nachdem, welche Anwendungen Sie zielen) der folgenden XUL-Dokumente:

- - - - - - - - - - - - - - - - - - - - -
AnwendungURI zu überlagern
Firefoxchrome: //browser/content/browser.xul
Thunderbirdchrome: //messenger/content/messenger.xul
Navigator von SeaMonkeychrome: //navigator/content/navigator.xul
- -

Anbringen eines Skripts

- -

Bringen Sie ein Skript, um Ihre einblenden (siehe "Anbringen eines Skripts zum Erstellen einer Overlay"), die eine fügt Last Ereignis-Listener APPCONTENT Element (Browser) oder messagepane (mail):

- -
window.addEventListener("load", function load(event) {
-    window.removeEventListener("load", load, false); // Listener entfernen, da nicht mehr benötigt
-    myExtension.init();  
-}, false);
-
-var myextension = {
-  init: function() {
-    var APPCONTENT = document.getElementById("APPCONTENT"); // Browser
-    if (APPCONTENT) {
-      appcontent.addEventListener("DOMContentLoaded", myExtension.onPageLoad, true);
-    }
-    var messagepane = document.getElementById("messagepane"); // Mail
-    if (messagepane) {
-      messagepane.addEventListener("load", function(event) { myExtension.onPageLoad(event); }, true);
-    }
-  }
-
-  onPageLoad: function(aEvent) {
-    var doc = aEvent.originalTarget; // doc ist das Dokument, das den "onload" Event ausgelöst hat
-    // Tu etwas mit der geladenen Seite.
-    // doc.location ist ein Location-Objekt (siehe Link unten).
-    // Man kann es verwenden, um Code nur auf bestimmten Seiten auszuführen.
-    if (doc.location.href.search ("forum")> -1)
-      alert("Eine Forum-Seite, wird geladen");
-    
-    // Füge Ereignis-Listener für page "unload" hinzu
-    aEvent.originalTarget.defaultView.addEventListener ("unload", function(event) { myExtension.onPageUnload (event); }, true);
-  }
-
-  onPageUnload: function(Aevent) {
-    // Tu etwas
-  }
-};
-
- -

Aktuelle Firefox Stamm Night die onPageLoad Funktion nicht nur für Dokumente, Feuer, aber xul: Bilder (Favicons in Tabbrowser). Wenn Sie nur wollen, Dokumente zu verarbeiten, zu gewährleisten aEvent.originalTarget.nodeName == "#document".

- -

Wenn Sie mit Code auf einer Seite zu laden, ist es wahrscheinlich, würden Sie wollen, um etwas Bereinigungscode auf Seite Entladen laufen. Um in das Unload-Ereignis im obigen Beispiel können Sie den "pagehide" Veranstaltung wie diese verwenden zu befestigen:

- -
appcontent.addEventListener ("pagehide", myExtension.onPageUnload, false);
-
- -

für APPCONTENT und ähnlich für messagepane

- -
messagepane.addEventListener ("pagehide", myExtension.onPageUnload, false);
- -

und fügen Sie den Code zur onPageUnload Methode.

- -

 

- -

 

- -

Basis onPageLoad für ein Browser-Fenster

- -
var myextension = {
-    init: function () {
-        // Das Ereignis kann DOMContentLoaded werden, pageshow, pagehide, laden oder entladen.
-        if (gBrowser) gBrowser.addEventListener ("DOMContentLoaded", this.onPageLoad, false);
-    }
-    onPageLoad: function (Aevent) {
-        var doc = aEvent.originalTarget; // Doc ist Dokument, das das Ereignis ausgelöst hat
-        var win = doc.defaultView; // Sieg ist das Fenster für den doc
-        // Test gewünschten Bedingungen und etwas tun,
-        // If (doc.nodeName = "#document"!) Return; // Nur Dokumente
-        // If (Sieg = win.top!) Return; // nur Top-Fenster.
-        // If (win.frameElement) return; // Überspringen iframes / Rahmen
-        alert ("Seite geladen wird \ n" + doc.location.href);
-    }
-}
-window.addEventListener ("load", Funktion load (event) {
-    window.removeEventListener ("load", Last, false); // Listener zu entfernen, nicht mehr benötigt
-    myExtension.init ();  
-},falsch);
-
- -

Referenzen

- - - -

Sehe auch

- - diff --git a/files/de/codeschnipsel/scrollbar/index.html b/files/de/codeschnipsel/scrollbar/index.html deleted file mode 100644 index 3fa77ebaf7..0000000000 --- a/files/de/codeschnipsel/scrollbar/index.html +++ /dev/null @@ -1,32 +0,0 @@ ---- -title: Scrollbar -slug: Codeschnipsel/Scrollbar -translation_of: Archive/Add-ons/Code_snippets/Scrollbar ---- -

Dieses Beispiel zeigt, wie die Scrollbars in einer XUL-Applikation verändert werden können.  Scrollbars im Browser werden auch gestylt.
-(Auf Windows XP getestet)

-

Das Beispiel setzt die folgende Struktur voraus:

-
app/chrome/chrome.manifest
-app/chrome/skin/global/
-
-

Kopieren Sie die scrollbars.css von xulrunner/chrome/classic.jar/skin/classic/global nach app/chrome/skin/global/scrollbars.css

-

Öffnen Sie app/chrome/chrome.manifest und fügen Sie folgende Zeilen hinzu:

-
skin app-global standard/1.0 skin/global/
-override chrome://global/skin/xulscrollbars.css chrome://app-global/skin/scrollbars.css
-
-

xulscrollbars.css wird für Windows XP benutzt, nativescrollbars.css auf OSX. Für OSX, fügen Sie noch folgendes an:

-
override chrome://global/skin/nativescrollbars.css chrome://app-global/skin/scrollbars.css
-
-

Ändern Sie nun ein paar Farbwerte in app/chrome/skin/global/scrollbars.css um zu testen, ob das CSS benutzt wird.

-

Beispielfenster in XUL:

-
<?xml version="1.0"?>
-<?xml-stylesheet href="chrome://global/skin/" type="text/css"?>
-<window id="sampleWindow" width="320" height="240"
-   xmlns="http://www.mozilla.org/keymaster/gat...re.is.only.xul">
-<hbox flex="1">
-   <browser type="content" src="http://mozilla.org" flex="1"/>
-   <scrollbar orient="vertical"/>
-</hbox>
-</window>
-
-

{{ languages( { "en": "en/Code_snippets/Scrollbar" } ) }}

diff --git a/files/de/codeschnipsel/tabbed_browser/index.html b/files/de/codeschnipsel/tabbed_browser/index.html deleted file mode 100644 index f08d80a7d4..0000000000 --- a/files/de/codeschnipsel/tabbed_browser/index.html +++ /dev/null @@ -1,517 +0,0 @@ ---- -title: Tabbed browser -slug: Codeschnipsel/Tabbed_browser -translation_of: Archive/Add-ons/Tabbed_browser ---- -

Here you should find a set of useful code snippets to help you work with Firefox's tabbed browser. The comments normally mark where you should be inserting your own code.

-

Each snippet normally includes some code to run at initialization, these are best run using a load listener. These snippets assume they are run in the context of a browser window. If you need to work with tabs from a non-browser window, you need to obtain a reference to one first, see Working with windows in chrome code for details.

-

Multiple meanings for the word 'browser'

-

The word 'browser' is used several ways. Of course the entire application Firefox is called "a browser". Within the Firefox browser are tabs and inside each tab is a browser, both in the common sense of a web page browser and the XUL sense of a {{ XULElem("browser") }} element. Furthermore another meaning of 'browser' in this document and in some Firefox source is "the tabbrowser element" in a Firefox XUL window.

-

Getting access to the browser

-

From main window

-

Code running in Firefox's global ChromeWindow, common for extensions that overlay into browser.xul, can access the {{ XULElem("tabbrowser") }} element using the global variable gBrowser.

-
// gBrowser is only accessible from the scope of
-// the browser window (browser.xul)
-gBrowser.addTab(...);
-
-

If gBrowser isn't defined your code is either not running in the scope of the browser window or running too early. You can access gBrowser only after the browser window is fully loaded. If you need to do something with gBrowser right after the window is opened, listen for the load event and use gBrowser in the event listener.

-

If your code does not have access to the main window because it is run in a sidebar or dialog, you first need to get access to the browser window you need before you can use gBrowser. You can find more information on getting access to the browser window in Working with windows in chrome code.

-

From a sidebar

-

Basically, if your extension code is a sidebar you can use:

-
var mainWindow = window.QueryInterface(Components.interfaces.nsIInterfaceRequestor)
-                       .getInterface(Components.interfaces.nsIWebNavigation)
-                       .QueryInterface(Components.interfaces.nsIDocShellTreeItem)
-                       .rootTreeItem
-                       .QueryInterface(Components.interfaces.nsIInterfaceRequestor)
-                       .getInterface(Components.interfaces.nsIDOMWindow);
-
-mainWindow.gBrowser.addTab(...);
-
-

From a dialog

-

If your code is running in a dialog opened directly by a browser window, you can use:

-
window.opener.gBrowser.addTab(...);
-
-

If window.opener doesn't work, you can get the most recent browser window using this code:

-
var wm = Components.classes["@mozilla.org/appshell/window-mediator;1"]
-                   .getService(Components.interfaces.nsIWindowMediator);
-var mainWindow = wm.getMostRecentWindow("navigator:browser");
-mainWindow.gBrowser.addTab(...);
-
-

Opening a URL in a new tab

-
// Add tab
-gBrowser.addTab("http://www.google.com/");
-
-// Add tab, then make active
-gBrowser.selectedTab = gBrowser.addTab("http://www.google.com/");
-
-

Manipulating content of a new tab

-

If you want to work on the content of the newly opened tab, you'll need to wait until the content has finished loading.

-
// WRONG WAY (the page hasn't finished loading yet)
-var newTabBrowser = gBrowser.getBrowserForTab(gBrowser.addTab("http://www.google.com/"));
-alert(newTabBrowser.contentDocument.body.innerHTML);
-
-// BETTER WAY
-var newTabBrowser = gBrowser.getBrowserForTab(gBrowser.addTab("http://www.google.com/"));
-newTabBrowser.addEventListener("load", function () {
-  newTabBrowser.contentDocument.body.innerHTML = "<div>hello world</div>";
-}, true);
-
-

(The event target in the onLoad handler will be a 'tab' XUL element). See tabbrowser for getBrowserForTab(). Note that the code above does not work inside of the Electrolysis (e10s) enabled tabs.

-

Opening a URL in the correct window/tab

-

There are methods available in chrome://browser/content/utilityOverlay.js that make it easy to open URL in tabs such as openUILinkIn and openUILink.

-
-
- openUILinkIn( url, where, allowThirdPartyFixup, postData, referrerUrl )
-
- where: -
    -
  • "current" current tab (if there aren't any browser windows, then in a new window instead)
    • -
  • "tab" new tab (if there aren't any browser windows, then in a new window instead)
    • -
  • "tabshifted" same as "tab" but in background if default is to select new tabs, and vice versa
    • -
  • "window" new window
    • -
  • "save" save to disk (with no filename hint!)
    • -
-
-
- openUILink( url, e, ignoreButton, ignoreAlt, allowKeywordFixup, postData, referrerUrl )
-
-  
-
-

The following code will open a URL in a new tab, an existing tab, or an existing window based on which mouse button was pressed and which hotkeys (ex: Ctrl) are being held. The code given is for a {{ XULElem("menuitem") }}, but will work equally well for other XUL elements. This will only work in an overlay of browser.xul.

-

XUL:

-
<menuitem oncommand="myExtension.foo(event)" onclick="checkForMiddleClick(this, event)" label="Click me"/>
-
-

JS:

-
var myExtension = {
-  foo: function(event) {
-    openUILink("http://www.example.com", event, false, true);
-  }
-}
-

Opening a URL in an on demand tab

-
var gSessionStore = Cc["@mozilla.org/browser/sessionstore;1"].getService(Ci.nsISessionStore);
-
-// Create new tab, but don't load the content.
-var url = "https://developer.mozilla.org";
-var tab = gBrowser.addTab(null);
-gSessionStore.setTabState(tab, JSON.stringify({
-  entries: [
-    { url: url, title: url }
-  ],
-  lastAccessed: 0,
-  index: 1,
-  hidden: false,
-  attributes: {},
-  image: null
-}));
-
-

Reusing tabs

-

Rather than open a new browser or new tab each and every time one is needed, it is good practice to try to re-use an existing tab which already displays the desired URL--if one is already open. Following this practice minimizes the proliferation of tabs and browsers created by your extension.

-
Reusing by URL/URI
-

A common feature found in many extensions is to point the user to chrome:// URIs in a browser window (for example, help or about information) or external (on-line http(s)://) HTML documents when the user clicks an extension's button or link. The following code demonstrates how to re-use an existing tab that already displays the desired URL/URI. If no such tab exists, a new one is opened with the specified URL/URI.

-
function openAndReuseOneTabPerURL(url) {
-  var wm = Components.classes["@mozilla.org/appshell/window-mediator;1"]
-                     .getService(Components.interfaces.nsIWindowMediator);
-  var browserEnumerator = wm.getEnumerator("navigator:browser");
-
-  // Check each browser instance for our URL
-  var found = false;
-  while (!found && browserEnumerator.hasMoreElements()) {
-    var browserWin = browserEnumerator.getNext();
-    var tabbrowser = browserWin.gBrowser;
-
-    // Check each tab of this browser instance
-    var numTabs = tabbrowser.browsers.length;
-    for (var index = 0; index < numTabs; index++) {
-      var currentBrowser = tabbrowser.getBrowserAtIndex(index);
-      if (url == currentBrowser.currentURI.spec) {
-
-        // The URL is already opened. Select this tab.
-        tabbrowser.selectedTab = tabbrowser.tabContainer.childNodes[index];
-
-        // Focus *this* browser-window
-        browserWin.focus();
-
-        found = true;
-        break;
-      }
-    }
-  }
-
-  // Our URL isn't open. Open it now.
-  if (!found) {
-    var recentWindow = wm.getMostRecentWindow("navigator:browser");
-    if (recentWindow) {
-      // Use an existing browser window
-      recentWindow.delayedOpenTab(url, null, null, null, null);
-    }
-    else {
-      // No browser windows are open, so open a new one.
-      window.open(url);
-    }
-  }
-}
-
-
Reusing by other criteria
-

Sometimes you want to reuse a previously-opened tab regardless of which URL/URI it displays. This assumes the tab is opened by your extension, not by some other browser component. We can do re-use an arbitrary tab by attaching a custom attribute to it when we first open it. Later, when we want to re-use that tab, we iterate over all open tabs looking for one which has our custom attribute. If such a tab exists, we change its URL/URI and focus/select it. If no such tab exists (perhaps the user closed it or we never opened it in the first place), we create a new tab with our custom attribute.

-
function openAndReuseOneTabPerAttribute(attrName, url) {
-  var wm = Components.classes["@mozilla.org/appshell/window-mediator;1"]
-                     .getService(Components.interfaces.nsIWindowMediator);
-  for (var found = false, index = 0, tabbrowser = wm.getEnumerator('navigator:browser').getNext().gBrowser;
-       index < tabbrowser.tabContainer.childNodes.length && !found;
-       index++) {
-
-    // Get the next tab
-    var currentTab = tabbrowser.tabContainer.childNodes[index];
-
-    // Does this tab contain our custom attribute?
-    if (currentTab.hasAttribute(attrName)) {
-
-      // Yes--select and focus it.
-      tabbrowser.selectedTab = currentTab;
-
-      // Focus *this* browser window in case another one is currently focused
-      tabbrowser.ownerDocument.defaultView.focus();
-      found = true;
-    }
-  }
-
-  if (!found) {
-    // Our tab isn't open. Open it now.
-    var browserEnumerator = wm.getEnumerator("navigator:browser");
-    var tabbrowser = browserEnumerator.getNext().gBrowser;
-
-    // Create tab
-    var newTab = tabbrowser.addTab(url);
-    newTab.setAttribute(attrName, "xyz");
-
-    // Focus tab
-    tabbrowser.selectedTab = newTab;
-
-    // Focus *this* browser window in case another one is currently focused
-    tabbrowser.ownerDocument.defaultView.focus();
-  }
-}
-
-

The function can be called like so:

-
openAndReuseOneTabPerAttribute("myextension-myattribute", "http://developer.mozilla.org/").
-
-

Closing a tab

-

This example closes the currently selected tab.

-
gBrowser.removeCurrentTab();
-
-

There is also a more generic removeTab method, which accepts a XUL {{ XULElem("tab") }} element as its single parameter.

-

Changing active tab

-

This moves one tab forward (to the right).

-
gBrowser.tabContainer.advanceSelectedTab(1, true);
-
-

This moves one tab to the left.

-
gBrowser.tabContainer.advanceSelectedTab(-1, true);
-
-

Detecting page load

-

See also Code snippets:On page load

-
function examplePageLoad(event) {
-  if (event.originalTarget instanceof Components.interfaces.nsIDOMHTMLDocument) {
-    var win = event.originalTarget.defaultView;
-    if (win.frameElement) {
-      // Frame within a tab was loaded. win should be the top window of
-      // the frameset. If you don't want do anything when frames/iframes
-      // are loaded in this web page, uncomment the following line:
-      // return;
-      // Find the root document:
-      win = win.top;
-    }
-  }
-}
-
-// do not try to add a callback until the browser window has
-// been initialised. We add a callback to the tabbed browser
-// when the browser's window gets loaded.
-window.addEventListener("load", function () {
-  // Add a callback to be run every time a document loads.
-  // note that this includes frames/iframes within the document
-  gBrowser.addEventListener("load", examplePageLoad, true);
-}, false);
-
-...
-// When no longer needed
-gBrowser.removeEventListener("load", examplePageLoad, true);
-...
-
-

Notification when a tab is added or removed

-
function exampleTabAdded(event) {
-  var browser = gBrowser.getBrowserForTab(event.target);
-  // browser is the XUL element of the browser that's been added
-}
-
-function exampleTabMoved(event) {
-  var browser = gBrowser.getBrowserForTab(event.target);
-  // browser is the XUL element of the browser that's been moved
-}
-
-function exampleTabRemoved(event) {
-  var browser = gBrowser.getBrowserForTab(event.target);
-  // browser is the XUL element of the browser that's been removed
-}
-
-// During initialization
-var container = gBrowser.tabContainer;
-container.addEventListener("TabOpen", exampleTabAdded, false);
-container.addEventListener("TabMove", exampleTabMoved, false);
-container.addEventListener("TabClose", exampleTabRemoved, false);
-
-// When no longer needed
-container.removeEventListener("TabOpen", exampleTabAdded, false);
-container.removeEventListener("TabMove", exampleTabMoved, false);
-container.removeEventListener("TabClose", exampleTabRemoved, false);
-
-
-

Note: Starting in {{Gecko("1.9.1") }}, there's an easy way to listen on progress events on all tabs.

-
-

{{ h2_gecko_minversion("Notification when a tab's attributes change", "2.0") }}

-

Starting in Gecko 2.0, you can detect when a tab's attributes change by listening for the TabAttrModified event. The attributes to which changes result in this event being sent are:

- -
function exampleTabAttrModified(event) {
-  var tab = event.target;
-  // Now you can check what's changed on the tab
-}
-
-// During initialization
-var container = gBrowser.tabContainer;
-container.addEventListener("TabAttrModified", exampleTabAttrModified, false);
-
-// When no longer needed
-container.removeEventListener("TabAttrModified", exampleTabAttrModified, false);
-
-

{{ h2_gecko_minversion("Notification when a tab is pinned or unpinned", "2.0") }}

-

Starting in Gecko 2.0, tabs can be "pinned"; that is, they become special application tabs ("app tabs"), which are pinned to the beginning of the tab bar, and show only the favicon. You can detect when a tab becomes pinned or unpinned by watching for the TabPinned and TabUnpinned events.

-
function exampleTabPinned(event) {
-  var browser = gBrowser.getBrowserForTab(event.target);
-  // browser is the XUL element of the browser that's been pinned
-}
-
-function exampleTabUnpinned(event) {
-  var browser = gBrowser.getBrowserForTab(event.target);
-  // browser is the XUL element of the browser that's been pinned
-}
-
-// Initialization
-
-var container = gBrowser.tabContainer;
-container.addEventListener("TabPinned", exampleTabPinned, false);
-container.addEventListener("TabUnpinned", exampleTabUnpinned, false);
-
-// When no longer needed
-
-container.removeEventListener("TabPinned", exampleTabPinned, false);
-container.removeEventListener("TabUnpinned", exampleTabUnpinned, false);
-
-

Detecting tab selection

-

The following code allows you to detect when a new tab is selected in the browser:

-
function exampleTabSelected(event) {
-  var browser = gBrowser.selectedBrowser;
-  // browser is the XUL element of the browser that's just been selected
-}
-
-// During initialisation
-var container = gBrowser.tabContainer;
-container.addEventListener("TabSelect", exampleTabSelected, false);
-
-// When no longer needed
-container.removeEventListener("TabSelect", exampleTabSelected, false);
-
-

Getting document of currently selected tab

-

The following code allows you to retrieve the document that is in the selected tab. This code will work in the scope of the browser window (e.g. you're working from an overlay to the browser window).

-
gBrowser.contentDocument;
-
-

or

-
content.document
-
-

If you're working from a window or dialog that was opened by the browser window, you can use this code to get the document displayed in the selected tab in the browser window that opened the new window or dialog.

-
window.opener.content.document
-
-

From windows or dialogs not opened by the browser window, you can use {{ interface("nsIWindowMediator") }} to get the document displayed in the selected tab of the most recently used browser window.

-
var wm = Components.classes["@mozilla.org/appshell/window-mediator;1"]
-                   .getService(Components.interfaces.nsIWindowMediator);
-var recentWindow = wm.getMostRecentWindow("navigator:browser");
-return recentWindow ? recentWindow.content.document.location : null;
-
-

See also Working with windows in chrome code.

-

Enumerating browsers

-

To go through all browser in a tabbrowser, first get a reference to a browser's window. If your code is executed from a Firefox browser.xul overlay (for example, it is a toolbar button or menu click handler), you can access the current window with the window pre-defined variable. However, if your code is executed from its own window (for example, a settings/options dialog), you can use {{ interface("nsIWindowMediator") }} to get a browser's window.

-

Next, get the <tabbrowser/> element. You can get it with win.gBrowser, where win is the browser's window from the previous step. You can use simply gBrowser instead of window.gBrowser if running in the context of a browser.xul overlay.

-

Finally, use gBrowser.browsers.length to get the number of browsers and gBrowser.getBrowserAtIndex() to get a <browser/> element. For example:

-
var num = gBrowser.browsers.length;
-for (var i = 0; i < num; i++) {
-  var b = gBrowser.getBrowserAtIndex(i);
-  try {
-    dump(b.currentURI.spec); // dump URLs of all open tabs to console
-  } catch(e) {
-    Components.utils.reportError(e);
-  }
-}
-

To learn what methods are available for <browser/> and <tabbrowser/> elements, use DOM Inspector or look in {{ source("toolkit/content/widgets/browser.xml","browser.xml") }} for corresponding XBL bindings (or just look at the current reference pages on {{ XULElem("browser") }} and {{ XULElem("tabbrowser") }}.

-

Getting the browser that fires the http-on-modify-request notification

-

See the Observer notifications page for information on http-on-* notifications.

-

Note that some HTTP requests aren't associated with a tab; for example, RSS feed updates, extension manager requests, XHR requests from XPCOM components, etc. In those cases, the following code returns null.

-
- Warning: This code should be updated to use {{interface("nsILoadContext")}} instead of getInterface(Components.interfaces.nsIDOMWindow), see this example..UPDATED EXAMPLE IS IN SECTION BELOW THIS
-
observe: function (subject, topic, data) {
-  if (topic == "http-on-modify-request") {
-    subject.QueryInterface(Components.interfaces.nsIHttpChannel);
-    var url = subject.URI.spec; /* url being requested. you might want this for something else */
-    var browser = this.getBrowserFromChannel(subject);
-    if (browser != null) {
-      /* do something */
-    }
-  }
-},
-
-getBrowserFromChannel: function (aChannel) {
-  try {
-    var notificationCallbacks =
-      aChannel.notificationCallbacks ? aChannel.notificationCallbacks : aChannel.loadGroup.notificationCallbacks;
-
-    if (!notificationCallbacks)
-      return null;
-
-    var domWin = notificationCallbacks.getInterface(Components.interfaces.nsIDOMWindow);
-    return gBrowser.getBrowserForDocument(domWin.top.document);
-  }
-  catch (e) {
-    dump(e + "\n");
-    return null;
-  }
-}
-
-

Getting the browser that fires the http-on-modify-request notification (example code updated for loadContext)

-

Here an example of the previous section is shown. The previous section was left intact so people can see the old way of doing things.

-
Components.utils.import('resource://gre/modules/Services.jsm');
-Services.obs.addObserver(httpObs, 'http-on-modify-request', false);
-//Services.obs.removeObserver(httpObs, 'http-on-modify-request'); //uncomment this line, or run this line when you want to remove the observer
-
-var httpObs = {
-    observe: function (aSubject, aTopic, aData) {
-        if (aTopic == 'http-on-modify-request') {
-            /*start - do not edit here*/
-            var oHttp = aSubject.QueryInterface(Components.interfaces.nsIHttpChannel); //i used nsIHttpChannel but i guess you can use nsIChannel, im not sure why though
-            var interfaceRequestor = oHttp.notificationCallbacks.QueryInterface(Components.interfaces.nsIInterfaceRequestor);
-            //var DOMWindow = interfaceRequestor.getInterface(Components.interfaces.nsIDOMWindow); //not to be done anymore because: https://developer.mozilla.org/en-US/docs/Updating_extensions_for_Firefox_3.5#Getting_a_load_context_from_a_request //instead do the loadContext stuff below
-            var loadContext;
-            try {
-                loadContext = interfaceRequestor.getInterface(Components.interfaces.nsILoadContext);
-            } catch (ex) {
-                try {
-                    loadContext = aSubject.loadGroup.notificationCallbacks.getInterface(Components.interfaces.nsILoadContext);
-                    //in ff26 aSubject.loadGroup.notificationCallbacks was null for me, i couldnt find a situation where it wasnt null, but whenever this was null, and i knew a loadContext is supposed to be there, i found that "interfaceRequestor.getInterface(Components.interfaces.nsILoadContext);" worked fine, so im thinking in ff26 it doesnt use aSubject.loadGroup.notificationCallbacks anymore, but im not sure
-                } catch (ex2) {
-                    loadContext = null;
-                    //this is a problem i dont know why it would get here
-                }
-            }
-            /*end do not edit here*/
-            /*start - do all your edits below here*/
-            var url = oHttp.URI.spec; //can get url without needing loadContext
-            if (loadContext) {
-                var contentWindow = loadContext.associatedWindow; //this is the HTML window of the page that just loaded
-                //aDOMWindow this is the firefox window holding the tab
-                var aDOMWindow = contentWindow.top.QueryInterface(Ci.nsIInterfaceRequestor).getInterface(Ci.nsIWebNavigation).QueryInterface(Ci.nsIDocShellTreeItem).rootTreeItem.QueryInterface(Ci.nsIInterfaceRequestor).getInterface(Ci.nsIDOMWindow);
-                var gBrowser = aDOMWindow.gBrowser; //this is the gBrowser object of the firefox window this tab is in
-                var aTab = gBrowser._getTabForContentWindow(contentWindow.top); //this is the clickable tab xul element, the one found in the tab strip of the firefox window, aTab.linkedBrowser is same as browser var above //can stylize tab like aTab.style.backgroundColor = 'blue'; //can stylize the tab like aTab.style.fontColor = 'red';
-                var browser = aTab.linkedBrowser; //this is the browser within the tab //this is what the example in the previous section gives
-                //end getting other useful stuff
-            } else {
-                Components.utils.reportError('EXCEPTION: Load Context Not Found!!');
-                //this is likely no big deal as the channel proably has no associated window, ie: the channel was loading some resource. but if its an ajax call you may end up here
-            }
-        }
-    }
-};
-
-

Here's a cleaner example of the same thing:

-
Cu.import('resource://gre/modules/Services.jsm');
-
-var httpRequestObserver = {
-    observe: function (subject, topic, data) {
-        var httpChannel, requestURL;
-
-        if (topic == "http-on-modify-request") {
-            httpChannel = subject.QueryInterface(Ci.nsIHttpChannel);
-            requestURL = httpChannel.URI.spec;
-
-            var newRequestURL, i;
-
-            if (/someurl/.test(requestURL)) {
-                var goodies = loadContextGoodies(httpChannel);
-                if (goodies) {
-                    httpChannel.cancel(Cr.NS_BINDING_ABORTED);
-                    goodies.contentWindow.location = self.data.url('pages/test.html');
-                } else {
-                    //dont do anything as there is no contentWindow associated with the httpChannel, liekly a google ad is loading or some ajax call or something, so this is not an error
-                }
-            }
-
-            return;
-        }
-    }
-};
-Services.obs.addObserver(httpRequestObserver, "http-on-modify-request", false);
-
-
-
-
-
-//this function gets the contentWindow and other good stuff from loadContext of httpChannel
-function loadContextGoodies(httpChannel) {
-    //httpChannel must be the subject of http-on-modify-request QI'ed to nsiHTTPChannel as is done on line 8 "httpChannel = subject.QueryInterface(Ci.nsIHttpChannel);"
-    //start loadContext stuff
-    var loadContext;
-    try {
-        var interfaceRequestor = httpChannel.notificationCallbacks.QueryInterface(Ci.nsIInterfaceRequestor);
-        //var DOMWindow = interfaceRequestor.getInterface(Components.interfaces.nsIDOMWindow); //not to be done anymore because: https://developer.mozilla.org/en-US/docs/Updating_extensions_for_Firefox_3.5#Getting_a_load_context_from_a_request //instead do the loadContext stuff below
-        try {
-            loadContext = interfaceRequestor.getInterface(Ci.nsILoadContext);
-        } catch (ex) {
-            try {
-                loadContext = subject.loadGroup.notificationCallbacks.getInterface(Ci.nsILoadContext);
-            } catch (ex2) {}
-        }
-    } catch (ex0) {}
-
-    if (!loadContext) {
-        //no load context so dont do anything although you can run this, which is your old code
-        //this probably means that its loading an ajax call or like a google ad thing
-        return null;
-    } else {
-        var contentWindow = loadContext.associatedWindow;
-        if (!contentWindow) {
-            //this channel does not have a window, its probably loading a resource
-            //this probably means that its loading an ajax call or like a google ad thing
-            return null;
-        } else {
-            var aDOMWindow = contentWindow.top.QueryInterface(Ci.nsIInterfaceRequestor)
-                .getInterface(Ci.nsIWebNavigation)
-                .QueryInterface(Ci.nsIDocShellTreeItem)
-                .rootTreeItem
-                .QueryInterface(Ci.nsIInterfaceRequestor)
-                .getInterface(Ci.nsIDOMWindow);
-            var gBrowser = aDOMWindow.gBrowser;
-            var aTab = gBrowser._getTabForContentWindow(contentWindow.top); //this is the clickable tab xul element, the one found in the tab strip of the firefox window, aTab.linkedBrowser is same as browser var above //can stylize tab like aTab.style.backgroundColor = 'blue'; //can stylize the tab like aTab.style.fontColor = 'red';
-            var browser = aTab.linkedBrowser; //this is the browser within the tab //this is where the example in the previous section ends
-            return {
-                aDOMWindow: aDOMWindow,
-                gBrowser: gBrowser,
-                aTab: aTab,
-                browser: browser,
-                contentWindow: contentWindow
-            };
-        }
-    }
-    //end loadContext stuff
-}
-

{{ languages( { "fr": "fr/Extraits_de_code/Onglets_de_navigation", "ja": "ja/Code_snippets/Tabbed_browser", "pl": "pl/Fragmenty_kodu/Przegl\u0105danie_w_kartach" } ) }}

diff --git a/files/de/codeschnipsel/tree/index.html b/files/de/codeschnipsel/tree/index.html deleted file mode 100644 index 95ae8ed107..0000000000 --- a/files/de/codeschnipsel/tree/index.html +++ /dev/null @@ -1,69 +0,0 @@ ---- -title: Tree -slug: Codeschnipsel/Tree -translation_of: Archive/Add-ons/Code_snippets/Tree ---- -

Aufklappen/Zuklappen aller Baumknoten

-

Um alle Baumknoten aufzuklappen:

-
 var treeView = tree.treeBoxObject.view;
- for (var i = 0; i < treeView.rowCount; i++) {
-   if (treeView.isContainer(i) && !treeView.isContainerOpen(i))
-     treeView.toggleOpenState(i);
- }
-
-

Um alle Baumknoten zu zuklappen, wird die Bedingung einfach umgekehrt:

-
 var treeView = tree.treeBoxObject.view;
- for (var i = 0; i < treeView.rowCount; i++) {
-   if (treeView.isContainer(i) && treeView.isContainerOpen(i))
-     treeView.toggleOpenState(i);
- }
-
-

Text der ausgewählten Zeile abrufen

-

Ausgehend von gegebenem Baum:

-
 <tree id="my-tree" seltype="single" onselect="onTreeSelected()">
-
-

Wird das folgende JavaScript verwendet:

-
 function onTreeSelected(){
-   var tree = document.getElementById("my-tree");
-   var cellIndex = 0;
-   var cellText = tree.view.getCellText(tree.currentIndex, tree.columns.getColumnAt(cellIndex));
-   alert(cellText);
- }
-
-

Das Baum-Item einer fokussierten Zeile abrufen

-

Ausgehend von <tree id="my-tree">, kann der folgende Codeausschnitt verwendet werden, um das tree item abzurufen:

-
var view = document.getElementById("my-tree").view;
-var sel = view.selection.currentIndex; //returns -1 if the tree is not focused
-var treeItem = view.getItemAtIndex(sel);
-
-

Zu beachten ist, dass der aktuelle Index unter Umständen nicht ausgewählt sein (z.B. in einem Baum mit mehrfach-Auswahl).

-

Einen treecell von einem Mausklick abrufen

-

Die erste Wahl ist <treecell onclick="yourfunc();"/> oder etwas ähnliches auszuprobieren. das funktioniert nicht. Es können keine Event-Handler zum <treecell> Element hinzugefügt werden. Stattdessen kann ein Event-Handler zum <tree> Element hinzugefügt werden. Dann können event- und andere Methoden benutzt werden, um das <treecell> Element zu finden. Zum Beispiel, ausgehend von:

-
<tree id="my-tree" onclick="onTreeClicked(event)">
-
-

Wird das folgende JavaScript verwendet:

-
function onTreeClicked(event){
-  var tree = document.getElementById("my-tree");
-  var tbo = tree.treeBoxObject;
-
-  // get the row, col and child element at the point
-  var row = { }, col = { }, child = { };
-  tbo.getCellAt(event.clientX, event.clientY, row, col, child);
-
-  var cellText = tree.view.getCellText(row.value, col.value);
-  alert(cellText);
-}
-
-

Ausgewählte Indizes eines mehrfach ausgewählten Baumes abrufen

-
  var start = {}, end = {}, numRanges = tree.view.selection.getRangeCount(), selectedIndices = [];
-
-  for (var t = 0; t < numRanges; t++){
-    tree.view.selection.getRangeAt(t, start, end);
-    for (var v = start.value; v <= end.value; v++)
-      selectedIndices.push(v);
-  }
-
-

Weitere Ressourcen

- -

{{ languages( { "fr": "fr/Extraits_de_code/Tree", "en": "en/Code_snippets/Tree" } ) }}

diff --git a/files/de/codeschnipsel/windows/index.html b/files/de/codeschnipsel/windows/index.html deleted file mode 100644 index 6da2289604..0000000000 --- a/files/de/codeschnipsel/windows/index.html +++ /dev/null @@ -1,60 +0,0 @@ ---- -title: Windows -slug: Codeschnipsel/Windows -tags: - - Add-ons - - Erweiterungen -translation_of: Archive/Add-ons/Code_snippets/Windows ---- -

Diese Seite zeigt einige interessante Codebeispiele.

-

Neue Browser-Fenster öffnen

-

Um ein neues Browser-Fenster zu öffnen, wird einfach window.open() benutzt. Jedoch gibt window.open() ein Window Objekt für den Inhalt zurück, nicht für das Browser-Fenster selbst, deshalb sollte man sich das Chrome Window zuerst holen. Der einfachste Weg das zu machen, ist nsIWindowMediator zu benutzen.

-

Beispiel

-
window.open();
-var wm = Components.classes["@mozilla.org/appshell/window-mediator;1"]
-                            .getService(Components.interfaces.nsIWindowMediator);
-var newWindow = wm.getMostRecentWindow("navigator:browser");
-var b = newWindow.getBrowser();
-// why did we do this? we never do anything with |b|
-
-

Ziehbare Fenster

-

Um ein Fenster durch das Klicken auf die Fensterinhalte ziehbar zu machen, können die mousedown und mousemove Ereignisse verwendet werden. Der folgende Code berücksichtigt nicht, welches Element angeklickt wurde, sondern reagiert auf alle mousedown Ereignisse gleich. Dieser Code kann verbessert werden, indem das  Zielelements des Ereignisses überprüft wird und startPos nur festgelegt wird, wenn das Element den Kriterien entspricht.

-

Beispiel

-
var startPos=0;
-var mouseDown = function(event) {
-  startPos = [ event.clientX, event.clientY];
-}
-var mouseMove = function(event) {
-  if (startPos != 0) {
-    var newX = event.screenX-startPos[0];
-    var newY = event.screenY-startPos[1];
-    window.moveTo(newX,newY);
-  }
-}
-var mouseUp = function(event) {
-  startPos=0;
-}
-
-window.addEventListener("mousedown",mouseDown, false);
-window.addEventListener("mouseup",mouseUp, false);
-window.addEventListener("mousemove",mouseMove, false);
-
-

XUL Titelleistenelement

-

XUL Anwendungen können Vorteile aus dem Titlebar Element ziehen, um ein ähnliche Ergebnisse ohne extra JavaScript Code zu erzielen.

-

Wiederbenutzung und Fokussierung von benannten Fenstern

-

Dieser Abschnitt ist inkorrekt und muss neu geschrieben werden. Siehe nsIWindowMediator für eine korrekte Dokumentation.

-
-

Während eine Festlegung des name Parameters bei window.open oder window.openDialog verhindert, dass mehrere Fenster geöffnet werden, wird jeder Aufruf das Fenster Wiederinitialisieren und daher geht alles, was der Benutzer in diesem Fenster gerade getan hat, verloren. Zusätzlich wird es nicht im Vordergrund angezeigt, wenn das Fenster im Hintergrund ist. Dieser Code prüft, ob ein Fenster mit dem gegebenen Namen existiert. Wird eines gefunden, wird es fokussiert. Wenn nicht, wird ein Neues geöffnet.

-
var windowName = "yourWindowName";
-var windowsMediator = Components.classes["@mozilla.org/appshell/window-mediator;1"].getService(Components.interfaces.nsIWindowMediator);
-var win = windowsMediator.getMostRecentWindow(windowName);
-if (win)
-  win.focus();
-else
-  window.open("chrome://to/your/window.xul", windowName, "features");
-
-
-

Siehe auch

- -

{{ languages( {"en": "en/Code_snippets/Windows", "fr": "fr/Extraits_de_code/Fen\u00eatres", "ja": "ja/Code_snippets/Windows", "pl": "pl/Fragmenty_kodu/Okna" } ) }}

-- cgit v1.2.3-54-g00ecf