sheet.go 10 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410
  1. package xlsx
  2. import (
  3. "errors"
  4. "fmt"
  5. "strconv"
  6. )
  7. // Sheet is a high level structure intended to provide user access to
  8. // the contents of a particular sheet within an XLSX file.
  9. type Sheet struct {
  10. Name string
  11. File *File
  12. Rows []*Row
  13. Cols []*Col
  14. MaxRow int
  15. MaxCol int
  16. Hidden bool
  17. Selected bool
  18. SheetViews []SheetView
  19. SheetFormat SheetFormat
  20. AutoFilter *AutoFilter
  21. }
  22. type SheetView struct {
  23. Pane *Pane
  24. }
  25. type Pane struct {
  26. XSplit float64
  27. YSplit float64
  28. TopLeftCell string
  29. ActivePane string
  30. State string // Either "split" or "frozen"
  31. }
  32. type SheetFormat struct {
  33. DefaultColWidth float64
  34. DefaultRowHeight float64
  35. OutlineLevelCol uint8
  36. OutlineLevelRow uint8
  37. }
  38. type AutoFilter struct {
  39. TopLeftCell string
  40. BottomRightCell string
  41. }
  42. // Add a new Row to a Sheet
  43. func (s *Sheet) AddRow() *Row {
  44. row := &Row{Sheet: s}
  45. s.Rows = append(s.Rows, row)
  46. if len(s.Rows) > s.MaxRow {
  47. s.MaxRow = len(s.Rows)
  48. }
  49. return row
  50. }
  51. // Make sure we always have as many Cols as we do cells.
  52. func (s *Sheet) maybeAddCol(cellCount int) {
  53. if cellCount > s.MaxCol {
  54. col := &Col{
  55. style: NewStyle(),
  56. Min: cellCount,
  57. Max: cellCount,
  58. Hidden: false,
  59. Collapsed: false}
  60. s.Cols = append(s.Cols, col)
  61. s.MaxCol = cellCount
  62. }
  63. }
  64. // Make sure we always have as many Cols as we do cells.
  65. func (s *Sheet) Col(idx int) *Col {
  66. s.maybeAddCol(idx + 1)
  67. return s.Cols[idx]
  68. }
  69. // Get a Cell by passing it's cartesian coordinates (zero based) as
  70. // row and column integer indexes.
  71. //
  72. // For example:
  73. //
  74. // cell := sheet.Cell(0,0)
  75. //
  76. // ... would set the variable "cell" to contain a Cell struct
  77. // containing the data from the field "A1" on the spreadsheet.
  78. func (sh *Sheet) Cell(row, col int) *Cell {
  79. // If the user requests a row beyond what we have, then extend.
  80. for len(sh.Rows) <= row {
  81. sh.AddRow()
  82. }
  83. r := sh.Rows[row]
  84. for len(r.Cells) <= col {
  85. r.AddCell()
  86. }
  87. return r.Cells[col]
  88. }
  89. //Set the width of a single column or multiple columns.
  90. func (s *Sheet) SetColWidth(startcol, endcol int, width float64) error {
  91. if startcol > endcol {
  92. return fmt.Errorf("Could not set width for range %d-%d: startcol must be less than endcol.", startcol, endcol)
  93. }
  94. col := &Col{
  95. style: NewStyle(),
  96. Min: startcol + 1,
  97. Max: endcol + 1,
  98. Hidden: false,
  99. Collapsed: false,
  100. Width: width}
  101. s.Cols = append(s.Cols, col)
  102. if endcol+1 > s.MaxCol {
  103. s.MaxCol = endcol + 1
  104. }
  105. return nil
  106. }
  107. // When merging cells, the cell may be the 'original' or the 'covered'.
  108. // First, figure out which cells are merge starting points. Then create
  109. // the necessary cells underlying the merge area.
  110. // Then go through all the underlying cells and apply the appropriate
  111. // border, based on the original cell.
  112. func (s *Sheet) handleMerged() {
  113. merged := make(map[string]*Cell)
  114. for r, row := range s.Rows {
  115. for c, cell := range row.Cells {
  116. if cell.HMerge > 0 || cell.VMerge > 0 {
  117. coord := GetCellIDStringFromCoords(c, r)
  118. merged[coord] = cell
  119. }
  120. }
  121. }
  122. // This loop iterates over all cells that should be merged and applies the correct
  123. // borders to them depending on their position. If any cells required by the merge
  124. // are missing, they will be allocated by s.Cell().
  125. for key, cell := range merged {
  126. mainstyle := cell.GetStyle()
  127. top := mainstyle.Border.Top
  128. left := mainstyle.Border.Left
  129. right := mainstyle.Border.Right
  130. bottom := mainstyle.Border.Bottom
  131. // When merging cells, the upper left cell does not maintain
  132. // the original borders
  133. mainstyle.Border.Top = "none"
  134. mainstyle.Border.Left = "none"
  135. mainstyle.Border.Right = "none"
  136. mainstyle.Border.Bottom = "none"
  137. maincol, mainrow, _ := GetCoordsFromCellIDString(key)
  138. for rownum := 0; rownum <= cell.VMerge; rownum++ {
  139. for colnum := 0; colnum <= cell.HMerge; colnum++ {
  140. tmpcell := s.Cell(mainrow+rownum, maincol+colnum)
  141. style := tmpcell.GetStyle()
  142. style.ApplyBorder = true
  143. if rownum == 0 {
  144. style.Border.Top = top
  145. }
  146. if rownum == (cell.VMerge) {
  147. style.Border.Bottom = bottom
  148. }
  149. if colnum == 0 {
  150. style.Border.Left = left
  151. }
  152. if colnum == (cell.HMerge) {
  153. style.Border.Right = right
  154. }
  155. }
  156. }
  157. }
  158. }
  159. // Dump sheet to its XML representation, intended for internal use only
  160. func (s *Sheet) makeXLSXSheet(refTable *RefTable, styles *xlsxStyleSheet) *xlsxWorksheet {
  161. worksheet := newXlsxWorksheet()
  162. xSheet := xlsxSheetData{}
  163. maxRow := 0
  164. maxCell := 0
  165. var maxLevelCol, maxLevelRow uint8
  166. // Scan through the sheet and see if there are any merged cells. If there
  167. // are, we may need to extend the size of the sheet. There needs to be
  168. // phantom cells underlying the area covered by the merged cell
  169. s.handleMerged()
  170. for index, sheetView := range s.SheetViews {
  171. if sheetView.Pane != nil {
  172. worksheet.SheetViews.SheetView[index].Pane = &xlsxPane{
  173. XSplit: sheetView.Pane.XSplit,
  174. YSplit: sheetView.Pane.YSplit,
  175. TopLeftCell: sheetView.Pane.TopLeftCell,
  176. ActivePane: sheetView.Pane.ActivePane,
  177. State: sheetView.Pane.State,
  178. }
  179. }
  180. }
  181. if s.Selected {
  182. worksheet.SheetViews.SheetView[0].TabSelected = true
  183. }
  184. if s.SheetFormat.DefaultRowHeight != 0 {
  185. worksheet.SheetFormatPr.DefaultRowHeight = s.SheetFormat.DefaultRowHeight
  186. }
  187. worksheet.SheetFormatPr.DefaultColWidth = s.SheetFormat.DefaultColWidth
  188. colsXfIdList := make([]int, len(s.Cols))
  189. worksheet.Cols = &xlsxCols{Col: []xlsxCol{}}
  190. for c, col := range s.Cols {
  191. XfId := 0
  192. if col.Min == 0 {
  193. col.Min = 1
  194. }
  195. if col.Max == 0 {
  196. col.Max = 1
  197. }
  198. style := col.GetStyle()
  199. //col's style always not nil
  200. if style != nil {
  201. xNumFmt := styles.newNumFmt(col.numFmt)
  202. XfId = handleStyleForXLSX(style, xNumFmt.NumFmtId, styles)
  203. }
  204. colsXfIdList[c] = XfId
  205. var customWidth bool
  206. if col.Width == 0 {
  207. col.Width = ColWidth
  208. customWidth = false
  209. } else {
  210. customWidth = true
  211. }
  212. worksheet.Cols.Col = append(worksheet.Cols.Col,
  213. xlsxCol{Min: col.Min,
  214. Max: col.Max,
  215. Hidden: col.Hidden,
  216. Width: col.Width,
  217. CustomWidth: customWidth,
  218. Collapsed: col.Collapsed,
  219. OutlineLevel: col.OutlineLevel,
  220. Style: XfId,
  221. })
  222. if col.OutlineLevel > maxLevelCol {
  223. maxLevelCol = col.OutlineLevel
  224. }
  225. }
  226. for r, row := range s.Rows {
  227. if r > maxRow {
  228. maxRow = r
  229. }
  230. xRow := xlsxRow{}
  231. xRow.R = r + 1
  232. if row.isCustom {
  233. xRow.CustomHeight = true
  234. xRow.Ht = fmt.Sprintf("%g", row.Height)
  235. }
  236. xRow.OutlineLevel = row.OutlineLevel
  237. if row.OutlineLevel > maxLevelRow {
  238. maxLevelRow = row.OutlineLevel
  239. }
  240. for c, cell := range row.Cells {
  241. XfId := colsXfIdList[c]
  242. // generate NumFmtId and add new NumFmt
  243. xNumFmt := styles.newNumFmt(cell.NumFmt)
  244. style := cell.style
  245. if style != nil {
  246. XfId = handleStyleForXLSX(style, xNumFmt.NumFmtId, styles)
  247. } else if len(cell.NumFmt) > 0 && !compareFormatString(s.Cols[c].numFmt, cell.NumFmt) {
  248. XfId = handleNumFmtIdForXLSX(xNumFmt.NumFmtId, styles)
  249. }
  250. if c > maxCell {
  251. maxCell = c
  252. }
  253. xC := xlsxC{
  254. S: XfId,
  255. R: GetCellIDStringFromCoords(c, r),
  256. }
  257. if cell.formula != "" {
  258. xC.F = &xlsxF{Content: cell.formula}
  259. }
  260. switch cell.cellType {
  261. case CellTypeInline:
  262. // Inline strings are turned into shared strings since they are more efficient.
  263. // This is what Excel does as well.
  264. fallthrough
  265. case CellTypeString:
  266. if len(cell.Value) > 0 {
  267. xC.V = strconv.Itoa(refTable.AddString(cell.Value))
  268. }
  269. xC.T = "s"
  270. case CellTypeNumeric:
  271. // Numeric is the default, so the type can be left blank
  272. xC.V = cell.Value
  273. case CellTypeBool:
  274. xC.V = cell.Value
  275. xC.T = "b"
  276. case CellTypeError:
  277. xC.V = cell.Value
  278. xC.T = "e"
  279. case CellTypeDate:
  280. xC.V = cell.Value
  281. xC.T = "d"
  282. case CellTypeStringFormula:
  283. xC.V = cell.Value
  284. xC.T = "str"
  285. default:
  286. panic(errors.New("unknown cell type cannot be marshaled"))
  287. }
  288. xRow.C = append(xRow.C, xC)
  289. if cell.HMerge > 0 || cell.VMerge > 0 {
  290. // r == rownum, c == colnum
  291. mc := xlsxMergeCell{}
  292. start := GetCellIDStringFromCoords(c, r)
  293. endCol := c + cell.HMerge
  294. endRow := r + cell.VMerge
  295. end := GetCellIDStringFromCoords(endCol, endRow)
  296. mc.Ref = start + ":" + end
  297. if worksheet.MergeCells == nil {
  298. worksheet.MergeCells = &xlsxMergeCells{}
  299. }
  300. worksheet.MergeCells.Cells = append(worksheet.MergeCells.Cells, mc)
  301. }
  302. }
  303. xSheet.Row = append(xSheet.Row, xRow)
  304. }
  305. // Update sheet format with the freshly determined max levels
  306. s.SheetFormat.OutlineLevelCol = maxLevelCol
  307. s.SheetFormat.OutlineLevelRow = maxLevelRow
  308. // .. and then also apply this to the xml worksheet
  309. worksheet.SheetFormatPr.OutlineLevelCol = s.SheetFormat.OutlineLevelCol
  310. worksheet.SheetFormatPr.OutlineLevelRow = s.SheetFormat.OutlineLevelRow
  311. if worksheet.MergeCells != nil {
  312. worksheet.MergeCells.Count = len(worksheet.MergeCells.Cells)
  313. }
  314. if s.AutoFilter != nil {
  315. worksheet.AutoFilter = &xlsxAutoFilter{Ref: fmt.Sprintf("%v:%v", s.AutoFilter.TopLeftCell, s.AutoFilter.BottomRightCell)}
  316. }
  317. worksheet.SheetData = xSheet
  318. dimension := xlsxDimension{}
  319. dimension.Ref = "A1:" + GetCellIDStringFromCoords(maxCell, maxRow)
  320. if dimension.Ref == "A1:A1" {
  321. dimension.Ref = "A1"
  322. }
  323. worksheet.Dimension = dimension
  324. return worksheet
  325. }
  326. func handleStyleForXLSX(style *Style, NumFmtId int, styles *xlsxStyleSheet) (XfId int) {
  327. xFont, xFill, xBorder, xCellXf := style.makeXLSXStyleElements()
  328. fontId := styles.addFont(xFont)
  329. fillId := styles.addFill(xFill)
  330. // HACK - adding light grey fill, as in OO and Google
  331. greyfill := xlsxFill{}
  332. greyfill.PatternFill.PatternType = "lightGray"
  333. styles.addFill(greyfill)
  334. borderId := styles.addBorder(xBorder)
  335. xCellXf.FontId = fontId
  336. xCellXf.FillId = fillId
  337. xCellXf.BorderId = borderId
  338. xCellXf.NumFmtId = NumFmtId
  339. // apply the numFmtId when it is not the default cellxf
  340. if xCellXf.NumFmtId > 0 {
  341. xCellXf.ApplyNumberFormat = true
  342. }
  343. xCellXf.Alignment.Horizontal = style.Alignment.Horizontal
  344. xCellXf.Alignment.Indent = style.Alignment.Indent
  345. xCellXf.Alignment.ShrinkToFit = style.Alignment.ShrinkToFit
  346. xCellXf.Alignment.TextRotation = style.Alignment.TextRotation
  347. xCellXf.Alignment.Vertical = style.Alignment.Vertical
  348. xCellXf.Alignment.WrapText = style.Alignment.WrapText
  349. XfId = styles.addCellXf(xCellXf)
  350. return
  351. }
  352. func handleNumFmtIdForXLSX(NumFmtId int, styles *xlsxStyleSheet) (XfId int) {
  353. xCellXf := makeXLSXCellElement()
  354. xCellXf.NumFmtId = NumFmtId
  355. if xCellXf.NumFmtId > 0 {
  356. xCellXf.ApplyNumberFormat = true
  357. }
  358. XfId = styles.addCellXf(xCellXf)
  359. return
  360. }