Map.setGestureHandling
Sử dụng bộ sưu tập để sắp xếp ngăn nắp các trang
Lưu và phân loại nội dung dựa trên lựa chọn ưu tiên của bạn.
Kiểm soát cách xử lý cử chỉ trên bản đồ.
Hãy xem https://developers.google.com/maps/documentation/javascript/reference/map#MapOptions.gestureHandling.
| Cách sử dụng | Giá trị trả về |
|---|
Map.setGestureHandling(option) | |
| Đối số | Loại | Thông tin chi tiết |
|---|
option | Chuỗi | Lựa chọn kiểm soát cách xử lý cử chỉ trên bản đồ. Các giá trị được phép:
- "cooperative": Các sự kiện cuộn và cử chỉ chạm bằng một ngón tay sẽ cuộn trang chứ không thu phóng hoặc di chuyển bản đồ. Cử chỉ chạm bằng hai ngón tay sẽ di chuyển và thu phóng bản đồ. Sự kiện cuộn khi nhấn phím ctrl hoặc phím ⌘ sẽ thu phóng bản đồ. Ở chế độ này, bản đồ sẽ phối hợp với trang.
- "greedy": Tất cả cử chỉ chạm và sự kiện cuộn đều dịch chuyển hoặc thu phóng bản đồ.
- "none": Người dùng không thể dùng cử chỉ để di chuyển hoặc thu phóng bản đồ.
- "auto": (mặc định) Chế độ xử lý cử chỉ là phối hợp hoặc tham lam, tuỳ thuộc vào việc trang có thể cuộn hay nằm trong iframe.
|
Trừ phi có lưu ý khác, nội dung của trang này được cấp phép theo Giấy phép ghi nhận tác giả 4.0 của Creative Commons và các mẫu mã lập trình được cấp phép theo Giấy phép Apache 2.0. Để biết thông tin chi tiết, vui lòng tham khảo Chính sách trang web của Google Developers. Java là nhãn hiệu đã đăng ký của Oracle và/hoặc các đơn vị liên kết với Oracle.
Cập nhật lần gần đây nhất: 2025-07-26 UTC.
[null,null,["Cập nhật lần gần đây nhất: 2025-07-26 UTC."],[[["\u003cp\u003e\u003ccode\u003egestureHandling\u003c/code\u003e option controls how users interact with the map through gestures like scrolling and touch.\u003c/p\u003e\n"],["\u003cp\u003eOptions include "cooperative", "greedy", "none", and the default "auto", each affecting how the map responds to user input.\u003c/p\u003e\n"],["\u003cp\u003e"cooperative" allows page scrolling with one finger and map interaction with two fingers, while "greedy" makes all gestures control the map.\u003c/p\u003e\n"],["\u003cp\u003e"none" disables map panning and zooming via gestures, whereas "auto" intelligently switches between "cooperative" and "greedy" based on context.\u003c/p\u003e\n"],["\u003cp\u003eRefer to the Google Maps documentation for detailed information and implementation instructions.\u003c/p\u003e\n"]]],["The `Map.setGestureHandling(option)` method controls map gesture behavior. The `option` argument, a string, determines how the map interacts with user gestures. \"cooperative\" mode allows page scrolling with single-finger or scroll events while reserving two-finger gestures for map manipulation. \"greedy\" mode assigns all touch and scroll actions to the map. \"none\" disables map panning/zooming via gestures. \"auto\" (default) switches between cooperative and greedy modes.\n"],null,["# Map.setGestureHandling\n\n\u003cbr /\u003e\n\nControls how gestures are handled on the map.\n\n\u003cbr /\u003e\n\nSee https://developers.google.com/maps/documentation/javascript/reference/map#MapOptions.gestureHandling.\n\n| Usage | Returns |\n|----------------------------------|---------|\n| `Map.setGestureHandling(option)` | |\n\n| Argument | Type | Details |\n|----------|--------|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `option` | String | The option that controls how gestures are handled on the map. Allowed values: - \"cooperative\": Scroll events and one-finger touch gestures scroll the page, and do not zoom or pan the map. Two-finger touch gestures pan and zoom the map. Scroll events with a ctrl key or ⌘ key pressed zoom the map. In this mode the map cooperates with the page. - \"greedy\": All touch gestures and scroll events pan or zoom the map. - \"none\": The map cannot be panned or zoomed by user gestures. - \"auto\": (default) Gesture handling is either cooperative or greedy, depending on whether the page is scrollable or in an iframe. |"]]
