Info Window

Lớp InfoWindow

Lớp google.maps.InfoWindow

Lớp phủ trông giống như bong bóng và thường được kết nối với điểm đánh dấu.

Lớp này mở rộng MVCObject.

InfoWindow
InfoWindow([opts])
Thông số:
Tạo cửa sổ thông tin có các tùy chọn nhất định. Có thể đặt InfoWindow trên bản đồ tại một vị trí cụ thể hoặc phía trên một điểm đánh dấu, tùy thuộc vào nội dung được chỉ định trong các tùy chọn. Trừ khi tính năng tự động xoay bị tắt, Cửa sổ thông tin sẽ xoay bản đồ để hiển thị bản đồ khi ứng dụng mở ra. Sau khi tạo InfoWindow, bạn phải gọi để mở thông tin đó trên bản đồ. Người dùng có thể nhấp vào nút đóng trên InfoWindow để xóa nút đó khỏi bản đồ hoặc nhà phát triển có thể gọi Close() để tạo hiệu ứng tương tự.
close
close()
Thông số: Không có
Giá trị trả về: Không có
Đóng InfoWindow này bằng cách xoá nó khỏi cấu trúc DOM.
focus
focus()
Thông số: Không có
Giá trị trả về: Không có
Đặt tiêu điểm vào InfoWindow này. Bạn nên cân nhắc sử dụng phương thức này cùng với một sự kiện visible để đảm bảo rằng InfoWindow hiển thị trước khi đặt tiêu điểm vào phương thức đó. Không thể lấy tiêu điểm vào một InfoWindow không hiển thị.
getContent
getContent()
Thông số: Không có
Giá trị trả về: string|Element|null|Text|undefined Nội dung của InfoWindow này. Giống như nội dung đã đặt trước đó làm nội dung.
getPosition
getPosition()
Thông số: Không có
Giá trị trả về: LatLng|null|undefined Vị trí LatLng của InfoWindow này.
getZIndex
getZIndex()
Thông số: Không có
Giá trị trả về: number Chỉ mục zIndex của InfoWindow này.
open
open([options, anchor])
Thông số:
  • options: InfoWindowOpenOptions|Map|StreetViewPanorama optional Một đối tượng InfoWindowOpenOptions (nên dùng) hoặc bản đồ|panorama để hiển thị InfoWindow này.
  • anchor: MVCObject optional Nội dung neo của cửa sổ thông tin này. Nếu liên kết không phải là giá trị rỗng, Cửa sổ thông tin sẽ được đặt ở giữa phía trên cùng của liên kết. Cửa sổ thông tin sẽ hiển thị trên cùng một bản đồ hoặc toàn cảnh như neo (khi có sẵn).
Giá trị trả về: Không có
Mở InfoWindow này trên bản đồ đã cho. Không bắt buộc, bạn có thể liên kết InfoWindow với một liên kết. Trong API lõi, neo duy nhất là lớp Đánh dấu. Tuy nhiên, neo có thể là bất kỳ MVCObject nào hiển thị thuộc tính LatLng position và có thể là thuộc tính Point anchorPoint để tính toán pixelOffset (xem InfoWindowOptions). anchorPoint là độ dời từ vị trí cố định đến đầu Cửa sổ thông tin. Bạn nên sử dụng giao diện InfoWindowOpenOptions làm đối số duy nhất cho phương thức này. Để ngăn việc thay đổi tiêu điểm của trình duyệt khi mở, hãy đặt InfoWindowOpenOptions.shouldFocus thành false.
setContent
setContent([content])
Thông số:
  • contentstring|Element|Text optional Nội dung sẽ hiển thị trong Thông tin này.
Giá trị trả về: Không có
setOptions
setOptions([options])
Thông số:
Giá trị trả về: Không có
setPosition
setPosition([position])
Thông số:
Giá trị trả về: Không có
setZIndex
setZIndex(zIndex)
Thông số:
  • zIndexnumber Chỉ mục z cho InfoWindow này. Một tệp Windows có chỉ mục z lớn hơn sẽ được hiển thị trước tất cả thông tin khác có chỉ số z thấp hơn.
Giá trị trả về: Không có
Đã kế thừa: addListener, bindTo, get, notify, set, setValues, unbind, unbindAll
closeclick
function()
Đối số: Không có
Sự kiện này được kích hoạt khi người dùng nhấp vào nút đóng.
content_changed
function()
Đối số: Không có
Sự kiện này được kích hoạt khi thuộc tính nội dung thay đổi.
domready
function()
Đối số: Không có
Sự kiện này được kích hoạt khi <div> chứa nội dung InfoWindow#39; được đính kèm vào DOM. Bạn nên theo dõi sự kiện này nếu đang xây dựng nội dung cửa sổ thông tin một cách linh động.
position_changed
function()
Đối số: Không có
Sự kiện này được kích hoạt khi thuộc tính vị trí thay đổi.
visible
function()
Đối số: Không có
Sự kiện này được kích hoạt khi InfoWindow hiển thị đầy đủ. Sự kiện này không được kích hoạt khi InfoWindow được xoay rồi quay lại màn hình.
zindex_changed
function()
Đối số: Không có
Sự kiện này được kích hoạt khi zIndex của InfoWindow thay đổi.

