Excelize v2.9.1

• Rilasciato questo il: Maggio 13, 2025
• Rilascio di GitHub: https://github.com/xuri/excelize/releases/tag/v2.9.1

Note di rilascio

Le modifiche più importanti in questa versione sono:

Cambiamento dirompente

• Aggiornamento dei requisiti: la versione del linguaggio Go deve essere 1.23.0 o successiva, per aggiornare il pacchetto dipendente golang.org/x/crypto
• Modifica del tipo di dato di DataValidationType, DataValidationErrorStyle, DataValidationOperator, PictureInsertType da int a byte
• La funzione SetCellInt ora richiede un parametro di tipo int64, risolvendo il problema #2068
• Quando si aggiungono oggetti di disegno come immagini, grafici, forme e controlli di modulo, l'impostazione di offset non influirà più sulla dimensione dell'oggetto di disegno, risolvendo il problema #2001

Caratteristiche notevoli

• Aggiunti i nuovi campi GapWidth e Overlap nel tipo di dato Chart
• Aggiunti i nuovi campi ShowDataTable e ShowDataTableKeys nel tipo di dati ChartPlotArea
• Aggiunto il nuovo campo Alignment nel tipo di dato ChartAxis
• Aggiunto il nuovo campo DataLabel nel tipo di dato ChartSeries
• Aggiunto il nuovo campo PageOrder per il tipo di dato PageLayoutOptions
• Aggiunte 2 nuove variabili di errore esportate: ErrPageSetupAdjustTo e ErrStreamSetColStyle
• Aggiunte 2 nuove enumerazioni esportate: HeaderFooterImagePositionType e IgnoredErrorsType
• Aggiunti 2 nuovi tipi di dato esportati: CalcPropsOptions e HeaderFooterImageOptions
• Aggiunte 2 nuove funzioni: SetCalcProps e GetCalcProps per impostare e ottenere le proprietà di calcolo del workbook
• Aggiunti nuovi valori di enumerazione CultureNameJaJP, CultureNameKoKR e CultureNameZhTW, per supportare l'applicazione del formato numerico agli anni del calendario giapponese, al calendario Danki coreano e all'anno della Repubblica di Cina, problema correlato #1885
• Aggiunta la nuova funzione AddHeaderFooterImage per supportare l'impostazione della grafica in intestazione e piè di pagina, problema correlato #1395
• Aggiunta la nuova funzione AddIgnoredErrors per supportare l'ignorare errori in un intervallo di celle, problema correlato #2046
• Aggiunta la nuova funzione SetColStyle per lo streaming writer, per supportare l'impostazione dello stile delle colonne, problema correlato #2075
• Le funzioni AddChart e AddChartSheet ora supportano l'impostazione della direzione e della rotazione del testo degli assi del grafico, problema correlato #2025
• Le funzioni AddChart e AddChartSheet ora supportano l'impostazione della larghezza della spaziatura e della sovrapposizione per i grafici a colonne e a barre, problema correlato #2033
• Le funzioni AddChart e AddChartSheet ora supportano l'impostazione del formato dell'etichetta dei dati della serie del grafico, problema correlato #2052
• Le funzioni AddChart e AddChartSheet supportano la tabella dati impostata per il grafico, problema correlato #2117
• La funzione AddFormControl supporta l'impostazione del collegamento della cella per la casella di controllo, problema correlato #2113
• La funzione SetPageLayout supporta ora l'impostazione dell'ordine delle pagine del layout
• La funzione DeletePicture supporta l'eliminazione di un'immagine ancorata a una cella, problema correlato #2059
• Verrà restituito un errore se il valore dell'opzione della funzione SetPageLayout non è valido
• Supporto per l'aggiustamento delle validazioni dei dati su più fogli di lavoro, problema correlato #2072
• Supporto per l'applicazione del formato numerico con segno di hash e segnaposto per zero, problema correlato #2058
• Supporto per l'applicazione del formato numerico con il simbolo ?
• Supporto per l'inserimento di un oggetto di disegno di ancoraggio di cella quando specificato il posizionamento come "oneCell", problema correlato #2002

