docs(core): 调整文档

Author: caixw

packages/components/src/table/loader.tsx

@@ -268,11 +268,6 @@ export function Root<T extends object, Q extends Query = Query>(props: Props<T,
 								}
 							}}
 							items={[
-								{
-									type: 'item',
-									value: '.csv',
-									label: <Label.Root icon={<IconCSV />}>{l.t('_c.table.exportTo', { type: 'CSV' })}</Label.Root>,
-								},
 								{
 									type: 'item',
 									value: '.xlsx',
@@ -283,6 +278,12 @@ export function Root<T extends object, Q extends Query = Query>(props: Props<T,
 									value: '.ods',
 									label: <Label.Root icon={<IconODS />}>{l.t('_c.table.exportTo', { type: 'ODS' })}</Label.Root>,
 								},
+								{ type: 'divider' },
+								{
+									type: 'item',
+									value: '.csv',
+									label: <Label.Root icon={<IconCSV />}>{l.t('_c.table.exportTo', { type: 'CSV' })}</Label.Root>,
+								},
 								{
 									type: 'item',
 									value: '.md',

packages/core/src/api/export/export.ts

@@ -10,6 +10,8 @@ import { presetCellRenderFunc } from './column';
 import { createDownloadLink } from './download';
 import type { Page, Query } from './query';
 
+type ExtsType = (typeof Exporter.exts)[number];
+
 /**
  * 从服务器获取数据的函数签名
  *
@@ -102,22 +104,17 @@ export class Exporter<T extends object, Q extends Query> {
 		}
 	}
 
-	#buildHeader(): Array<ColumnDef> {
-		return this.#header.map(h => ({ header: h }));
-	}
-
 	/**
-	 * 导出数据
-	 *
-	 * 将 {@link Exporter#fetch} 下载的数据导出给用户。
+	 * 导出由 {@link Exporter#fetch} 获取的数据
 	 *
-	 * @param filename - 文件名，如果是 excel 和 ods，文件名部分也作为工作表的名称；
+	 * @param filename - 文件名，包含扩展名，根据扩展名决定导出类型。如果是 excel 和 ods，文件名部分也作为工作表的名称；
 	 *
+	 * @remarks
 	 * NOTE: 这将通过浏览器创建一个自动下载的功能。
 	 */
-	async export(filename: `${string}${(typeof Exporter.exts)[number]}`): Promise<void> {
+	async export(filename: `${string}${ExtsType}`): Promise<void> {
 		const index = filename.lastIndexOf('.');
-		const ext = filename.slice(index);
+		const ext = filename.slice(index) as (typeof Exporter.exts)[number];
 		const basename = filename.slice(0, index);
 
 		switch (ext) {
@@ -126,15 +123,6 @@ export class Exporter<T extends object, Q extends Query> {
 				createDownloadLink(content, filename, 'text/csv');
 				break;
 			}
-			case '.xlsx': {
-				const content = await writeXlsx(this.buildWriteOptions(basename));
-				createDownloadLink(
-					content.buffer as ArrayBuffer,
-					filename,
-					'application/vnd.openxmlformats-officedocument.spreadsheetml.sheet',
-				);
-				break;
-			}
 			case '.md': {
 				const sheet = {
 					name: basename,
@@ -145,15 +133,24 @@ export class Exporter<T extends object, Q extends Query> {
 				createDownloadLink(content, filename, 'text/markdown');
 				break;
 			}
+			case '.xlsx': {
+				const content = await writeXlsx(this.#buildWriteOptions(basename));
+				createDownloadLink(
+					content.buffer as ArrayBuffer,
+					filename,
+					'application/vnd.openxmlformats-officedocument.spreadsheetml.sheet',
+				);
+				break;
+			}
 			case '.ods': {
-				const content = await writeOds(this.buildWriteOptions(basename));
+				const content = await writeOds(this.#buildWriteOptions(basename));
 				createDownloadLink(content.buffer as ArrayBuffer, filename, 'application/vnd.oasis.opendocument.spreadsheet');
 				break;
 			}
 		}
 	}
 
-	buildWriteOptions(basename: string): WriteOptions {
+	#buildWriteOptions(basename: string): WriteOptions {
 		const now = new Date();
 		return {
 			sheets: [
@@ -170,4 +167,8 @@ export class Exporter<T extends object, Q extends Query> {
 			},
 		};
 	}
+
+	#buildHeader(): Array<ColumnDef> {
+		return this.#header.map(h => ({ header: h }));
+	}
 }