chart: заголовок по MS-OI29500 — автозаголовок из имени ряда для любого типа, autoTitleDeleted только при отсутствии c:title
PR checks / web (pull_request) Successful in 32s
PR checks / java (pull_request) Successful in 1m0s
Main: tests, deploy, autotests / web (push) Successful in 32s
Main: tests, deploy, autotests / java (push) Successful in 57s
Main: tests, deploy, autotests / images-web (push) Successful in 29s
Main: tests, deploy, autotests / images-app (push) Successful in 43s
Main: tests, deploy, autotests / deploy (push) Successful in 1m34s
Main: tests, deploy, autotests / autotests (push) Failing after 2m1s
Main: tests, deploy, autotests / rollback (push) Successful in 3m10s

- readTitle: пустой/пробельный c:title (или val=0 без c:title) — автозаголовок
  Office (MS-OI29500 §2.1.1561(a)): одиночный ряд с именем → имя ряда любого
  типа графика, иначе плейсхолдер; раньше имя ряда — только у круговых
- autoTitleDeleted (§21.2.2.7) применяется только при отсутствии c:title
  (MS-OI29500 §2.1.1431(a)) — явный заголовок показывается при любом флаге
- регрессии ChartSpecTest: emptyTitleSingleSeriesBar_usesSeriesName,
  deletedTitleWithText_stillShown, deletedTitleValOmitted_stillShown,
  noTitleElement_*; AGENTS.md приведён в соответствие
