fix(core): заголовок диаграммы по ECMA-376 #66

Merged
pjandro merged 2 commits from fix/chart-title-ecma into main 2026-10-27 02:48:11 +03:00
2 changed files with 101 additions and 14 deletions
Showing only changes of commit a06b988e83 - Show all commits
@@ -75,7 +75,8 @@ import java.util.Set;
final class ChartSpec { final class ChartSpec {
/** Плейсхолдер автозаголовка для графика с пустым c:title (Word подставляет /** Плейсхолдер автозаголовка для графика с пустым c:title (Word подставляет
* строку своего UI-языка — у нас русская). */ * строку своего UI-языка — у нас русская; текста плейсхолдера ECMA-376
* не определяет). */
static final String AUTO_TITLE = "Название диаграммы"; static final String AUTO_TITLE = "Название диаграммы";
/** /**
@@ -898,14 +899,24 @@ final class ChartSpec {
} }
/** /**
* Заголовок: явный текст (c:title/c:tx) или автозаголовок из имени * Заголовок: явный текст (c:title/c:tx) или автозаголовок.
* первого ряда (Word так и делает, когда c:autoTitleDeleted = 0). * {@code c:autoTitleDeleted=true} скрывает заголовок целиком, включая
* явный текст (ECMA-376 §21.2.2.7: «the title shall not be shown»;
* атрибут {@code c:val} опущен — значение по умолчанию true). Пустой
* заголовок при autoTitleDeleted=0: у круговой диаграммы с одним рядом
* — имя ряда, иначе встроенный плейсхолдер (строка UI-языка Word).
*/ */
static void readTitle(CTChart chart, ChartSpec spec, DrawMlColor colors) { static void readTitle(CTChart chart, ChartSpec spec, DrawMlColor colors) {
CTTitle t = chart.getTitle(); CTTitle t = chart.getTitle();
if (t == null) { if (t == null) {
return; return;
} }
// §21.2.2.7: удалённый автозаголовок не показывает заголовок ни при
// каких условиях — в том числе явный c:tx (устаревший текст из чужих
// шаблонов, где Word его скрывает, у нас не должен появляться).
if (chart.getAutoTitleDeleted() != null && chart.getAutoTitleDeleted().isVal()) {
return;
}
String text = null; String text = null;
CTTx tx = t.getTx(); CTTx tx = t.getTx();
if (tx != null) { if (tx != null) {
@@ -914,25 +925,26 @@ final class ChartSpec {
text = tx.getStrRef().getStrCache().getPt().get(0).getV(); text = tx.getStrRef().getStrCache().getPt().get(0).getV();
} }
if (text == null && tx.getRich() != null) { if (text == null && tx.getRich() != null) {
StringBuilder sb = new StringBuilder(); List<String> paragraphs = new ArrayList<>();
for (DrawMlText.Paragraph p : DrawMlText.paragraphs( for (DrawMlText.Paragraph p : DrawMlText.paragraphs(
tx.getRich(), colors, colors.minorFontName(), 14, Color.DARK_GRAY)) { tx.getRich(), colors, colors.minorFontName(), 14, Color.DARK_GRAY)) {
sb.append(p.text()); paragraphs.add(p.text());
} }
text = sb.toString(); // Абзацы a:p — отдельные строки; DrawMlText.paint разбивает
// по '\n' как по жёсткому переносу.
text = String.join("\n", paragraphs);
} }
} }
// Пустой c:title при autoTitleDeleted=0 — это автозаголовок Word: // Пустой c:title при autoTitleDeleted=0 — это автозаголовок Word:
// для круговых диаграмм он берётся из имени ряда, для остальных // у круговой диаграммы с ОДНИМ рядом он берётся из имени ряда
// типов рисуется встроенный плейсхолдер (в англ. эталоне Word — // (автозаголовок = имя единственного ряда), во всех остальных
// случаях рисуется встроенный плейсхолдер (в англ. эталоне Word —
// "Chart Title", у нас плейсхолдер русифицирован; в XML его нет, // "Chart Title", у нас плейсхолдер русифицирован; в XML его нет,
// Word подставляет строку из своего UI-языка). // Word подставляет строку из своего UI-языка).
boolean deleted = chart.getAutoTitleDeleted() != null if (text == null || text.isBlank()) {
&& chart.getAutoTitleDeleted().isVal();
if ((text == null || text.isBlank()) && !deleted) {
boolean circular = spec.type == Type.PIE || spec.type == Type.PIE3D boolean circular = spec.type == Type.PIE || spec.type == Type.PIE3D
|| spec.type == Type.DOUGHNUT || spec.type == Type.OF_PIE; || spec.type == Type.DOUGHNUT || spec.type == Type.OF_PIE;
if (circular && !spec.series.isEmpty()) { if (circular && spec.series.size() == 1) {
text = spec.series.get(0).name; text = spec.series.get(0).name;
} else { } else {
text = AUTO_TITLE; text = AUTO_TITLE;
@@ -109,8 +109,9 @@ import static org.junit.jupiter.api.Assertions.*;
/** /**
* Пустой c:title при autoTitleDeleted=0 — это автозаголовок Word, которого * Пустой c:title при autoTitleDeleted=0 — это автозаголовок Word, которого
* нет в XML: для круговых диаграмм он равен имени ряда, для остальных * нет в XML: у круговой диаграммы с одним рядом он равен имени ряда,
* типов это встроенный плейсхолдер. * в остальных случаях это встроенный плейсхолдер; c:autoTitleDeleted=true
* скрывает заголовок целиком, включая явный текст (ECMA-376 §21.2.2.7).
*/ */
class ChartSpecTest { class ChartSpecTest {
@@ -146,6 +147,72 @@ class ChartSpecTest {
assertNull(spec.title); assertNull(spec.title);
} }
/** c:autoTitleDeleted=true скрывает заголовок целиком, включая явный
* текст (§21.2.2.7): устаревший "Chart Title" из чужого шаблона, где
* Word его не показывает, не должен появляться и у нас. */
@Test
void deletedTitleWithText_notShown() {
ChartSpec spec = new ChartSpec();
spec.type = ChartSpec.Type.BAR;
CTChart chart = emptyTitleChart();
CTBoolean deleted = new CTBoolean();
deleted.setVal(Boolean.TRUE);
chart.setAutoTitleDeleted(deleted);
CTTx tx = new CTTx();
tx.setStrRef(strRef("Chart Title"));
chart.getTitle().setTx(tx);
ChartSpec.readTitle(chart, spec, new DrawMlColor(null));
assertNull(spec.title, "удалённый автозаголовок — явный текст не показывается");
assertNull(spec.titleStyle, "и начертание тоже");
}
/** c:autoTitleDeleted без c:val — по умолчанию true (§21.2.2.7). */
@Test
void deletedTitleValOmitted_notShown() {
ChartSpec spec = new ChartSpec();
spec.type = ChartSpec.Type.BAR;
CTChart chart = emptyTitleChart();
chart.setAutoTitleDeleted(new CTBoolean());
CTTx tx = new CTTx();
tx.setStrRef(strRef("Главный"));
chart.getTitle().setTx(tx);
ChartSpec.readTitle(chart, spec, new DrawMlColor(null));
assertNull(spec.title, "val опущен — заголовок считается удалённым");
}
/** Автозаголовок из имени ряда — только у круговой диаграммы с одним
* рядом; многорядовая кольцевая получает плейсхолдер, а не имя первого. */
@Test
void multiSeriesDoughnut_placeholderNotSeriesName() {
ChartSpec spec = new ChartSpec();
spec.type = ChartSpec.Type.DOUGHNUT;
ChartSpec.Series first = new ChartSpec.Series();
first.name = "Продажи";
ChartSpec.Series second = new ChartSpec.Series();
second.name = "План";
spec.series.add(first);
spec.series.add(second);
ChartSpec.readTitle(emptyTitleChart(), spec, new DrawMlColor(null));
assertEquals(ChartSpec.AUTO_TITLE, spec.title,
"многорядовая круговая — плейсхолдер, а не имя первого ряда");
}
/** Несколько абзацев a:p в заголовке — отдельные строки ('\n'). */
@Test
void multiParagraphTitle_joinedWithNewlines() {
ChartSpec spec = new ChartSpec();
spec.type = ChartSpec.Type.BAR;
CTChart chart = emptyTitleChart();
CTTx tx = new CTTx();
CTTextBody body = new CTTextBody();
body.getP().add(textParagraph("А"));
body.getP().add(textParagraph("B"));
tx.setRich(body);
chart.getTitle().setTx(tx);
ChartSpec.readTitle(chart, spec, new DrawMlColor(null));
assertEquals("А\nB", spec.title, "абзацы заголовка — жёсткий перенос");
}
@Test @Test
void barGapWidthAndOverlapParsed() { void barGapWidthAndOverlapParsed() {
CTBarChart chart = new CTBarChart(); CTBarChart chart = new CTBarChart();
@@ -846,6 +913,14 @@ class ChartSpecTest {
return chart; return chart;
} }
private static CTTextParagraph textParagraph(String t) {
CTTextParagraph p = new CTTextParagraph();
CTRegularTextRun run = new CTRegularTextRun();
run.setT(t);
p.getEGTextRun().add(run);
return p;
}
// ---- ветви разбора, не затронутые основными тестами ---- // ---- ветви разбора, не затронутые основными тестами ----
/** a:ln без noFill/solidFill/w и пустой solidFill — дефолты рамки сохраняются. */ /** a:ln без noFill/solidFill/w и пустой solidFill — дефолты рамки сохраняются. */