Preserve QExcell active sheet in XLSX
This commit is contained in:
Курнат Андрей
@@ -32,7 +32,7 @@ npm run build
|
||||
## Поддержка форматов
|
||||
|
||||
- QWord открывает `.docx` и сохраняет `.docx`; при импорте базовых DOCX-абзацев читает выравнивание, переносы строк, внешние гиперссылки, простые таблицы, базовые растровые изображения, явные цвета текста, подсветку, размер и семейство шрифта из OOXML, а при экспорте DOCX сохраняются заголовки, абзацы, переносы строк, выравнивание абзацев, списки, простые таблицы, внешние гиперссылки, базовые растровые изображения и базовое inline-форматирование текста: полужирный, курсив, подчеркивание, зачеркивание, цвет текста, подсветка, размер и семейство шрифта.
|
||||
- QExcell открывает `.xlsx` и сохраняет `.xlsx`; сетка расширяется по фактически заполненным ячейкам, поддерживает несколько листов, формулы за пределами стартового диапазона A-H, shared formulas XLSX с относительными ссылками, базовые merged cells, внешние и внутренние гиперссылки ячеек, базовые диаграммы листа и базовое форматирование ячеек: полужирный, курсив, подчеркивание, зачеркивание, размер и семейство шрифта, прямые RGB/theme/indexed цвета текста с учетом `xl/theme/theme1.xml`, заливку, горизонтальное и вертикальное выравнивание, перенос текста, границы и цвет границ ячеек, числовые форматы XLSX для дат, процентов, денежных и дробных значений.
|
||||
- QExcell открывает `.xlsx` и сохраняет `.xlsx`; сетка расширяется по фактически заполненным ячейкам, поддерживает несколько листов, активный лист через `workbookView activeTab`, формулы за пределами стартового диапазона A-H, shared formulas XLSX с относительными ссылками, базовые merged cells, внешние и внутренние гиперссылки ячеек, базовые диаграммы листа и базовое форматирование ячеек: полужирный, курсив, подчеркивание, зачеркивание, размер и семейство шрифта, прямые RGB/theme/indexed цвета текста с учетом `xl/theme/theme1.xml`, заливку, горизонтальное и вертикальное выравнивание, перенос текста, границы и цвет границ ячеек, числовые форматы XLSX для дат, процентов, денежных и дробных значений.
|
||||
- QPowerPoint открывает `.pptx` и сохраняет `.pptx`; импорт учитывает порядок слайдов из `presentation.xml`, переносы абзацев и ручные переносы строк `a:br` внутри текстовых блоков, а также заметки докладчика через relationships слайда, сохраняет заметки докладчика, базовые растровые изображения слайдов, пользовательский цвет фона слайда, а также цвет, размер и семейство шрифта текста заголовка/подзаголовка.
|
||||
- QOutlook открывает `.eml` и одиночные сообщения Outlook `.msg`, сохраняет письма в `.eml`; импорт EML поддерживает простые текстовые письма, `multipart/alternative`, `multipart/mixed`, `multipart/related`, `text/plain`, fallback из `text/html` в читаемый текст, base64, quoted-printable, MIME encoded-word заголовки UTF-8/windows-1251, MIME-вложения и inline-вложения с `Content-ID`, `To`, `Cc` и `Bcc`. Импорт MSG читает тему, отправителя, получателей `To/Cc/Bcc`, текст/HTML body и вложения, если эти поля доступны в MSG-файле. Новые письма можно адресовать через `To/Cc/Bcc` и сохранять в EML вместе с добавленными файлами. `.pst` и экспорт в `.msg` пока не реализованы.
|
||||
|
||||
@@ -46,7 +46,7 @@ Desktop-меню поддерживает системные команды дл
|
||||
- `Ctrl/Cmd+Shift+E`: экспортировать текущую рабочую область в PDF.
|
||||
- `Ctrl/Cmd+P`: печать текущей рабочей области.
|
||||
|
||||
Импорт и экспорт реализуют базовую совместимость с Office Open XML, EML и чтением MSG: текст, базовое inline-форматирование, явные `w:br`, `w:color`, `w:shd`, `w:highlight`, `w:sz`, `w:rFonts` и `w:strike` для переносов строк/цвета/подсветки/размера/семейства/зачеркивания текста DOCX, выравнивание абзацев DOCX, внешние гиперссылки DOCX, внешние и внутренние гиперссылки XLSX, базовые растровые изображения DOCX/PPTX, простые таблицы, несколько листов XLSX, ячейки, формулы, shared formulas XLSX с относительными ссылками, базовые merged cells, базовые стили, RGB/theme/indexed цвета XLSX с учетом `xl/theme/theme1.xml`, размеры и семейства шрифта, зачеркивание ячеек, горизонтальное и вертикальное выравнивание, перенос текста, границы и цвет границ ячеек, числовые форматы и простые bar/line/pie диаграммы ячеек XLSX, текстовые слайды PPTX с переносами абзацев и ручными переносами строк `a:br` при импорте, пользовательский фон слайдов PPTX, цвет, размер и семейство шрифта текста заголовка/подзаголовка PPTX, импорт и экспорт заметок докладчика, адресацию `To/Cc/Bcc`, MIME encoded-word заголовки UTF-8/windows-1251, MIME-вложения EML, inline-вложения EML с `Content-ID` и базовые поля одиночных MSG-писем. Сложные стили, макросы, сложные диаграммы, сложное позиционирование и обтекание изображений, PST, экспорт MSG и полная fidelity документов Microsoft Office в текущем инкременте не заявлены.
|
||||
Импорт и экспорт реализуют базовую совместимость с Office Open XML, EML и чтением MSG: текст, базовое inline-форматирование, явные `w:br`, `w:color`, `w:shd`, `w:highlight`, `w:sz`, `w:rFonts` и `w:strike` для переносов строк/цвета/подсветки/размера/семейства/зачеркивания текста DOCX, выравнивание абзацев DOCX, внешние гиперссылки DOCX, внешние и внутренние гиперссылки XLSX, базовые растровые изображения DOCX/PPTX, простые таблицы, несколько листов и активный лист XLSX через `workbookView activeTab`, ячейки, формулы, shared formulas XLSX с относительными ссылками, базовые merged cells, базовые стили, RGB/theme/indexed цвета XLSX с учетом `xl/theme/theme1.xml`, размеры и семейства шрифта, зачеркивание ячеек, горизонтальное и вертикальное выравнивание, перенос текста, границы и цвет границ ячеек, числовые форматы и простые bar/line/pie диаграммы ячеек XLSX, текстовые слайды PPTX с переносами абзацев и ручными переносами строк `a:br` при импорте, пользовательский фон слайдов PPTX, цвет, размер и семейство шрифта текста заголовка/подзаголовка PPTX, импорт и экспорт заметок докладчика, адресацию `To/Cc/Bcc`, MIME encoded-word заголовки UTF-8/windows-1251, MIME-вложения EML, inline-вложения EML с `Content-ID` и базовые поля одиночных MSG-писем. Сложные стили, макросы, сложные диаграммы, сложное позиционирование и обтекание изображений, PST, экспорт MSG и полная fidelity документов Microsoft Office в текущем инкременте не заявлены.
|
||||
|
||||
## Сборка пакета
|
||||
|
||||
|
||||
@@ -433,7 +433,7 @@ export function QExcell({ workbook, onChange }: QExcellProps) {
|
||||
onChange({
|
||||
...workbook,
|
||||
title: imported.title,
|
||||
activeSheet: imported.sheets[0]?.id ?? "sheet-1",
|
||||
activeSheet: imported.activeSheet ?? imported.sheets[0]?.id ?? "sheet-1",
|
||||
sheets: imported.sheets.length > 0 ? imported.sheets : [{ id: "sheet-1", name: "Лист 1", cells: {}, mergedCells: [] }]
|
||||
});
|
||||
} catch (error) {
|
||||
|
||||
@@ -12,6 +12,7 @@ import {
|
||||
importXlsxFile,
|
||||
chartDataPoints,
|
||||
chartXmlToSheetChart,
|
||||
workbookActiveSheetId,
|
||||
workbookRelationshipTargets,
|
||||
workbookSheetRefs,
|
||||
worksheetXmlToCells,
|
||||
@@ -519,6 +520,39 @@ describe("excellOffice OOXML helpers", () => {
|
||||
}
|
||||
})
|
||||
).toEqual({ rId3: "worksheets/sheet7.xml" });
|
||||
|
||||
expect(
|
||||
workbookActiveSheetId(
|
||||
{
|
||||
workbook: {
|
||||
bookViews: { workbookView: { activeTab: "1" } }
|
||||
}
|
||||
},
|
||||
[
|
||||
{ id: "sheet-1" },
|
||||
{ id: "sheet-7" }
|
||||
]
|
||||
)
|
||||
).toBe("sheet-7");
|
||||
});
|
||||
|
||||
it("сохраняет и импортирует активный лист XLSX через workbookView activeTab", async () => {
|
||||
const blob = await exportXlsxBlob({
|
||||
id: "book-1",
|
||||
title: "Активный лист.xlsx",
|
||||
updatedAt: "2026-06-01T00:00:00.000Z",
|
||||
activeSheet: "sheet-2",
|
||||
sheets: [
|
||||
{ id: "sheet-1", name: "Первый", cells: { A1: "Первый" } },
|
||||
{ id: "sheet-2", name: "Второй", cells: { A1: "Второй" } }
|
||||
]
|
||||
});
|
||||
const zip = await JSZip.loadAsync(await blob.arrayBuffer());
|
||||
const workbookXml = await zip.file("xl/workbook.xml")?.async("string");
|
||||
const imported = await importXlsxFile(new File([blob], "Активный лист.xlsx", { type: blob.type }));
|
||||
|
||||
expect(workbookXml).toContain('<workbookView activeTab="1"/>');
|
||||
expect(imported.activeSheet).toBe("sheet-2");
|
||||
});
|
||||
|
||||
it("создает OOXML chart part для диаграммы XLSX", () => {
|
||||
|
||||
+21
-3
@@ -4,6 +4,7 @@ import { officeTitleFromFileName, readOfficeFileAsArrayBuffer, XLSX_MIME_TYPE }
|
||||
|
||||
export interface ImportedExcellWorkbook {
|
||||
title: string;
|
||||
activeSheet?: string;
|
||||
sheets: Array<{
|
||||
id: string;
|
||||
name: string;
|
||||
@@ -201,9 +202,11 @@ export async function importXlsxFile(file: File): Promise<ImportedExcellWorkbook
|
||||
return { ...parsedSheet, charts };
|
||||
})
|
||||
);
|
||||
const activeSheet = workbookActiveSheetId(workbookXml, sheets);
|
||||
|
||||
return {
|
||||
title: officeTitleFromFileName(file.name, "Книга QExcell.xlsx"),
|
||||
...(activeSheet ? { activeSheet } : {}),
|
||||
sheets
|
||||
};
|
||||
}
|
||||
@@ -215,12 +218,13 @@ export async function exportXlsxBlob(workbook: Workbook): Promise<Blob> {
|
||||
|
||||
const styleRegistry = createCellStyleRegistry(sheets.map((sheet) => sheet.cellFormats));
|
||||
const chartParts = chartPartRefsForSheets(sheets);
|
||||
const activeSheetIndex = Math.max(0, sheets.findIndex((sheet) => sheet.id === workbook.activeSheet));
|
||||
|
||||
zip.file("[Content_Types].xml", buildContentTypesXml(sheets.length, chartParts));
|
||||
zip.file("_rels/.rels", buildRootRelationshipsXml());
|
||||
zip.file("docProps/app.xml", buildAppPropertiesXml());
|
||||
zip.file("docProps/core.xml", buildCorePropertiesXml());
|
||||
zip.file("xl/workbook.xml", buildWorkbookXml(sheets.map((sheet, index) => sheet.name.trim() || `Лист ${index + 1}`)));
|
||||
zip.file("xl/workbook.xml", buildWorkbookXml(sheets.map((sheet, index) => sheet.name.trim() || `Лист ${index + 1}`), activeSheetIndex));
|
||||
zip.file("xl/_rels/workbook.xml.rels", buildWorkbookRelationshipsXml(sheets.length));
|
||||
zip.file("xl/styles.xml", buildStylesXml(styleRegistry));
|
||||
|
||||
@@ -636,6 +640,18 @@ export function workbookSheetRefs(workbookXml: unknown): WorkbookSheetRef[] {
|
||||
});
|
||||
}
|
||||
|
||||
export function workbookActiveSheetId(workbookXml: unknown, sheets: Array<{ id: string }>): string {
|
||||
const workbook = childRecord(workbookXml, "workbook");
|
||||
const bookViews = childRecord(workbook, "bookViews");
|
||||
const workbookView = asRecord(toArray(bookViews.workbookView)[0]);
|
||||
const activeTab = Number.parseInt(String(workbookView.activeTab ?? workbookView["@_activeTab"] ?? ""), 10);
|
||||
if (!Number.isInteger(activeTab) || activeTab < 0) {
|
||||
return "";
|
||||
}
|
||||
|
||||
return sheets[activeTab]?.id ?? "";
|
||||
}
|
||||
|
||||
export function workbookRelationshipTargets(relationshipsXml: unknown) {
|
||||
const relationships = childRecord(relationshipsXml, "Relationships");
|
||||
const targets: Record<string, string> = {};
|
||||
@@ -689,7 +705,9 @@ function buildRootRelationshipsXml() {
|
||||
);
|
||||
}
|
||||
|
||||
function buildWorkbookXml(sheetNames: string[]) {
|
||||
function buildWorkbookXml(sheetNames: string[], activeSheetIndex = 0) {
|
||||
const activeTab = Math.min(Math.max(0, activeSheetIndex), Math.max(0, sheetNames.length - 1));
|
||||
const bookViews = `<bookViews><workbookView activeTab="${activeTab}"/></bookViews>`;
|
||||
const sheets = sheetNames
|
||||
.map((name, index) => {
|
||||
return `<sheet name="${escapeXmlAttribute(name)}" sheetId="${index + 1}" r:id="rId${index + 1}"/>`;
|
||||
@@ -697,7 +715,7 @@ function buildWorkbookXml(sheetNames: string[]) {
|
||||
.join("");
|
||||
|
||||
return xmlDeclaration(
|
||||
`<workbook xmlns="http://schemas.openxmlformats.org/spreadsheetml/2006/main" xmlns:r="http://schemas.openxmlformats.org/officeDocument/2006/relationships"><sheets>${sheets}</sheets></workbook>`
|
||||
`<workbook xmlns="http://schemas.openxmlformats.org/spreadsheetml/2006/main" xmlns:r="http://schemas.openxmlformats.org/officeDocument/2006/relationships">${bookViews}<sheets>${sheets}</sheets></workbook>`
|
||||
);
|
||||
}
|
||||
|
||||
|
||||
Reference in New Issue
Block a user