table: defaults for row/header/footer align/valign; fixes #340 #341

jedib0t · 2024-11-17T16:10:52Z

Proposed Changes

the default align/valign option for every row (header+footer) is text.AlignDefault and text.VAlignDefault
expose these as customizable options in table.Style().Format

To change the defaults, you'd do something like this:

		tw := table.NewWriter()
		tw.AppendHeader(table.Row{"#", "First\nName", "Last\nName", "Final\nState", "Misc.\nMulti-line\nNotes"})
		tw.AppendRows([]table.Row{
			{1, "Arya", "Stark", ":) 8)"},
			{20, "Jon", "Snow", ":( :( :(", "You know nothing, Jon Snow!"},
			{300, "Tyrion", "Lannister", ":)"},
		})
		tw.AppendFooter(table.Row{"#", "First\nName", "Last\nName", "Final\nState", "Misc.\nMulti-line\nNotes"})
		tw.SetStyle(table.StyleLight)
		tw.Style().Format.HeaderAlign = text.AlignCenter
		tw.Style().Format.HeaderVAlign = text.VAlignBottom
		tw.Style().Format.FooterAlign = text.AlignRight
		tw.Style().Format.FooterVAlign = text.VAlignTop
		fmt.Println(tw.Render())

to get:

┌─────┬────────┬───────────┬──────────┬─────────────────────────────┐
│     │        │           │          │            MISC.            │
│     │  FIRST │    LAST   │   FINAL  │          MULTI-LINE         │
│   # │  NAME  │    NAME   │   STATE  │            NOTES            │
├─────┼────────┼───────────┼──────────┼─────────────────────────────┤
│   1 │ Arya   │ Stark     │ :) 8)    │                             │
│  20 │ Jon    │ Snow      │ :( :( :( │ You know nothing, Jon Snow! │
│ 300 │ Tyrion │ Lannister │ :)       │                             │
├─────┼────────┼───────────┼──────────┼─────────────────────────────┤
│   # │  FIRST │      LAST │    FINAL │                       MISC. │
│     │   NAME │      NAME │    STATE │                  MULTI-LINE │
│     │        │           │          │                       NOTES │
└─────┴────────┴───────────┴──────────┴─────────────────────────────┘

Remember that column-configs takes precedence and will override the above.