Giao diện InfoWindowOptions

Giao diện google.maps.InfoWindowOptions

Đối tượng InfoWindowOptions dùng để xác định các thuộc tính có thể đặt trên Cửa sổ thông tin.

ariaLabel optional
Loại: string optional
AriaLabel để gán cho InfoWindow.
content optional
Loại: string|Element|Text optional
Nội dung hiển thị trong Cửa sổ thông tin. Đó có thể là một phần tử HTML, một chuỗi văn bản thuần túy hoặc một chuỗi chứa HTML. InfoWindow sẽ được định kích thước theo nội dung. Để đặt kích thước rõ ràng cho nội dung, hãy đặt nội dung thành một phần tử HTML có kích thước đó.
disableAutoPan optional
Loại: boolean optional
Mặc định: false
Tắt tính năng xoay bản đồ để thông tin hoàn toàn xuất hiện khi cửa sổ mở ra.
maxWidth optional
Loại: number optional
Chiều rộng tối đa của Cửa sổ thông tin, bất kể chiều rộng nội dung. Giá trị này chỉ được xem xét nếu được đặt trước lệnh gọi đến open(). Để thay đổi chiều rộng tối đa khi thay đổi nội dung, hãy gọi close(), setOptions(), sau đó gọi open().
minWidth optional
Loại: number optional
Chiều rộng tối thiểu của InfoWindow, bất kể chiều rộng nội dung. Khi sử dụng thuộc tính này, bạn nên đặt minWidth thành một giá trị nhỏ hơn chiều rộng của bản đồ (tính bằng pixel). Giá trị này chỉ được xem xét nếu được đặt trước lệnh gọi đến open(). Để thay đổi chiều rộng tối thiểu khi thay đổi nội dung, hãy gọi close(), setOptions(), sau đó gọi open().
pixelOffset optional
Loại: Size optional
Chênh lệch, tính bằng pixel, của đầu cửa sổ thông tin từ điểm trên bản đồ có tọa độ địa lý của cửa sổ thông tin cố định. Nếu bạn mở một cửa sổ thông tin bằng một điểm neo, thì pixelOffset sẽ được tính toán từ thuộc tính anchorPoint của neo đó.
position optional
Loại: LatLng|LatLngLiteral optional
LatLng tại đó hiển thị InfoWindow này. Nếu Cửa sổ thông tin được mở bằng neo, vị trí neo sẽ được sử dụng.
zIndex optional
Loại: number optional
Tất cả InfoWindows được hiển thị trên bản đồ theo thứ tự zIndex, với các giá trị cao hơn được hiển thị trước InfoWindows với các giá trị thấp hơn. Theo mặc định, InfoWindows được hiển thị theo vĩ độ của chúng, với InfoWindows có vĩ độ thấp hơn xuất hiện phía trước InfoWindows ở vĩ độ cao hơn. InfoWindows luôn hiển thị phía trước các điểm đánh dấu.

Giao diện InfoWindowOpenOptions

Giao diện google.maps.InfoWindowOpenOptions

Các tùy chọn để mở InfoWindow

anchor optional
Loại: MVCObject optional
Nội dung liên kết mà InfoWindow này sẽ được đặt vị trí. Nếu liên kết không phải là giá trị rỗng, Cửa sổ thông tin sẽ được đặt ở giữa phía trên cùng của liên kết. Cửa sổ thông tin sẽ hiển thị trên cùng một bản đồ hoặc toàn cảnh như neo (khi có sẵn).
map optional
Loại: Map|StreetViewPanorama optional
Bản đồ hoặc ảnh toàn cảnh dùng để kết xuất InfoWindow này.
shouldFocus optional
Loại: boolean optional
Liệu có nên di chuyển tiêu điểm bên trong Cửa sổ thông tin khi nó được mở hay không. Khi bạn không đặt thuộc tính này hoặc đặt thuộc tính này thành null hoặc undefined, một phương pháp phỏng đoán sẽ được dùng để quyết định xem có nên di chuyển tiêu điểm hay không. Bạn nên đặt thuộc tính này một cách rõ ràng cho phù hợp với nhu cầu của mình vì phỏng đoán có thể thay đổi và có thể không hoạt động tốt cho tất cả các trường hợp sử dụng.