smalljs$molجستجو⌘ Kمستنداتزمین بازیمقایسهاکوسیستمدربارهFA
نصبGetting Startedمعرفیمدل ذهنیشروع به کاراز تایپ‌اسکریپت به view.treeساختار پروژهابزارهاEssentialsنصبنماهاوضعیت و واکنش‌گراییمسیریابیرندرتست‌نویسیاستقراررفع اشکالDataدریافت دادهطرح‌واره‌های دادهGiper BazaMoreویتریناز 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 چگونه سازمان‌دهی می‌شود و ساخت (build) چگونه کار می‌کند.

پیش‌نیازها

Node.js 18+ و git. چیز دیگری به‌صورت سراسری نصب نمی‌شود.

فضای کاری MAM

برنامه‌های $mol درون MAM زندگی می‌کنند — ابزار ساخت و رجیستری ماژول‌ها. یک بار آن را کلون می‌کنید و ماژول‌های خود را درون آن توسعه می‌دهید:1git clone https://github.com/hyoo-ru/mam.git ./mam2cd mam3npm install4npm startnpm start یک سرور توسعهٔ نظارتی روی http://localhost:9080/ اجرا می‌کند. هنگام ذخیره دوباره می‌سازد و وابستگی‌ها را به‌صورت خودکار حل می‌کند — هرگز پیکربندی باندلر را نگهداری نمی‌کنید.

چگونگی نام‌گذاری ماژول‌ها

هر نام مؤلفه به یک مسیر پوشه نگاشته می‌شود و هر زیرخط (underscore) یک جداکنندهٔ پوشه است:1$my_appmy/app/2$my_app_headermy/app/header/نام پوشهٔ ماژول‌ها هرگز شامل زیرخط نیست — برای نام‌های چندکلمه‌ای از پوشه‌های تودرتو استفاده کنید. اگر مؤلفه‌ای که استفاده می‌کنید هرگز در باندل ظاهر نشد، تقریباً همیشه مسیر پوشه با نام کلاس مطابقت ندارد.

کالبدشکافی یک ماژول

هر مؤلفه یک پوشه است که تا چهار فایل دارد:فایلکاربردname.view.treeچیدمان اعلانیname.view.tsرفتار (TypeScript)name.view.css.tsسبک‌های نوع‌دارname.view.tree، index.htmlنقطهٔ ورود یک ماژول برنامهفایل index.html یک برنامه مؤلفهٔ ریشه را نصب (mount) می‌کند:1<body mol_view_root>2 <div mol_view_root="$my_app"></div>3 <script src="web.js"></script>4</body>

ساخت برای تولید (production)

سرور توسعه در لحظه می‌سازد، اما می‌توانید هر ماژولی را به‌صراحت از ریشهٔ فضای کاری بسازید:1npm run start my/appخروجی در my/app/-/ قرار می‌گیرد — شامل web.js، web.css و web.audit.js. همیشه فایل حسابرسی (audit) را بررسی کنید: یک web.audit.js تمیز یعنی هیچ وابستگی بلااستفاده و هیچ خطای نوعی وجود ندارد.

افزودن بسته‌های npm

با require به یک بسته ارجاع دهید و MAM آن را در ساخت بعدی نصب می‌کند:1const dayjs = require( 'dayjs' ) as typeof import( 'dayjs' )

بعدی

ویرایش این صفحه در GitHubآیا این مفید بود؟بلهخیرقبلیابزارهابعدینماها
در این صفحهپیش‌نیازهافضای کاری MAMچگونگی نام‌گذاری ماژول‌هاکالبدشکافی یک ماژولساخت برای تولید (production)افزودن بسته‌های npmبعدی
Type to search the documentation.