diff --git a/website/.markdownlint-cli2.jsonc b/website/.markdownlint-cli2.jsonc index ab2dca188d..d8a9c9d5eb 100644 --- a/website/.markdownlint-cli2.jsonc +++ b/website/.markdownlint-cli2.jsonc @@ -23,15 +23,18 @@ "div", "table", "tr", + "th", "td", "a", "img", "sub", "b", "br", + "thead", "tbody", "mark", "font", + "small", "p" ] }, diff --git a/website/docs/sheet/help/built-in-converters.md b/website/docs/sheet/help/built-in-converters.md new file mode 100644 index 0000000000..8cef3b7a44 --- /dev/null +++ b/website/docs/sheet/help/built-in-converters.md @@ -0,0 +1,442 @@ +--- +id: 'built-in-converters' +title: 'Built-in Converters' +--- + + + +# Built-in Converters + +This section lists the converters provided in the project. + +
+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
Java TypeCell TypeConverterRead & WriteReleased
ByteSTRINGByteStringConverter✅ Read
✅ Write
🟢 YES
NUMBERByteNumberConverter✅ Read
✅ Write
🟢 YES
BOOLEANByteBooleanConverter✅ Read
✅ Write
🟢 YES
ShortSTRINGShortStringConverter✅ Read
✅ Write
🟢 YES
NUMBERShortNumberConverter✅ Read
✅ Write
🟢 YES
BOOLEANShortBooleanConverter✅ Read
✅ Write
🟢 YES
IntegerSTRINGIntegerStringConverter✅ Read
✅ Write
🟢 YES
NUMBERIntegerNumberConverter✅ Read
✅ Write
🟢 YES
BOOLEANIntegerBooleanConverter✅ Read
✅ Write
🟢 YES
LongSTRINGLongStringConverter✅ Read
✅ Write
🟢 YES
NUMBERLongNumberConverter✅ Read
✅ Write
🟢 YES
BOOLEANLongBooleanConverter✅ Read
✅ Write
🟢 YES
FloatSTRINGFloatStringConverter✅ Read
✅ Write
🟢 YES
NUMBERFloatNumberConverter✅ Read
✅ Write
🟢 YES
BOOLEANFloatBooleanConverter✅ Read
✅ Write
🟢 YES
DoubleSTRINGDoubleStringConverter✅ Read
✅ Write
🟢 YES
NUMBERDoubleNumberConverter✅ Read
✅ Write
🟢 YES
BOOLEANDoubleBooleanConverter✅ Read
✅ Write
🟢 YES
BigDecimalSTRINGBigDecimalStringConverter✅ Read
✅ Write
🟢 YES
NUMBERBigDecimalNumberConverter✅ Read
✅ Write
🟢 YES
BOOLEANBigDecimalBooleanConverter✅ Read
✅ Write
🟢 YES
BigIntegerSTRINGBigIntegerStringConverter✅ Read
✅ Write
🟢 YES
NUMBERBigIntegerNumberConverter✅ Read
✅ Write
🟢 YES
BOOLEANBigIntegerBooleanConverter✅ Read
✅ Write
🟢 YES
CharacterSTRINGCharacterStringConverter✅ Read
✅ Write
🟡 NEXT
BooleanSTRINGBooleanStringConverter✅ Read
✅ Write
🟢 YES
NUMBERBooleanNumberConverter✅ Read
✅ Write
🟢 YES
BOOLEANBooleanBooleanConverter✅ Read
✅ Write
🟢 YES
StringSTRINGStringStringConverter✅ Read
✅ Write
🟢 YES
NUMBERStringNumberConverter✅ Read
✅ Write
🟢 YES
BOOLEANStringBooleanConverter✅ Read
✅ Write
🟢 YES
ERRORStringErrorConverter✅ Read
✅ Write
🟢 YES
java.util.DateSTRINGDateStringConverter✅ Read
✅ Write
🟢 YES
NUMBERDateNumberConverter✅ Read
✅ Write
🟢 YES
DATE (Serial Number)DateDateConverter❌ Read
✅ Write
🟢 YES
java.sql.TimeSTRINGSqlTimeStringConverter✅ Read
✅ Write
🟡 NEXT
NUMBERSqlTimeNumberConverter✅ Read
✅ Write
🟡 NEXT
DATE (Serial Number)SqlTimeDateConverter❌ Read
✅ Write
🟡 NEXT
java.sql.TimestampSTRINGTimestampStringConverter✅ Read
✅ Write
🟡 NEXT
NUMBERTimestampNumberConverter✅ Read
✅ Write
🟡 NEXT
DATE (Serial Number)TimestampDateConverter❌ Read
✅ Write
🟡 NEXT
LocalDateSTRINGLocalDateStringConverter✅ Read
✅ Write
🟢 YES
NUMBERLocalDateNumberConverter✅ Read
✅ Write
🟢 YES
DATE (Serial Number)LocalDateDateConverter❌ Read
✅ Write
🟢 YES
LocalTimeSTRINGLocalTimeStringConverter✅ Read
✅ Write
🟢 YES
NUMBERLocalTimeNumberConverter✅ Read
✅ Write
🟢 YES
DATE (Serial Number)LocalTimeDateConverter❌ Read
✅ Write
🟢 YES
LocalDateTimeSTRINGLocalDateTimeStringConverter✅ Read
✅ Write
🟢 YES
NUMBERLocalDateTimeNumberConverter✅ Read
✅ Write
🟢 YES
DATE (Serial Number)LocalDateTimeDateConverter❌ Read
✅ Write
🟢 YES
InstantSTRINGInstantStringConverter✅ Read
✅ Write
🟡 NEXT
OffsetDateTimeSTRINGOffsetDateTimeStringConverter✅ Read
✅ Write
🟡 NEXT
NUMBEROffsetDateTimeNumberConverter✅ Read
✅ Write
🟡 NEXT
DATE (Serial Number)OffsetDateTimeDateConverter❌ Read
✅ Write
🟡 NEXT
YearSTRINGYearStringConverter✅ Read
✅ Write
🟡 NEXT
byte[]IMAGE (Drawing)ByteArrayImageConverter❌ Read
✅ Write
🟢 YES
Byte[]IMAGE (Drawing)BoxingByteArrayImageConverter❌ Read
✅ Write
🟢 YES
FileIMAGE (Drawing)FileImageConverter❌ Read
✅ Write
🟢 YES
InputStreamIMAGE (Drawing)InputStreamImageConverter❌ Read
✅ Write
🟢 YES
URLIMAGE (Drawing)UrlImageConverter❌ Read
✅ Write
🟢 YES
StringIMAGE (Drawing)StringPathnameImageConverter ⚠️❌ Read
✅ Write
🟢 YES
IMAGE (Drawing)StringBase64ImageConverter ⚠️❌ Read
✅ Write
🟢 YES
UUIDSTRINGUUIDStringConverter✅ Read
✅ Write
🟡 NEXT
+
diff --git a/website/docs/sheet/write/image.md b/website/docs/sheet/write/image.md index 122254d939..8cd590fa81 100644 --- a/website/docs/sheet/write/image.md +++ b/website/docs/sheet/write/image.md @@ -42,12 +42,18 @@ The declared field type selects the converter, so most sources need no configura | `URL` | `UrlImageConverter` | Downloaded while the file is written, see [URL Sources](#url-sources). | | `String` | none by default | Must be declared explicitly, see below. | + + +:::warning + `String` is the only source you have to declare, because an undeclared `String` field is written as text. Choose the converter that matches the value: - `StringImageConverter` or `StringPathnameImageConverter` - a path to a file (the two behave identically). - `StringBase64ImageConverter` - base64 data, with or without a `data:image/png;base64,` prefix. +::: + ## Image Export ### POJO Class diff --git a/website/i18n/zh-cn/docusaurus-plugin-content-docs/current/sheet/help/built-in-converters.md b/website/i18n/zh-cn/docusaurus-plugin-content-docs/current/sheet/help/built-in-converters.md new file mode 100644 index 0000000000..9b20864f44 --- /dev/null +++ b/website/i18n/zh-cn/docusaurus-plugin-content-docs/current/sheet/help/built-in-converters.md @@ -0,0 +1,442 @@ +--- +id: 'built-in-converters' +title: '内置转换器' +--- + + + +# 内置转换器 + +本章节列出了项目中提供的内置转换器。 + +
+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
Java 类型单元格类型转换器读取 & 写入支持发布状态
ByteSTRINGByteStringConverter✅ 读取
✅ 写入
🟢 已发布
NUMBERByteNumberConverter✅ 读取
✅ 写入
🟢 已发布
BOOLEANByteBooleanConverter✅ 读取
✅ 写入
🟢 已发布
ShortSTRINGShortStringConverter✅ 读取
✅ 写入
🟢 已发布
NUMBERShortNumberConverter✅ 读取
✅ 写入
🟢 已发布
BOOLEANShortBooleanConverter✅ 读取
✅ 写入
🟢 已发布
IntegerSTRINGIntegerStringConverter✅ 读取
✅ 写入
🟢 已发布
NUMBERIntegerNumberConverter✅ 读取
✅ 写入
🟢 已发布
BOOLEANIntegerBooleanConverter✅ 读取
✅ 写入
🟢 已发布
LongSTRINGLongStringConverter✅ 读取
✅ 写入
🟢 已发布
NUMBERLongNumberConverter✅ 读取
✅ 写入
🟢 已发布
BOOLEANLongBooleanConverter✅ 读取
✅ 写入
🟢 已发布
FloatSTRINGFloatStringConverter✅ 读取
✅ 写入
🟢 已发布
NUMBERFloatNumberConverter✅ 读取
✅ 写入
🟢 已发布
BOOLEANFloatBooleanConverter✅ 读取
✅ 写入
🟢 已发布
DoubleSTRINGDoubleStringConverter✅ 读取
✅ 写入
🟢 已发布
NUMBERDoubleNumberConverter✅ 读取
✅ 写入
🟢 已发布
BOOLEANDoubleBooleanConverter✅ 读取
✅ 写入
🟢 已发布
BigDecimalSTRINGBigDecimalStringConverter✅ 读取
✅ 写入
🟢 已发布
NUMBERBigDecimalNumberConverter✅ 读取
✅ 写入
🟢 已发布
BOOLEANBigDecimalBooleanConverter✅ 读取
✅ 写入
🟢 已发布
BigIntegerSTRINGBigIntegerStringConverter✅ 读取
✅ 写入
🟢 已发布
NUMBERBigIntegerNumberConverter✅ 读取
✅ 写入
🟢 已发布
BOOLEANBigIntegerBooleanConverter✅ 读取
✅ 写入
🟢 已发布
CharacterSTRINGCharacterStringConverter✅ 读取
✅ 写入
🟡 待发布
BooleanSTRINGBooleanStringConverter✅ 读取
✅ 写入
🟢 已发布
NUMBERBooleanNumberConverter✅ 读取
✅ 写入
🟢 已发布
BOOLEANBooleanBooleanConverter✅ 读取
✅ 写入
🟢 已发布
StringSTRINGStringStringConverter✅ 读取
✅ 写入
🟢 已发布
NUMBERStringNumberConverter✅ 读取
✅ 写入
🟢 已发布
BOOLEANStringBooleanConverter✅ 读取
✅ 写入
🟢 已发布
ERRORStringErrorConverter✅ 读取
✅ 写入
🟢 已发布
java.util.DateSTRINGDateStringConverter✅ 读取
✅ 写入
🟢 已发布
NUMBERDateNumberConverter✅ 读取
✅ 写入
🟢 已发布
DATE (Serial Number)DateDateConverter❌ 读取
✅ 写入
🟢 已发布
java.sql.TimeSTRINGSqlTimeStringConverter✅ 读取
✅ 写入
🟡 待发布
NUMBERSqlTimeNumberConverter✅ 读取
✅ 写入
🟡 待发布
DATE (Serial Number)SqlTimeDateConverter❌ 读取
✅ 写入
🟡 待发布
java.sql.TimestampSTRINGTimestampStringConverter✅ 读取
✅ 写入
🟡 待发布
NUMBERTimestampNumberConverter✅ 读取
✅ 写入
🟡 待发布
DATE (Serial Number)TimestampDateConverter❌ 读取
✅ 写入
🟡 待发布
LocalDateSTRINGLocalDateStringConverter✅ 读取
✅ 写入
🟢 已发布
NUMBERLocalDateNumberConverter✅ 读取
✅ 写入
🟢 已发布
DATE (Serial Number)LocalDateDateConverter❌ 读取
✅ 写入
🟢 已发布
LocalTimeSTRINGLocalTimeStringConverter✅ 读取
✅ 写入
🟢 已发布
NUMBERLocalTimeNumberConverter✅ 读取
✅ 写入
🟢 已发布
DATE (Serial Number)LocalTimeDateConverter❌ 读取
✅ 写入
🟢 已发布
LocalDateTimeSTRINGLocalDateTimeStringConverter✅ 读取
✅ 写入
🟢 已发布
NUMBERLocalDateTimeNumberConverter✅ 读取
✅ 写入
🟢 已发布
DATE (Serial Number)LocalDateTimeDateConverter❌ 读取
✅ 写入
🟢 已发布
InstantSTRINGInstantStringConverter✅ 读取
✅ 写入
🟡 待发布
OffsetDateTimeSTRINGOffsetDateTimeStringConverter✅ 读取
✅ 写入
🟡 待发布
NUMBEROffsetDateTimeNumberConverter✅ 读取
✅ 写入
🟡 待发布
DATE (Serial Number)OffsetDateTimeDateConverter❌ 读取
✅ 写入
🟡 待发布
YearSTRINGYearStringConverter✅ 读取
✅ 写入
🟡 待发布
byte[]IMAGE (Drawing)ByteArrayImageConverter❌ 读取
✅ 写入
🟢 已发布
Byte[]IMAGE (Drawing)BoxingByteArrayImageConverter❌ 读取
✅ 写入
🟢 已发布
FileIMAGE (Drawing)FileImageConverter❌ 读取
✅ 写入
🟢 已发布
InputStreamIMAGE (Drawing)InputStreamImageConverter❌ 读取
✅ 写入
🟢 已发布
URLIMAGE (Drawing)UrlImageConverter❌ 读取
✅ 写入
🟢 已发布
StringIMAGE (Drawing)StringPathnameImageConverter ⚠️❌ 读取
✅ 写入
🟢 已发布
IMAGE (Drawing)StringBase64ImageConverter ⚠️❌ 读取
✅ 写入
🟢 已发布
UUIDSTRINGUUIDStringConverter✅ 读取
✅ 写入
🟡 待发布
+
diff --git a/website/i18n/zh-cn/docusaurus-plugin-content-docs/current/sheet/write/image.md b/website/i18n/zh-cn/docusaurus-plugin-content-docs/current/sheet/write/image.md index 1182c2e170..52a46ea946 100644 --- a/website/i18n/zh-cn/docusaurus-plugin-content-docs/current/sheet/write/image.md +++ b/website/i18n/zh-cn/docusaurus-plugin-content-docs/current/sheet/write/image.md @@ -40,11 +40,17 @@ title: '图片' | `URL` | `UrlImageConverter` | 写文件时通过网络下载,见 [URL 来源](#url-来源)。 | | `String` | 默认没有 | 必须显式指定,见下文。 | + + +:::warning + `String` 是唯一必须显式声明转换器的来源,否则该字段会被当作文本写出。根据取值选择对应的转换器: - `StringImageConverter` 或 `StringPathnameImageConverter` - 文件路径(两者行为一致)。 - `StringBase64ImageConverter` - base64 数据,可以带 `data:image/png;base64,` 前缀,也可以不带。 +::: + ## 图片导出 ### POJO 类 diff --git a/website/sidebars.js b/website/sidebars.js index 8106f3b7fb..22d0a38421 100644 --- a/website/sidebars.js +++ b/website/sidebars.js @@ -109,6 +109,7 @@ const sidebars = { label: 'help', items: [ 'sheet/help/annotation', + 'sheet/help/built-in-converters', 'sheet/help/core-class', 'sheet/help/parameter', 'sheet/help/large-data', diff --git a/website/src/css/custom.css b/website/src/css/custom.css index 131e6bda0d..77133f6a9f 100644 --- a/website/src/css/custom.css +++ b/website/src/css/custom.css @@ -101,8 +101,14 @@ article header h2 { font-weight: bold; } -.team table { +.team table, +.built-in-converters table { display: table; width: 100%; table-layout: auto; +} + +#string-explicit-declaration { + scroll-margin-top: var(--ifm-navbar-height); + display: block; } \ No newline at end of file