安裝
裝上套件,掛上根,再告訴打包工具一件事。
每種宿主的準備工作都一樣。唯一不同的是打包工具的設定寫在哪裡,每種宿主都有自己的一頁。
安裝
pnpm add @hanzo/ui @hanzo/guireact 與 react-dom 是 19 或更新版本的對等相依。@hanzo/gui 故意做成對等相依:它交出一份 React context,實體上的第二份複本就會是第二份 context,根往一份裡寫,每個元件卻去讀另一份。版本維持一個,由應用自己宣告。
掛上根
import { Hanzo } from '@hanzo/ui'
export default function App({ children }) {
return <Hanzo>{children}</Hanzo>
}應用要掛的只有 Hanzo。它把 gui 設定當成一個值帶著,匯入產生好的樣式表,並設定主題——預設深色,theme="light" 則改調。沒有根主題時,每個元件都會擲出。忘了它,第一次繪製就當掉,不會安靜地畫出一頁沒有樣式的頁面。
開發時,根會檢查樣式表有沒有抵達文件,沒有抵達就在主控台裡說出來。它點名的修法是一次匯入,@hanzo/ui/styles.css,給那些把套件自己的樣式表丟掉的打包工具用。
告訴打包工具
引擎的相依圖寫著 react-native 這個名字,其中的一個套件、圖示集下面的 react-native-svg,在原生入口旁邊還帶了一份 .web.js 兄弟檔。網頁建置若選中原生那份,錯誤會是相依內部 Flow 原始碼的解析失敗,讀起來像套件壞了,不像少了一項設定。兩項設定可以攔住它:
react-native解析到react-native-web。.web.js排在.js前面。
在 Next 裡,這兩項是一個包裝,@hanzo/ui/next。在 Vite 裡,是 resolve 的兩行。在 One 裡,框架已經兩件都做了。在 Expo 裡沒有要設的,因為 Metro 本來就會說 react-native。
畫一點東西
import { Badge, Button, Card, CardContent, CardHeader, CardTitle, Input, XStack } from '@hanzo/ui'
export function Sample() {
return (
<Card>
<CardHeader>
<CardTitle>Deploy</CardTitle>
</CardHeader>
<CardContent>
<Input placeholder="name" />
<XStack gap="$2" mt="$3">
<Button>Deploy</Button>
<Button variant="outline">Cancel</Button>
<Badge variant="secondary">preview</Badge>
</XStack>
</CardContent>
</Card>
)
}字型
套件裡帶了 Zen 和 Zen Mono,並繫到 --font-sans 與 --font-mono 上,所以什麼都不繫的宿主不用動手就得到這兩款字型。自帶字型的宿主設定 --font-sans-provided,就會勝出。見 排版。