chrome.app.venster

Beschrijving

Gebruik de chrome.app.window API om vensters te maken. Vensters hebben een optioneel frame met titelbalk en grootte-instellingen. Ze zijn niet gekoppeld aan Chrome-browservensters. Zie het vensterstatusvoorbeeld voor een demonstratie van deze opties.

Typen

AppWindow

Eigenschappen

  • inhoudsvenster

    Raam

    Het JavaScript 'window'-object voor het gemaakte kind.

  • id

    snaar

    Het ID waarmee het venster is gemaakt.

  • binnengrenzen

    Grenzen

    De positie, grootte en beperkingen van de inhoud van het venster, exclusief vensterdecoraties. Deze eigenschap is nieuw in Chrome 36.

  • buitenste grenzen

    Grenzen

    De positie, grootte en beperkingen van het venster, inclusief vensterdecoraties, zoals de titelbalk en het frame. Deze eigenschap is nieuw in Chrome 36.

  • duidelijkAandacht

    leegte

    Duidelijke aandacht voor het raam.

    De clearAttention -functie ziet er als volgt uit: 

    () => {...}

  • dichtbij

    leegte

    Sluit het raam.

    De close ziet er als volgt uit: 

    () => {...}

  • aandacht trekken

    leegte

    Vestig de aandacht op het raam.

    De drawAttention -functie ziet er als volgt uit: 

    () => {...}

  • focus

    leegte

    Stel het venster scherp.

    De focus ziet er als volgt uit: 

    () => {...}

  • volledig scherm

    leegte

    Maakt het venster volledig scherm.

    De gebruiker kan het venster herstellen door op ESC te drukken. Een applicatie kan voorkomen dat de volledige schermstatus wordt verlaten wanneer ESC wordt ingedrukt door de machtiging app.window.fullscreen.overrideEsc aan te vragen en de gebeurtenis te annuleren door .preventDefault() aan te roepen in de keydown- en keyup-handlers, zoals hier:

    window.onkeydown = window.onkeyup = function(e) { if (e.keyCode == 27 /* ESC *\/) { e.preventDefault(); } };

    Let op: window.fullscreen() zorgt ervoor dat het hele venster volledig scherm wordt en vereist geen gebruikersgebaar. De HTML5 fullscreen API kan ook worden gebruikt om de volledig schermmodus te activeren (zie Web API's voor meer informatie).

    De fullscreen -functie ziet er als volgt uit: 

    () => {...}

  • getBounds

    leegte

    Verouderd

    Gebruik innerBounds of outerBounds.

    Haal de binnengrenzen van het venster op als een ContentBounds -object.

    De getBounds -functie ziet er als volgt uit: 

    () => {...}

  • verbergen

    leegte

    Verberg het venster. Doet niets als het venster al verborgen is.

    De hide ziet er als volgt uit: 

    () => {...}

  • isAltijdAanBoven

    leegte

    Staat het raam altijd boven?

    De functie isAlwaysOnTop ziet er als volgt uit: 

    () => {...}

    • retouren

      Booleaanse

  • isVolledig scherm

    leegte

    Is het venster schermvullend? Dit is het geval als het venster schermvullend is gemaakt of via de AppWindow of HTML5 schermvullende API's is gemaakt.

    De functie isFullscreen ziet er als volgt uit: 

    () => {...}

    • retouren

      Booleaanse

  • isGemaximaliseerd

    leegte

    Is het venster gemaximaliseerd?

    De functie isMaximized ziet er als volgt uit: 

    () => {...}

    • retouren

      Booleaanse

  • isGeminimaliseerd

    leegte

    Is het venster geminimaliseerd?

    De functie isMinimized ziet er als volgt uit: 

    () => {...}

    • retouren

      Booleaanse

  • maximaliseren

    leegte

    Maximaliseer het venster.

    De maximize ziet er als volgt uit: 

    () => {...}

  • minimaliseren

    leegte

    Minimaliseer het venster.

    De minimize ziet er als volgt uit: 

    () => {...}

  • verhuizen naar

    leegte

    Verouderd sinds Chrome 43

    Gebruik outerBounds.

    Verplaats het venster naar de positie ( left , top ).

    De moveTo -functie ziet er als volgt uit: 

    (left: number, top: number) => {...}

    • links

      nummer

    • bovenkant

      nummer

  • formaat wijzigen

    leegte

    Verouderd sinds Chrome 43

    Gebruik outerBounds.

    Wijzig de grootte van het venster naar width x height in pixels.

    De resizeTo functie ziet er als volgt uit: 

    (width: number, height: number) => {...}

    • breedte

      nummer

    • hoogte

      nummer

  • herstellen

    leegte

    Herstel het venster door de gemaximaliseerde, geminimaliseerde of volledig schermstatus te verlaten.

    De restore ziet er als volgt uit: 

    () => {...}

  • setAlwaysOnTop

    leegte

    Stelt in of het venster boven de meeste andere vensters moet blijven. Vereist de machtiging alwaysOnTopWindows .

    De functie setAlwaysOnTop ziet er als volgt uit: 

    (alwaysOnTop: boolean) => {...}

    • altijdOpTop

      Booleaanse

  • setBounds

    leegte

    Verouderd

    Gebruik innerBounds of outerBounds.

    Stel de binnengrenzen van het venster in.

    De functie setBounds ziet er als volgt uit: 

    (bounds: ContentBounds) => {...}

  • setVisibleOnAllWorkspaces

    leegte

    Geef aan of het venster zichtbaar is op alle werkruimten. (Alleen voor platforms die dit ondersteunen).

    De functie setVisibleOnAllWorkspaces ziet er als volgt uit: 

    (alwaysVisible: boolean) => {...}

    • altijd zichtbaar

      Booleaanse

  • show

    leegte

    Toon het venster. Doet niets als het venster al zichtbaar is. Focus het venster als focused is ingesteld op 'true' of 'weggelaten'.

    De show ziet er als volgt uit: 

    (focused?: boolean) => {...}

    • gefocust

      boolean optioneel

Bounds

Eigenschappen

  • hoogte

    nummer

    Met deze eigenschap kunt u de huidige hoogte van de inhoud of het venster lezen of schrijven.

  • links

    nummer

    Deze eigenschap kan worden gebruikt om de huidige X-coördinaat van de inhoud of het venster te lezen of te schrijven.

  • maximale hoogte

    nummer optioneel

    Deze eigenschap kan worden gebruikt om de huidige maximale hoogte van de inhoud of het venster te lezen of te schrijven. De waarde ' null ' geeft 'niet gespecificeerd' aan.

  • maximale breedte

    nummer optioneel

    Deze eigenschap kan worden gebruikt om de huidige maximale breedte van de inhoud of het venster te lezen of te schrijven. De waarde ' null ' geeft 'niet gespecificeerd' aan.

  • minHoogte

    nummer optioneel

    Deze eigenschap kan worden gebruikt om de huidige minimale hoogte van de content of het venster te lezen of te schrijven. De waarde ' null ' geeft 'niet gespecificeerd' aan.

  • minBreedte

    nummer optioneel

    Deze eigenschap kan worden gebruikt om de huidige minimale breedte van de inhoud of het venster te lezen of te schrijven. De waarde ' null ' geeft 'niet gespecificeerd' aan.

  • bovenkant

    nummer

    Met deze eigenschap kunt u de huidige Y-coördinaat van de inhoud of het venster lezen of schrijven.

  • breedte

    nummer

    Met deze eigenschap kunt u de huidige breedte van de inhoud of het venster lezen of schrijven.

  • setMaximumSize

    leegte

    Stel de maximale groottebeperkingen van de inhoud of het venster in. De maximale breedte of hoogte kan op null worden gezet om de beperking te verwijderen. Een waarde van undefined laat een beperking ongewijzigd.

    De functie setMaximumSize ziet er als volgt uit: 

    (maxWidth: number, maxHeight: number) => {...}

    • maximale breedte

      nummer

    • maximale hoogte

      nummer

  • setMinimumSize

    leegte

    Stel de minimale groottebeperkingen van de inhoud of het venster in. De minimale breedte of hoogte kan op null worden ingesteld om de beperking te verwijderen. Een waarde van undefined laat een beperking ongewijzigd.

    De functie setMinimumSize ziet er als volgt uit: 

    (minWidth: number, minHeight: number) => {...}

    • minBreedte

      nummer

    • minHoogte

      nummer

  • setPositie

    leegte

    Stel de linker- en bovenpositie van de inhoud of het venster in.

    De setPosition -functie ziet er als volgt uit: 

    (left: number, top: number) => {...}

    • links

      nummer

    • bovenkant

      nummer

  • setgrootte

    leegte

    Stel de breedte en hoogte van de inhoud of het venster in.

    De functie setSize ziet er als volgt uit: 

    (width: number, height: number) => {...}

    • breedte

      nummer

    • hoogte

      nummer

BoundsSpecification

Eigenschappen

  • hoogte

    nummer optioneel

    De hoogte van de inhoud of het venster.

  • links

    nummer optioneel

    De X-coördinaat van de inhoud of het venster.

  • maximale hoogte

    nummer optioneel

    De maximale hoogte van de inhoud of het venster.

  • maximale breedte

    nummer optioneel

    De maximale breedte van de inhoud of het venster.

  • minHoogte

    nummer optioneel

    De minimale hoogte van de inhoud of het venster.

  • minBreedte

    nummer optioneel

    De minimale breedte van de inhoud of het venster.

  • bovenkant

    nummer optioneel

    De Y-coördinaat van de inhoud of het venster.

  • breedte

    nummer optioneel

    De breedte van de inhoud of het venster.

ContentBounds

Eigenschappen

  • hoogte

    nummer optioneel

  • links

    nummer optioneel

  • bovenkant

    nummer optioneel

  • breedte

    nummer optioneel

CreateWindowOptions

Eigenschappen

  • altijdOpTop

    boolean optioneel

    Indien ingesteld op 'true', blijft het venster boven de meeste andere vensters staan. Als er meerdere vensters van dit type zijn, wordt het venster dat momenteel de focus heeft op de voorgrond geplaatst. Vereist de machtiging alwaysOnTopWindows . Standaard is dit 'false'.

    Roep setAlwaysOnTop() aan op het venster om deze eigenschap te wijzigen nadat deze is gemaakt.

  • grenzen

    ContentBounds optioneel

    Verouderd

    Gebruik innerBounds of outerBounds.

    Grootte en positie van de inhoud in het venster (exclusief de titelbalk). Als er ook een id is opgegeven en er eerder een venster met een overeenkomende id is weergegeven, worden de onthouden grenzen van het venster gebruikt.

  • gefocust

    boolean optioneel

    Indien true, krijgt het venster de focus wanneer het wordt aangemaakt. Standaard is dit true.

  • kader

    string | FrameOptions optioneel

    Frametype: none of chrome (standaard chrome ). Voor none kan de CSS-eigenschap -webkit-app-region worden gebruikt om sleepbaarheid toe te passen op het app-venster. -webkit-app-region: drag kan worden gebruikt om gebieden als sleepbaar te markeren. no-drag kan worden gebruikt om deze stijl uit te schakelen voor geneste elementen.

    Het gebruik van FrameOptions is nieuw in M36.

  • verborgen

    boolean optioneel

    Indien true, wordt het venster in een verborgen toestand aangemaakt. Roep show() aan op het venster om het weer te geven zodra het is aangemaakt. Standaard is dit false.

  • icon

    string optioneel

    Chroom 54+

    URL van het vensterpictogram. Een venster kan een eigen pictogram hebben wanneer showInShelf is ingesteld op true. De URL moet een globale URL of een lokale URL met een extensie zijn.

  • id

    string optioneel

    ID om het venster te identificeren. Dit wordt gebruikt om de grootte en positie van het venster te onthouden en die geometrie te herstellen wanneer later een venster met dezelfde ID wordt geopend. Als een venster met een bepaalde ID wordt aangemaakt terwijl er al een ander venster met dezelfde ID bestaat, krijgt het momenteel geopende venster de focus in plaats van dat er een nieuw venster wordt aangemaakt.

  • binnengrenzen

    BoundsSpecification optioneel

    Wordt gebruikt om de beginpositie, begingrootte en beperkingen van de inhoud van het venster (met uitzondering van vensterdecoraties) te specificeren. Als er ook een id is opgegeven en er eerder een venster met een overeenkomende id is weergegeven, worden de onthouden grenzen gebruikt.

    Houd er rekening mee dat de opvulling tussen de binnen- en buitengrenzen wordt bepaald door het besturingssysteem. Het instellen van dezelfde bounds-eigenschap voor zowel de innerBounds als outerBounds resulteert daarom in een fout.

    Deze eigenschap is nieuw in Chrome 36.

  • maximale hoogte

    nummer optioneel

    Verouderd

    Gebruik innerBounds of outerBounds.

    Maximale hoogte van het raam.

  • maximale breedte

    nummer optioneel

    Verouderd

    Gebruik innerBounds of outerBounds.

    Maximale breedte van het raam.

  • minHoogte

    nummer optioneel

    Verouderd

    Gebruik innerBounds of outerBounds.

    Minimale hoogte van het raam.

  • minBreedte

    nummer optioneel

    Verouderd

    Gebruik innerBounds of outerBounds.

    Minimale breedte van het raam.

  • buitenste grenzen

    BoundsSpecification optioneel

    Wordt gebruikt om de beginpositie, begingrootte en beperkingen van het venster (inclusief vensterdecoraties zoals de titelbalk en het kader) te specificeren. Als er ook een id is opgegeven en er eerder een venster met een overeenkomende id is weergegeven, worden de onthouden grenzen gebruikt.

    Houd er rekening mee dat de opvulling tussen de binnen- en buitengrenzen wordt bepaald door het besturingssysteem. Het instellen van dezelfde bounds-eigenschap voor zowel de innerBounds als outerBounds resulteert daarom in een fout.

    Deze eigenschap is nieuw in Chrome 36.

  • aanpasbaar

    boolean optioneel

    Indien true, kan de gebruiker de grootte van het venster aanpassen. Standaard is dit true.

  • weergevenInShelf

    boolean optioneel

    Chroom 54+

    Indien true, krijgt het venster een eigen plankpictogram. Anders wordt het venster gegroepeerd in de plank met andere vensters die aan de app zijn gekoppeld. Standaard is dit false. Als showInShelf is ingesteld op true, moet u een id voor het venster opgeven.

  • eenling

    boolean optioneel

    Verouderd

    Meerdere vensters met dezelfde id worden niet meer ondersteund.

    Als u standaard een id voor het venster opgeeft, wordt het venster alleen aangemaakt als er nog geen ander venster met dezelfde id bestaat. Als er al een venster met dezelfde id bestaat, wordt dat venster geactiveerd. Als u meerdere vensters met dezelfde id wilt aanmaken, kunt u deze eigenschap op 'false' zetten.

  • staat

    Staat optioneel

    De begintoestand van het venster, waardoor het al op volledig scherm, gemaximaliseerd of geminimaliseerd kan worden gemaakt. Standaard is dit 'normaal'.

  • type

    WindowType optioneel

    Chrome 45+ Verouderd sinds Chrome 69

    Alle app-vensters gebruiken het 'shell'-venstertype

    Het type venster dat u wilt maken.

  • zichtbaarOpAlleWerkruimten

    boolean optioneel

    Als dit het geval is en het platform dit ondersteunt, is het venster zichtbaar op alle werkruimten.

FrameOptions

Eigenschappen

  • actieve kleur

    string optioneel

    Hiermee kan de framekleur van het actieve venster worden ingesteld. Framekleur is alleen beschikbaar als het frametype chrome is.

    Framekleur is alleen beschikbaar als het frametype chrome is.

    Framekleuring is nieuw in Chrome 36.

  • kleur

    string optioneel

    Hiermee kan de kleur van het frame worden ingesteld. De kleur van het frame is alleen beschikbaar als het frametype chrome is.

    Framekleuring is nieuw in Chrome 36.

  • inactieve kleur

    string optioneel

    Hiermee kan de framekleur van het venster in inactieve toestand anders worden ingesteld dan de actieve kleur. Framekleur is alleen beschikbaar als het frametype chrome is.

    inactiveColor moet in combinatie met color worden gebruikt.

    Framekleuring is nieuw in Chrome 36.

  • type

    string optioneel

    Frametype: none of chrome (standaard chrome ).

    Voor none kan de CSS-eigenschap -webkit-app-region worden gebruikt om versleepbaarheid toe te passen op het app-venster.

    -webkit-app-region: drag kan worden gebruikt om gebieden te markeren als versleepbaar. no-drag kan worden gebruikt om deze stijl uit te schakelen voor geneste elementen.

State

Status van een venster: normaal, volledig scherm, gemaximaliseerd, geminimaliseerd.

Enum

"normaal"

"volledig scherm"

"gemaximaliseerd"

"geminimaliseerd"

WindowType

Chroom 45+

Hiermee geeft u het type venster op dat u wilt maken.

Enum

"schelp"
Standaardvenstertype.

"paneel"
Door het besturingssysteem beheerd venster (verouderd).

Methoden

canSetVisibleOnAllWorkspaces()

chrome.app.window.canSetVisibleOnAllWorkspaces(): boolean

Of het huidige platform ondersteuning biedt voor zichtbare vensters in alle werkruimten.

Retourneren

  • Booleaanse

create()

Belofte
chrome.app.window.create(
  url: string,
  options?: CreateWindowOptions,
  callback?: function,
): Promise<AppWindow>

De grootte en positie van een venster kunnen op verschillende manieren worden gespecificeerd. De eenvoudigste optie is om helemaal niets te specificeren. In dat geval worden de standaardgrootte en platformafhankelijke positie gebruikt.

Gebruik de eigenschappen innerBounds of outerBounds om de positie, grootte en beperkingen van het venster in te stellen. Binnengrenzen omvatten geen vensterdecoraties. Buitengrenzen omvatten de titelbalk en het kader van het venster. Houd er rekening mee dat de opvulling tussen de binnen- en buitengrenzen wordt bepaald door het besturingssysteem. Het instellen van dezelfde eigenschap voor zowel de binnen- als de buitengrenzen wordt daarom als een fout beschouwd (bijvoorbeeld het instellen van zowel innerBounds.left als outerBounds.left ).

Om de posities van vensters automatisch te onthouden, kunt u ze een ID geven. Als een venster een ID heeft, wordt deze ID gebruikt om de grootte en positie van het venster te onthouden wanneer het wordt verplaatst of vergroot of verkleind. Deze grootte en positie worden vervolgens gebruikt in plaats van de opgegeven grenzen wanneer een venster met dezelfde ID opnieuw wordt geopend. Als u een venster met een ID op een andere locatie dan de onthouden standaardlocatie wilt openen, kunt u het verbergen, naar de gewenste locatie verplaatsen en vervolgens weergeven.

Parameters

Retourneren

  • Belofte <AppWindow>

    Chroom 117+

    Promises worden alleen ondersteund voor Manifest V3 en hoger. Andere platforms moeten callbacks gebruiken.

current()

chrome.app.window.current(): AppWindow | undefined

Retourneert een AppWindow object voor de huidige scriptcontext (d.w.z. een JavaScript 'window'-object). Dit kan ook worden aangeroepen op een handle naar een scriptcontext voor een andere pagina, bijvoorbeeld: otherWindow.chrome.app.window.current().

Retourneren

get()

chrome.app.window.get(
  id: string,
): AppWindow | undefined

Haalt een AppWindow op met de opgegeven id. Als er geen venster met de opgegeven id bestaat, wordt null geretourneerd. Deze methode is nieuw in Chrome 33.

Parameters

  • id

    snaar

Retourneren

getAll()

chrome.app.window.getAll(): AppWindow[]

Haalt een array op van alle momenteel aangemaakte app-vensters. Deze methode is nieuw in Chrome 33.

Retourneren

Evenementen

onBoundsChanged

chrome.app.window.onBoundsChanged.addListener(
  callback: function,
)

Wordt geactiveerd wanneer het vensterformaat wordt gewijzigd.

Parameters

  • terugbellen

    functie

    De callback ziet er als volgt uit: 

    () => void

onClosed

chrome.app.window.onClosed.addListener(
  callback: function,
)

Wordt geactiveerd wanneer het venster wordt gesloten. Let op: dit moet worden afgeluisterd vanuit een ander venster dan het venster dat wordt gesloten, bijvoorbeeld vanaf de achtergrondpagina. Dit komt doordat het venster dat wordt gesloten, nog bezig is met afbreken wanneer de gebeurtenis wordt geactiveerd. Dit betekent dat niet alle API's in de scriptcontext van het venster functioneel zullen zijn.

Parameters

  • terugbellen

    functie

    De callback ziet er als volgt uit: 

    () => void

onFullscreened

chrome.app.window.onFullscreened.addListener(
  callback: function,
)

Wordt geactiveerd wanneer het venster op volledig scherm wordt weergegeven (via de AppWindow of HTML5 API's).

Parameters

  • terugbellen

    functie

    De callback ziet er als volgt uit: 

    () => void

onMaximized

chrome.app.window.onMaximized.addListener(
  callback: function,
)

Wordt geactiveerd wanneer het venster gemaximaliseerd is.

Parameters

  • terugbellen

    functie

    De callback ziet er als volgt uit: 

    () => void

onMinimized

chrome.app.window.onMinimized.addListener(
  callback: function,
)

Wordt geactiveerd wanneer het venster geminimaliseerd is.

Parameters

  • terugbellen

    functie

    De callback ziet er als volgt uit: 

    () => void

onRestored

chrome.app.window.onRestored.addListener(
  callback: function,
)

Wordt geactiveerd wanneer het venster wordt hersteld nadat het geminimaliseerd of gemaximaliseerd is.

Parameters

  • terugbellen

    functie

    De callback ziet er als volgt uit: 

    () => void