$mol
搜尋
⌘ K
文件
遊樂場
比較
生態系統
關於
ZH_HK
安裝
Getting Started
介紹
心智模型
快速開始
從 TypeScript 到 view.tree
專案結構
工具鏈
Essentials
安裝
視圖
狀態與響應式
路由
渲染
測試
部署
疑難排解
Data
資料獲取
資料模式
Giper Baza
More
展示
來自 React、Vue 和 Svelte
食譜
Advanced
外掛
模組元資料
離線
幽靈視圖
About
常見問題
團隊
發布
API
$mol_button_major
$mol_button_minor
$mol_string
$mol_number
$mol_text
$mol_paragraph
$mol_list
$mol_row
$mol_link
$mol_check
$mol_switch
$mol_select
$mol_scroll
$mol_page
$mol_pick
安裝
快速上手
會一步步帶你完成第一個應用程式。本頁是參考手冊:$mol 專案如何組織,以及建置是如何運作的。
環境需求
Node.js 18+
和
git
。不需要全域安裝其他任何東西。
MAM 工作區
$mol 應用程式運行在
MAM
之中——它是建置工具和模組註冊表。你只需複製一次,然後在其中開發你的模組:
1
git
clone
https://github.com/hyoo-ru/mam.git
.
/
mam
2
cd
mam
3
npm
install
4
npm
start
npm
start
會在
http://localhost:9080/
啟動一個帶監聽的開發伺服器。它在儲存時重新建置,並自動解析相依性——你永遠不用維護打包器設定。
模組如何命名
每個元件名都對應到一個資料夾路徑,且
每個底線都是資料夾分隔符
:
1
$my_app
→
my
/app/
2
$my_app_header
→
my
/app/header/
模組資料夾名永遠不包含底線——多詞名稱請使用巢狀資料夾。如果你用到的某個元件始終沒有出現在打包結果中,幾乎總是因為資料夾路徑與類別名不相符。
模組剖析
一個元件就是一個資料夾,最多包含四個檔案:
檔案
用途
name
.
view
.
tree
宣告式版面
name
.
view
.
ts
行為(TypeScript)
name
.
view
.
css
.
ts
帶型別的樣式
name
.
view
.
tree
、
index
.
html
應用模組的進入點
應用程式的
index
.
html
會掛載根元件:
1
<body
mol_view_root
>
2
<div
mol_view_root
=
"$my_app"
>
</div>
3
<script
src
=
"web.js"
>
</script>
4
</body>
建置生產版本
開發伺服器會即時建置,但你也可以從工作區根目錄明確建置任意模組:
1
npm
run
start
my
/
app
產物會輸出到
my
/app/
-
/
——包括
web
.
js
、
web
.
css
和
web
.
audit
.
js
。
務必檢查稽核檔案:
乾淨的
web
.
audit
.
js
表示沒有未使用的相依性,也沒有型別錯誤。
加入 npm 套件
用
require
引用一個套件,MAM 會在下次建置時安裝它:
1
const
dayjs
=
require
(
'dayjs'
)
as
typeof
import
(
'dayjs'
)
下一步
工作區就緒後,接下來了解 UI 本身是如何描述的——繼續閱讀
視圖
。
在 GitHub 上編輯此頁
這有幫助嗎?
是
否
上一頁
工具鏈
下一頁
視圖
本頁內容
環境需求
MAM 工作區
模組如何命名
模組剖析
建置生產版本
加入 npm 套件
下一步
Type to search the documentation.