@astrojs/ preact
이 Astro 통합 을 통해 Preact 컴포넌트에 대한 렌더링 및 클라이언트 측 하이드레이션이 가능해졌습니다.
왜 Preact인가?
섹션 제목: 왜 Preact인가?Preact는 웹용 대화형 UI 컴포넌트를 빌드할 수 있는 라이브러리입니다. JavaScript를 사용하여 사이트에 대화형 기능을 빌드하려면 브라우저 API를 직접 사용하는 대신 컴포넌트 형식을 사용하는 것이 좋습니다.
이전에 React를 사용해 본 적이 있다면 Preact도 좋은 선택입니다. Preact는 React와 동일한 API를 제공하지만 훨씬 더 작은 3kB 패키지로 제공됩니다. compat
구성 옵션을 사용하여 많은 React 컴포넌트 렌더링도 지원합니다 (아래 참조).
이 통합을 사용하기 전에 Preact에 대해 자세히 알아보고 싶으신가요?
웹사이트에서 대화형 튜토리얼인 “Preact 배우기”를 확인하세요.
Astro에는 공식 통합 설정을 자동화하는 astro add
명령이 포함되어 있습니다. 원하는 경우 대신 통합을 수동으로 설치할 수 있습니다.
@astrojs/preact
를 설치하려면 프로젝트 디렉터리에서 다음을 실행하고 프롬프트를 따르세요.
문제가 발생하면 GitHub에서 언제든지 보고하고 아래 수동 설치 단계를 시도해 보세요.
수동 설치
섹션 제목: 수동 설치먼저 @astrojs/preact
패키지를 설치하세요.
대부분의 패키지 관리자는 관련 피어 종속성도 설치합니다. Astro를 시작할 때 “Cannot find package ‘preact’” (또는 이와 유사한) 경고가 표시되면 Preact를 설치해야 합니다.
그런 다음 integrations
속성을 사용하여 astro.config.*
파일에 통합을 적용합니다.
사용하기
섹션 제목: 사용하기Astro에서 첫 번째 Preact 컴포넌트를 사용하려면 UI 프레임워크 문서로 이동하세요. 다음을 탐색하게 됩니다.
- 📦 프레임워크 컴포넌트가 로드되는 방식,
- 💧 클라이언트 측 하이드레이션 옵션
- 🤝 프레임워크를 함께 혼합하고 중첩할 수 있는 기회
또한 통합에 대한 자세한 내용은 Astro 통합 문서를 확인하세요.
Astro Preact 통합은 Preact 컴포넌트가 렌더링되는 방식을 처리하며 자체 옵션이 있습니다. 프로젝트의 통합 설정이 있는 astro.config.mjs
파일에서 이를 변경하세요.
기본 사용의 경우 Preact 통합을 구성할 필요가 없습니다.
compat
섹션 제목: compatReact의 대규모 라이브러리를 사용자의 웹 브라우저에 설치하거나 제공할 필요 없이 React 컴포넌트를 렌더링하기 위한 Preact의 호환성 레이어인 preact/compat
를 활성화할 수 있습니다.
이렇게 하려면 객체를 Preact 통합에 전달하고 compat: true
를 설정하세요.
compat
옵션이 활성화되면 Preact 통합은 React 컴포넌트와 Preact 컴포넌트를 프로젝트에 렌더링하고 Preact 컴포넌트 내에서 React 컴포넌트를 가져올 수도 있습니다. Preact 웹사이트의 “React에서 Preact로 전환”에서 자세한 내용을 읽어보세요.
React 컴포넌트 라이브러리를 가져올 때 react
및 react-dom
종속성을 preact/compat
으로 교체하려면 overrides
를 사용하면 됩니다.
해당 overrides 기능에 대해서는pnpm
overrides 및 yarn
resolutions 문서를 확인하세요.
현재 compat
옵션은 코드를 ESM으로 내보내는 React 라이브러리에서만 작동합니다. 빌드 시 오류가 발생하면 astro.config.mjs
파일의 vite.ssr.noExternal: ['the-react-library']
에 라이브러리를 추가해 보세요.
devtools
섹션 제목: devtools
Added in:
@astrojs/preact@3.3.0
devtools: true
가 포함된 객체를 preact()
통합 구성에 전달하여 개발 모드에서 Preact devtools를 활성화할 수 있습니다.
여러 JSX 프레임워크 결합
섹션 제목: 여러 JSX 프레임워크 결합동일한 프로젝트에서 여러 JSX 프레임워크 (React, Preact, Solid)를 사용하는 경우 Astro는 각 컴포넌트에 어떤 JSX 프레임워크별 변환을 사용해야 하는지 결정해야 합니다. 프로젝트에 하나의 JSX 프레임워크 통합만 추가한 경우 추가 구성이 필요하지 않습니다.
어떤 파일이 어떤 프레임워크에 속하는지 지정하려면 include
(필수) 및 exclude
(선택 사항) 구성 옵션을 사용하세요. 사용 중인 각 프레임워크에 포함
할 파일 및/또는 폴더 배열을 제공하세요. 와일드카드를 사용하여 여러 파일 경로를 포함할 수 있습니다.
포함을 더 쉽게 지정할 수 있도록 공통 프레임워크 컴포넌트를 동일한 폴더 (예: /components/react/
및 /components/solid/
)에 배치하는 것이 좋지만 필수는 아닙니다.
- Astro Preact 예시는 Astro 프로젝트에서 대화형 Preact 컴포넌트를 사용하는 방법을 보여줍니다.
- Astro Nanostores 예시는 서로 다른 컴포넌트, 심지어는 서로 다른 프레임워크 간 상태를 공유하는 방법을 보여줍니다! — Astro 프로젝트에서