@modern-js/main-doc 2.3.0 → 2.4.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/.turbo/turbo-build.log +1 -1
- package/en/components/init-app.mdx +1 -1
- package/en/configure/app/dev/asset-prefix.mdx +1 -1
- package/en/configure/app/dev/hmr.mdx +1 -1
- package/en/configure/app/dev/https.mdx +1 -1
- package/en/configure/app/dev/port.mdx +1 -1
- package/en/configure/app/dev/progress-bar.mdx +1 -1
- package/en/configure/app/dev/start-url.mdx +1 -1
- package/en/configure/app/experiments/lazy-compilation.mdx +1 -1
- package/en/configure/app/html/app-icon.mdx +1 -1
- package/en/configure/app/html/crossorigin.mdx +1 -1
- package/en/configure/app/html/disable-html-folder.mdx +1 -1
- package/en/configure/app/html/favicon-by-entries.mdx +1 -1
- package/en/configure/app/html/favicon.mdx +1 -1
- package/en/configure/app/html/inject-by-entries.mdx +1 -1
- package/en/configure/app/html/inject.mdx +1 -1
- package/en/configure/app/html/meta-by-entries.mdx +1 -1
- package/en/configure/app/html/meta.mdx +1 -1
- package/en/configure/app/html/mount-id.mdx +1 -1
- package/en/configure/app/html/tags-by-entries.mdx +1 -1
- package/en/configure/app/html/tags.mdx +1 -1
- package/en/configure/app/html/template-by-entries.mdx +1 -1
- package/en/configure/app/html/template-parameters-by-entries.mdx +1 -1
- package/en/configure/app/html/template-parameters.mdx +1 -1
- package/en/configure/app/html/template.mdx +1 -1
- package/en/configure/app/html/title-by-entries.mdx +1 -1
- package/en/configure/app/html/title.mdx +1 -1
- package/en/configure/app/output/asset-prefix.mdx +1 -1
- package/en/configure/app/output/assets-retry.mdx +1 -1
- package/en/configure/app/output/charset.mdx +1 -1
- package/en/configure/app/output/clean-dist-path.mdx +1 -1
- package/en/configure/app/output/convert-to-rem.mdx +1 -1
- package/en/configure/app/output/copy.mdx +1 -1
- package/en/configure/app/output/css-module-local-ident-name.mdx +1 -1
- package/en/configure/app/output/data-uri-limit.mdx +1 -1
- package/en/configure/app/output/disable-css-extract.mdx +1 -1
- package/en/configure/app/output/disable-css-module-extension.mdx +1 -1
- package/en/configure/app/output/disable-filename-hash.mdx +1 -1
- package/en/configure/app/output/disable-inline-runtime-chunk.mdx +1 -1
- package/en/configure/app/output/disable-minimize.mdx +1 -1
- package/en/configure/app/output/disable-source-map.mdx +1 -1
- package/en/configure/app/output/disable-ts-checker.mdx +1 -1
- package/en/configure/app/output/dist-path.mdx +1 -1
- package/en/configure/app/output/enable-asset-fallback.mdx +1 -1
- package/en/configure/app/output/enable-asset-manifest.mdx +1 -1
- package/en/configure/app/output/enable-css-module-tsdeclaration.mdx +1 -1
- package/en/configure/app/output/enable-inline-scripts.mdx +1 -1
- package/en/configure/app/output/enable-inline-styles.mdx +1 -1
- package/en/configure/app/output/enable-latest-decorators.mdx +1 -1
- package/en/configure/app/output/externals.mdx +1 -1
- package/en/configure/app/output/filename.mdx +1 -1
- package/en/configure/app/output/legal-comments.mdx +1 -1
- package/en/configure/app/output/override-browserslist.mdx +1 -1
- package/en/configure/app/output/polyfill.mdx +1 -1
- package/en/configure/app/output/svg-default-export.mdx +1 -1
- package/en/configure/app/performance/build-cache.mdx +1 -1
- package/en/configure/app/performance/bundle-analyze.mdx +1 -1
- package/en/configure/app/performance/chunk-split.mdx +1 -1
- package/en/configure/app/performance/print-file-size.mdx +1 -1
- package/en/configure/app/performance/profile.mdx +1 -1
- package/en/configure/app/performance/remove-console.mdx +1 -1
- package/en/configure/app/performance/remove-moment-locale.mdx +1 -1
- package/en/configure/app/security/check-syntax.mdx +1 -1
- package/en/configure/app/security/sri.mdx +1 -1
- package/en/configure/app/source/alias.mdx +1 -1
- package/en/configure/app/source/compile-js-data-uri.mdx +1 -1
- package/en/configure/app/source/define.mdx +1 -1
- package/en/configure/app/source/exclude.mdx +1 -1
- package/en/configure/app/source/global-vars.mdx +1 -1
- package/en/configure/app/source/include.mdx +1 -1
- package/en/configure/app/source/module-scopes.mdx +1 -1
- package/en/configure/app/source/pre-entry.mdx +1 -1
- package/en/configure/app/source/resolve-extension-prefix.mdx +1 -1
- package/en/configure/app/source/resolve-main-fields.mdx +1 -1
- package/en/configure/app/tools/autoprefixer.mdx +1 -1
- package/en/configure/app/tools/babel.mdx +1 -1
- package/en/configure/app/tools/css-extract.mdx +1 -1
- package/en/configure/app/tools/css-loader.mdx +1 -1
- package/en/configure/app/tools/dev-server.mdx +1 -1
- package/en/configure/app/tools/html-plugin.mdx +1 -1
- package/en/configure/app/tools/inspector.mdx +1 -1
- package/en/configure/app/tools/less.mdx +1 -1
- package/en/configure/app/tools/minify-css.mdx +1 -1
- package/en/configure/app/tools/postcss.mdx +1 -1
- package/en/configure/app/tools/pug.mdx +1 -1
- package/en/configure/app/tools/sass.mdx +1 -1
- package/en/configure/app/tools/style-loader.mdx +1 -1
- package/en/configure/app/tools/styled-components.mdx +1 -1
- package/en/configure/app/tools/terser.mdx +1 -1
- package/en/configure/app/tools/ts-checker.mdx +1 -1
- package/en/configure/app/tools/ts-loader.mdx +1 -1
- package/en/configure/app/tools/webpack-chain.mdx +1 -1
- package/en/configure/app/tools/webpack.mdx +1 -1
- package/en/configure/app/usage.mdx +63 -0
- package/en/guides/advanced-features/_category_.json +5 -0
- package/en/guides/advanced-features/ssr.mdx +2 -2
- package/en/guides/basic-features/_category_.json +5 -0
- package/en/guides/basic-features/builder.mdx +1 -1
- package/en/guides/basic-features/routes.mdx +28 -0
- package/en/guides/concept/_category_.json +5 -0
- package/en/guides/get-started/_category_.json +5 -0
- package/en/guides/topic-detail/generator/config/{mwa.mdx → app.mdx} +1 -1
- package/en/guides/topic-detail/generator/plugin/api/new/createElement.mdx +1 -1
- package/en/guides/topic-detail/generator/plugin/api/new/enableFunc.mdx +1 -1
- package/en/guides/topic-detail/generator/plugin/api/new/introduce.mdx +1 -1
- package/en/guides/topic-detail/generator/plugin/develop.mdx +2 -2
- package/package.json +3 -3
- package/scripts/config.ts +1 -1
- package/zh/components/custom-router-micro-frontend.mdx +40 -0
- package/zh/components/enable-micro-frontend.mdx +12 -2
- package/zh/components/micro-runtime-config.mdx +9 -10
- package/zh/configure/app/dev/asset-prefix.mdx +1 -1
- package/zh/configure/app/dev/hmr.mdx +1 -1
- package/zh/configure/app/dev/https.mdx +1 -1
- package/zh/configure/app/dev/port.mdx +1 -1
- package/zh/configure/app/dev/progress-bar.mdx +1 -1
- package/zh/configure/app/dev/start-url.mdx +1 -1
- package/zh/configure/app/experiments/lazy-compilation.mdx +1 -1
- package/zh/configure/app/html/app-icon.mdx +1 -1
- package/zh/configure/app/html/crossorigin.mdx +1 -1
- package/zh/configure/app/html/disable-html-folder.mdx +1 -1
- package/zh/configure/app/html/favicon-by-entries.mdx +1 -1
- package/zh/configure/app/html/favicon.mdx +1 -1
- package/zh/configure/app/html/inject-by-entries.mdx +1 -1
- package/zh/configure/app/html/inject.mdx +1 -1
- package/zh/configure/app/html/meta-by-entries.mdx +1 -1
- package/zh/configure/app/html/meta.mdx +1 -1
- package/zh/configure/app/html/mount-id.mdx +1 -1
- package/zh/configure/app/html/tags-by-entries.mdx +1 -1
- package/zh/configure/app/html/tags.mdx +1 -1
- package/zh/configure/app/html/template-by-entries.mdx +1 -1
- package/zh/configure/app/html/template-parameters-by-entries.mdx +1 -1
- package/zh/configure/app/html/template-parameters.mdx +1 -1
- package/zh/configure/app/html/template.mdx +1 -1
- package/zh/configure/app/html/title-by-entries.mdx +1 -1
- package/zh/configure/app/html/title.mdx +1 -1
- package/zh/configure/app/output/asset-prefix.mdx +1 -1
- package/zh/configure/app/output/assets-retry.mdx +1 -1
- package/zh/configure/app/output/charset.mdx +1 -1
- package/zh/configure/app/output/clean-dist-path.mdx +1 -1
- package/zh/configure/app/output/convert-to-rem.mdx +1 -1
- package/zh/configure/app/output/copy.mdx +1 -1
- package/zh/configure/app/output/css-module-local-ident-name.mdx +1 -1
- package/zh/configure/app/output/data-uri-limit.mdx +1 -1
- package/zh/configure/app/output/disable-css-extract.mdx +1 -1
- package/zh/configure/app/output/disable-css-module-extension.mdx +1 -1
- package/zh/configure/app/output/disable-filename-hash.mdx +1 -1
- package/zh/configure/app/output/disable-inline-runtime-chunk.mdx +1 -1
- package/zh/configure/app/output/disable-minimize.mdx +1 -1
- package/zh/configure/app/output/disable-source-map.mdx +1 -1
- package/zh/configure/app/output/disable-ts-checker.mdx +1 -1
- package/zh/configure/app/output/dist-path.mdx +1 -1
- package/zh/configure/app/output/enable-asset-fallback.mdx +1 -1
- package/zh/configure/app/output/enable-asset-manifest.mdx +1 -1
- package/zh/configure/app/output/enable-css-module-tsdeclaration.mdx +1 -1
- package/zh/configure/app/output/enable-inline-scripts.mdx +1 -1
- package/zh/configure/app/output/enable-inline-styles.mdx +1 -1
- package/zh/configure/app/output/enable-latest-decorators.mdx +1 -1
- package/zh/configure/app/output/externals.mdx +1 -1
- package/zh/configure/app/output/filename.mdx +1 -1
- package/zh/configure/app/output/legal-comments.mdx +1 -1
- package/zh/configure/app/output/override-browserslist.mdx +1 -1
- package/zh/configure/app/output/polyfill.mdx +1 -1
- package/zh/configure/app/output/svg-default-export.mdx +1 -1
- package/zh/configure/app/performance/build-cache.mdx +1 -1
- package/zh/configure/app/performance/bundle-analyze.mdx +1 -1
- package/zh/configure/app/performance/chunk-split.mdx +1 -1
- package/zh/configure/app/performance/print-file-size.mdx +1 -1
- package/zh/configure/app/performance/profile.mdx +1 -1
- package/zh/configure/app/performance/remove-console.mdx +1 -1
- package/zh/configure/app/performance/remove-moment-locale.mdx +1 -1
- package/zh/configure/app/security/check-syntax.mdx +1 -1
- package/zh/configure/app/security/sri.mdx +1 -1
- package/zh/configure/app/source/alias.mdx +1 -1
- package/zh/configure/app/source/compile-js-data-uri.mdx +1 -1
- package/zh/configure/app/source/define.mdx +1 -1
- package/zh/configure/app/source/exclude.mdx +1 -1
- package/zh/configure/app/source/global-vars.mdx +1 -1
- package/zh/configure/app/source/include.mdx +1 -1
- package/zh/configure/app/source/module-scopes.mdx +1 -1
- package/zh/configure/app/source/pre-entry.mdx +1 -1
- package/zh/configure/app/source/resolve-extension-prefix.mdx +1 -1
- package/zh/configure/app/source/resolve-main-fields.mdx +1 -1
- package/zh/configure/app/tools/autoprefixer.mdx +1 -1
- package/zh/configure/app/tools/babel.mdx +1 -1
- package/zh/configure/app/tools/css-extract.mdx +1 -1
- package/zh/configure/app/tools/css-loader.mdx +1 -1
- package/zh/configure/app/tools/dev-server.mdx +1 -1
- package/zh/configure/app/tools/html-plugin.mdx +1 -1
- package/zh/configure/app/tools/inspector.mdx +1 -1
- package/zh/configure/app/tools/less.mdx +1 -1
- package/zh/configure/app/tools/minify-css.mdx +1 -1
- package/zh/configure/app/tools/postcss.mdx +1 -1
- package/zh/configure/app/tools/pug.mdx +1 -1
- package/zh/configure/app/tools/sass.mdx +1 -1
- package/zh/configure/app/tools/style-loader.mdx +1 -1
- package/zh/configure/app/tools/styled-components.mdx +1 -1
- package/zh/configure/app/tools/terser.mdx +1 -1
- package/zh/configure/app/tools/ts-checker.mdx +1 -1
- package/zh/configure/app/tools/ts-loader.mdx +1 -1
- package/zh/configure/app/tools/webpack-chain.mdx +1 -1
- package/zh/configure/app/tools/webpack.mdx +1 -1
- package/zh/configure/app/usage.mdx +63 -0
- package/zh/guides/advanced-features/ssr.mdx +2 -2
- package/zh/guides/basic-features/routes.mdx +28 -1
- package/zh/guides/topic-detail/generator/config/{mwa.mdx → app.mdx} +1 -1
- package/zh/guides/topic-detail/generator/plugin/api/new/createElement.mdx +1 -1
- package/zh/guides/topic-detail/generator/plugin/api/new/enableFunc.mdx +1 -1
- package/zh/guides/topic-detail/generator/plugin/api/new/introduce.mdx +2 -2
- package/zh/guides/topic-detail/generator/plugin/develop.mdx +3 -3
- package/zh/guides/topic-detail/micro-frontend/c02-development.mdx +128 -61
- package/zh/guides/topic-detail/micro-frontend/c03-main-app.mdx +71 -40
|
@@ -5,7 +5,7 @@ sidebar_label: overrideBrowserslist
|
|
|
5
5
|
# output.overrideBrowserslist
|
|
6
6
|
|
|
7
7
|
:::tip
|
|
8
|
-
该配置由 Modern.js Builder 提供,更多信息可参考 [output.overrideBrowserslist](https://modernjs.dev/builder/api/config-output.html#
|
|
8
|
+
该配置由 Modern.js Builder 提供,更多信息可参考 [output.overrideBrowserslist](https://modernjs.dev/builder/api/config-output.html#outputoverridebrowserslist)。
|
|
9
9
|
:::
|
|
10
10
|
|
|
11
11
|
import Main from '@modern-js/builder-doc/docs/zh/config/output/overrideBrowserslist.md'
|
|
@@ -5,7 +5,7 @@ sidebar_label: polyfill
|
|
|
5
5
|
# output.polyfill
|
|
6
6
|
|
|
7
7
|
:::tip
|
|
8
|
-
该配置由 Modern.js Builder 提供,更多信息可参考 [output.polyfill](https://modernjs.dev/builder/api/config-output.html#
|
|
8
|
+
该配置由 Modern.js Builder 提供,更多信息可参考 [output.polyfill](https://modernjs.dev/builder/api/config-output.html#outputpolyfill)。
|
|
9
9
|
:::
|
|
10
10
|
|
|
11
11
|
import Main from '@modern-js/builder-doc/docs/zh/config/output/polyfill.md'
|
|
@@ -5,7 +5,7 @@ sidebar_label: svgDefaultExport
|
|
|
5
5
|
# output.svgDefaultExport
|
|
6
6
|
|
|
7
7
|
:::tip
|
|
8
|
-
该配置由 Modern.js Builder 提供,更多信息可参考 [output.svgDefaultExport](https://modernjs.dev/builder/api/config-output.html#
|
|
8
|
+
该配置由 Modern.js Builder 提供,更多信息可参考 [output.svgDefaultExport](https://modernjs.dev/builder/api/config-output.html#outputsvgdefaultexport)。
|
|
9
9
|
:::
|
|
10
10
|
|
|
11
11
|
import Main from '@modern-js/builder-doc/docs/zh/config/output/svgDefaultExport.md'
|
|
@@ -5,7 +5,7 @@ sidebar_label: buildCache
|
|
|
5
5
|
# performance.buildCache
|
|
6
6
|
|
|
7
7
|
:::tip
|
|
8
|
-
该配置由 Modern.js Builder 提供,更多信息可参考 [performance.buildCache](https://modernjs.dev/builder/api/config-performance.html#
|
|
8
|
+
该配置由 Modern.js Builder 提供,更多信息可参考 [performance.buildCache](https://modernjs.dev/builder/api/config-performance.html#performancebuildcache)。
|
|
9
9
|
:::
|
|
10
10
|
|
|
11
11
|
import Main from '@modern-js/builder-doc/docs/zh/config/performance/buildCache.md'
|
|
@@ -5,7 +5,7 @@ sidebar_label: bundleAnalyze
|
|
|
5
5
|
# performance.bundleAnalyze
|
|
6
6
|
|
|
7
7
|
:::tip
|
|
8
|
-
该配置由 Modern.js Builder 提供,更多信息可参考 [performance.bundleAnalyze](https://modernjs.dev/builder/api/config-performance.html#
|
|
8
|
+
该配置由 Modern.js Builder 提供,更多信息可参考 [performance.bundleAnalyze](https://modernjs.dev/builder/api/config-performance.html#performancebundleanalyze)。
|
|
9
9
|
:::
|
|
10
10
|
|
|
11
11
|
import Main from '@modern-js/builder-doc/docs/zh/config/performance/bundleAnalyze.md'
|
|
@@ -5,7 +5,7 @@ sidebar_label: chunkSplit
|
|
|
5
5
|
# performance.chunkSplit
|
|
6
6
|
|
|
7
7
|
:::tip
|
|
8
|
-
该配置由 Modern.js Builder 提供,更多信息可参考 [performance.chunkSplit](https://modernjs.dev/builder/api/config-performance.html#
|
|
8
|
+
该配置由 Modern.js Builder 提供,更多信息可参考 [performance.chunkSplit](https://modernjs.dev/builder/api/config-performance.html#performancechunksplit)。
|
|
9
9
|
:::
|
|
10
10
|
|
|
11
11
|
import Main from '@modern-js/builder-doc/docs/zh/config/performance/chunkSplit.md'
|
|
@@ -5,7 +5,7 @@ sidebar_label: printFileSize
|
|
|
5
5
|
# performance.printFileSize
|
|
6
6
|
|
|
7
7
|
:::tip
|
|
8
|
-
该配置由 Modern.js Builder 提供,更多信息可参考 [performance.printFileSize](https://modernjs.dev/builder/api/config-performance.html#
|
|
8
|
+
该配置由 Modern.js Builder 提供,更多信息可参考 [performance.printFileSize](https://modernjs.dev/builder/api/config-performance.html#performanceprintfilesize)。
|
|
9
9
|
:::
|
|
10
10
|
|
|
11
11
|
import Main from '@modern-js/builder-doc/docs/zh/config/performance/printFileSize.md'
|
|
@@ -5,7 +5,7 @@ sidebar_label: profile
|
|
|
5
5
|
# performance.profile
|
|
6
6
|
|
|
7
7
|
:::tip
|
|
8
|
-
该配置由 Modern.js Builder 提供,更多信息可参考 [performance.profile](https://modernjs.dev/builder/api/config-performance.html#
|
|
8
|
+
该配置由 Modern.js Builder 提供,更多信息可参考 [performance.profile](https://modernjs.dev/builder/api/config-performance.html#performanceprofile)。
|
|
9
9
|
:::
|
|
10
10
|
|
|
11
11
|
import Main from '@modern-js/builder-doc/docs/zh/config/performance/profile.md'
|
|
@@ -5,7 +5,7 @@ sidebar_label: removeConsole
|
|
|
5
5
|
# performance.removeConsole
|
|
6
6
|
|
|
7
7
|
:::tip
|
|
8
|
-
该配置由 Modern.js Builder 提供,更多信息可参考 [performance.removeConsole](https://modernjs.dev/builder/api/config-performance.html#
|
|
8
|
+
该配置由 Modern.js Builder 提供,更多信息可参考 [performance.removeConsole](https://modernjs.dev/builder/api/config-performance.html#performanceremoveconsole)。
|
|
9
9
|
:::
|
|
10
10
|
|
|
11
11
|
import Main from '@modern-js/builder-doc/docs/zh/config/performance/removeConsole.md'
|
|
@@ -5,7 +5,7 @@ sidebar_label: removeMomentLocale
|
|
|
5
5
|
# performance.removeMomentLocale
|
|
6
6
|
|
|
7
7
|
:::tip
|
|
8
|
-
该配置由 Modern.js Builder 提供,更多信息可参考 [performance.removeMomentLocale](https://modernjs.dev/builder/api/config-performance.html#
|
|
8
|
+
该配置由 Modern.js Builder 提供,更多信息可参考 [performance.removeMomentLocale](https://modernjs.dev/builder/api/config-performance.html#performanceremovemomentlocale)。
|
|
9
9
|
:::
|
|
10
10
|
|
|
11
11
|
import Main from '@modern-js/builder-doc/docs/zh/config/performance/removeMomentLocale.md'
|
|
@@ -5,7 +5,7 @@ sidebar_label: checkSyntax
|
|
|
5
5
|
# security.checkSyntax
|
|
6
6
|
|
|
7
7
|
:::tip
|
|
8
|
-
该配置由 Modern.js Builder 提供,更多信息可参考 [security.checkSyntax](https://modernjs.dev/builder/api/config-security.html#
|
|
8
|
+
该配置由 Modern.js Builder 提供,更多信息可参考 [security.checkSyntax](https://modernjs.dev/builder/api/config-security.html#securitychecksyntax)。
|
|
9
9
|
:::
|
|
10
10
|
|
|
11
11
|
import Main from '@modern-js/builder-doc/docs/zh/config/security/checkSyntax.md'
|
|
@@ -5,7 +5,7 @@ sidebar_label: sri
|
|
|
5
5
|
# security.sri
|
|
6
6
|
|
|
7
7
|
:::tip
|
|
8
|
-
该配置由 Modern.js Builder 提供,更多信息可参考 [security.sri](https://modernjs.dev/builder/api/config-security.html#
|
|
8
|
+
该配置由 Modern.js Builder 提供,更多信息可参考 [security.sri](https://modernjs.dev/builder/api/config-security.html#securitysri)。
|
|
9
9
|
:::
|
|
10
10
|
|
|
11
11
|
import Main from '@modern-js/builder-doc/docs/zh/config/security/sri.md'
|
|
@@ -5,7 +5,7 @@ sidebar_label: alias
|
|
|
5
5
|
# source.alias
|
|
6
6
|
|
|
7
7
|
:::tip
|
|
8
|
-
该配置由 Modern.js Builder 提供,更多信息可参考 [source.alias](https://modernjs.dev/builder/api/config-source.html#
|
|
8
|
+
该配置由 Modern.js Builder 提供,更多信息可参考 [source.alias](https://modernjs.dev/builder/api/config-source.html#sourcealias)。
|
|
9
9
|
:::
|
|
10
10
|
|
|
11
11
|
import Main from '@modern-js/builder-doc/docs/zh/config/source/alias.md'
|
|
@@ -5,7 +5,7 @@ sidebar_label: compileJsDataURI
|
|
|
5
5
|
# source.compileJsDataURI
|
|
6
6
|
|
|
7
7
|
:::tip
|
|
8
|
-
该配置由 Modern.js Builder 提供,更多信息可参考 [source.compileJsDataURI](https://modernjs.dev/builder/api/config-source.html#
|
|
8
|
+
该配置由 Modern.js Builder 提供,更多信息可参考 [source.compileJsDataURI](https://modernjs.dev/builder/api/config-source.html#sourcecompilejsdatauri)。
|
|
9
9
|
:::
|
|
10
10
|
|
|
11
11
|
import Main from '@modern-js/builder-doc/docs/zh/config/source/compileJsDataURI.md'
|
|
@@ -5,7 +5,7 @@ sidebar_label: define
|
|
|
5
5
|
# source.define
|
|
6
6
|
|
|
7
7
|
:::tip
|
|
8
|
-
该配置由 Modern.js Builder 提供,更多信息可参考 [source.define](https://modernjs.dev/builder/api/config-source.html#
|
|
8
|
+
该配置由 Modern.js Builder 提供,更多信息可参考 [source.define](https://modernjs.dev/builder/api/config-source.html#sourcedefine)。
|
|
9
9
|
:::
|
|
10
10
|
|
|
11
11
|
import Main from '@modern-js/builder-doc/docs/zh/config/source/define.md'
|
|
@@ -5,7 +5,7 @@ sidebar_label: exclude
|
|
|
5
5
|
# source.exclude
|
|
6
6
|
|
|
7
7
|
:::tip
|
|
8
|
-
该配置由 Modern.js Builder 提供,更多信息可参考 [source.exclude](https://modernjs.dev/builder/api/config-source.html#
|
|
8
|
+
该配置由 Modern.js Builder 提供,更多信息可参考 [source.exclude](https://modernjs.dev/builder/api/config-source.html#sourceexclude)。
|
|
9
9
|
:::
|
|
10
10
|
|
|
11
11
|
import Main from '@modern-js/builder-doc/docs/zh/config/source/exclude.md'
|
|
@@ -5,7 +5,7 @@ sidebar_label: globalVars
|
|
|
5
5
|
# source.globalVars
|
|
6
6
|
|
|
7
7
|
:::tip
|
|
8
|
-
该配置由 Modern.js Builder 提供,更多信息可参考 [source.globalVars](https://modernjs.dev/builder/api/config-source.html#
|
|
8
|
+
该配置由 Modern.js Builder 提供,更多信息可参考 [source.globalVars](https://modernjs.dev/builder/api/config-source.html#sourceglobalvars)。
|
|
9
9
|
:::
|
|
10
10
|
|
|
11
11
|
import Main from '@modern-js/builder-doc/docs/zh/config/source/globalVars.md'
|
|
@@ -5,7 +5,7 @@ sidebar_label: include
|
|
|
5
5
|
# source.include
|
|
6
6
|
|
|
7
7
|
:::tip
|
|
8
|
-
该配置由 Modern.js Builder 提供,更多信息可参考 [source.include](https://modernjs.dev/builder/api/config-source.html#
|
|
8
|
+
该配置由 Modern.js Builder 提供,更多信息可参考 [source.include](https://modernjs.dev/builder/api/config-source.html#sourceinclude)。
|
|
9
9
|
:::
|
|
10
10
|
|
|
11
11
|
import Main from '@modern-js/builder-doc/docs/zh/config/source/include.md'
|
|
@@ -5,7 +5,7 @@ sidebar_label: moduleScopes
|
|
|
5
5
|
# source.moduleScopes
|
|
6
6
|
|
|
7
7
|
:::tip
|
|
8
|
-
该配置由 Modern.js Builder 提供,更多信息可参考 [source.moduleScopes](https://modernjs.dev/builder/api/config-source.html#
|
|
8
|
+
该配置由 Modern.js Builder 提供,更多信息可参考 [source.moduleScopes](https://modernjs.dev/builder/api/config-source.html#sourcemodulescopes)。
|
|
9
9
|
:::
|
|
10
10
|
|
|
11
11
|
import Main from '@modern-js/builder-doc/docs/zh/config/source/moduleScopes.md'
|
|
@@ -5,7 +5,7 @@ sidebar_label: preEntry
|
|
|
5
5
|
# source.preEntry
|
|
6
6
|
|
|
7
7
|
:::tip
|
|
8
|
-
该配置由 Modern.js Builder 提供,更多信息可参考 [source.preEntry](https://modernjs.dev/builder/api/config-source.html#
|
|
8
|
+
该配置由 Modern.js Builder 提供,更多信息可参考 [source.preEntry](https://modernjs.dev/builder/api/config-source.html#sourcepreentry)。
|
|
9
9
|
:::
|
|
10
10
|
|
|
11
11
|
import Main from '@modern-js/builder-doc/docs/zh/config/source/preEntry.md'
|
|
@@ -5,7 +5,7 @@ sidebar_label: resolveExtensionPrefix
|
|
|
5
5
|
# source.resolveExtensionPrefix
|
|
6
6
|
|
|
7
7
|
:::tip
|
|
8
|
-
该配置由 Modern.js Builder 提供,更多信息可参考 [source.resolveExtensionPrefix](https://modernjs.dev/builder/api/config-source.html#
|
|
8
|
+
该配置由 Modern.js Builder 提供,更多信息可参考 [source.resolveExtensionPrefix](https://modernjs.dev/builder/api/config-source.html#sourceresolveextensionprefix)。
|
|
9
9
|
:::
|
|
10
10
|
|
|
11
11
|
import Main from '@modern-js/builder-doc/docs/zh/config/source/resolveExtensionPrefix.md'
|
|
@@ -5,7 +5,7 @@ sidebar_label: resolveMainFields
|
|
|
5
5
|
# source.resolveMainFields
|
|
6
6
|
|
|
7
7
|
:::tip
|
|
8
|
-
该配置由 Modern.js Builder 提供,更多信息可参考 [source.resolveMainFields](https://modernjs.dev/builder/api/config-source.html#
|
|
8
|
+
该配置由 Modern.js Builder 提供,更多信息可参考 [source.resolveMainFields](https://modernjs.dev/builder/api/config-source.html#sourceresolvemainfields)。
|
|
9
9
|
:::
|
|
10
10
|
|
|
11
11
|
import Main from '@modern-js/builder-doc/docs/zh/config/source/resolveMainFields.md'
|
|
@@ -5,7 +5,7 @@ sidebar_label: autoprefixer
|
|
|
5
5
|
# tools.autoprefixer
|
|
6
6
|
|
|
7
7
|
:::tip
|
|
8
|
-
该配置由 Modern.js Builder 提供,更多信息可参考 [tools.autoprefixer](https://modernjs.dev/builder/api/config-tools.html#
|
|
8
|
+
该配置由 Modern.js Builder 提供,更多信息可参考 [tools.autoprefixer](https://modernjs.dev/builder/api/config-tools.html#toolsautoprefixer)。
|
|
9
9
|
:::
|
|
10
10
|
|
|
11
11
|
import Main from '@modern-js/builder-doc/docs/zh/config/tools/autoprefixer.md'
|
|
@@ -5,7 +5,7 @@ sidebar_label: babel
|
|
|
5
5
|
# tools.babel
|
|
6
6
|
|
|
7
7
|
:::tip
|
|
8
|
-
该配置由 Modern.js Builder 提供,更多信息可参考 [tools.babel](https://modernjs.dev/builder/api/config-tools.html#
|
|
8
|
+
该配置由 Modern.js Builder 提供,更多信息可参考 [tools.babel](https://modernjs.dev/builder/api/config-tools.html#toolsbabel)。
|
|
9
9
|
:::
|
|
10
10
|
|
|
11
11
|
import Main from '@modern-js/builder-doc/docs/zh/config/tools/babel.md'
|
|
@@ -5,7 +5,7 @@ sidebar_label: cssExtract
|
|
|
5
5
|
# tools.cssExtract
|
|
6
6
|
|
|
7
7
|
:::tip
|
|
8
|
-
该配置由 Modern.js Builder 提供,更多信息可参考 [tools.cssExtract](https://modernjs.dev/builder/api/config-tools.html#
|
|
8
|
+
该配置由 Modern.js Builder 提供,更多信息可参考 [tools.cssExtract](https://modernjs.dev/builder/api/config-tools.html#toolscssextract)。
|
|
9
9
|
:::
|
|
10
10
|
|
|
11
11
|
import Main from '@modern-js/builder-doc/docs/zh/config/tools/cssExtract.md'
|
|
@@ -5,7 +5,7 @@ sidebar_label: cssLoader
|
|
|
5
5
|
# tools.cssLoader
|
|
6
6
|
|
|
7
7
|
:::tip
|
|
8
|
-
该配置由 Modern.js Builder 提供,更多信息可参考 [tools.cssLoader](https://modernjs.dev/builder/api/config-tools.html#
|
|
8
|
+
该配置由 Modern.js Builder 提供,更多信息可参考 [tools.cssLoader](https://modernjs.dev/builder/api/config-tools.html#toolscssloader)。
|
|
9
9
|
:::
|
|
10
10
|
|
|
11
11
|
import Main from '@modern-js/builder-doc/docs/zh/config/tools/cssLoader.md'
|
|
@@ -5,7 +5,7 @@ sidebar_label: devServer
|
|
|
5
5
|
# tools.devServer
|
|
6
6
|
|
|
7
7
|
:::tip
|
|
8
|
-
该配置由 Modern.js Builder 提供,更多信息可参考 [tools.devServer](https://modernjs.dev/builder/api/config-tools.html#
|
|
8
|
+
该配置由 Modern.js Builder 提供,更多信息可参考 [tools.devServer](https://modernjs.dev/builder/api/config-tools.html#toolsdevserver)。
|
|
9
9
|
:::
|
|
10
10
|
|
|
11
11
|
import Main from '@modern-js/builder-doc/docs/zh/config/tools/devServer.md'
|
|
@@ -5,7 +5,7 @@ sidebar_label: htmlPlugin
|
|
|
5
5
|
# tools.htmlPlugin
|
|
6
6
|
|
|
7
7
|
:::tip
|
|
8
|
-
该配置由 Modern.js Builder 提供,更多信息可参考 [tools.htmlPlugin](https://modernjs.dev/builder/api/config-tools.html#
|
|
8
|
+
该配置由 Modern.js Builder 提供,更多信息可参考 [tools.htmlPlugin](https://modernjs.dev/builder/api/config-tools.html#toolshtmlplugin)。
|
|
9
9
|
:::
|
|
10
10
|
|
|
11
11
|
import Main from '@modern-js/builder-doc/docs/zh/config/tools/htmlPlugin.md'
|
|
@@ -5,7 +5,7 @@ sidebar_label: inspector
|
|
|
5
5
|
# tools.inspector
|
|
6
6
|
|
|
7
7
|
:::tip
|
|
8
|
-
该配置由 Modern.js Builder 提供,更多信息可参考 [tools.inspector](https://modernjs.dev/builder/api/config-tools.html#
|
|
8
|
+
该配置由 Modern.js Builder 提供,更多信息可参考 [tools.inspector](https://modernjs.dev/builder/api/config-tools.html#toolsinspector)。
|
|
9
9
|
:::
|
|
10
10
|
|
|
11
11
|
import Main from '@modern-js/builder-doc/docs/zh/config/tools/inspector.md'
|
|
@@ -5,7 +5,7 @@ sidebar_label: less
|
|
|
5
5
|
# tools.less
|
|
6
6
|
|
|
7
7
|
:::tip
|
|
8
|
-
该配置由 Modern.js Builder 提供,更多信息可参考 [tools.less](https://modernjs.dev/builder/api/config-tools.html#
|
|
8
|
+
该配置由 Modern.js Builder 提供,更多信息可参考 [tools.less](https://modernjs.dev/builder/api/config-tools.html#toolsless)。
|
|
9
9
|
:::
|
|
10
10
|
|
|
11
11
|
import Main from '@modern-js/builder-doc/docs/zh/config/tools/less.md'
|
|
@@ -5,7 +5,7 @@ sidebar_label: minifyCss
|
|
|
5
5
|
# tools.minifyCss
|
|
6
6
|
|
|
7
7
|
:::tip
|
|
8
|
-
该配置由 Modern.js Builder 提供,更多信息可参考 [tools.minifyCss](https://modernjs.dev/builder/api/config-tools.html#
|
|
8
|
+
该配置由 Modern.js Builder 提供,更多信息可参考 [tools.minifyCss](https://modernjs.dev/builder/api/config-tools.html#toolsminifycss)。
|
|
9
9
|
:::
|
|
10
10
|
|
|
11
11
|
import Main from '@modern-js/builder-doc/docs/zh/config/tools/minifyCss.md'
|
|
@@ -5,7 +5,7 @@ sidebar_label: postcss
|
|
|
5
5
|
# tools.postcss
|
|
6
6
|
|
|
7
7
|
:::tip
|
|
8
|
-
该配置由 Modern.js Builder 提供,更多信息可参考 [tools.postcss](https://modernjs.dev/builder/api/config-tools.html#
|
|
8
|
+
该配置由 Modern.js Builder 提供,更多信息可参考 [tools.postcss](https://modernjs.dev/builder/api/config-tools.html#toolspostcss)。
|
|
9
9
|
:::
|
|
10
10
|
|
|
11
11
|
import Main from '@modern-js/builder-doc/docs/zh/config/tools/postcss.md'
|
|
@@ -5,7 +5,7 @@ sidebar_label: pug
|
|
|
5
5
|
# tools.pug
|
|
6
6
|
|
|
7
7
|
:::tip
|
|
8
|
-
该配置由 Modern.js Builder 提供,更多信息可参考 [tools.pug](https://modernjs.dev/builder/api/config-tools.html#
|
|
8
|
+
该配置由 Modern.js Builder 提供,更多信息可参考 [tools.pug](https://modernjs.dev/builder/api/config-tools.html#toolspug)。
|
|
9
9
|
:::
|
|
10
10
|
|
|
11
11
|
import Main from '@modern-js/builder-doc/docs/zh/config/tools/pug.md'
|
|
@@ -5,7 +5,7 @@ sidebar_label: sass
|
|
|
5
5
|
# tools.sass
|
|
6
6
|
|
|
7
7
|
:::tip
|
|
8
|
-
该配置由 Modern.js Builder 提供,更多信息可参考 [tools.sass](https://modernjs.dev/builder/api/config-tools.html#
|
|
8
|
+
该配置由 Modern.js Builder 提供,更多信息可参考 [tools.sass](https://modernjs.dev/builder/api/config-tools.html#toolssass)。
|
|
9
9
|
:::
|
|
10
10
|
|
|
11
11
|
import Main from '@modern-js/builder-doc/docs/zh/config/tools/sass.md'
|
|
@@ -5,7 +5,7 @@ sidebar_label: styleLoader
|
|
|
5
5
|
# tools.styleLoader
|
|
6
6
|
|
|
7
7
|
:::tip
|
|
8
|
-
该配置由 Modern.js Builder 提供,更多信息可参考 [tools.styleLoader](https://modernjs.dev/builder/api/config-tools.html#
|
|
8
|
+
该配置由 Modern.js Builder 提供,更多信息可参考 [tools.styleLoader](https://modernjs.dev/builder/api/config-tools.html#toolsstyleloader)。
|
|
9
9
|
:::
|
|
10
10
|
|
|
11
11
|
import Main from '@modern-js/builder-doc/docs/zh/config/tools/styleLoader.md'
|
|
@@ -5,7 +5,7 @@ sidebar_label: styledComponents
|
|
|
5
5
|
# tools.styledComponents
|
|
6
6
|
|
|
7
7
|
:::tip
|
|
8
|
-
该配置由 Modern.js Builder 提供,更多信息可参考 [tools.styledComponents](https://modernjs.dev/builder/api/config-tools.html#
|
|
8
|
+
该配置由 Modern.js Builder 提供,更多信息可参考 [tools.styledComponents](https://modernjs.dev/builder/api/config-tools.html#toolsstyledcomponents)。
|
|
9
9
|
:::
|
|
10
10
|
|
|
11
11
|
import Main from '@modern-js/builder-doc/docs/zh/config/tools/styledComponents.md'
|
|
@@ -5,7 +5,7 @@ sidebar_label: terser
|
|
|
5
5
|
# tools.terser
|
|
6
6
|
|
|
7
7
|
:::tip
|
|
8
|
-
该配置由 Modern.js Builder 提供,更多信息可参考 [tools.terser](https://modernjs.dev/builder/api/config-tools.html#
|
|
8
|
+
该配置由 Modern.js Builder 提供,更多信息可参考 [tools.terser](https://modernjs.dev/builder/api/config-tools.html#toolsterser)。
|
|
9
9
|
:::
|
|
10
10
|
|
|
11
11
|
import Main from '@modern-js/builder-doc/docs/zh/config/tools/terser.md'
|
|
@@ -5,7 +5,7 @@ sidebar_label: tsChecker
|
|
|
5
5
|
# tools.tsChecker
|
|
6
6
|
|
|
7
7
|
:::tip
|
|
8
|
-
该配置由 Modern.js Builder 提供,更多信息可参考 [tools.tsChecker](https://modernjs.dev/builder/api/config-tools.html#
|
|
8
|
+
该配置由 Modern.js Builder 提供,更多信息可参考 [tools.tsChecker](https://modernjs.dev/builder/api/config-tools.html#toolstschecker)。
|
|
9
9
|
:::
|
|
10
10
|
|
|
11
11
|
import Main from '@modern-js/builder-doc/docs/zh/config/tools/tsChecker.md'
|
|
@@ -5,7 +5,7 @@ sidebar_label: tsLoader
|
|
|
5
5
|
# tools.tsLoader
|
|
6
6
|
|
|
7
7
|
:::tip
|
|
8
|
-
该配置由 Modern.js Builder 提供,更多信息可参考 [tools.tsLoader](https://modernjs.dev/builder/api/config-tools.html#
|
|
8
|
+
该配置由 Modern.js Builder 提供,更多信息可参考 [tools.tsLoader](https://modernjs.dev/builder/api/config-tools.html#toolstsloader)。
|
|
9
9
|
:::
|
|
10
10
|
|
|
11
11
|
import Main from '@modern-js/builder-doc/docs/zh/config/tools/tsLoader.md'
|
|
@@ -5,7 +5,7 @@ sidebar_label: webpackChain
|
|
|
5
5
|
# tools.webpackChain
|
|
6
6
|
|
|
7
7
|
:::tip
|
|
8
|
-
该配置由 Modern.js Builder 提供,更多信息可参考 [tools.webpackChain](https://modernjs.dev/builder/api/config-tools.html#
|
|
8
|
+
该配置由 Modern.js Builder 提供,更多信息可参考 [tools.webpackChain](https://modernjs.dev/builder/api/config-tools.html#toolswebpackchain)。
|
|
9
9
|
:::
|
|
10
10
|
|
|
11
11
|
import Main from '@modern-js/builder-doc/docs/zh/config/tools/webpackChain.md'
|
|
@@ -5,7 +5,7 @@ sidebar_label: webpack
|
|
|
5
5
|
# tools.webpack
|
|
6
6
|
|
|
7
7
|
:::tip
|
|
8
|
-
该配置由 Modern.js Builder 提供,更多信息可参考 [tools.webpack](https://modernjs.dev/builder/api/config-tools.html#
|
|
8
|
+
该配置由 Modern.js Builder 提供,更多信息可参考 [tools.webpack](https://modernjs.dev/builder/api/config-tools.html#toolswebpack)。
|
|
9
9
|
:::
|
|
10
10
|
|
|
11
11
|
import Main from '@modern-js/builder-doc/docs/zh/config/tools/webpack.md'
|
|
@@ -69,6 +69,69 @@ export default defineConfig({
|
|
|
69
69
|
});
|
|
70
70
|
```
|
|
71
71
|
|
|
72
|
+
### 导出配置函数
|
|
73
|
+
|
|
74
|
+
Modern.js 支持在配置文件中导出一个函数,你可以在函数中动态计算配置,并返回给 Modern.js。
|
|
75
|
+
|
|
76
|
+
```js title="modern.config.js"
|
|
77
|
+
import { defineConfig } from '@modern-js/app-tools';
|
|
78
|
+
|
|
79
|
+
export default defineConfig(({ env, command }) => ({
|
|
80
|
+
source: {
|
|
81
|
+
alias: {
|
|
82
|
+
'@foo': env === 'development' ? './src/foo.dev.ts' : './src/foo.prod.ts',
|
|
83
|
+
},
|
|
84
|
+
},
|
|
85
|
+
}));
|
|
86
|
+
```
|
|
87
|
+
|
|
88
|
+
该函数接受以下入参:
|
|
89
|
+
|
|
90
|
+
- `env`:对应 `process.env.NODE_ENV` 的值。
|
|
91
|
+
- 当运行 `modern dev` 或 `modern start` 时,`env` 的值为 `development`。
|
|
92
|
+
- 当运行 `modern build` 或 `modern serve` 时,`env` 的值为 `production`。
|
|
93
|
+
- 当运行 `modern test` 时,`env` 的值为 `test`。
|
|
94
|
+
- `command`: 对应当前运行的命令,如 `dev`、`start`、`build`、`serve`。
|
|
95
|
+
|
|
96
|
+
### 导出异步函数
|
|
97
|
+
|
|
98
|
+
Modern.js 也支持在配置文件中导出一个异步函数,你可以在函数中进行一些异步操作:
|
|
99
|
+
|
|
100
|
+
```js title="modern.config.js"
|
|
101
|
+
import { defineConfig } from '@modern-js/app-tools';
|
|
102
|
+
|
|
103
|
+
export default defineConfig(async ({ env, command }) => {
|
|
104
|
+
const result = await someAsyncFunction();
|
|
105
|
+
|
|
106
|
+
return {
|
|
107
|
+
html: {
|
|
108
|
+
title: result,
|
|
109
|
+
},
|
|
110
|
+
};
|
|
111
|
+
});
|
|
112
|
+
```
|
|
113
|
+
|
|
114
|
+
### 指定配置文件
|
|
115
|
+
|
|
116
|
+
Modern.js 命令行支持通过 `--config` 选项来指定配置文件的名称。
|
|
117
|
+
|
|
118
|
+
例如,你需要在执行 build 命令时使用 `modern.prod.config.ts` 文件,可以在 `package.json` 中添加如下配置:
|
|
119
|
+
|
|
120
|
+
```json title="package.json"
|
|
121
|
+
{
|
|
122
|
+
"scripts": {
|
|
123
|
+
"dev": "modern modern",
|
|
124
|
+
"build": "modern build --config modern.prod.config.ts"
|
|
125
|
+
}
|
|
126
|
+
}
|
|
127
|
+
```
|
|
128
|
+
|
|
129
|
+
你也可以将 `--config` 选项缩写为 `-c`:
|
|
130
|
+
|
|
131
|
+
```bash
|
|
132
|
+
$ modern build -c modern.prod.config.js
|
|
133
|
+
```
|
|
134
|
+
|
|
72
135
|
## 在 package.json 中配置(不推荐)
|
|
73
136
|
|
|
74
137
|
除了配置文件外,也可以在 `package.json` 中的 `modernConfig` 字段下设置配置选项,如:
|
|
@@ -242,11 +242,11 @@ if (process.env.MODERN_TARGET === 'browser') {
|
|
|
242
242
|
例如在代码中引入了 `fs-extra`,这时候直接引用到组件中,会造成 CSR 加载报错。可以创建同名的 `.ts` 和 `.node.ts` 文件做一层代理:
|
|
243
243
|
|
|
244
244
|
```ts title="compat.ts"
|
|
245
|
-
export
|
|
245
|
+
export const readFileSync: any = () => {};
|
|
246
246
|
```
|
|
247
247
|
|
|
248
248
|
```ts title="compat.node.ts"
|
|
249
|
-
export
|
|
249
|
+
export { readFileSync } from 'fs-extra';
|
|
250
250
|
```
|
|
251
251
|
|
|
252
252
|
在文件中直接引入 `./compat`,此时 SSR 环境下会优先使用 `.node.ts` 后缀的文件,CSR 环境下会使用 `.ts` 后缀的文件。
|
|
@@ -4,7 +4,7 @@ sidebar_position: 1
|
|
|
4
4
|
---
|
|
5
5
|
# 路由
|
|
6
6
|
|
|
7
|
-
Modern.js
|
|
7
|
+
Modern.js 的路由基于 [React Router 6](https://reactrouter.com/en/main),并提供了多种类型的路由模式。根据不同[入口](/docs/guides/concept/entries)类型,将路由分为三种模式,分别是**约定式路由**,**自控式路由**和**其他路由方案**。
|
|
8
8
|
|
|
9
9
|
:::note
|
|
10
10
|
本小节提到的路由,都是客户端路由,即 SPA 路由。
|
|
@@ -168,6 +168,33 @@ export default () => {
|
|
|
168
168
|
|
|
169
169
|
在 loader 中,params 会作为 [loader](/guides/basic-features/data-fetch#loader-函数) 的入参,通过 `params.xxx` 可以获取。
|
|
170
170
|
|
|
171
|
+
### 通配路由
|
|
172
|
+
|
|
173
|
+
如果在 routes 目录下创建 `$.tsx` 文件,该文件会作为通配路由组件,当没有匹配的路由时,会渲染该路由组件。
|
|
174
|
+
|
|
175
|
+
:::note
|
|
176
|
+
`$.tsx` 可以认为是一种特殊的 `page` 路由组件,当前目录下有 `layout` 组件时,`$.tsx`,会作为 `layout` 的子组件渲染。
|
|
177
|
+
:::
|
|
178
|
+
|
|
179
|
+
例如以下目录结构:
|
|
180
|
+
```
|
|
181
|
+
└── routes
|
|
182
|
+
├── $.tsx
|
|
183
|
+
├── blog
|
|
184
|
+
│ └── page.tsx
|
|
185
|
+
└── page.tsx
|
|
186
|
+
```
|
|
187
|
+
|
|
188
|
+
当访问任何匹配不到的路径时,都会渲染 `routes/$.tsx` 组件,同样,`$.tsx` 中可以使用 [useParams](/apis/app/runtime/router/#useparams) 捕获 url 的剩余部分。
|
|
189
|
+
```ts title="$.tsx"
|
|
190
|
+
import { useParams } from '@modern-js/runtime/router';
|
|
191
|
+
// 当 path 是 `/aaa/bbb` 时
|
|
192
|
+
const params = useParams();
|
|
193
|
+
params['*'] // => 'aaa/bbb'
|
|
194
|
+
```
|
|
195
|
+
|
|
196
|
+
`$.tsx` 可以加入到 `routes` 目录下的任意目录中,一个常见的使用示例是添加 `routes/$.tsx` 文件去定制任意层级的 404 页面。
|
|
197
|
+
|
|
171
198
|
### 无路径布局
|
|
172
199
|
|
|
173
200
|
当目录名以 \_\_ 开头时,对应的目录名不会转换为实际的路由路径,例如以下文件目录:
|
|
@@ -41,4 +41,4 @@ export type ForgedAPI = {
|
|
|
41
41
|
|
|
42
42
|
## params
|
|
43
43
|
|
|
44
|
-
启用功能时其他参数,详细参考[应用 New 命令](/guides/topic-detail/generator/config/
|
|
44
|
+
启用功能时其他参数,详细参考[应用 New 命令](/guides/topic-detail/generator/config/app#new-命令)和[模块 New 命令](/guides/topic-detail/generator/config/module#new-命令)。
|
|
@@ -6,9 +6,9 @@ sidebar_position: 1
|
|
|
6
6
|
|
|
7
7
|
Modern.js 提供的三个工程方案支持在项目中执行 new 命令创建元素和开启功能。在生成器插件中可直接调用相关 API 默认创建一些元素和开启支持的功能。
|
|
8
8
|
|
|
9
|
-
不同的工程方案支持的 new
|
|
9
|
+
不同的工程方案支持的 new 操作:
|
|
10
10
|
|
|
11
|
-
- [应用](/guides/topic-detail/generator/config/
|
|
11
|
+
- [Web 应用](/guides/topic-detail/generator/config/app#new-命令)
|
|
12
12
|
|
|
13
13
|
- [模块](/guides/topic-detail/generator/config/module#new-命令)
|
|
14
14
|
|
|
@@ -6,7 +6,7 @@ sidebar_position: 3
|
|
|
6
6
|
|
|
7
7
|
## 创建项目
|
|
8
8
|
|
|
9
|
-
Modern.js
|
|
9
|
+
Modern.js 提供了生成器插件用于创建开发项目,可直接执行以下命令创建:
|
|
10
10
|
|
|
11
11
|
```bash
|
|
12
12
|
npx @modern-js/create plugin --plugin @modern-js/generator-plugin-plugin
|
|
@@ -14,7 +14,7 @@ npx @modern-js/create plugin --plugin @modern-js/generator-plugin-plugin
|
|
|
14
14
|
|
|
15
15
|
插件类型不同,会提问不同的问题,可根据需求选择插件类型
|
|
16
16
|
|
|
17
|
-
###
|
|
17
|
+
### 扩展工程方案
|
|
18
18
|
|
|
19
19
|
```
|
|
20
20
|
? 请选择你想创建的工程类型 模块
|
|
@@ -26,7 +26,7 @@ npx @modern-js/create plugin --plugin @modern-js/generator-plugin-plugin
|
|
|
26
26
|
? 插件基础类型 应用
|
|
27
27
|
```
|
|
28
28
|
|
|
29
|
-
###
|
|
29
|
+
### 创建工程方案场景
|
|
30
30
|
|
|
31
31
|
```
|
|
32
32
|
? 请选择你想创建的工程类型 模块
|