InfoWindow クラス
class
google.maps.InfoWindow
extends MVCObject
library "maps", "streetView"
吹き出しのようなオーバーレイで、多くの場合、マーカーに接続されています。
const {InfoWindow} = await google.maps.importLibrary("maps");
const {InfoWindow} = await google.maps.importLibrary("streetView");
コンストラクタ | |
|---|---|
InfoWindow |
InfoWindow([opts])パラメータ:
指定されたオプションを使用して情報ウィンドウを作成します。InfoWindow は、オプションで指定した内容に応じて、地図上の特定の位置またはマーカーの上に配置できます。自動パンが無効になっていない限り、InfoWindow が開かれると、InfoWindow が表示されるように地図がパンされます。InfoWindow を作成したら、open を呼び出して地図上に表示する必要があります。ユーザーは情報ウィンドウの閉じるボタン [X] をクリックして地図から情報ウィンドウを削除できます。またはデベロッパーが close() を呼び出しても同じことです。 |
プロパティ | |
|---|---|
isOpen
readonly |
タイプ:
booleanInfoWindow が開いているかどうかを確認します。 |
メソッド | |
|---|---|
close |
close()パラメータ: なし
戻り値: なし
DOM 構造から削除して、この情報ウィンドウを閉じます。 |
focus |
focus()パラメータ: なし
戻り値: なし
この InfoWindow にフォーカスを設定します。このメソッドを visible イベントと組み合わせて使用すると、InfoWindow にフォーカスを設定する前に、InfoWindow が表示されていることを確認できます。表示されていない InfoWindow にフォーカスを合わせることはできません。 |
getContent |
getContent()パラメータ: なし
|
getHeaderContent |
getHeaderContent()パラメータ: なし
戻り値:
string|Element|Text|null|undefined この InfoWindow のヘッダー コンテンツ。InfoWindowOptions.headerContent をご覧ください。 |
getHeaderDisabled |
getHeaderDisabled()パラメータ: なし
戻り値:
boolean|undefined ヘッダー行全体が無効になっているかどうか。InfoWindowOptions.headerDisabled をご覧ください。 |
getPosition |
getPosition()パラメータ: なし
戻り値:
LatLng|null|undefined この InfoWindow の LatLng 位置。 |
getZIndex |
getZIndex()パラメータ: なし
戻り値:
number この InfoWindow の zIndex。 |
open |
open([options, anchor])パラメータ:
戻り値: なし
指定された地図上でこの InfoWindow を開きます。必要に応じて、InfoWindow をアンカーに関連付けることができます。コア API では、アンカーは Marker クラスのみです。ただし、アンカーは、LatLng position プロパティと、必要に応じて pixelOffset を計算するための Point anchorPoint プロパティを公開する任意の MVCObject にすることができます(InfoWindowOptions を参照)。anchorPoint は、アンカーの位置から InfoWindow の先端までのオフセットです。このメソッドの単一の引数として InfoWindowOpenOptions インターフェースを使用することをおすすめします。開いたときにブラウザのフォーカスが変更されないようにするには、InfoWindowOpenOptions.shouldFocus を false に設定します。 |
setContent |
setContent([content])戻り値: なし
|
setHeaderContent |
setHeaderContent([headerContent])パラメータ:
戻り値: なし
|
setHeaderDisabled |
setHeaderDisabled([headerDisabled])パラメータ:
戻り値: なし
|
setOptions |
setOptions([options])パラメータ:
戻り値: なし
|
setPosition |
setPosition([position])パラメータ:
戻り値: なし
|
setZIndex |
setZIndex(zIndex)パラメータ:
戻り値: なし
|
継承:
addListener、
bindTo、
get、
notify、
set、
setValues、
unbind、
unbindAll
| |
イベント | |
|---|---|
close |
function()引数: なし
このイベントは、 InfoWindow が閉じられるたびに発生します。たとえば、InfoWindow.close メソッドの呼び出し、Esc キーを押して InfoWindow を閉じる、閉じるボタンをクリックする、InfoWindow を別の地図に移動する、などの操作が考えられます。 |
closeclick |
function()引数: なし
このイベントは、閉じるボタン [X] がクリックされると発生します。 |
content_changed |
function()引数: なし
このイベントは、content プロパティが変更されたときに発生します。 |
domready |
function()引数: なし
このイベントは、 InfoWindow のコンテンツを含む <div> が DOM にアタッチされたときに発生します。情報ウィンドウのコンテンツを動的に作成している場合は、このイベントを監視できます。 |
headercontent_changed |
function()引数: なし
このイベントは、headerContent プロパティが変更されたときに発生します。 |
headerdisabled_changed |
function()引数: なし
このイベントは、headerDisabled プロパティが変更されたときに発生します。 |
position_changed |
function()引数: なし
このイベントは、position プロパティが変更されたときに発生します。 |
visible |
function()引数: なし
このイベントは、 InfoWindow が完全に表示されたときに発生します。InfoWindow が画面外にパンされてから画面内に戻ったときには、このイベントは発生しません。 |
zindex_changed |
function()引数: なし
このイベントは、 InfoWindow の zIndex が変更されたときに発生します。 |
InfoWindowOptions インターフェース
インターフェース
google.maps.InfoWindowOptions
InfoWindow に設定できるプロパティを定義するために使用される InfoWindowOptions オブジェクト。
プロパティ | |
|---|---|
ariaLabel
省略可 |
タイプ:
string optionalInfoWindow に割り当てる AriaLabel。 |
content
省略可 |
InfoWindow に表示するコンテンツ。HTML 要素、プレーンテキスト文字列、HTML を含む文字列を指定できます。InfoWindow のサイズは、コンテンツに応じて調整されます。コンテンツのサイズを明示的に設定するには、コンテンツをそのサイズの HTML 要素に設定します。 |
disableAutoPan
省略可 |
タイプ:
boolean optionalデフォルト:
false情報ウィンドウが開いたときに、情報ウィンドウが完全に表示されるように地図をパンする機能を無効にします。 |
headerContent
省略可 |
InfoWindow のヘッダー行に表示するコンテンツ。HTML 要素または書式なしテキストの文字列を指定できます。InfoWindow のサイズは、コンテンツに応じて調整されます。ヘッダー コンテンツのサイズを明示的に設定するには、headerContent をそのサイズの HTML 要素に設定します。 |
headerDisabled
省略可 |
タイプ:
boolean optionalInfoWindow のヘッダー行全体を無効にします。true に設定すると、ヘッダーが削除され、ヘッダーのコンテンツと閉じるボタンが非表示になります。 |
maxWidth
省略可 |
タイプ:
number optionalコンテンツの幅に関係なく、InfoWindow の最大幅。この値は、 open() の呼び出し前に設定されている場合にのみ考慮されます。コンテンツの変更時に最大幅を変更するには、close()、setOptions()、open() の順に呼び出します。 |
minWidth
省略可 |
タイプ:
number optionalコンテンツの幅に関係なく、InfoWindow の最小幅。このプロパティを使用する場合は、 minWidth を地図の幅(ピクセル単位)より小さい値に設定することを強くおすすめします。この値は、open() の呼び出し前に設定されている場合にのみ考慮されます。コンテンツの変更時に最小幅を変更するには、close()、setOptions()、open() の順に呼び出します。 |
pixelOffset
省略可 |
タイプ:
Size optional情報ウィンドウの先端から、情報ウィンドウが固定されている地図上のポイント(地理座標)までのオフセット(ピクセル単位)。アンカーを使用して InfoWindow を開いた場合、 pixelOffset はアンカーの anchorPoint プロパティから計算されます。 |
position
省略可 |
タイプ:
LatLng|LatLngLiteral optionalこの InfoWindow を表示する LatLng。情報ウィンドウがアンカー付きで開かれた場合は、代わりにアンカーの位置が使用されます。 |
zIndex
省略可 |
タイプ:
number optionalすべての InfoWindow は、zIndex の順に地図上に表示されます。値が大きい InfoWindow ほど、値が小さい InfoWindow の手前に表示されます。デフォルトでは、情報ウィンドウは緯度に従って表示され、緯度の低い情報ウィンドウが緯度の高い情報ウィンドウの前に表示されます。InfoWindow は常にマーカーの前面に表示されます。 |
InfoWindowOpenOptions インターフェース
インターフェース
google.maps.InfoWindowOpenOptions
InfoWindow を開くためのオプション
プロパティ | |
|---|---|
anchor
省略可 |
タイプ:
MVCObject|AdvancedMarkerElement optionalこの InfoWindow を配置するアンカー。アンカーが null 以外の場合、InfoWindow はアンカーの上部中央に配置されます。InfoWindow は、アンカーと同じ地図またはパノラマにレンダリングされます(利用可能な場合)。 |
map
省略可 |
タイプ:
Map|StreetViewPanorama optionalこの InfoWindow をレンダリングする地図またはパノラマ。 |
shouldFocus
省略可 |
タイプ:
boolean optional情報ウィンドウが開かれたときに、そのウィンドウ内でフォーカスを移動するかどうか。このプロパティが未設定の場合、または null か undefined に設定されている場合は、ヒューリスティックを使用してフォーカスを移動するかどうかを決定します。ヒューリスティックは変更される可能性があり、すべてのユースケースで適切に機能するとは限らないため、ニーズに合わせてこのプロパティを明示的に設定することをおすすめします。 |