iT邦幫忙

2025 iThome 鐵人賽

DAY 6
0
自我挑戰組

請問這是魔法嗎?前端轉職菜雞的修煉之路!系列 第 6

DAY 06 有吵有糖吃的魔法 - Shadcn (2) 安裝與操作

  • 分享至 

  • xImage
  •  

今天不廢話,直接來看看 shadcn 如何安裝與操作吧,其實官方文件也有針對不同框架指導安裝流程~真的是貼心小棉襖><,今天就用選擇我公司的專案框架 Next.js 跟著文件做

  1. 建立 Next.js 專案並指向該專案
    (因為 Shadcn 支援 Typescript,所以需要 TS 的人可以放心按下 yes)
    記得專案內一定要先安裝好 tailwind,無論是手動裝好或是順便一起裝都行,否則安裝 shadcn 時會報錯

    npx create-next-app@latest shadcn-learning
    cd shadcn-learning
    

    https://ithelp.ithome.com.tw/upload/images/20250920/20178674Mif19S0JxR.png

  2. 安裝 shadcn

    npx shadcn@latest init
    

    這邊會詢問使用者想選哪種 base color,如果沒有特別需求,就隨便選一個即可
    https://ithelp.ithome.com.tw/upload/images/20250920/20178674sK8TAhEOLV.png
    等待終端機的檢查訊息跑完,看到 success,就能開始使用 shadcn
    https://ithelp.ithome.com.tw/upload/images/20250920/201786740l3U2jZPdo.png
    我們可以再看仔細一點,安裝完成後,專案內會在根目錄多出components.json,這個檔案是 shadcn 的設定檔,主要負責記錄「專案是如何安裝、管理元件的資訊」;而lib資料夾下會多出utils.ts,預設中包含 cn 函式,主要統一管理 className 合併,避免手寫很多判斷或衝突;global.css 中也會多出一些預設的樣式變數。

  3. 使用元件
    假設需要使用 shadcn 的 button 元件

    npx shadcn@latest add button
    

    之後會在 components 資料夾下多出 ui資料夾,裡面會多出 button.tsx。ui 資料夾集中管理官方包好的 Radix UI + Tailwind 基礎元件,可以在專案中直接在引用該元件,更能直接編輯該檔案,用 tailwind 將元件修改成自己需要的樣子。比起 Ant Design,shadcn 能夠看見完整的程式碼,客製化更透明容易,真的是開發前台的好幫手啊><

下篇終於能來講講 shadcn + tailwind 客製化組合技,我們明天見啦~


上一篇
DAY 05 有吵有糖吃的魔法 - Shadcn (1) 緣起和簡介
下一篇
DAY 07 有吵有糖吃的魔法 - Shadcn (3) 客製化組合技
系列文
請問這是魔法嗎?前端轉職菜雞的修煉之路!9
圖片
  熱門推薦
圖片
{{ item.channelVendor }} | {{ item.webinarstarted }} |
{{ formatDate(item.duration) }}
直播中

尚未有邦友留言

立即登入留言