Skip to content

Commit

Permalink
[i18nIgnore][prefetch.mdx]: Adds a load prefetch strategy (#5967)
Browse files Browse the repository at this point in the history
Co-authored-by: liruifengv <liruifeng1024@gmail.com>
Co-authored-by: Yan Thomas <61414485+Yan-Thomas@users.noreply.github.com>
Co-authored-by: Waxer59 <78129249+Waxer59@users.noreply.github.com>
Co-authored-by: Sarah Rainsberger <sarah@rainsberger.ca>
  • Loading branch information
5 people authored Jan 4, 2024
1 parent 9fd6e52 commit 13a552f
Show file tree
Hide file tree
Showing 4 changed files with 12 additions and 8 deletions.
5 changes: 3 additions & 2 deletions src/content/docs/en/guides/prefetch.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -32,11 +32,12 @@ The `prefetch` config also accepts an option object to further customize prefetc

### Prefetch strategies

Astro supports 3 prefetch strategies for various use cases:
Astro supports 4 prefetch strategies for various use cases:

- `hover` (default): Prefetch when you hover over or focus on the link.
- `tap`: Prefetch just before you click on the link.
- `viewport`: Prefetch as the links enter the viewport.
- `load`: Prefetch all links on the page after the page is loaded.

You can specify a strategy for an individual link by passing it to the `data-astro-prefetch` attribute:

Expand All @@ -48,7 +49,7 @@ Each strategy is fine-tuned to only prefetch when needed and save your users' ba

- If a visitor is using [data saver mode](https://developer.mozilla.org/en-US/docs/Web/API/NetworkInformation/saveData) or has a [slow connection](https://developer.mozilla.org/en-US/docs/Web/API/NetworkInformation/effectiveType), prefetch will fallback to the `tap` strategy.
- Quickly hovering or scrolling over links will not prefetch them.
- Links that use the `viewport` strategy are prefetched with a lower priority to avoid clogging up the network.
- Links that use the `viewport` or `load` strategy are prefetched with a lower priority to avoid clogging up the network.

### Default prefetch strategy

Expand Down
5 changes: 3 additions & 2 deletions src/content/docs/es/guides/prefetch.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -32,11 +32,12 @@ La configuración `prefetch` también acepta un objeto de opciones para personal

### Estrategias de precarga

Astro admite 3 estrategias de precarga para varios casos de uso:
Astro admite 4 estrategias de precarga para varios casos de uso:

- `hover` (por defecto): Precarga cuando pasas el cursor o te enfocas en el enlace.
- `tap`: Precarga justo antes de hacer clic en el enlace.
- `viewport`: Precarga cuando los enlaces entran en el viewport.
- `load`: Precarga todos los enlaces en la página después de que la página se ha cargado.

Puedes especificar una estrategia para un enlace individual pasándola al atributo `data-astro-prefetch`:

Expand All @@ -48,7 +49,7 @@ Cada estrategia está ajustada para precargar solo cuando sea necesario y ahorra

- Si un visitante está usando el [modo ahorro de datos](https://developer.mozilla.org/en-US/docs/Web/API/NetworkInformation/saveData) o tiene una [conexión lenta](https://developer.mozilla.org/en-US/docs/Web/API/NetworkInformation/effectiveType), la precarga volverá a la estrategia `tap`.
- Desplazarse rápidamente sobre los enlaces no los precargará.
- Los enlaces que usan la estrategia `viewport` se precargan con una prioridad más baja para evitar obstruir la red.
- Los enlaces que usan la estrategia `viewport` o `load` se precargan con una prioridad más baja para evitar obstruir la red.

### Estrategia de precarga predeterminada

Expand Down
5 changes: 3 additions & 2 deletions src/content/docs/ko/guides/prefetch.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -32,11 +32,12 @@ export default defineConfig({

### 프리페치 전략

Astro는 다양한 사용 사례에 대해 3가지 프리페치 전략을 지원합니다.
Astro는 다양한 사용 사례에 대해 4가지 프리페치 전략을 지원합니다.

- `hover` (기본값): 링크 위로 마우스를 가져가거나 링크에 포커싱하면 페이지를 미리 가져옵니다.
- `tap`: 링크를 클릭하기 직전에 페이지를 미리 가져옵니다.
- `viewport`: 링크가 뷰포트에 들어갈 때 페이지를 미리 가져옵니다.
- `load`: 페이지가 로드된 후에 페이지의 모든 링크를 미리 가져오세요.。

`data-astro-prefetch` 속성에 전달하여 개별 링크에 대한 전략을 지정할 수 있습니다.

Expand All @@ -48,7 +49,7 @@ Astro는 다양한 사용 사례에 대해 3가지 프리페치 전략을 지원

- 방문자가 [데이터 절약 모드](https://developer.mozilla.org/en-US/docs/Web/API/NetworkInformation/saveData)를 사용 중이거나 [연결 속도가 느린 경우](https://developer.mozilla.org/en-US/docs/Web/API/NetworkInformation/effectiveType), 프리페치는 `tap` 전략으로 대체됩니다.
- 링크 위에 빠르게 마우스를 올리거나 스크롤하면 해당 링크를 미리 가져오지 않습니다.
- `viewport` 전략을 사용하는 링크는 네트워크 막힘을 방지하기 위해 낮은 우선순위로 미리 가져옵니다.
- `viewport` 또는 `load` 전략을 사용하는 링크는 네트워크 막힘을 방지하기 위해 낮은 우선순위로 미리 가져옵니다.

### 기본 프리페치 전략

Expand Down
5 changes: 3 additions & 2 deletions src/content/docs/zh-cn/guides/prefetch.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -32,11 +32,12 @@ export default defineConfig({

### 预获取策略

Astro 支持 3 种预获取策略,以适应各种用例:
Astro 支持 4 种预获取策略,以适应各种用例:

- `hover`(默认):当你将鼠标悬停在链接上或聚焦在链接上时预获取。
- `tap`:在你点击链接之前预获取。
- `viewport`:当链接进入视口时预获取。
- `load`:当页面加载后预获取当前页面的所有链接。

你可以通过将其传递给 `data-astro-prefetch` 属性来为单个链接指定策略:

Expand All @@ -48,7 +49,7 @@ Astro 支持 3 种预获取策略,以适应各种用例:

- 如果访问者使用[流量节省模式](https://developer.mozilla.org/zh-CN/docs/Web/API/NetworkInformation/saveData)或者有[慢速连接](https://developer.mozilla.org/en-US/docs/Web/API/NetworkInformation/effectiveType),则预获取策略将会回退到 “tap” 策略。
- 快速悬停或滚动链接不会预获取它们。
- 使用 `viewport` 策略的链接会以较低的优先级预获取,以避免堵塞网络。
- 使用 `viewport` 或者 `load` 策略的链接会以较低的优先级预获取,以避免堵塞网络。

### 默认预获取策略

Expand Down

0 comments on commit 13a552f

Please sign in to comment.