이것을 다른 언어로 읽으십시오 : 영어 ??.
Design React Kit는 부트 스트랩 이탈리아와 UI 키트 디자인의 스타일을 구현하는 반응 구성 요소 세트입니다. 라이브러리를 탐색하고 구성 요소를보기 위해 스토리 북이 사용되었습니다. The Storybook의 공개 버전은 여기에서 게시 된 최신 안정적인 릴리스를 위해 제공됩니다. Playground React Kit는 도서관과 함께 플레이 할 수 있습니다.
React Design을 앱의 중독으로 사용하려면 NPM에서 설치할 수 있습니다. create vite 사용하여 다음과 같이 새로운 WebApp React를 생성하는 것이 좋습니다.
yarn create vite nome-app --template react
cd nome-app
yarn add design-react-kit --saveReact를 사용하여 새로운 앱을 만들기위한 자세한 정보 :
design-react-kit CSS 및 글꼴 파일이 포함되어 있지 않으므로 별도로 설치해야합니다.
yarn add bootstrap-italia typeface-lora typeface-roboto-mono typeface-titillium-web --save 이 시점에서 ./src/App.js 파일 내부에서 create vite 경우 CSS 및 FONT 앱으로 명시 적으로 가져 오십시오.
import React from 'react' ;
import './App.css' ;
import { Alert } from 'design-react-kit' ;
import 'bootstrap-italia/dist/css/bootstrap-italia.min.css' ;
import 'typeface-titillium-web' ;
import 'typeface-roboto-mono' ;
import 'typeface-lora' ;
function App ( ) {
return < Alert > This is an Alert </ Alert > ;
}
export default App ;STACKBLITZ : 웹 템플릿 으로이 웹 템플릿을 참조 할 수 있습니다.
Bootstrap Italia 테마는 titillium-web , roboto-mono 및 lora 의 특정 서체 글꼴 세트를 사용합니다. 이 글꼴의 로딩은 브라우저에 맡겨져 있지만 원하는 경우 적절한 FontLoader 구성 요소를 통해 제어 할 수 있습니다. 로드 할 수 있도록 React 앱의 상단에 FontLoader 구성 요소를 선언하면됩니다.
또는 webfontloader 패키지를 통해 수동으로 글꼴의 로딩을 관리해야합니다.
const WebFont = require ( 'webfontloader' ) ;
WebFont . load ( {
custom : {
families : [ 'Titillium Web:300,400,600,700:latin-ext' , 'Lora:400,700:latin-ext' , 'Roboto Mono:400,700:latin-ext' ]
}
} ) ; 라이브러리에는 react 및 react-dom 포함되지 않으며, 버전의 충돌을 피하고 번들 크기의 쓸모없는 증가를 포함합니다. 이러한 이유로 지역 개발의 경우 수동으로 중독을 설치해야합니다.
수행해야 할 명령은 다음과 같습니다
yarn install --peers또는 대안 적으로 수동으로
yarn install react react-dom? 다양한 방법으로 도서관에 기여할 수 있습니다.
Design React Kit에 도움을 주시겠습니까? 당신은 올바른 장소에 있습니다!
아직 그렇게하지 않은 경우 PA 웹 서비스에 대한 설계 지침에 대한 지식을 심화시키기 위해 몇 분을 보내고 Design React Kit에 기여하는 방법에 대한 표시를 참조하십시오.
지역 환경의 최소 요구 사항은 다음과 같습니다.
저장소를 복제하고 yarn 수행하여 중독을 설치하십시오. 그런 다음 수행하십시오
yarn storybook:serve개발 서버를 시작합니다.
그런 다음 스토리 북은 http : // localhost : 9001/에서 제공됩니다.
스토리 북에는 더 많은 이야기를하는 addons 풍부 해졌습니다.
이 섹션에서는 저장소에서 새로운 구성 요소 작성을 안내합니다. 모든 구성 요소는 src 폴더에 있습니다. 각 구성 요소에는 작동하는 데 필요한 모든 것을 갖춘 폴더가 있습니다. Storybook 스토리는 대신 stories 아래에 있습니다. 단위 테스트는 test 폴더에 있습니다. 예를 들어, Button 구성 요소는 src/Button 경로 아래에 있으며 그 구조는 다음과 같습니다.
├── src
│ └── Button
│ └── Button.tsx
├── stories
│ ├── Components
│ │ └── Button.stories.tsx
│ └── Documentation
│ └── Button.mdx
└── test
└── Button.test.tsx
구성 요소를 구성하기위한 몇 가지 기본 규칙 :
.stories.tsx 파일에는 구성 요소 자체와 관련된 것만 포함해야합니다..mdx 파일은 구성 요소 자체와 관련된 문서 만 포함해야합니다..test.tsx 파일에는 구성 요소 자체와 관련된 테스트 만 포함되어야합니다.새로운 구성 요소가 만들어지면 그의 스토리와 함께 시작 스토리 북은 모든 것이 필요한대로 작동하는지 확인할 수 있습니다.
선적 서류 비치:
테스트 시스템은 "스냅 샷"테스트라는 기술을 통해 존재하는 스토리의 제어를 제공합니다. 스토리 북 스토리의 내용은 특수 파일로 복사되어 향후 변경 사항을 알리기 위해 보존됩니다. 이것은 새로운 이야기의 추가가 PR에서 "테스트"작업이 실패 할 수 있음을 의미합니다. 새로운 스토리가 추가되었거나 이미 존재하는 경우 스냅 샷 파일을 다음과 같이 업데이트해야합니다.
yarn test -u이 시점에서 새 커미션을 만들고 업데이트 된 스냅 샷 파일로 PR을 업데이트하십시오. PR을 업데이트하기 전에 변경 사항이 수정되었는지 확인하십시오.
라이브러리를 채우고 dist 폴더에서 파일을 생성하려면 전용 명령을 시작하십시오.
yarn build 이 키트는 공공 행정의 웹 서비스에 대한 설계 지침 (6.3.1.2.1)에 표시된 표시를 따릅니다. browserslist-config-design-italia 패키지 사용을 통한 브라우저 지원.
라이브러리는 TypeScript로 가져 왔으며 유형은 이로 내보내려 있습니다.
이 도서관의 개발을 가능하게 한 사람들에게 특별한 감사를드립니다!
![]() | ![]() | ![]() | ![]() |
|---|---|---|---|
| 사바 티노 갈라소 | 마르코 라이베라티 | 마테오 아베 사니 | Federico Turbino |
그리고 Opencity Labs의 기여에
모든 기고자 ( 기여자 -IMG로 만든 )