Correzioni di bug

• Risolto un bug di regressione in v2.9.0, in cui il workbook generato dallo streaming writer risultava corrotto all'apertura, risolvendo il problema #2015
• Risolto il problema della generazione ridondante del riempimento a pattern di tipo none, risolvendo il problema #2014
• Correzione della mancanza di stili di bordo verticale e orizzontale in alcuni casi, risolvendo il problema #2048
• Correzione della mancata applicazione degli stili di bordo nei formati condizionali in alcuni casi, risolvendo il problema #2061
• Corretto il panico nel recupero delle tabelle pivot in alcuni casi, risolvendo i problemi #1954 e #2051
• Corretto il fatto che la funzione GetStyle non riuscisse a ottenere il formato VertAlign
• Corretto il calcolo errato delle sottoespressioni nella funzione CalcCellValue in alcuni casi, risolvendo il problema #2083
• Corretto il problema dell'eliminazione errata delle immagini in alcuni casi, causata da errori nella rilevazione del riferimento delle immagini
• Corretto il problema per cui lo stile predefinito della cella non veniva sovrascritto dallo stile di riga non zero impostato tramite lo streaming writer
• Corretto il problema della generazione ridondante dell'elemento cols da parte dello streaming writer
• Correggi il panico durante l'impostazione del carattere del titolo del grafico, risolvendo il problema #2102
• Risolto il problema del panico durante l'eliminazione della catena di calcolo in alcuni casi
• Correggi il risultato errato del calcolo della formula causato dall'errore di analisi della formula condivisa, risolvendo il problema #2056
• Correggi la cartella di lavoro danneggiata generata quando la dimensione di un file ZIP64 interno supera i 4GB
• Correggi l'errore del nome del foglio nel nome definito dopo aver rinominato il foglio, risolvendo il problema #2126

Prestazione

• Utilizza una libreria per la copia profonda (deepcopy) 3 volte più veloce, github.com/tiendc/go-deepcopy, al posto di github.com/mohae/deepcopy, problema correlato #2029
• Corregge la regressione delle prestazioni nella versione 2.9.0, riduce l'allocazione della memoria del valore delle celle di ritaglio per le celle vuote
• Migliorare le prestazioni per calcolare la formula quando la formula contiene riferimenti a intere colonne e righe
• L'iteratore delle righe è aumentato di circa il 20%, l'allocazione della memoria è stata ridotta di circa il 10%

Varie

• Il modulo delle dipendenze è stato aggiornato
• Unit test e godoc aggiornati
• Sito Web di documentazione con multilingue: arabo, tedesco, inglese, spagnolo, francese, italiano, giapponese, coreano, portoghese, russo, cinese semplificato e cinese tradizionale, che è stato aggiornato. Aggiunta la versione italiana del documento
• excelize-wasm Aggiornamento del pacchetto NPM per il supporto WebAssembly / JavaScript
• excelize Aggiornamento del pacchetto PyPI per Python

Crediti

Grazie a tutti i contributori di Excelize. Di seguito è riportato un elenco di contributori che hanno contribuito al codice in questa versione:

• @wushiling50
• @imirkin (Ilia Mirkin)
• @Juneezee (Eng Zer Jun)
• @Arpelicy
• @zhuhaicity (ZhuHaiCheng)
• @xxf0512 (xxf)
• @gypsy1234
• @mengpromax (MengZhongYuan)
• @hly-717
• @kurtinge (Kurt Inge Smådal)
• @IvanHristov98 (Ivan Hristov)
• @artur-chopikian (Artur Chopikian)
• @romanshevelev (Roman Shevelev)
• @LZCZ
• @hm3248
• @moisespsena (Moises P. Sena)
• @paolobarbolini (Paolo Barbolini)
• @timesince
• @shcabin
• @tgulacsi (Tamás Gulácsi)
• @R3dByt3 (R3dByt3)
• @Now-Shimmer