diff --git a/docs/content/docs/4.migration-guide/1.v0-to-v1.md b/docs/content/docs/4.migration-guide/1.v0-to-v1.md index 2c264404..7fe33de0 100644 --- a/docs/content/docs/4.migration-guide/1.v0-to-v1.md +++ b/docs/content/docs/4.migration-guide/1.v0-to-v1.md @@ -301,6 +301,42 @@ Default `object-fit` changed from `contain` to `cover`: Player instances are now properly isolated. Remove any workarounds for multiple players. +### Google Maps Static Placeholder ([#673](https://github.com/nuxt/scripts/pull/673)) + +v1 extracts the built-in static map placeholder into a standalone [``{lang="html"}](/scripts/google-maps/api/static-map) component. This removes the following props from ``{lang="html"}: + +- `placeholderOptions` +- `placeholderAttrs` +- `aboveTheFold` + +The `#placeholder` slot no longer passes a `placeholder` URL string. It is now empty by default. + +```diff + + + + ++ ++ ++ +``` + +Use the new component standalone for store locators, contact pages, and directions previews without loading the interactive Maps API. + ### Google Tag Manager #### onBeforeGtmStart Callback diff --git a/docs/content/scripts/google-maps/2.api/1.script-google-maps.md b/docs/content/scripts/google-maps/2.api/1.script-google-maps.md index 12922ad9..425a400d 100644 --- a/docs/content/scripts/google-maps/2.api/1.script-google-maps.md +++ b/docs/content/scripts/google-maps/2.api/1.script-google-maps.md @@ -9,7 +9,7 @@ The [``{lang="html"}](/scripts/google-maps){lang="html"} compo It's optimized for performance by using the [Element Event Triggers](/docs/guides/script-triggers#element-event-triggers), only loading the Google Maps when specific elements events happen. -Before Google Maps loads, it shows a placeholder using [Maps Static API](https://developers.google.com/maps/documentation/maps-static). +The `#placeholder` slot is empty by default. Use [``{lang="html"}](/scripts/google-maps/api/static-map) inside it to show a static map image while the interactive map loads. By default, it will load on the `mouseenter`, `mouseover`, and `mousedown` events. @@ -124,15 +124,17 @@ override this component. Make sure you provide a loading indicator. **placeholder** -This slot displays a placeholder image before Google Maps loads. By default, this will show the Google Maps Static API image for the map. - -Provide custom `#placeholder` content without rendering the provided `placeholder` URL to skip the Static Maps API request and avoid those charges. +The placeholder slot is empty by default. Use [``{lang="html"}](/scripts/google-maps/api/static-map) to show a static map preview while the interactive map loads. ```vue