Preserve QExcell border colors

This commit is contained in:
Курнат Андрей
2026-06-01 08:00:09 +03:00
parent 56f2a4d6e4
commit 95be5e3a8a
5 changed files with 74 additions and 17 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 в текущем инкременте не заявлены.
## Сборка пакета
+34 -2
View File
@@ -67,6 +67,15 @@ const textColorSwatches = [
{ color: "7C3AED", label: "Фиолетовый текст" }
];
const borderColorSwatches = [
{ color: "", label: "Авто цвет границ" },
{ color: "202124", label: "Черные границы" },
{ color: "0F5FAE", label: "Синие границы" },
{ color: "0F766E", label: "Зеленые границы" },
{ color: "C2410C", label: "Красные границы" },
{ color: "7C3AED", label: "Фиолетовые границы" }
];
const numberFormatOptions = [
{ value: "", label: "Обычный" },
{ value: "0.00", label: "Число" },
@@ -119,6 +128,7 @@ function normalizedFillColor(value?: string) {
function normalizedCellFormat(format: CellFormat): CellFormat | undefined {
const textColor = normalizedFillColor(format.textColor);
const fillColor = normalizedFillColor(format.fillColor);
const borderColor = normalizedFillColor(format.borderColor);
const horizontalAlign = normalizedHorizontalAlign(format.horizontalAlign);
const verticalAlign = normalizedVerticalAlign(format.verticalAlign);
const numberFormat = format.numberFormat?.trim();
@@ -136,7 +146,8 @@ function normalizedCellFormat(format: CellFormat): CellFormat | undefined {
...(horizontalAlign ? { horizontalAlign } : {}),
...(verticalAlign ? { verticalAlign } : {}),
...(format.wrapText ? { wrapText: true } : {}),
...(format.border ? { border: true } : {}),
...(format.border || borderColor ? { border: true } : {}),
...(borderColor ? { borderColor } : {}),
...(numberFormat ? { numberFormat } : {})
};
@@ -159,7 +170,14 @@ function cellInputStyle(format?: CellFormat): CSSProperties {
}
function cellBoxStyle(format?: CellFormat): CSSProperties | undefined {
return format?.verticalAlign ? { verticalAlign: cssVerticalAlignValue(format.verticalAlign) } : undefined;
const style: CSSProperties = {
...(format?.verticalAlign ? { verticalAlign: cssVerticalAlignValue(format.verticalAlign) } : {}),
...(format?.border && format.borderColor
? { borderColor: `#${format.borderColor}`, boxShadow: `inset 0 0 0 1px #${format.borderColor}` }
: {})
};
return Object.keys(style).length > 0 ? style : undefined;
}
function normalizedHorizontalAlign(value?: string) {
@@ -547,6 +565,20 @@ export function QExcell({ workbook, onChange }: QExcellProps) {
>
<SquareDashed size={16} />
</button>
<div className="fill-swatches" aria-label="Цвет границ">
<SquareDashed size={16} aria-hidden="true" />
{borderColorSwatches.map((swatch) => (
<button
key={swatch.label}
className={`fill-swatch ${swatch.color ? "" : "is-empty"} ${selectedCellFormat.borderColor === swatch.color || (!selectedCellFormat.borderColor && !swatch.color) ? "is-active" : ""}`.trim()}
type="button"
onClick={() => updateCellFormat(selectedCell, { border: selectedCellFormat.border || Boolean(swatch.color), borderColor: swatch.color || undefined })}
title={swatch.label}
aria-label={swatch.label}
style={swatch.color ? { backgroundColor: `#${swatch.color}` } : undefined}
/>
))}
</div>
{horizontalAlignOptions.map((option) => {
const Icon = option.icon;
const isActive = selectedCellFormat.horizontalAlign === option.value;
+15 -4
View File
@@ -188,7 +188,7 @@ describe("excellOffice OOXML helpers", () => {
id: "sheet-1",
name: "Sheet 1",
cells: { A1: "Bordered" },
cellFormats: { A1: { border: true } }
cellFormats: { A1: { border: true, borderColor: "C2410C" } }
}
]
});
@@ -201,6 +201,7 @@ describe("excellOffice OOXML helpers", () => {
expect(stylesXml).toContain('<right style="thin">');
expect(stylesXml).toContain('<top style="thin">');
expect(stylesXml).toContain('<bottom style="thin">');
expect(stylesXml).toContain('<color rgb="FFC2410C"/>');
});
it("читает базовое форматирование ячеек XLSX из styles.xml и XML листа", () => {
@@ -216,7 +217,15 @@ describe("excellOffice OOXML helpers", () => {
fill: [{}, {}, { patternFill: { fgColor: { rgb: "FFFFF2CC" } } }]
},
borders: {
border: [{}, { left: { style: "thin" }, right: { style: "thin" }, top: { style: "thin" }, bottom: { style: "thin" } }]
border: [
{},
{
left: { style: "thin", color: { rgb: "FFC2410C" } },
right: { style: "thin", color: { rgb: "FFC2410C" } },
top: { style: "thin", color: { rgb: "FFC2410C" } },
bottom: { style: "thin", color: { rgb: "FFC2410C" } }
}
]
},
cellXfs: {
xf: [
@@ -241,6 +250,7 @@ describe("excellOffice OOXML helpers", () => {
verticalAlign: "middle",
wrapText: true,
border: true,
borderColor: "C2410C",
numberFormat: "dd.mm.yyyy"
});
expect(styleTable[2]).toEqual({ numberFormat: "m/d/yy" });
@@ -272,6 +282,7 @@ describe("excellOffice OOXML helpers", () => {
verticalAlign: "middle",
wrapText: true,
border: true,
borderColor: "C2410C",
numberFormat: "dd.mm.yyyy"
}
});
@@ -473,7 +484,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, border: true },
A1: { bold: true, strike: true, fontSize: 14, fontFamily: "Arial", textColor: "0F5FAE", fillColor: "FFF2CC", horizontalAlign: "center", verticalAlign: "middle", wrapText: true, border: true, borderColor: "C2410C" },
AC20: { underline: true },
D20: { numberFormat: "dd.mm.yyyy" },
E20: { numberFormat: "0%" }
@@ -507,7 +518,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, border: true },
A1: { bold: true, strike: true, fontSize: 14, fontFamily: "Arial", textColor: "0F5FAE", fillColor: "FFF2CC", horizontalAlign: "center", verticalAlign: "middle", wrapText: true, border: true, borderColor: "C2410C" },
AC20: { underline: true },
D20: { numberFormat: "dd.mm.yyyy" },
E20: { numberFormat: "0%" }
+22 -9
View File
@@ -874,6 +874,7 @@ function buildStylesXml(styleRegistry = createCellStyleRegistry([])) {
const borders = [baseBorderXml()];
const fontIdsByKey: Record<string, number> = {};
const fillIdsByColor: Record<string, number> = {};
const borderIdsByColor: Record<string, number> = {};
const numberFormatIdsByCode: Record<string, number> = {};
const customNumberFormats: Array<[number, string]> = [];
@@ -899,9 +900,11 @@ function buildStylesXml(styleRegistry = createCellStyleRegistry([])) {
let borderId = 0;
if (format.border) {
borderId = 1;
if (borders.length === 1) {
borders.push(formatBorderXml());
const borderKey = format.borderColor || "auto";
borderId = borderIdsByColor[borderKey] ?? borders.length;
if (!borderIdsByColor[borderKey]) {
borderIdsByColor[borderKey] = borderId;
borders.push(formatBorderXml(format.borderColor));
}
}
@@ -966,7 +969,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.border ? "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.borderColor ?? ""}|${normalized.numberFormat ?? ""}`;
}
function fontStyleKey(format: CellFormat) {
@@ -978,6 +981,7 @@ function fontStyleKey(format: CellFormat) {
function normalizedCellFormat(format: CellFormat | undefined): CellFormat | null {
const textColor = normalizeFillColor(format?.textColor);
const fillColor = normalizeFillColor(format?.fillColor);
const borderColor = normalizeFillColor(format?.borderColor);
const horizontalAlign = normalizedHorizontalAlign(format?.horizontalAlign);
const verticalAlign = normalizedVerticalAlign(format?.verticalAlign);
const numberFormat = normalizedNumberFormat(format?.numberFormat);
@@ -995,7 +999,8 @@ function normalizedCellFormat(format: CellFormat | undefined): CellFormat | null
...(horizontalAlign ? { horizontalAlign } : {}),
...(verticalAlign ? { verticalAlign } : {}),
...(format?.wrapText ? { wrapText: true } : {}),
...(format?.border ? { border: true } : {}),
...(format?.border || borderColor ? { border: true } : {}),
...(borderColor ? { borderColor } : {}),
...(numberFormat ? { numberFormat } : {})
};
@@ -1028,12 +1033,19 @@ function fillXmlToCellFormat(fill: unknown): CellFormat {
function borderXmlToCellFormat(border: unknown): CellFormat {
const record = asRecord(border);
const hasBorder = ["left", "right", "top", "bottom"].some((side) => {
const borderedSides = ["left", "right", "top", "bottom"].filter((side) => {
const style = String(childRecord(record, side).style || childRecord(record, side)["@_style"] || "").trim().toLowerCase();
return style && style !== "none";
});
return hasBorder ? { border: true } : {};
const borderColor = borderedSides
.map((side) => normalizeFillColor(String(childRecord(childRecord(record, side), "color").rgb || "")))
.find(Boolean);
return normalizedCellFormat({
border: borderedSides.length > 0,
...(borderColor ? { borderColor } : {})
}) ?? {};
}
function baseFontXml() {
@@ -1054,8 +1066,9 @@ 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 formatBorderXml(borderColor = "") {
const colorXml = borderColor ? `<color rgb="FF${borderColor}"/>` : '<color auto="1"/>';
return `<border><left style="thin">${colorXml}</left><right style="thin">${colorXml}</right><top style="thin">${colorXml}</top><bottom style="thin">${colorXml}</bottom><diagonal/></border>`;
}
function normalizeFillColor(value?: string) {
+1
View File
@@ -38,6 +38,7 @@ export interface CellFormat {
verticalAlign?: "top" | "middle" | "bottom";
wrapText?: boolean;
border?: boolean;
borderColor?: string;
numberFormat?: string;
}