Classe InfoWindow
Classe
google.maps.InfoWindow
Uma sobreposição que parece com uma bolha e é normalmente conectada a um marcador.
Essa classe estende
MVCObject
.
Acesse chamando const {InfoWindow} = await google.maps.importLibrary("maps")
ou const {InfoWindow} = await google.maps.importLibrary("streetView")
.
Consulte Bibliotecas na API Maps JavaScript.
Construtor | |
---|---|
InfoWindow |
InfoWindow([opts]) Parâmetros:
Cria uma janela de informações com as opções especificadas. Uma InfoWindow pode ser colocada em um mapa em uma posição específica ou acima de um marcador, dependendo das especificações nas opções. A menos que o recurso panorâmico automático esteja desativado, uma InfoWindow movimentará o mapa para se tornar visível quando for aberta. Após a construção de uma InfoWindow, você precisa chamar open para exibi-la no mapa. O usuário pode clicar no botão fechar na InfoWindow para removê-la do mapa, ou o desenvolvedor pode chamar close() para obter o mesmo resultado. |
Propriedades | |
---|---|
isOpen |
Tipo:
boolean Verifica se a InfoWindow está aberta. |
Métodos | |
---|---|
close |
close() Parâmetros:nenhum
Valor de retorno:nenhum
Fecha esta janela de informações removendo-a da estrutura DOM. |
focus |
focus() Parâmetros:nenhum
Valor de retorno:nenhum
Define o foco neste InfoWindow . Considere usar esse método com um evento visible para garantir que InfoWindow esteja visível antes de definir o foco nele. Um InfoWindow que não está visível não pode ser focado. |
getContent |
getContent() Parâmetros:nenhum
|
getHeaderContent |
getHeaderContent() Parâmetros:nenhum
Valor de retorno:
string|Element|Text|null|undefined o conteúdo do cabeçalho desta InfoWindow. Consulte InfoWindowOptions.headerContent . |
getHeaderDisabled |
getHeaderDisabled() Parâmetros:nenhum
Valor de retorno:
boolean|undefined indica se toda a linha de cabeçalho está desativada ou não. Consulte InfoWindowOptions.headerDisabled . |
getPosition |
getPosition() Parâmetros:nenhum
Valor de retorno:
LatLng|null|undefined a posição LatLng da InfoWindow. |
getZIndex |
getZIndex() Parâmetros:nenhum
Valor de retorno:
number o zIndex desta InfoWindow. |
open |
open([options, anchor]) Parâmetros:
Valor de retorno:nenhum
Abre essa InfoWindow no mapa especificado. Se preferir, uma InfoWindow pode ser associada a uma âncora. Na API principal, a única âncora é a classe Marker. No entanto, uma âncora pode ser qualquer MVCObject que exponha uma propriedade LatLng position e, opcionalmente, uma propriedade Point anchorPoint para calcular o pixelOffset (consulte InfoWindowOptions). O anchorPoint é o deslocamento da posição da âncora até a ponta da InfoWindow. Recomendamos usar a interface InfoWindowOpenOptions como o único argumento desse método. Para evitar a mudança de foco do navegador ao abrir, defina InfoWindowOpenOptions.shouldFocus como false . |
setContent |
setContent([content]) Valor de retorno:nenhum
|
setHeaderContent |
setHeaderContent([headerContent]) Parâmetros:
Valor de retorno:nenhum
|
setHeaderDisabled |
setHeaderDisabled([headerDisabled]) Parâmetros:
Valor de retorno:nenhum
|
setOptions |
setOptions([options]) Parâmetros:
Valor de retorno:nenhum
|
setPosition |
setPosition([position]) Parâmetros:
Valor de retorno:nenhum
|
setZIndex |
setZIndex(zIndex) Parâmetros:
Valor de retorno:nenhum
|
Herdado:addListener ,
bindTo ,
get ,
notify ,
set ,
setValues ,
unbind ,
unbindAll
|
Eventos | |
---|---|
close |
function() Argumentos: nenhum
Esse evento é disparado sempre que o InfoWindow é fechado. Por exemplo, isso pode acontecer ao chamar o método InfoWindow.close , pressionar a tecla "Esc" para fechar a InfoWindow, clicar no botão de fechar ou mover a InfoWindow para outro mapa. |
closeclick |
function() Argumentos: nenhum
Este evento é disparado quando o botão fechar é clicado. |
content_changed |
function() Argumentos: nenhum
Este evento é disparado quando a propriedade de conteúdo é alterada. |
domready |
function() Argumentos: nenhum
Esse evento é disparado quando o <div> que contém o conteúdo do InfoWindow é anexado ao DOM. Talvez você queira monitorar este evento se estiver expandindo o conteúdo da sua janela de informações de modo dinâmico. |
headercontent_changed |
function() Argumentos: nenhum
Esse evento é disparado quando a propriedade "headerContent" muda. |
headerdisabled_changed |
function() Argumentos: nenhum
Esse evento é disparado quando a propriedade "headerDisabled" muda. |
position_changed |
function() Argumentos: nenhum
Este evento é disparado quando a propriedade de posição é alterada. |
visible |
function() Argumentos: nenhum
Esse evento é disparado quando o InfoWindow está totalmente visível. Esse evento não é disparado quando InfoWindow é movido para fora e depois de volta à tela. |
zindex_changed |
function() Argumentos: nenhum
Esse evento é disparado quando o zIndex do InfoWindow muda. |
Interface InfoWindowOptions
Interface google.maps.InfoWindowOptions
Objeto InfoWindowOptions usado para definir as propriedades que podem ser definidas em uma InfoWindow.
Propriedades | |
---|---|
ariaLabel optional |
Tipo:
string optional AriaLabel a ser atribuído à InfoWindow. |
content optional |
Conteúdo a ser exibido na janela de informações. Pode ser um elemento HTML, uma string de texto sem formatação ou uma string contendo HTML. A janela de informações será dimensionada de acordo com o conteúdo. Para definir um tamanho explícito para o conteúdo, defina-o como um elemento HTML com esse tamanho. |
disableAutoPan optional |
Tipo:
boolean optional Padrão:
false Desativa o movimento panorâmico do mapa para tornar a janela de informações totalmente visível quando ela é aberta. |
headerContent optional |
O conteúdo a ser exibido na linha de cabeçalho da InfoWindow. Pode ser um elemento HTML ou uma string de texto simples. A janela de informações será dimensionada de acordo com o conteúdo. Para definir um tamanho explícito para o conteúdo do cabeçalho, defina headerContent como um elemento HTML com esse tamanho. |
headerDisabled optional |
Tipo:
boolean optional Desativa toda a linha de cabeçalho na InfoWindow. Quando definido como "true", o cabeçalho é removido para que o conteúdo e o botão de fechar fiquem ocultos. |
maxWidth optional |
Tipo:
number optional Largura máxima da InfoWindow, independente da largura do conteúdo. Esse valor só é considerado se for definido antes de uma chamada para open() . Para mudar a largura máxima ao alterar o conteúdo, chame close() , setOptions() e open() . |
minWidth optional |
Tipo:
number optional Largura mínima da InfoWindow, independente da largura do conteúdo. Ao usar essa propriedade, recomendamos definir o minWidth como um valor menor que a largura do mapa (em pixels). Esse valor só é considerado se for definido antes de uma chamada para open() . Para mudar a largura mínima ao alterar o conteúdo, chame close() , setOptions() e open() . |
pixelOffset optional |
Tipo:
Size optional O deslocamento, em pixels, da extremidade da janela de informações a partir do ponto no mapa em cujas coordenadas geográficas está ancorada a janela de informações. Se uma InfoWindow for aberta com uma âncora, o pixelOffset será calculado com base na propriedade anchorPoint da âncora. |
position optional |
Tipo:
LatLng|LatLngLiteral optional A LatLng para exibição dessa janela de informações. Se a InfoWindow for aberta com uma âncora, a posição dela será usada. |
zIndex optional |
Tipo:
number optional Todas as janelas de informações são exibidas no mapa na ordem de seus zIndex, com os valores maiores exibidos na frente de janelas de informações com valores menores. Por padrão, as janelas de informações são mostradas de acordo com a latitude. As janelas de informações de latitudes menores aparecem na frente das de latitudes maiores. As janelas de informações são sempre exibidas na frente dos marcadores. |
Interface InfoWindowOpenOptions
Interface google.maps.InfoWindowOpenOptions
Opções para abrir uma InfoWindow
Propriedades | |
---|---|
anchor optional |
Tipo:
MVCObject|AdvancedMarkerElement optional A âncora em que a InfoWindow será posicionada. Se a âncora não for nula, a InfoWindow será posicionada na parte superior central dela. A InfoWindow será renderizada no mesmo mapa ou panorama da âncora (quando disponível). |
map optional |
Tipo:
Map|StreetViewPanorama optional O mapa ou panorama em que a InfoWindow será renderizada. |
shouldFocus optional |
Tipo:
boolean optional Especifica se o foco precisa ou não ser movido na janela de informações na abertura. Quando essa propriedade não é definida ou é definida como null ou undefined , uma heurística é usada para decidir se o foco deve ser movido ou não. Recomendamos definir explicitamente essa propriedade para atender às suas necessidades, já que a heurística está sujeita a mudanças e pode não funcionar bem em todos os casos de uso. |