docs: update upload

midwayjs · Jul 26, 2024 · 1e6169e · 1e6169e
1 parent 9edcf6f
commit 1e6169e
Show file tree

Hide file tree

Showing 4 changed files with 84 additions and 7 deletions.
diff --git a/site/docs/extensions/upload.md b/site/docs/extensions/upload.md
@@ -357,6 +357,45 @@ export default {
 
 
 
+### 同名 Field
+
+从 v3.16.6 开始，组件支持同名 Field。
+
+```typescript
+// src/config/config.default.ts
+import { tmpdir } from 'os';
+import { join } from 'path';
+
+export default {
+  // ...
+  upload: {
+    allowFieldsDuplication: true
+  },
+}
+
+```
+
+开启 `allowFieldsDuplication` 之后，同名的 Field 会被合并为数组。
+
+```typescript
+import { Controller, Inject, Post, Files, Fields } from '@midwayjs/core';
+
+@Controller('/')
+export class HomeController {
+  @Post('/upload')
+  async upload(@Files() files, @Fields() fields) {
+    /*
+    fields = {
+    	name: ['name1', 'name2'],
+    	otherName: 'nameOther'
+    	// ...
+    }
+
+    */
+  }
+}
+```
+
 
 
 

diff --git a/site/docs/legacy/task.md b/site/docs/legacy/task.md
@@ -254,7 +254,7 @@ export class MainConfiguration implements ILifeCycle {
 
 
 
-Midway 在框架侧提供了一些常用的表达式，放在 `@midwayjs/decorator` 中供大家使用。
+Midway 在框架侧提供了一些常用的表达式，放在 `@midwayjs/core` 中供大家使用。
 
 ```typescript
 import { FORMAT } from '@midwayjs/core';

diff --git a/site/docs/router_table.md b/site/docs/router_table.md
@@ -444,8 +444,7 @@ export class DataController {
 
 ```typescript
 // src/configuration.ts
-import { MidwayWebRouterService } from '@midwayjs/core';
-import { Configuration, Inject } from '@midwayjs/decorator';
+import { Configuration, Inject, MidwayWebRouterService } from '@midwayjs/core';
 import { DataController } from './controller/data.controller';
 
 @Configuration({
@@ -481,8 +480,7 @@ export class MainConfiguration {
 
 ```typescript
 // src/configuration.ts
-import { MidwayWebRouterService } from '@midwayjs/core';
-import { Configuration, Inject } from '@midwayjs/decorator';
+import { Configuration, Inject, MidwayWebRouterService } from '@midwayjs/core';
 
 @Configuration({
   // ...
@@ -524,8 +522,7 @@ export class MainConfiguration {
 
 ```typescript
 // src/configuration.ts
-import { MidwayServerlessFunctionService } from '@midwayjs/core';
-import { Configuration, Inject } from '@midwayjs/decorator';
+import { Configuration, Inject, MidwayServerlessFunctionService } from '@midwayjs/core';
 
 @Configuration({
   // ...

diff --git a/site/i18n/en/docusaurus-plugin-content-docs/current/extensions/upload.md b/site/i18n/en/docusaurus-plugin-content-docs/current/extensions/upload.md
@@ -349,6 +349,47 @@ Therefore, you can add `match` or `ignore` configuration to the configuration to
 
 
 
+### Same name Field
+
+The componennt support Field with the same name since v3.16.6.
+
+```typescript
+// src/config/config.default.ts
+import { tmpdir } from 'os';
+import { join } from 'path';
+
+export default {
+  // ...
+  upload: {
+    allowFieldsDuplication: true
+  },
+}
+
+```
+
+After `allowFieldsDuplication` is enabled, Fields with the same name will be merged into an array.
+
+```typescript
+import { Controller, Inject, Post, Files, Fields } from '@midwayjs/core';
+
+@Controller('/')
+export class HomeController {
+  @Post('/upload')
+  async upload(@Files() files, @Fields() fields) {
+    /*
+    fields = {
+    	name: ['name1', 'name2'],
+    	otherName: 'nameOther'
+    	// ...
+    }
+
+    */
+  }
+}
+```
+
+
+