실험적 Astro Vite 플러그인
@astrojs/vite-plugin-astro를 사용하면 Astro 프로젝트 없이도 모든 Vite 프로젝트에서 Astro 컴포넌트를 사용할 수 있습니다. 무엇을 렌더링할지는 여러분의 서버가 결정합니다. Hono 라우트, Express 핸들러, 또는 컴포넌트를 렌더링하고 HTML을 반환하는 워커의 fetch() 등이 될 수 있습니다.
컴포넌트는 Astro에서와 동일하게 동작합니다. 범위가 지정된 스타일과 <script> 태그를 사용할 수 있고, 브라우저에서 하이드레이션되는 React, Preact, Solid, Svelte 또는 Vue 컴포넌트로 만든 아일랜드도 사용할 수 있습니다.
@astrojs/vite-plugin-astro와 @astrojs/runtime은 실험적입니다. 1.0에 도달할 때까지 마이너 릴리스에서 API가 변경될 수 있습니다.
플러그인과 런타임을 설치하세요:
npm install @astrojs/vite-plugin-astro @astrojs/runtimepnpm add @astrojs/vite-plugin-astro @astrojs/runtimeyarn add @astrojs/vite-plugin-astro @astrojs/runtime그런 다음 Vite 구성에 플러그인을 추가하세요:
import astro from '@astrojs/vite-plugin-astro';import { defineConfig } from 'vite';
export default defineConfig({ plugins: [astro()],});이제 서버 코드에서 .astro 파일을 가져올 수 있습니다.
컴포넌트 렌더링하기
섹션 제목: “컴포넌트 렌더링하기”서버 코드에서 컴포넌트를 가져온 다음 @astrojs/runtime의 renderToResponse() 또는 renderToString()으로 렌더링하세요.
다음 예시는 Hono 라우트를 사용하여 URL에서 가져온 name prop과 함께 Page.astro 컴포넌트를 렌더링합니다:
import { renderToResponse } from '@astrojs/runtime';import { Hono } from 'hono';import Page from './components/Page.astro';
const app = new Hono();
app.get('/hello/:name', (c) => renderToResponse(Page, { props: { name: c.req.param('name') } }),);
export default app;Page.astro는 name prop을 받으며, 다른 Astro 프로젝트에서와 마찬가지로 컴포넌트 props를 사용할 수 있습니다:
---const { name } = Astro.props;---<html lang="en"> <head> <meta charset="utf-8" /> <title>Hello, {name}</title> </head> <body> <h1>Hello, {name}!</h1> </body></html>
<style> h1 { color: rebeccapurple; }</style>