콘텐츠로 이동

실험적 클라이언트 사전 렌더링

타입: boolean
기본값: false

추가된 버전: astro@4.2.0

지원되는 브라우저의 클라이언트에서 미리 가져온 페이지를 사전 렌더링할 수 있습니다.

이 기능은 실험적인 Speculation Rules Web API를 사용하며 전역적으로 기본 prefetch 동작을 향상시켜 클라이언트에서 링크를 사전 렌더링합니다.이 기능을 활성화하기 전에 클라이언트에서 사전 렌더링할 때의 잠재적 위험을 검토하는 것이 좋습니다.

astro.config.mjs에서 원하는 prefetch 구성 옵션과 함께 클라이언트 측 사전 렌더링을 활성화하세요:

import { defineConfig } from 'astro/config';

export default defineConfig({
  prefetch: {
    prefetchAll: true,
    defaultStrategy: 'viewport',
  },
  experimental: {
    clientPrerender: true,
  },
});

사이트의 모든 <a /> 링크에서 data-astro-prefetch 속성을 계속 사용하여 프리페칭을 설정하세요.문서의 head에 <link> 태그를 추가하거나 JavaScript로 페이지를 가져오는 대신, 해당하는 추측 규칙이 포함된 <script> 태그가 추가됩니다.

클라이언트 측 사전 렌더링에는 브라우저 지원이 필요합니다. Speculation Rules API가 지원되지 않는 경우, prefetch는 지원되는 전략으로 대체됩니다.

더 많은 prefetch 옵션과 사용법은 프리페치 가이드를 참조하세요.

기여하기 커뮤니티 후원하기