diff --git a/README.md b/README.md
index 0602cf6..051fd0e 100644
--- a/README.md
+++ b/README.md
@@ -32,7 +32,7 @@ npm run build
## Поддержка форматов
- QWord открывает `.docx` и сохраняет `.docx`; при импорте базовых DOCX-абзацев читает выравнивание, отступы `w:ind`, переносы строк, разрывы страниц, табуляцию, закладки, внешние и внутренние гиперссылки-якоря, простые таблицы, базовые растровые изображения, явные цвета текста, подсветку, размер и семейство шрифта из OOXML, а при экспорте DOCX сохраняются заголовки, абзацы, переносы строк, разрывы страниц, табуляция, выравнивание и отступы абзацев из HTML `margin-left`/`text-indent`, закладки из HTML `id`, списки, простые таблицы, внешние и внутренние гиперссылки-якоря, базовые растровые изображения и базовое inline-форматирование текста: полужирный, курсив, подчеркивание, зачеркивание, цвет текста, подсветка, размер и семейство шрифта.
-- QExcell открывает `.xlsx` и сохраняет `.xlsx`; сетка расширяется по фактически заполненным ячейкам, поддерживает несколько листов, скрытые и veryHidden листы через `sheet state`, закрепленные области через `sheetViews pane`, скрытие сетки через `sheetView showGridLines`, масштаб листа через `sheetView zoomScale`, автофильтр через `autoFilter ref`, область печати через `_xlnm.Print_Area`, цвет вкладки листа через `sheetPr tabColor`, ширину колонок через `cols/col width`, высоту строк через `row ht/customHeight`, активный лист через `workbookView activeTab`, формулы за пределами стартового диапазона A-H, shared formulas XLSX с относительными ссылками, базовые merged cells, внешние и внутренние гиперссылки ячеек, базовые диаграммы листа и базовое форматирование ячеек: полужирный, курсив, подчеркивание, зачеркивание, размер и семейство шрифта, прямые RGB/theme/indexed цвета текста с учетом `xl/theme/theme1.xml`, заливку, горизонтальное и вертикальное выравнивание, перенос текста, границы и цвет границ ячеек, числовые форматы XLSX для дат, процентов, денежных и дробных значений.
+- QExcell открывает `.xlsx` и сохраняет `.xlsx`; сетка расширяется по фактически заполненным ячейкам, поддерживает несколько листов, скрытые и veryHidden листы через `sheet state`, закрепленные области через `sheetViews pane`, скрытие сетки через `sheetView showGridLines`, масштаб листа через `sheetView zoomScale`, автофильтр через `autoFilter ref`, область печати через `_xlnm.Print_Area`, цвет вкладки листа через `sheetPr tabColor`, ширину и скрытие колонок через `cols/col width` и `col hidden`, высоту и скрытие строк через `row ht/customHeight` и `row hidden`, активный лист через `workbookView activeTab`, формулы за пределами стартового диапазона A-H, shared formulas XLSX с относительными ссылками, базовые merged cells, внешние и внутренние гиперссылки ячеек, базовые диаграммы листа и базовое форматирование ячеек: полужирный, курсив, подчеркивание, зачеркивание, размер и семейство шрифта, прямые RGB/theme/indexed цвета текста с учетом `xl/theme/theme1.xml`, заливку, горизонтальное и вертикальное выравнивание, перенос текста, границы и цвет границ ячеек, числовые форматы XLSX для дат, процентов, денежных и дробных значений.
- QPowerPoint открывает `.pptx` и сохраняет `.pptx`; импорт учитывает порядок слайдов из `presentation.xml`, переносы абзацев и ручные переносы строк `a:br` внутри текстовых блоков, скрытые слайды через атрибут `show`, переходы `p:transition` для `fade`/`push`/`wipe`, а также заметки докладчика через 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`, `Reply-To`, `Message-ID`, `In-Reply-To`, `References`, `Importance`, `X-Priority` и `Priority`. Импорт MSG читает тему, отправителя, получателей `To/Cc/Bcc`, `Reply-To`, `Message-ID`, `In-Reply-To`, `References`, `Importance`, `X-Priority` и `Priority` из транспортных заголовков, текст/HTML body и вложения, если эти поля доступны в MSG-файле. Новые письма можно адресовать через `To/Cc/Bcc`, задавать `Reply-To` и сохранять в 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:br w:type="page"`, `w:tab`, `w:color`, `w:shd`, `w:highlight`, `w:sz`, `w:rFonts` и `w:strike` для переносов строк/разрывов страниц/табуляции/цвета/подсветки/размера/семейства/зачеркивания текста DOCX, выравнивание и отступы абзацев DOCX через `w:jc`/`w:ind`, закладки DOCX через `w:bookmarkStart`/`w:bookmarkEnd`, внешние `w:hyperlink r:id` и внутренние `w:hyperlink w:anchor` гиперссылки DOCX, внешние и внутренние гиперссылки XLSX, базовые растровые изображения DOCX/PPTX, простые таблицы, несколько листов, скрытые/veryHidden листы через `sheet state`, закрепленные области через `sheetViews pane`, скрытие сетки через `sheetView showGridLines`, масштаб листа через `sheetView zoomScale`, автофильтр через `autoFilter ref`, область печати XLSX через `_xlnm.Print_Area`, цвет вкладки листа через `sheetPr tabColor`, ширину колонок через `cols/col width`, высоту строк через `row ht/customHeight` и активный лист XLSX через `workbookView activeTab`, ячейки, формулы, shared formulas XLSX с относительными ссылками, базовые merged cells, базовые стили, RGB/theme/indexed цвета XLSX с учетом `xl/theme/theme1.xml`, размеры и семейства шрифта, зачеркивание ячеек, горизонтальное и вертикальное выравнивание, перенос текста, границы и цвет границ ячеек, числовые форматы и простые bar/line/pie диаграммы ячеек XLSX, текстовые слайды PPTX с переносами абзацев и ручными переносами строк `a:br` при импорте, скрытые слайды PPTX через атрибут `show`, переходы PPTX через `p:transition` для `fade`/`push`/`wipe`, пользовательский фон слайдов PPTX, цвет, размер и семейство шрифта текста заголовка/подзаголовка PPTX, импорт и экспорт заметок докладчика, адресацию `To/Cc/Bcc/Reply-To`, заголовки цепочки писем `Message-ID`/`In-Reply-To`/`References`, заголовки приоритета `Importance`/`X-Priority`/`Priority`, 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:br w:type="page"`, `w:tab`, `w:color`, `w:shd`, `w:highlight`, `w:sz`, `w:rFonts` и `w:strike` для переносов строк/разрывов страниц/табуляции/цвета/подсветки/размера/семейства/зачеркивания текста DOCX, выравнивание и отступы абзацев DOCX через `w:jc`/`w:ind`, закладки DOCX через `w:bookmarkStart`/`w:bookmarkEnd`, внешние `w:hyperlink r:id` и внутренние `w:hyperlink w:anchor` гиперссылки DOCX, внешние и внутренние гиперссылки XLSX, базовые растровые изображения DOCX/PPTX, простые таблицы, несколько листов, скрытые/veryHidden листы через `sheet state`, закрепленные области через `sheetViews pane`, скрытие сетки через `sheetView showGridLines`, масштаб листа через `sheetView zoomScale`, автофильтр через `autoFilter ref`, область печати XLSX через `_xlnm.Print_Area`, цвет вкладки листа через `sheetPr tabColor`, ширину и скрытие колонок через `cols/col width`/`col hidden`, высоту и скрытие строк через `row ht/customHeight`/`row hidden` и активный лист XLSX через `workbookView activeTab`, ячейки, формулы, shared formulas XLSX с относительными ссылками, базовые merged cells, базовые стили, RGB/theme/indexed цвета XLSX с учетом `xl/theme/theme1.xml`, размеры и семейства шрифта, зачеркивание ячеек, горизонтальное и вертикальное выравнивание, перенос текста, границы и цвет границ ячеек, числовые форматы и простые bar/line/pie диаграммы ячеек XLSX, текстовые слайды PPTX с переносами абзацев и ручными переносами строк `a:br` при импорте, скрытые слайды PPTX через атрибут `show`, переходы PPTX через `p:transition` для `fade`/`push`/`wipe`, пользовательский фон слайдов PPTX, цвет, размер и семейство шрифта текста заголовка/подзаголовка PPTX, импорт и экспорт заметок докладчика, адресацию `To/Cc/Bcc/Reply-To`, заголовки цепочки писем `Message-ID`/`In-Reply-To`/`References`, заголовки приоритета `Importance`/`X-Priority`/`Priority`, MIME encoded-word заголовки UTF-8/windows-1251, MIME-вложения EML, inline-вложения EML с `Content-ID` и базовые поля одиночных MSG-писем. Сложные стили, макросы, сложные диаграммы, сложное позиционирование и обтекание изображений, PST, экспорт MSG и полная fidelity документов Microsoft Office в текущем инкременте не заявлены.
## Сборка пакета
diff --git a/src/io/excellOffice.test.ts b/src/io/excellOffice.test.ts
index 0b21c22..5b1a4d4 100644
--- a/src/io/excellOffice.test.ts
+++ b/src/io/excellOffice.test.ts
@@ -25,6 +25,8 @@ import {
worksheetXmlToCellFormats,
worksheetXmlToColumnWidths,
worksheetXmlToFrozenPane,
+ worksheetXmlToHiddenColumns,
+ worksheetXmlToHiddenRows,
worksheetXmlToHyperlinks,
worksheetXmlToMergedCells,
worksheetXmlToRowHeights,
@@ -912,6 +914,62 @@ describe("excellOffice OOXML helpers", () => {
expect(imported.sheets[0].rowHeights).toEqual({ "1": 24, "4": 30.5 });
});
+ it("читает и записывает скрытые колонки и строки XLSX", async () => {
+ expect(
+ worksheetXmlToHiddenColumns({
+ worksheet: {
+ cols: {
+ col: [
+ { min: "2", max: "3", hidden: "1" },
+ { min: "5", max: "5", width: "12", hidden: "true" }
+ ]
+ }
+ }
+ })
+ ).toEqual({ B: true, C: true, E: true });
+ expect(
+ worksheetXmlToHiddenRows({
+ worksheet: {
+ sheetData: {
+ row: [{ r: "4", hidden: "1" }, { r: "6", ht: "21", hidden: "true" }]
+ }
+ }
+ })
+ ).toEqual({ "4": true, "6": true });
+ expect(buildColumnWidthsXml({ E: 12 }, { B: true, C: true, E: true })).toBe(
+ ''
+ );
+
+ const blob = await exportXlsxBlob({
+ id: "book-1",
+ title: "Hidden rows and columns.xlsx",
+ updatedAt: "2026-06-01T00:00:00.000Z",
+ activeSheet: "sheet-1",
+ sheets: [
+ {
+ id: "sheet-1",
+ name: "Hidden",
+ columnWidths: { E: 12 },
+ rowHeights: { "6": 21 },
+ hiddenColumns: { B: true, C: true, E: true },
+ hiddenRows: { "4": true, "6": true },
+ cells: { A1: "Visible" }
+ }
+ ]
+ });
+ const zip = await JSZip.loadAsync(await blob.arrayBuffer());
+ const sheetXml = (await zip.file("xl/worksheets/sheet1.xml")?.async("string")) ?? "";
+ const imported = await importXlsxFile(new File([blob], "Hidden rows and columns.xlsx", { type: blob.type }));
+
+ expect(sheetXml).toContain(
+ ''
+ );
+ expect(sheetXml).toContain('
');
+ expect(sheetXml).toContain('
');
+ expect(imported.sheets[0].hiddenColumns).toEqual({ B: true, C: true, E: true });
+ expect(imported.sheets[0].hiddenRows).toEqual({ "4": true, "6": true });
+ });
+
it("создает OOXML chart part для диаграммы XLSX", () => {
const xml = buildChartXml(
{
diff --git a/src/io/excellOffice.ts b/src/io/excellOffice.ts
index 5949449..234558a 100644
--- a/src/io/excellOffice.ts
+++ b/src/io/excellOffice.ts
@@ -14,6 +14,8 @@ export interface ImportedExcellWorkbook {
tabColor?: string;
columnWidths?: Record;
rowHeights?: Record;
+ hiddenColumns?: Record;
+ hiddenRows?: Record;
showGridLines?: boolean;
zoomScale?: number;
printArea?: string;
@@ -69,6 +71,8 @@ interface ParsedSheet {
tabColor?: string;
columnWidths?: Record;
rowHeights?: Record;
+ hiddenColumns?: Record;
+ hiddenRows?: Record;
showGridLines?: boolean;
zoomScale?: number;
printArea?: string;
@@ -291,6 +295,8 @@ export async function exportXlsxBlob(workbook: Workbook): Promise {
sheet.tabColor,
sheet.columnWidths,
sheet.rowHeights,
+ sheet.hiddenColumns,
+ sheet.hiddenRows,
sheet.showGridLines,
sheet.zoomScale
)
@@ -330,6 +336,8 @@ export function parsedWorksheetToSheet(
const tabColor = worksheetXmlToTabColor(worksheetXml, themeColors);
const columnWidths = worksheetXmlToColumnWidths(worksheetXml);
const rowHeights = worksheetXmlToRowHeights(worksheetXml);
+ const hiddenColumns = worksheetXmlToHiddenColumns(worksheetXml);
+ const hiddenRows = worksheetXmlToHiddenRows(worksheetXml);
const showGridLines = worksheetXmlToShowGridLines(worksheetXml);
const zoomScale = worksheetXmlToZoomScale(worksheetXml);
@@ -342,6 +350,8 @@ export function parsedWorksheetToSheet(
...(tabColor ? { tabColor } : {}),
...(Object.keys(columnWidths).length > 0 ? { columnWidths } : {}),
...(Object.keys(rowHeights).length > 0 ? { rowHeights } : {}),
+ ...(Object.keys(hiddenColumns).length > 0 ? { hiddenColumns } : {}),
+ ...(Object.keys(hiddenRows).length > 0 ? { hiddenRows } : {}),
...(showGridLines === false ? { showGridLines } : {}),
...(zoomScale ? { zoomScale } : {}),
cells: worksheetXmlToCells(worksheetXml, sharedStrings),
@@ -514,6 +524,26 @@ export function worksheetXmlToColumnWidths(worksheetXml: unknown): Record {
+ const worksheet = childRecord(worksheetXml, "worksheet");
+ const cols = childRecord(worksheet, "cols");
+
+ return toArray(cols.col).reduce>((columns, col) => {
+ const record = asRecord(col);
+ const min = positiveIntegerAttribute(record.min);
+ const max = positiveIntegerAttribute(record.max) || min;
+ if (!min || !max || max < min || !booleanAttribute(record.hidden)) {
+ return columns;
+ }
+
+ for (let column = min; column <= max; column += 1) {
+ columns[columnName(column)] = true;
+ }
+
+ return columns;
+ }, {});
+}
+
export function worksheetXmlToRowHeights(worksheetXml: unknown): Record {
const worksheet = childRecord(worksheetXml, "worksheet");
const sheetData = childRecord(worksheet, "sheetData");
@@ -530,6 +560,21 @@ export function worksheetXmlToRowHeights(worksheetXml: unknown): Record {
+ const worksheet = childRecord(worksheetXml, "worksheet");
+ const sheetData = childRecord(worksheet, "sheetData");
+
+ return toArray(sheetData.row).reduce>((rows, row, index) => {
+ const record = asRecord(row);
+ const rowNumber = positiveIntegerAttribute(record.r) || index + 1;
+ if (booleanAttribute(record.hidden)) {
+ rows[String(rowNumber)] = true;
+ }
+
+ return rows;
+ }, {});
+}
+
async function worksheetXmlToCharts(
zip: ZipInstance,
parser: InstanceType,
@@ -706,10 +751,13 @@ export function buildWorksheetXml(
tabColor?: string,
columnWidths: Record = {},
rowHeights: Record = {},
+ hiddenColumns: Record = {},
+ hiddenRows: Record = {},
showGridLines?: boolean,
zoomScale?: number
) {
const normalizedRowHeights = normalizedSheetRowHeights(rowHeights);
+ const normalizedHiddenRows = normalizedSheetHiddenRows(hiddenRows);
const rows = sortedWorksheetEntries(cells, cellFormats).reduce>>((grouped, entry) => {
const rowNumber = cellRowNumber(entry[0]);
if (!grouped[rowNumber]) {
@@ -724,11 +772,17 @@ export function buildWorksheetXml(
rows[row] = [];
}
});
+ Object.keys(normalizedHiddenRows).forEach((rowNumber) => {
+ const row = positiveIntegerAttribute(rowNumber);
+ if (row && !rows[row]) {
+ rows[row] = [];
+ }
+ });
const rowXml = Object.entries(rows)
.map(([rowNumber, entries]) => {
const cellXml = entries.map(([address, value]) => buildCellXml(address, value, cellStyleId(cellFormats[address], styleRegistry))).join("");
- const rowAttributes = buildRowHeightAttributes(normalizedRowHeights[rowNumber]);
+ const rowAttributes = buildRowAttributes(normalizedRowHeights[rowNumber], normalizedHiddenRows[rowNumber]);
return cellXml ? `${cellXml}
` : `
`;
})
.join("");
@@ -739,7 +793,7 @@ export function buildWorksheetXml(
const drawingXml = drawingRelationshipId ? `` : "";
const sheetPrXml = buildSheetPrXml(tabColor);
const sheetViewsXml = buildSheetViewsXml(frozenPane, showGridLines, zoomScale);
- const colsXml = buildColumnWidthsXml(columnWidths);
+ const colsXml = buildColumnWidthsXml(columnWidths, hiddenColumns);
return xmlDeclaration(
`${sheetPrXml}${sheetViewsXml}${colsXml}${rowXml}${autoFilterXml}${mergeCellsXml}${hyperlinksXml}${drawingXml}`
@@ -835,16 +889,23 @@ export function buildSheetPrXml(tabColor?: string) {
return color ? `` : "";
}
-export function buildColumnWidthsXml(columnWidths: Record = {}) {
- const columns = normalizedSheetColumnWidths(columnWidths);
+export function buildColumnWidthsXml(columnWidths: Record = {}, hiddenColumns: Record = {}) {
+ const columnsByNumber = new Map();
+ normalizedSheetColumnWidths(columnWidths).forEach(({ column, width }) => {
+ columnsByNumber.set(column, { ...columnsByNumber.get(column), width });
+ });
+ normalizedSheetHiddenColumns(hiddenColumns).forEach((column) => {
+ columnsByNumber.set(column, { ...columnsByNumber.get(column), hidden: true });
+ });
+ const columns = Array.from(columnsByNumber.entries()).sort(([first], [second]) => first - second);
if (columns.length === 0) {
return "";
}
const xml = columns
.map(
- ({ column, width }) =>
- ``
+ ([column, options]) =>
+ ``
)
.join("");
@@ -1628,6 +1689,24 @@ function normalizedSheetRowHeights(rowHeights: Record = {}) {
}, {});
}
+function normalizedSheetHiddenColumns(hiddenColumns: Record = {}) {
+ return Object.entries(hiddenColumns)
+ .map(([column, hidden]) => (hidden ? columnAddressNumber(column) : 0))
+ .filter((column, index, columns): column is number => Boolean(column) && columns.indexOf(column) === index)
+ .sort((first, second) => first - second);
+}
+
+function normalizedSheetHiddenRows(hiddenRows: Record = {}) {
+ return Object.entries(hiddenRows).reduce>((rows, [row, hidden]) => {
+ const rowNumber = positiveIntegerAttribute(row);
+ if (rowNumber && hidden) {
+ rows[String(rowNumber)] = true;
+ }
+
+ return rows;
+ }, {});
+}
+
function normalizedSheetZoomScale(value: unknown) {
const number = Number(value);
if (!Number.isFinite(number)) {
@@ -1638,8 +1717,8 @@ function normalizedSheetZoomScale(value: unknown) {
return zoomScale >= 10 && zoomScale <= 400 && zoomScale !== 100 ? zoomScale : 0;
}
-function buildRowHeightAttributes(height?: number) {
- return height ? ` ht="${formatSheetDimension(height)}" customHeight="1"` : "";
+function buildRowAttributes(height?: number, hidden?: boolean) {
+ return `${height ? ` ht="${formatSheetDimension(height)}" customHeight="1"` : ""}${hidden ? ' hidden="1"' : ""}`;
}
function formatSheetDimension(value: number) {
diff --git a/src/types.ts b/src/types.ts
index dea0c99..7dbabbb 100644
--- a/src/types.ts
+++ b/src/types.ts
@@ -24,6 +24,8 @@ export interface Sheet {
tabColor?: string;
columnWidths?: Record;
rowHeights?: Record;
+ hiddenColumns?: Record;
+ hiddenRows?: Record;
showGridLines?: boolean;
zoomScale?: number;
printArea?: string;