BaseWindowConstructorOptions Object
widthInteiro (opcional) - A largura da janela em pixels. O padrão é800.heightInteiro (opcional) - A altura da janela em pixels. O padrão é600.xInteiro (opcional) - (obrigatório se y for usado) O deslocamento da janela com relação à esquerda da tela. O padrão é centralizar a janela.yInteiro (opcional) - (obrigatório se x for usado) O deslocamento da janela com relação ao topo da tela. O padrão é centralizar a janela.useContextSizebooleana (opcional) - Awidthe aheightserão usadas como o tamanho da página web, o que significa que o tamanho da janela em si irá conter o tamanho da página e será um pouco maior. O padrão éfalse.centerbooleana (opcional) - Mostra a janela no centro da tela. O padrão éfalse.minWidthInteiro (opcional) - A largura mínima da janela. O padrão é0.minHeightInteiro (opcional) - A altura mínima da janela. O padrão é0.maxWidthInteiro (opcional) - A largura máxima da janela. O padrão é sem limite.maxHeightInteiro (opcional) - A altura máxima da janela. O padrão é sem limite.resizablebooleana (opcional) - Se a janela é redimensionável. O padrão étrue.movablebooleana (opcional) macOS Windows - Se a janela pode ser movida. Não é implementado no Linux. O padrão étrue.minimizablebooleana (opcional) macOS Windows Se a janela é minimizável. Não é implementado no Linux. O padrão étrue.maximizablebooleana (opcional) macOS Windows - Se a janela é maximizável. Não é implementado no Linux. O padrão étrue.closablebooleana (opcional) macOS Windows - Se a janela pode ser fechada. Não é implementado no Linux. O padrão étrue.focusablebooleana (opcional) - Se a janela pode ser focada. O padrão étrueNo Windows, definirfocusable: falsetambém implica emskipTaskbar: true. No Linux, definirfocusable: falsefaz a janela parar de interagir com o wm, então a janela sempre ficará no topo em todos os ambientes de trabalho.alwaysOnTopbooleana (opcional) - Se a janela deve sempre ficar acima de outras janelas. O padrão éfalse. Not supported on Wayland (Linux).fullscreenbooleana (opcional) - Se a janela deve aparecer em tela cheia. Se explicitamente definida comofalseo botão de tela cheia será oculto e desabilitado no macOS. O padrão éfalse.fullscreenablebooleana (opcional) - Se a janela pode ser posta em modo detela cheia. No macOS, também define se o botão de maximizar/zoom pode alternar o modo de tela cheia ou maximizar a janela. O padrão étrue.simpleFullscreenbooleana (opcional) macOS - Usa a versão de tela cheia anterior à versão Lion no macOS. O padrão éfalse.skipTaskbarbooleana (opcional) macOS Windows - Se a janela deve aparecer na barra de tarefas. O padrão éfalse.hiddenInMissionControlbooleana (opcional) macOS - Se a janela deve ser oculta quando o usuário entra no modo mission control.kioskbooleana (opcional) - Se a janela está em modo quiosque. O padrão éfalse.namestring (opcional) - Um identificador único da janela, usado internamente pelo Electron para habilitar recursos como persistência de estado. Cada janela deve ter um nome distinto. Pode ser reutilizado depois que a janela correspondente é destruída. Um erro é lançado quando o nome já está em uso. Não é um título visível mostrado aos usuários na barra de título.windowStatePersistence(WindowStatePersistence | boolean) (opcional) - Configura ou habilita a persistência de estado de janelas (posição, tamanho, estado de maximização, etc.) across application restarts. Não tem efeito se onameda janela não for definido. Automaticamente desabilitada se não houver um monitor disponível. Experimentaltitlestring (opcional) - Título padrão da janela. O padrão é"Electron". Se a tag HTML<title>for definida no arquivo HTML carregado porloadURL(), esta propriedade será ignorada.icon(NativeImage | string) (opcional) - O ícone da janela. No Windows é recomendado que se use íconesICOpara obter melhores efeitos visuais, você também pode deixá-lo indefinido para que o ícone do executável seja usado.showbooleana (opcional) - Se a janela pode ser mostrada quando é criada. O padrão étrueframebooleana (opcional) - Definafalsepara criar uma janela frameless. O padrão étrue.parentBaseWindow (opcional) - Defina a janela pai. O padrão énull.modalbooleana (opcional) - Se esta janela é modal. Só funciona se a janela for uma janela filha. O padrão éfalse.appShimAppShimHost (opcional) macOS Experimental - Cria uma janela nativa no processo do shim deste aplicativo, para que ele pertença ao ícone da Dock do shim e não do seu aplicativo. Consulte AppShimHost para ver quais funções são dadas à janela.acceptFirstMousebooleana (opcional) macOS - Se clicar em uma janela inativa também irá clicar em seu conteúdo web. O padrão éfalseno macOS. Esta opção não é configurável em outras plataformas.disableAutoHideCursorbooleana (opcional) - Se o cursor deve ser oculto quando se estiver digitando. O padrão éfalse.autoHideMenuBarbooleana (opcional) Linux Windows - Auto-oculta a barra de menu a menos que a teclaAltesteja pressionada. O padrão éfalse.enableLargerThanScreenbooleana (opcional) macOS - Permite que a janela seja redimensionada maior que a tela. Apenas relevante para o macOS, visto que outros sistemas operacionais permitem janelas maiores que a tela por padrão. O padrão éfalse.backgroundColorstring (opcional) - A cor de fundo da janela em Hex, RGB, RGBA, HSL, HSLA ou no formato de uma cor nomeada de CSS. Há suporte de alpha em formato #AARRGGBB setransparentfor definida comotrue. O padrão é#FFF(branco). Consulte win.setBackgroundColor para mais informações.hasShadowbooleana (opcional) - Se a janela deve ter sombra. O padrão étrue.opacitynúmero (opcional) macOS Windows - Define a opacidade inicial da janela, entre 0.0 (completamente transparente) e 1.0 (completamente opaca). Só é implementado no Windows e no macOS.darkThemebooleana (opcional) - Força o uso do tema escuro na janela, só funciona em alguns ambientes desktop GTK+3. O padrão éfalse.transparentbooleana (opcional) - Torna a janela transparente. O padrão éfalse. No Windows, não funciona a não ser que a janela seja frameless. Quando você adiciona umaViewa umaBaseWindow, você precisará chamarview.setBackgroundColorcom uma cor de fundo transparente nessa view para que sua cor de fundo seja também transparente.typestring (opcional) - O tipo de janela, no padrão é uma janela normal. Veja mais sobre isso abaixo.visualEffectStatestring (opcional) macOS - Especifica se a aparência material deve refletir o estado de atividade da janela no macOS. Deve ser usado com a propriedadevibrancy. Possible values are:followWindow- O plano de fundo deve automaticamente aparecer ativo quando a janela estiver ativa, e inativo quando ela não estiver. This is the default.active- O plano de fundo deve sempre aparecer ativo.inactive- O plano de fundo deve sempre aparecer inativo.
titleBarStylestring (opcional) - O estilo da barra de título da janela. O padrão édefault. Possible values are:default- Resulta em uma barra de título padrão no macOS e no Windows respectivamente.hidden- Resulta em uma barra de título oculta e uma janela em que o conteúdo ocupa todo seu tamanho. No macOS, a janela ainda deve ter os controles padrão de janelas (as "luzes de semáforo") no topo esquerdo. No Windows e no Linux, quando combinada comtitleBarOverlay: trueativará o Overlay de Controles de Janela (vejatitleBarOverlaypara mais informações), caso contrário nenhum controle de janela será exibido.hiddenInsetmacOS - Resulta em uma barra de título com uma aparência alternativa onde os botões semáforo ficam levemente mais dentro da borda da janela.customButtonsOnHovermacOS - Resulta em uma barra de título oculta e uma janela em que o conteúdo ocupa todo seu tamanho, e os botões de semáforo aparecerão quando o cursor passar no topo esquerdo da janela. Nota: Esta opção é experimental atualmente.
titleBarOverlayObject | booleana (opcional) - Quando se estiver usando uma janela frameless em conjunto comwin.setWindowButtonVisibility(true)no macOS ou usando umtitleBarStyleno qual os controles de janela padrão ("luzes de semáforo" no macOS) ficam visíveis, esta propriedade habilita o Overlay de Controles de Janela das APIs Javascript e as Variáveis de Ambiente CSS. Definirtrueresultará em um overlay com cores padrão do sistema. O padrão éfalse.colorString (opcional) Windows Linux - A cor CSS do Overlay de Controles de Janela quando habilitado. O padrão é a cor do sistema.symbolColorString (opcional) Windows Linux - A cor CSS dos símbolos no Overlay de Controles de Janela quando habilitado. O padrão é a cor do sistema.heightInteger (optional) - The height of the title bar and Window Controls Overlay in pixels. O padrão é a altura do sistema.
accentColorbooleana | string (opcional) Windows - A cor de destaque da janela. Por padrão, segue a preferência do usuário nas Configurações do Sistema. Defina comofalsepara desabilitar explicatamente, ou defina a cor em Hex, RGB, RGBA, HSL, HSLA ou no formato de uma cor nomeada do CSS. Valores alpha serão ignorados.trafficLightPositionPoint (opcional) macOS - Define uma posição personalizada para os botões de semáforo em janelas frameless.roundedCornersbooleana (opcional) - Se a janela frameless deve ter cantos arrendodados. O padrão étrue. Em versões do Windows anteriores ao Windows 11 Build 22000 esta propriedade não tem efeito, e janelas frameless não terão cantos arrendondados. No Linux, os cantos arredondados só são desenhados quando o ambiente desktop tem suporte a decorações client-side.thickFramebooleana (opcional) Windows - Usa o estiloWS_THICKFRAMEem janelas frameless no Windows, que adiciona o frame de janela padrão. Definir comofalseremoverá a sombra e as animações da janela, e desabilitará o redimensionamento de janela através do arrasto dos seus cantos. O padrão étrue.vibrancystring (opcional) macOS - Adiciona um tipo de efeito vibrante à janela, somente no macOS. Pode serappearance-based,titlebar,selection,menu,popover,sidebar,header,sheet,window,hud,fullscreen-ui,tooltip,content,under-window, ouunder-page.backgroundMaterialstring (opcional) Windows - Define o material de fundo da janela desenhado pelo sistema, incluindo atrás da área fora do aplicativo. Pode serauto,none,mica,acrylicoutabbed. Consulte win.setBackgroundMaterial para mais informações.zoomToPageWidthboolean (opcional) macOS - Controla o comportamento no macOS quando se clica nas opções do botão semáforo verde na barra da janela ou ao clicar no item do menu Window > Zoom. Setrue, a janela aumentará para a largura preferida da página web quando aumentada,falsefará com que ela aumente para a largura da tela. Isto também afetará o comportamento quandomaximize()for chamado diretamente. O padrão éfalse.tabbingIdentifierstring (opcional) macOS - O nome do grupo de abas, quer permite abrir a janela como uma aba nativa. Janelas com o mesmo identificador serão agrupadas juntas. Isto também adiciona um novo botão de aba nativo à barra de abas da sua janela e permite que seuappe janela recebam o eventonew-window-for-tab.
Ao definir o tamanho mínimo ou máximo com minWidth/maxWidth/
minHeight/maxHeight, apenas restringe os usuários. Não vai te impedir de passar um tamanho que não siga os limites de tamanho para setBounds/setSize ou para o construtor de BrowserWindow.
Os valores possíveis e comportamentos da opção type dependem da plataforma.
Possible values are:
- No Linux, os possíveis tipos são
desktop,dock,toolbar,splash,notification.- O tipo
desktoppõe a janela no nível de janela de fundo desktop (kCGDesktopWindowLevel - 1). Dito isso, perceba que uma janela desktop não receberá eventos de foco, de teclado, ou de mouse. Você ainda pode usar globalShortcut para receber dados com moderação. - O tipo
dockcria uma janela com comportamento estilo dock. - O tipo
toolbarcria uma janela com aparência de barra de ferramentas. - O tipo
splashse comporta de uma maneira específica. Não é arrastável, mesmo se a estilização CSS do corpo da janela conter -webkit-app-region: drag. Este tipo é geralmente usado em telas de inicialização. - O tipo
notificationcria uma janela que se comporta como uma notificação do sistema.
- O tipo
- No macOS, os possíveis tipos são
desktop,textured,panel.- O tipo
texturedadiciona uma aparência de gradiente metálico. Esta opção é obsoleta. - O tipo
desktoppõe a janela no nível de janela de fundo desktop (kCGDesktopWindowLevel - 1). Note que essa janela desktop não receberá eventos de foco, de teclado ou de mouse, mas você pode usarglobalShortcutpara receber dados com moderação. - O tipo
panelpermite que a janela flutue no topo de aplicativos em tela cheia adicionando a máscara de estiloNSWindowStyleMaskNonactivatingPanel, normalmente reservado para o NSPanel, em tempo de execução. Além disso, a janela aparecerá em todos os espaços (desktops).
- O tipo
- No Windows, o tipo possível é
toolbar.