用其他語言閱讀此信息:英語??。
Design React套件是一組React組件,可實現Bootstrap Italia和UI套件設計上的樣式。為了瀏覽圖書館並查看組件,使用了故事書。故事書的公開版可用於發布最新的穩定版本。操場上的React套件可與圖書館一起玩。
要使用React Design作為對應用程序的成癮,您可以從NPM安裝它。我們建議使用create vite創建新的WebApp React,如下所示:
yarn create vite nome-app --template react
cd nome-app
yarn add design-react-kit --save更多信息以創建一個具有React的新應用:
design-react-kit不包括CSS和字體文件,因此有必要單獨安裝它們:
yarn add bootstrap-italia typeface-lora typeface-roboto-mono typeface-titillium-web --save./src/App.js ,如果您使用的使用create vite 。
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諮詢此Web模板:網絡模板
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?有可能以各種方式為圖書館做出貢獻:
您想幫助設計套件嗎?你在正確的地方!
如果您尚未這樣做,請首先花幾分鐘,以加深您對PA Web服務的設計指南的了解,並參考有關如何為設計React React Kit做出貢獻的指示。
當地環境的最低要求必須是:
克隆存儲庫並執行yarn以安裝成癮。然後執行
yarn storybook:serve啟動開發服務器。
故事書將在http:// localhost:9001/
Storybook充滿了一些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文件應僅包含與組件本身有關的測試。創建了一個新組件後,他的故事開始了Storybook,就可以檢查一切都應工作。
文件:
測試系統通過一種稱為“快照”測試的技術提供了對存在的故事的控制:Storybook故事的內容將被複製到一個特殊文件中,並保留以通知將來的任何更改。這意味著,新故事的添加可能會導致公關中“測試”任務的失敗。如果添加了一個新故事或已經存在的故事,則有必要如下更新快照文件:
yarn test -u此時,創建一個新的佣金,並使用更新的快照文件更新PR。在更新PR之前,檢查所做的更改是否已糾正。
要填寫庫並在dist文件夾中生成文件,只需啟動專用命令:
yarn build該套件遵循公共管理設計指南中顯示的指示,第6.3.1.2.1節。通過使用browserslist-config-design-italia軟件包,瀏覽器支持。
圖書館被帶到打字稿,並將其導出。
特別感謝那些使該圖書館發展成為可能的人!
![]() | ![]() | ![]() | ![]() |
|---|---|---|---|
| Sabatino Galasso | Marco Liberati | Matteo Avesani | Federico Turbino |
並為歐洲實驗室的貢獻
所有貢獻者(用貢獻者製造)