fix(core): заголовок диаграммы по ECMA-376 #66
@@ -13,10 +13,16 @@ import ru.pjandro.wordpdf.DrawingFoundException;
|
||||
class DrawingRejectedException extends RuntimeException {
|
||||
|
||||
DrawingRejectedException(DrawingFoundException.Kind kind) {
|
||||
super(switch (kind) {
|
||||
super(message(kind));
|
||||
}
|
||||
|
||||
// switch вынесен из super(): парсер PMD 7.17 (движок maven-pmd-plugin)
|
||||
// падает на switch-выражении в аргументе super (pmd/pmd#6234).
|
||||
private static String message(DrawingFoundException.Kind kind) {
|
||||
return switch (kind) {
|
||||
case CHARTS -> "Конвертация отменена: в документе найдены диаграммы";
|
||||
case SMARTART -> "Конвертация отменена: в документе найден SmartArt";
|
||||
case OLE -> "Конвертация отменена: в документе найдены OLE-объекты";
|
||||
});
|
||||
};
|
||||
}
|
||||
}
|
||||
|
||||
@@ -25,12 +25,18 @@ public class DrawingFoundException extends ConversionException {
|
||||
private final Kind kind;
|
||||
|
||||
public DrawingFoundException(Kind kind) {
|
||||
super(switch (kind) {
|
||||
super(message(kind));
|
||||
this.kind = kind;
|
||||
}
|
||||
|
||||
// switch вынесен из super(): парсер PMD 7.17 (движок maven-pmd-plugin)
|
||||
// падает на switch-выражении в аргументе super (pmd/pmd#6234).
|
||||
private static String message(Kind kind) {
|
||||
return switch (kind) {
|
||||
case CHARTS -> "В документе найдены диаграммы, а их обработка запрещена (errorOnCharts)";
|
||||
case SMARTART -> "В документе найден SmartArt, а его обработка запрещена (errorOnSmartArt)";
|
||||
case OLE -> "В документе найдены OLE-объекты, а их обработка запрещена (errorOnOle)";
|
||||
});
|
||||
this.kind = kind;
|
||||
};
|
||||
}
|
||||
|
||||
public Kind kind() {
|
||||
|
||||
@@ -75,7 +75,8 @@ import java.util.Set;
|
||||
final class ChartSpec {
|
||||
|
||||
/** Плейсхолдер автозаголовка для графика с пустым c:title (Word подставляет
|
||||
* строку своего UI-языка — у нас русская). */
|
||||
* строку своего UI-языка — у нас русская; текста плейсхолдера ECMA-376
|
||||
* не определяет). */
|
||||
static final String AUTO_TITLE = "Название диаграммы";
|
||||
|
||||
/**
|
||||
@@ -898,14 +899,24 @@ final class ChartSpec {
|
||||
}
|
||||
|
||||
/**
|
||||
* Заголовок: явный текст (c:title/c:tx) или автозаголовок из имени
|
||||
* первого ряда (Word так и делает, когда c:autoTitleDeleted = 0).
|
||||
* Заголовок: явный текст (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).
|
||||
*/
|
||||
static void readTitle(CTChart chart, ChartSpec spec, DrawMlColor colors) {
|
||||
CTTitle t = chart.getTitle();
|
||||
if (t == null) {
|
||||
return;
|
||||
}
|
||||
// §21.2.2.7: удалённый автозаголовок не показывает заголовок ни при
|
||||
// каких условиях — в том числе явный c:tx (устаревший текст из чужих
|
||||
// шаблонов, где Word его скрывает, у нас не должен появляться).
|
||||
if (chart.getAutoTitleDeleted() != null && chart.getAutoTitleDeleted().isVal()) {
|
||||
return;
|
||||
}
|
||||
String text = null;
|
||||
CTTx tx = t.getTx();
|
||||
if (tx != null) {
|
||||
@@ -914,25 +925,26 @@ final class ChartSpec {
|
||||
text = tx.getStrRef().getStrCache().getPt().get(0).getV();
|
||||
}
|
||||
if (text == null && tx.getRich() != null) {
|
||||
StringBuilder sb = new StringBuilder();
|
||||
List<String> paragraphs = new ArrayList<>();
|
||||
for (DrawMlText.Paragraph p : DrawMlText.paragraphs(
|
||||
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:
|
||||
// для круговых диаграмм он берётся из имени ряда, для остальных
|
||||
// типов рисуется встроенный плейсхолдер (в англ. эталоне Word —
|
||||
// у круговой диаграммы с ОДНИМ рядом он берётся из имени ряда
|
||||
// (автозаголовок = имя единственного ряда), во всех остальных
|
||||
// случаях рисуется встроенный плейсхолдер (в англ. эталоне Word —
|
||||
// "Chart Title", у нас плейсхолдер русифицирован; в XML его нет,
|
||||
// Word подставляет строку из своего UI-языка).
|
||||
boolean deleted = chart.getAutoTitleDeleted() != null
|
||||
&& chart.getAutoTitleDeleted().isVal();
|
||||
if ((text == null || text.isBlank()) && !deleted) {
|
||||
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.isEmpty()) {
|
||||
if (circular && spec.series.size() == 1) {
|
||||
text = spec.series.get(0).name;
|
||||
} else {
|
||||
text = AUTO_TITLE;
|
||||
|
||||
@@ -109,8 +109,9 @@ import static org.junit.jupiter.api.Assertions.*;
|
||||
|
||||
/**
|
||||
* Пустой c:title при autoTitleDeleted=0 — это автозаголовок Word, которого
|
||||
* нет в XML: для круговых диаграмм он равен имени ряда, для остальных
|
||||
* типов это встроенный плейсхолдер.
|
||||
* нет в XML: у круговой диаграммы с одним рядом он равен имени ряда,
|
||||
* в остальных случаях это встроенный плейсхолдер; c:autoTitleDeleted=true
|
||||
* скрывает заголовок целиком, включая явный текст (ECMA-376 §21.2.2.7).
|
||||
*/
|
||||
class ChartSpecTest {
|
||||
|
||||
@@ -146,6 +147,72 @@ class ChartSpecTest {
|
||||
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
|
||||
void barGapWidthAndOverlapParsed() {
|
||||
CTBarChart chart = new CTBarChart();
|
||||
@@ -846,6 +913,14 @@ class ChartSpecTest {
|
||||
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 — дефолты рамки сохраняются. */
|
||||
|
||||
Reference in New Issue
Block a user