This commit was merged in pull request #70.
This commit is contained in:
Pjandro
2026-10-28 05:18:02 +00:00
parent 8de839f375
commit e929c6ade7
3 changed files with 123 additions and 44 deletions
@@ -79,6 +79,9 @@ final class ChartSpec {
* не определяет). */
static final String AUTO_TITLE = "Название диаграммы";
/** Порог «одиночный ряд» для автозаголовка (MS-OI29500 §2.1.1561(a)). */
private static final int SINGLE_SERIES = 1;
/**
* Верхняя граница индекса точки ({@code c:pt/@idx}, ECMA-376 §21.2.2.150/.151) и
* счётчика ({@code c:ptCount}, §21.2.2.152): оба — ST_UnsignedInt без верхней
@@ -900,23 +903,33 @@ final class ChartSpec {
/**
* Заголовок: явный текст (c:title/c:tx) или автозаголовок.
* {@code c:autoTitleDeleted=true} скрывает заголовок целиком, включая
* явный текст (ECMA-376 §21.2.2.7: «the title shall not be shown»;
* атрибут {@code c:val} опущен — значение по умолчанию true). Пустой
* заголовок при autoTitleDeleted=0: у круговой диаграммы с одним рядом
* — имя ряда, иначе встроенный плейсхолдер (строка UI-языка Word).
* MS-OI29500 §2.1.1431(a): в Office {@code c:autoTitleDeleted}
* (ECMA-376 §21.2.2.7, {@code val} опущен — default true) применяется
* ТОЛЬКО когда {@code c:title} у графика отсутствует — явный заголовок
* показывается при любом флаге. Пустой/пробельный {@code c:title} —
* автозаголовок Office (MS-OI29500 §2.1.1561(a)): одиночный ряд с именем
* → имя ряда (любой тип графика), иначе — локализованный плейсхолдер.
* Регрессии — ChartSpecTest#emptyTitleSingleSeriesBar_usesSeriesName,
* #deletedTitleWithText_stillShown.
*/
static void readTitle(CTChart chart, ChartSpec spec, DrawMlColor colors) {
CTTitle t = chart.getTitle();
// §21.2.2.7: val опущен — true.
boolean autoDeleted = chart.getAutoTitleDeleted() == null
|| chart.getAutoTitleDeleted().isVal();
if (t == null) {
// §2.1.1431(a): флаг имеет смысл только при отсутствии c:title;
// val=0 — автозаголовок не удалён, он рисуется.
if (autoDeleted) {
return;
}
spec.title = autoTitleText(spec);
spec.titleStyle = DrawMlText.defaultStyle(null, colors,
colors.minorFontName(), 14, new Color(0x59, 0x59, 0x59));
return;
}
// §21.2.2.7: удалённый автозаголовок не показывает заголовок ни при
// каких условиях — в том числе явный c:tx (устаревший текст из чужих
// шаблонов, где Word его скрывает, у нас не должен появляться).
if (chart.getAutoTitleDeleted() != null && chart.getAutoTitleDeleted().isVal()) {
return;
}
// §2.1.1431(a): при наличии c:title Office игнорирует autoTitleDeleted —
// явный текст показывается всегда.
String text = null;
CTTx tx = t.getTx();
if (tx != null) {
@@ -935,29 +948,27 @@ final class ChartSpec {
text = String.join("\n", paragraphs);
}
}
// Пустой c:title при autoTitleDeleted=0 — это автозаголовок Word:
// у круговой диаграммы с ОДНИМ рядом он берётся из имени ряда
// (автозаголовок = имя единственного ряда), во всех остальных
// случаях рисуется встроенный плейсхолдер (в англ. эталоне Word —
// "Chart Title", у нас плейсхолдер русифицирован; в XML его нет,
// Word подставляет строку из своего UI-языка).
// Пустой/пробельный c:title — автозаголовок Office (§2.1.1561(a)).
if (text == null || text.isBlank()) {
boolean circular = spec.type == Type.PIE || spec.type == Type.PIE3D
|| spec.type == Type.DOUGHNUT || spec.type == Type.OF_PIE;
if (circular && spec.series.size() == 1) {
text = spec.series.get(0).name;
} else {
text = AUTO_TITLE;
}
}
if (text == null || text.isBlank()) {
return;
text = autoTitleText(spec);
}
spec.title = text;
spec.titleStyle = DrawMlText.defaultStyle(t.getTxPr(), colors,
colors.minorFontName(), 14, new Color(0x59, 0x59, 0x59));
}
/** Автозаголовок Office (§2.1.1561(a)): одиночный ряд с именем → имя ряда,
* иначе локализованный плейсхолдер. Круговые — частный случай, не отдельное правило. */
private static String autoTitleText(ChartSpec spec) {
if (spec.series.size() == SINGLE_SERIES) {
String name = spec.series.get(0).name;
if (name != null && !name.isBlank()) {
return name;
}
}
return AUTO_TITLE;
}
private static AxisSpec readAxis(Object ax, DrawMlColor colors) {
AxisSpec a = new AxisSpec();
CTScaling scaling;
@@ -135,8 +135,10 @@ class ChartSpecTest {
assertEquals("Продажи", spec.title);
}
/** MS-OI29500 §2.1.1431(a): при наличии c:title флаг autoTitleDeleted
* игнорируется — пустой заголовок получает автозаголовок (плейсхолдер). */
@Test
void deletedAutoTitleLeavesChartWithoutTitle() {
void emptyTitleWithDeletedFlag_placeholderShown() {
ChartSpec spec = new ChartSpec();
spec.type = ChartSpec.Type.LINE;
CTChart chart = emptyTitleChart();
@@ -144,14 +146,27 @@ class ChartSpecTest {
deleted.setVal(Boolean.TRUE);
chart.setAutoTitleDeleted(deleted);
ChartSpec.readTitle(chart, spec, new DrawMlColor(null));
assertEquals(ChartSpec.AUTO_TITLE, spec.title,
"флаг применяется только при отсутствии c:title");
}
/** c:title отсутствует + autoTitleDeleted=true — автозаголовок удалён, заголовка нет. */
@Test
void noTitleElement_deleted_noTitle() {
ChartSpec spec = new ChartSpec();
CTChart chart = new CTChart();
CTBoolean deleted = new CTBoolean();
deleted.setVal(Boolean.TRUE);
chart.setAutoTitleDeleted(deleted);
ChartSpec.readTitle(chart, spec, new DrawMlColor(null));
assertNull(spec.title);
}
/** c:autoTitleDeleted=true скрывает заголовок целиком, включая явный
* текст (§21.2.2.7): устаревший "Chart Title" из чужого шаблона, где
* Word его не показывает, не должен появляться и у нас. */
/** MS-OI29500 §2.1.1431(a): в Office autoTitleDeleted применяется только
* когда c:title отсутствует — явный текст показывается при любом флаге
* (устаревший "Chart Title" из чужого шаблона Word рисует, и мы рисуем). */
@Test
void deletedTitleWithText_notShown() {
void deletedTitleWithText_stillShown() {
ChartSpec spec = new ChartSpec();
spec.type = ChartSpec.Type.BAR;
CTChart chart = emptyTitleChart();
@@ -162,13 +177,14 @@ class ChartSpecTest {
tx.setStrRef(strRef("Chart Title"));
chart.getTitle().setTx(tx);
ChartSpec.readTitle(chart, spec, new DrawMlColor(null));
assertNull(spec.title, "удалённый автозаголовок — явный текст не показывается");
assertNull(spec.titleStyle, "и начертание тоже");
assertEquals("Chart Title", spec.title, "при наличии c:title флаг не применяется");
assertNotNull(spec.titleStyle);
}
/** c:autoTitleDeleted без c:val — по умолчанию true (§21.2.2.7). */
/** c:autoTitleDeleted без c:val — по умолчанию true (§21.2.2.7), но при
* наличии c:title флаг игнорируется (MS-OI29500 §2.1.1431(a)). */
@Test
void deletedTitleValOmitted_notShown() {
void deletedTitleValOmitted_stillShown() {
ChartSpec spec = new ChartSpec();
spec.type = ChartSpec.Type.BAR;
CTChart chart = emptyTitleChart();
@@ -177,11 +193,54 @@ class ChartSpecTest {
tx.setStrRef(strRef("Главный"));
chart.getTitle().setTx(tx);
ChartSpec.readTitle(chart, spec, new DrawMlColor(null));
assertNull(spec.title, "val опущен — заголовок считается удалённым");
assertEquals("Главный", spec.title, "val опущен, но c:title есть — показывается");
}
/** Автозаголовок из имени ряда — только у круговой диаграммы с одним
* рядом; многорядовая кольцевая получает плейсхолдер, а не имя первого. */
/** MS-OI29500 §2.1.1561(a): автозаголовок = имя единственного ряда для
* ЛЮБОГО типа графика, не только кругового — пустой c:title у столбчатой
* с одним рядом даёт имя ряда, а не плейсхолдер. Регрессия симптома
* «в PDF Название диаграммы, в Word — имя ряда». */
@Test
void emptyTitleSingleSeriesBar_usesSeriesName() {
ChartSpec spec = new ChartSpec();
spec.type = ChartSpec.Type.BAR;
ChartSpec.Series s = new ChartSpec.Series();
s.name = "Продажи";
spec.series.add(s);
ChartSpec.readTitle(emptyTitleChart(), spec, new DrawMlColor(null));
assertEquals("Продажи", spec.title);
}
/** c:title отсутствует + autoTitleDeleted=false — автозаголовок не удалён
* и рисуется: имя единственного ряда либо плейсхолдер (§2.1.1431(a)). */
@Test
void noTitleElement_autoTitleKept_seriesName() {
ChartSpec spec = new ChartSpec();
CTChart chart = new CTChart();
CTBoolean keep = new CTBoolean();
keep.setVal(Boolean.FALSE);
chart.setAutoTitleDeleted(keep);
ChartSpec.Series s = new ChartSpec.Series();
s.name = "Продажи";
spec.series.add(s);
ChartSpec.readTitle(chart, spec, new DrawMlColor(null));
assertEquals("Продажи", spec.title);
assertNotNull(spec.titleStyle);
}
@Test
void noTitleElement_autoTitleKept_placeholder() {
ChartSpec spec = new ChartSpec();
CTChart chart = new CTChart();
CTBoolean keep = new CTBoolean();
keep.setVal(Boolean.FALSE);
chart.setAutoTitleDeleted(keep);
ChartSpec.readTitle(chart, spec, new DrawMlColor(null));
assertEquals(ChartSpec.AUTO_TITLE, spec.title, "рядов нет — плейсхолдер");
}
/** Автозаголовок из имени ряда — только при ОДНОМ ряде (§2.1.1561(a));
* многорядовая кольцевая получает плейсхолдер, а не имя первого. */
@Test
void multiSeriesDoughnut_placeholderNotSeriesName() {
ChartSpec spec = new ChartSpec();
@@ -1176,9 +1235,10 @@ class ChartSpecTest {
assertEquals(ChartSpec.AUTO_TITLE, spec.title);
}
/** Пустой заголовок круговой диаграммы без рядов — плейсхолдер; ряд без имени — заголовка нет. */
/** Пустой заголовок без рядов — плейсхолдер; одиночный ряд без имени — тоже
* плейсхолдер (исключение §2.1.1561(a) требует «single series with a name»). */
@Test
void circularAutoTitleEdgeCases() {
void autoTitleEdgeCases() {
ChartSpec doughnut = new ChartSpec();
doughnut.type = ChartSpec.Type.DOUGHNUT;
ChartSpec.readTitle(emptyTitleChart(), doughnut, new DrawMlColor(null));
@@ -1188,7 +1248,15 @@ class ChartSpecTest {
pie.type = ChartSpec.Type.PIE;
pie.series.add(new ChartSpec.Series());
ChartSpec.readTitle(emptyTitleChart(), pie, new DrawMlColor(null));
assertNull(pie.title, "ряд без имени — заголовок не ставится");
assertEquals(ChartSpec.AUTO_TITLE, pie.title, "ряд без имени — плейсхолдер");
ChartSpec bar = new ChartSpec();
bar.type = ChartSpec.Type.BAR;
ChartSpec.Series blank = new ChartSpec.Series();
blank.name = " ";
bar.series.add(blank);
ChartSpec.readTitle(emptyTitleChart(), bar, new DrawMlColor(null));
assertEquals(ChartSpec.AUTO_TITLE, bar.title, "пробельное имя ряда — плейсхолдер");
}
/** c:catAx разбирается полностью; c:valAx без c:numFmt — General; dateAx со своим numFmt. */