Skip to content
이 페이지의 내용

react-iztro ​

react-iztro는 열두 궁(十二宮), 성요(星曜), 사화(四化), 삼방사정(三方四正)을 표시하는 React 컴포넌트 Iztrolabe를 제공합니다. 명반 안에서 운한을 바꿀 수 있습니다. 화면을 직접 구현하려면 iztro-hook으로 데이터를 가져오세요.

설치 ​

sh
npm install iztro react-iztro

아래 예제와 속성은 react-iztro 1.5.1을 기준으로 합니다.

명반 표시하기 ​

tsx
import React from 'react';
import { astro } from 'iztro';
import { Iztrolabe } from 'react-iztro';

astro.setLanguage('ko-KR');

export default function App() {
  return (
    <div style={{ maxWidth: 1024, margin: '0 auto' }}>
      <Iztrolabe
        birthday="2000-8-16"
        birthdayType="solar"
        birthTime={2}
        gender="여자"
        lang="ko-KR"
        horoscopeDate="2026-11-22"
        horoscopeHour={2}
      />
    </div>
  );
}

스크롤하면 실행 예제를 불러옵니다.

컴포넌트는 자체 스타일을 불러옵니다. 빌드 도구가 의존 패키지에서 CSS를 가져올 수 있어야 합니다. 바깥 컨테이너에서 명반 너비를 조절하고, 애플리케이션 스타일시트에서 기본 스타일을 덮어쓸 수 있습니다.

lang은 명반 데이터의 언어를 지정합니다. 예제에서는 중궁의 화면 항목에도 같은 언어를 적용하도록 astro.setLanguage()를 호출합니다. 애플리케이션을 초기화할 때 한 번 설정하세요.

컴포넌트 속성 ​

Iztrolabe는 useIztro의 명반 작성 매개변수를 받습니다. birthday, birthdayType, birthTime, gender는 필수입니다. 표시와 운한 조회에 쓰이는 속성도 제공합니다.

매개변수타입설명
horoscopeDatestring | Date운한을 조회할 양력 날짜입니다. 기본값은 현지의 현재 날짜입니다.
horoscopeHournumber유시(流時)를 조회할 시진 인덱스입니다. 범위는 0부터 12까지이며, 기본값은 0(조자시(早子時))입니다.
centerPalaceAlignbooleantrue로 설정하면 중궁(中宮)의 내용이 가운데 정렬됩니다.

중궁에서 운한 조회 날짜와 시진을 조절할 수 있습니다. 부모 컴포넌트가 horoscopeDate 또는 horoscopeHour를 변경해도 조회 조건이 갱신됩니다. 특정 Date 객체에 해당하는 시진을 쓰려면 변환한 인덱스를 horoscopeHour로 전달하세요.

중주파 명반 유형 전환하기 ​

기본값은 일반 명반 작성 알고리즘입니다. 중궁에서 중주파(中州派)로 바꾸면 천반(天盤), 지반(地盤), 인반(人盤)을 선택할 수 있습니다. 처음부터 중주파 지반을 표시하려면 위 컴포넌트에 다음 두 속성을 추가하세요.

tsx
options={{ algorithm: 'zhongzhou' }}
astroType="earth"

명반 유형과 나머지 설정은 AstroType과 Config를 참고하세요.

GitHub 소스 코드 · npm