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
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:
@@ -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. */
|
||||
|
||||
Reference in New Issue
Block a user