Preserve QExcell cell borders

This commit is contained in:
Курнат Андрей
2026-06-01 07:55:45 +03:00
parent 27eae3afac
commit 56f2a4d6e4
6 changed files with 90 additions and 10 deletions
+2 -2
View File
@@ -32,7 +32,7 @@ npm run build
## Поддержка форматов
- QWord открывает `.docx` и сохраняет `.docx`; при импорте базовых DOCX-абзацев читает выравнивание, внешние гиперссылки, явные цвета текста, подсветку, размер и семейство шрифта из OOXML, а при экспорте DOCX сохраняются заголовки, абзацы, выравнивание абзацев, списки, простые таблицы, внешние гиперссылки, базовые растровые изображения и базовое inline-форматирование текста: полужирный, курсив, подчеркивание, зачеркивание, цвет текста, подсветка, размер и семейство шрифта.
- QExcell открывает `.xlsx` и сохраняет `.xlsx`; сетка расширяется по фактически заполненным ячейкам, поддерживает несколько листов, формулы за пределами стартового диапазона A-H, базовые merged cells, внешние гиперссылки ячеек, базовые диаграммы листа и базовое форматирование ячеек: полужирный, курсив, подчеркивание, зачеркивание, размер и семейство шрифта, цвет текста, заливку, горизонтальное и вертикальное выравнивание, перенос текста и числовые форматы XLSX для дат, процентов, денежных и дробных значений.
- QExcell открывает `.xlsx` и сохраняет `.xlsx`; сетка расширяется по фактически заполненным ячейкам, поддерживает несколько листов, формулы за пределами стартового диапазона A-H, базовые merged cells, внешние гиперссылки ячеек, базовые диаграммы листа и базовое форматирование ячеек: полужирный, курсив, подчеркивание, зачеркивание, размер и семейство шрифта, цвет текста, заливку, горизонтальное и вертикальное выравнивание, перенос текста, границы ячеек и числовые форматы XLSX для дат, процентов, денежных и дробных значений.
- QPowerPoint открывает `.pptx` и сохраняет `.pptx`; импорт учитывает порядок слайдов из `presentation.xml`, читает заметки докладчика через relationships слайда, сохраняет заметки докладчика, базовые растровые изображения слайдов, пользовательский цвет фона слайда, а также цвет, размер и семейство шрифта текста заголовка/подзаголовка.
- QOutlook открывает `.eml` и одиночные сообщения Outlook `.msg`, сохраняет письма в `.eml`; импорт EML поддерживает простые текстовые письма, `multipart/alternative`, `multipart/mixed`, `text/plain`, fallback из `text/html` в читаемый текст, base64, quoted-printable, MIME-вложения, `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:color`, `w:shd`, `w:highlight`, `w:sz`, `w:rFonts` и `w:strike` для цвета/подсветки/размера/семейства/зачеркивания текста DOCX, выравнивание абзацев DOCX, внешние гиперссылки DOCX/XLSX, базовые растровые изображения DOCX/PPTX, простые таблицы, несколько листов XLSX, ячейки, формулы, базовые merged cells, базовые стили, цвета текста, размеры и семейства шрифта, зачеркивание ячеек, горизонтальное и вертикальное выравнивание и перенос текста ячеек, числовые форматы и простые bar/line/pie диаграммы ячеек XLSX, текстовые слайды PPTX, пользовательский фон слайдов PPTX, цвет, размер и семейство шрифта текста заголовка/подзаголовка PPTX, импорт и экспорт заметок докладчика, адресацию `To/Cc/Bcc`, MIME-вложения EML и базовые поля одиночных MSG-писем. Сложные стили, макросы, сложные диаграммы, сложное позиционирование и обтекание изображений, PST, экспорт MSG и полная fidelity документов Microsoft Office в текущем инкременте не заявлены.
Импорт и экспорт реализуют базовую совместимость с Office Open XML, EML и чтением MSG: текст, базовое inline-форматирование, явные `w:color`, `w:shd`, `w:highlight`, `w:sz`, `w:rFonts` и `w:strike` для цвета/подсветки/размера/семейства/зачеркивания текста DOCX, выравнивание абзацев DOCX, внешние гиперссылки DOCX/XLSX, базовые растровые изображения DOCX/PPTX, простые таблицы, несколько листов XLSX, ячейки, формулы, базовые merged cells, базовые стили, цвета текста, размеры и семейства шрифта, зачеркивание ячеек, горизонтальное и вертикальное выравнивание, перенос текста и границы ячеек, числовые форматы и простые bar/line/pie диаграммы ячеек XLSX, текстовые слайды PPTX, пользовательский фон слайдов PPTX, цвет, размер и семейство шрифта текста заголовка/подзаголовка PPTX, импорт и экспорт заметок докладчика, адресацию `To/Cc/Bcc`, MIME-вложения EML и базовые поля одиночных MSG-писем. Сложные стили, макросы, сложные диаграммы, сложное позиционирование и обтекание изображений, PST, экспорт MSG и полная fidelity документов Microsoft Office в текущем инкременте не заявлены.
## Сборка пакета
+13 -2
View File
@@ -22,6 +22,7 @@ import {
Plus,
Save,
Sigma,
SquareDashed,
Strikethrough,
Trash2,
Type,
@@ -135,6 +136,7 @@ function normalizedCellFormat(format: CellFormat): CellFormat | undefined {
...(horizontalAlign ? { horizontalAlign } : {}),
...(verticalAlign ? { verticalAlign } : {}),
...(format.wrapText ? { wrapText: true } : {}),
...(format.border ? { border: true } : {}),
...(numberFormat ? { numberFormat } : {})
};
@@ -286,7 +288,7 @@ export function QExcell({ workbook, onChange }: QExcellProps) {
});
}
function toggleSelectedFormat(key: "bold" | "italics" | "underline" | "strike" | "wrapText") {
function toggleSelectedFormat(key: "bold" | "italics" | "underline" | "strike" | "wrapText" | "border") {
updateCellFormat(selectedCell, { [key]: !selectedCellFormat[key] });
}
@@ -536,6 +538,15 @@ export function QExcell({ workbook, onChange }: QExcellProps) {
>
<Strikethrough size={16} />
</button>
<button
className={`icon-button format-toggle ${selectedCellFormat.border ? "is-active" : ""}`.trim()}
type="button"
onClick={() => toggleSelectedFormat("border")}
title="Границы ячейки"
aria-label="Границы ячейки"
>
<SquareDashed size={16} />
</button>
{horizontalAlignOptions.map((option) => {
const Icon = option.icon;
const isActive = selectedCellFormat.horizontalAlign === option.value;
@@ -691,7 +702,7 @@ export function QExcell({ workbook, onChange }: QExcellProps) {
return (
<td
key={id}
className={`${selectedCell === id ? "is-selected" : ""} ${merge ? "is-merged" : ""} ${hyperlink ? "is-linked" : ""} ${cellFormat ? "is-formatted" : ""} ${cellFormat?.wrapText ? "is-wrapped" : ""} ${cellFormat?.verticalAlign ? `is-valign-${cellFormat.verticalAlign}` : ""}`.trim()}
className={`${selectedCell === id ? "is-selected" : ""} ${merge ? "is-merged" : ""} ${hyperlink ? "is-linked" : ""} ${cellFormat ? "is-formatted" : ""} ${cellFormat?.wrapText ? "is-wrapped" : ""} ${cellFormat?.border ? "is-bordered" : ""} ${cellFormat?.verticalAlign ? `is-valign-${cellFormat.verticalAlign}` : ""}`.trim()}
style={cellBoxStyle(cellFormat)}
colSpan={merge?.columnSpan}
rowSpan={merge?.rowSpan}
+34 -3
View File
@@ -177,6 +177,32 @@ describe("excellOffice OOXML helpers", () => {
expect(stylesXml).toContain('vertical="center"');
});
it("записывает границы ячейки XLSX в styles.xml", async () => {
const blob = await exportXlsxBlob({
id: "workbook",
title: "Borders.xlsx",
updatedAt: "2026-06-01T00:00:00.000Z",
activeSheet: "sheet-1",
sheets: [
{
id: "sheet-1",
name: "Sheet 1",
cells: { A1: "Bordered" },
cellFormats: { A1: { border: true } }
}
]
});
const zip = await JSZip.loadAsync(await blob.arrayBuffer());
const stylesXml = await zip.file("xl/styles.xml")?.async("string");
expect(stylesXml).toContain('<borders count="2">');
expect(stylesXml).toContain('applyBorder="1"');
expect(stylesXml).toContain('<left style="thin">');
expect(stylesXml).toContain('<right style="thin">');
expect(stylesXml).toContain('<top style="thin">');
expect(stylesXml).toContain('<bottom style="thin">');
});
it("читает базовое форматирование ячеек XLSX из styles.xml и XML листа", () => {
const styleTable = xlsxStylesXmlToCellFormatTable({
styleSheet: {
@@ -189,10 +215,13 @@ describe("excellOffice OOXML helpers", () => {
fills: {
fill: [{}, {}, { patternFill: { fgColor: { rgb: "FFFFF2CC" } } }]
},
borders: {
border: [{}, { left: { style: "thin" }, right: { style: "thin" }, top: { style: "thin" }, bottom: { style: "thin" } }]
},
cellXfs: {
xf: [
{ fontId: "0", fillId: "0" },
{ fontId: "1", fillId: "2", numFmtId: "164", alignment: { horizontal: "center", vertical: "center", wrapText: "1" } },
{ fontId: "1", fillId: "2", borderId: "1", numFmtId: "164", alignment: { horizontal: "center", vertical: "center", wrapText: "1" } },
{ fontId: "0", fillId: "0", numFmtId: "14" }
]
}
@@ -211,6 +240,7 @@ describe("excellOffice OOXML helpers", () => {
horizontalAlign: "center",
verticalAlign: "middle",
wrapText: true,
border: true,
numberFormat: "dd.mm.yyyy"
});
expect(styleTable[2]).toEqual({ numberFormat: "m/d/yy" });
@@ -241,6 +271,7 @@ describe("excellOffice OOXML helpers", () => {
horizontalAlign: "center",
verticalAlign: "middle",
wrapText: true,
border: true,
numberFormat: "dd.mm.yyyy"
}
});
@@ -442,7 +473,7 @@ describe("excellOffice OOXML helpers", () => {
mergedCells: [{ start: "A1", end: "C1" }],
hyperlinks: { A1: "https://example.com/budget" },
cellFormats: {
A1: { bold: true, strike: true, fontSize: 14, fontFamily: "Arial", textColor: "0F5FAE", fillColor: "FFF2CC", horizontalAlign: "center", verticalAlign: "middle", wrapText: true },
A1: { bold: true, strike: true, fontSize: 14, fontFamily: "Arial", textColor: "0F5FAE", fillColor: "FFF2CC", horizontalAlign: "center", verticalAlign: "middle", wrapText: true, border: true },
AC20: { underline: true },
D20: { numberFormat: "dd.mm.yyyy" },
E20: { numberFormat: "0%" }
@@ -476,7 +507,7 @@ describe("excellOffice OOXML helpers", () => {
expect(imported.sheets[0].mergedCells).toEqual([{ start: "A1", end: "C1" }]);
expect(imported.sheets[0].hyperlinks).toEqual({ A1: "https://example.com/budget" });
expect(imported.sheets[0].cellFormats).toEqual({
A1: { bold: true, strike: true, fontSize: 14, fontFamily: "Arial", textColor: "0F5FAE", fillColor: "FFF2CC", horizontalAlign: "center", verticalAlign: "middle", wrapText: true },
A1: { bold: true, strike: true, fontSize: 14, fontFamily: "Arial", textColor: "0F5FAE", fillColor: "FFF2CC", horizontalAlign: "center", verticalAlign: "middle", wrapText: true, border: true },
AC20: { underline: true },
D20: { numberFormat: "dd.mm.yyyy" },
E20: { numberFormat: "0%" }
+35 -3
View File
@@ -844,11 +844,13 @@ export function xlsxStylesXmlToCellFormatTable(stylesXml?: unknown): Array<CellF
const numberFormats = xlsxNumberFormats(styleSheet);
const fonts = toArray(childRecord(styleSheet, "fonts").font).map(fontXmlToCellFormat);
const fills = toArray(childRecord(styleSheet, "fills").fill).map(fillXmlToCellFormat);
const borders = toArray(childRecord(styleSheet, "borders").border).map(borderXmlToCellFormat);
return toArray(childRecord(styleSheet, "cellXfs").xf).map((xf) => {
const record = asRecord(xf);
const fontFormat = fonts[numberAttribute(record.fontId)];
const fillFormat = fills[numberAttribute(record.fillId)];
const borderFormat = borders[numberAttribute(record.borderId)];
const numberFormat = normalizedNumberFormat(numberFormats[numberAttribute(record.numFmtId)]);
const alignment = childRecord(record, "alignment");
const horizontalAlign = normalizedHorizontalAlign(String(alignment.horizontal || ""));
@@ -857,6 +859,7 @@ export function xlsxStylesXmlToCellFormatTable(stylesXml?: unknown): Array<CellF
return normalizedCellFormat({
...fontFormat,
...fillFormat,
...borderFormat,
...(horizontalAlign ? { horizontalAlign } : {}),
...(verticalAlign ? { verticalAlign } : {}),
...(wrapText ? { wrapText: true } : {}),
@@ -868,6 +871,7 @@ export function xlsxStylesXmlToCellFormatTable(stylesXml?: unknown): Array<CellF
function buildStylesXml(styleRegistry = createCellStyleRegistry([])) {
const fonts = [baseFontXml()];
const fills = ['<fill><patternFill patternType="none"/></fill>', '<fill><patternFill patternType="gray125"/></fill>'];
const borders = [baseBorderXml()];
const fontIdsByKey: Record<string, number> = {};
const fillIdsByColor: Record<string, number> = {};
const numberFormatIdsByCode: Record<string, number> = {};
@@ -893,6 +897,14 @@ function buildStylesXml(styleRegistry = createCellStyleRegistry([])) {
}
}
let borderId = 0;
if (format.border) {
borderId = 1;
if (borders.length === 1) {
borders.push(formatBorderXml());
}
}
let numFmtId = 0;
if (format.numberFormat) {
numFmtId = numberFormatIdsByCode[format.numberFormat] ?? customNumberFormatStartId + customNumberFormats.length;
@@ -904,6 +916,7 @@ function buildStylesXml(styleRegistry = createCellStyleRegistry([])) {
const applyFont = fontId > 0 ? ' applyFont="1"' : "";
const applyFill = fillId > 0 ? ' applyFill="1"' : "";
const applyBorder = borderId > 0 ? ' applyBorder="1"' : "";
const applyAlignment = format.horizontalAlign || format.verticalAlign || format.wrapText ? ' applyAlignment="1"' : "";
const applyNumberFormat = numFmtId > 0 ? ' applyNumberFormat="1"' : "";
const alignmentAttributes = [
@@ -914,7 +927,7 @@ function buildStylesXml(styleRegistry = createCellStyleRegistry([])) {
.filter(Boolean)
.join(" ");
const alignmentXml = alignmentAttributes ? `<alignment ${alignmentAttributes}/>` : "";
return `<xf numFmtId="${numFmtId}" fontId="${fontId}" fillId="${fillId}" borderId="0" xfId="0"${applyFont}${applyFill}${applyAlignment}${applyNumberFormat}>${alignmentXml}</xf>`;
return `<xf numFmtId="${numFmtId}" fontId="${fontId}" fillId="${fillId}" borderId="${borderId}" xfId="0"${applyFont}${applyFill}${applyBorder}${applyAlignment}${applyNumberFormat}>${alignmentXml}</xf>`;
});
const numFmtsXml =
@@ -925,7 +938,7 @@ function buildStylesXml(styleRegistry = createCellStyleRegistry([])) {
: "";
return xmlDeclaration(
`<styleSheet xmlns="http://schemas.openxmlformats.org/spreadsheetml/2006/main">${numFmtsXml}<fonts count="${fonts.length}">${fonts.join("")}</fonts><fills count="${fills.length}">${fills.join("")}</fills><borders count="1"><border><left/><right/><top/><bottom/><diagonal/></border></borders><cellStyleXfs count="1"><xf numFmtId="0" fontId="0" fillId="0" borderId="0"/></cellStyleXfs><cellXfs count="${cellXfs.length + 1}"><xf numFmtId="0" fontId="0" fillId="0" borderId="0" xfId="0"/>${cellXfs.join("")}</cellXfs><cellStyles count="1"><cellStyle name="Normal" xfId="0" builtinId="0"/></cellStyles></styleSheet>`
`<styleSheet xmlns="http://schemas.openxmlformats.org/spreadsheetml/2006/main">${numFmtsXml}<fonts count="${fonts.length}">${fonts.join("")}</fonts><fills count="${fills.length}">${fills.join("")}</fills><borders count="${borders.length}">${borders.join("")}</borders><cellStyleXfs count="1"><xf numFmtId="0" fontId="0" fillId="0" borderId="0"/></cellStyleXfs><cellXfs count="${cellXfs.length + 1}"><xf numFmtId="0" fontId="0" fillId="0" borderId="0" xfId="0"/>${cellXfs.join("")}</cellXfs><cellStyles count="1"><cellStyle name="Normal" xfId="0" builtinId="0"/></cellStyles></styleSheet>`
);
}
@@ -953,7 +966,7 @@ function cellFormatKey(format: CellFormat | undefined) {
return "";
}
return `${normalized.bold ? "1" : "0"}|${normalized.italics ? "1" : "0"}|${normalized.underline ? "1" : "0"}|${normalized.strike ? "1" : "0"}|${normalized.fontSize ?? ""}|${normalized.fontFamily ?? ""}|${normalized.textColor ?? ""}|${normalized.fillColor ?? ""}|${normalized.horizontalAlign ?? ""}|${normalized.verticalAlign ?? ""}|${normalized.wrapText ? "1" : "0"}|${normalized.numberFormat ?? ""}`;
return `${normalized.bold ? "1" : "0"}|${normalized.italics ? "1" : "0"}|${normalized.underline ? "1" : "0"}|${normalized.strike ? "1" : "0"}|${normalized.fontSize ?? ""}|${normalized.fontFamily ?? ""}|${normalized.textColor ?? ""}|${normalized.fillColor ?? ""}|${normalized.horizontalAlign ?? ""}|${normalized.verticalAlign ?? ""}|${normalized.wrapText ? "1" : "0"}|${normalized.border ? "1" : "0"}|${normalized.numberFormat ?? ""}`;
}
function fontStyleKey(format: CellFormat) {
@@ -982,6 +995,7 @@ function normalizedCellFormat(format: CellFormat | undefined): CellFormat | null
...(horizontalAlign ? { horizontalAlign } : {}),
...(verticalAlign ? { verticalAlign } : {}),
...(format?.wrapText ? { wrapText: true } : {}),
...(format?.border ? { border: true } : {}),
...(numberFormat ? { numberFormat } : {})
};
@@ -1012,6 +1026,16 @@ function fillXmlToCellFormat(fill: unknown): CellFormat {
return fillColor ? { fillColor } : {};
}
function borderXmlToCellFormat(border: unknown): CellFormat {
const record = asRecord(border);
const hasBorder = ["left", "right", "top", "bottom"].some((side) => {
const style = String(childRecord(record, side).style || childRecord(record, side)["@_style"] || "").trim().toLowerCase();
return style && style !== "none";
});
return hasBorder ? { border: true } : {};
}
function baseFontXml() {
return '<font><sz val="11"/><color theme="1"/><name val="Calibri"/><family val="2"/></font>';
}
@@ -1026,6 +1050,14 @@ function formatFillXml(fillColor: string) {
return `<fill><patternFill patternType="solid"><fgColor rgb="FF${fillColor}"/><bgColor indexed="64"/></patternFill></fill>`;
}
function baseBorderXml() {
return "<border><left/><right/><top/><bottom/><diagonal/></border>";
}
function formatBorderXml() {
return '<border><left style="thin"><color auto="1"/></left><right style="thin"><color auto="1"/></right><top style="thin"><color auto="1"/></top><bottom style="thin"><color auto="1"/></bottom><diagonal/></border>';
}
function normalizeFillColor(value?: string) {
const raw = value?.trim().replace(/^#/, "").toUpperCase() ?? "";
if (/^[0-9A-F]{8}$/.test(raw)) {
+5
View File
@@ -732,6 +732,11 @@ button {
height: 58px;
}
.sheet-grid td.is-bordered {
border-color: #334155;
box-shadow: inset 0 0 0 1px #334155;
}
.sheet-grid td.is-valign-top input {
padding-top: 0;
padding-bottom: 8px;
+1
View File
@@ -37,6 +37,7 @@ export interface CellFormat {
horizontalAlign?: "left" | "center" | "right";
verticalAlign?: "top" | "middle" | "bottom";
wrapText?: boolean;
border?: boolean;
numberFormat?: string;
}