fix(core): заголовок диаграммы по ECMA-376
- c:autoTitleDeleted=true скрывает заголовок целиком, включая явный c:tx (§21.2.2.7) — фантомный "Chart Title" из чужих шаблонов больше не рисуется; - автозаголовок из имени ряда — только у круговой диаграммы с одним рядом, многорядовая круговая получает плейсхолдер; - несколько абзацев a:p в заголовке склеиваются через '\n' (жёсткий перенос), а не внахлёст; - 4 регрессии в ChartSpecTest (deletedTitleWithText_notShown, deletedTitleValOmitted_notShown, multiSeriesDoughnut_placeholderNotSeriesName, multiParagraphTitle_joinedWithNewlines).
This commit is contained in:
@@ -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 — дефолты рамки сохраняются. */
|
||||||
|
|||||||
Reference in New Issue
Block a user