Styling

Before you begin

You should get your API key from your UniCloud account.

If this is your first time using UniPDF SDK, follow this guide to set up a local development environment.

Project setup

Clone the project repository

In your terminal, clone the examples repository. It contains the Go code we will be using for this guide.

git clone https://github.com/unidoc/unipdf-examples.git

Navigate to the tables folder in the unipdf-examples directory.

cd unipdf-examples/tables

Configure environment variables

Replace the UNIDOC_LICENSE_API_KEY with API credentials from your UniCloud account.

Linux/Mac 

export UNIDOC_LICENSE_API_KEY=PUT_YOUR_API_KEY_HERE

Windows 

set UNIDOC_LICENSE_API_KEY=PUT_YOUR_API_KEY_HERE

How it works 

/*
 * This example showcases PDF tables features using unipdf's creator package.
 * The output is saved as unipdf-style-tables.pdf which illustrates how to
 * configure style in table.
 */
 
package main
 
import (
	"log"
	"os"
 
	"github.com/unidoc/unipdf/v4/common/license"
	"github.com/unidoc/unipdf/v4/contentstream/draw"
	"github.com/unidoc/unipdf/v4/creator"
	"github.com/unidoc/unipdf/v4/model"
)
 
func init() {
	// Make sure to load your metered License API key prior to using the library.
	// If you need a key, you can sign up and create a free one at https://cloud.unidoc.io
	err := license.SetMeteredKey(os.Getenv(`UNIDOC_LICENSE_API_KEY`))
	if err != nil {
		panic(err)
	}
}
 
func main() {
	c := creator.New()
	c.SetPageMargins(50, 50, 50, 50)
 
	// Create report fonts.
	// UniPDF supports a number of font-families, which can be accessed using model.
	font, err := model.NewStandard14Font(model.HelveticaName)
	if err != nil {
		log.Fatal(err)
	}
 
	fontBold, err := model.NewStandard14Font(model.HelveticaBoldName)
	if err != nil {
		log.Fatal(err)
	}
 
	// Generate styling content chapter.
	if err := stylingContent(c, font, fontBold); err != nil {
		log.Fatal(err)
	}
 
	// Write to output file.
	if err := c.WriteToFile("unipdf-style-tables.pdf"); err != nil {
		log.Fatal(err)
	}
}
 
func stylingContent(c *creator.Creator, font, fontBold *model.PdfFont) error {
	c.NewPage()
 
	// Create chapter.
	ch := c.NewChapter("Styling content")
	ch.SetMargins(0, 0, 50, 0)
	ch.GetHeading().SetFont(font)
	ch.GetHeading().SetFontSize(18)
	ch.GetHeading().SetFontColor(creator.ColorRGBFrom8bit(72, 86, 95))
 
	// Draw subchapters.
	contentBorders(c, ch, font, fontBold)
	contentBackground(c, ch, font, fontBold)
 
	// Draw chapter.
	if err := c.Draw(ch); err != nil {
		return err
	}
 
	return nil
}
 
func contentBorders(c *creator.Creator, ch *creator.Chapter, font, fontBold *model.PdfFont) {
	// Create subchapter.
	sc := ch.NewSubchapter("Cell borders")
	sc.SetMargins(0, 0, 30, 0)
	sc.GetHeading().SetFont(font)
	sc.GetHeading().SetFontSize(13)
	sc.GetHeading().SetFontColor(creator.ColorRGBFrom8bit(72, 86, 95))
 
	// Create subchapter description.
	desc := c.NewStyledParagraph()
	desc.SetMargins(0, 0, 10, 0)
	desc.Append("Customizable cell border properties:\n\n")
	desc.Append("\u2022 Border side: left, right, top, bottom, all\n")
	desc.Append("\u2022 Border style: single or double\n")
	desc.Append("\u2022 Border line style: solid or dashed\n")
	desc.Append("\u2022 Border color\n")
	desc.Append("\u2022 Border width\n")
 
	sc.Add(desc)
 
	// Create table.
	table := c.NewTable(2)
	table.SetMargins(0, 0, 10, 0)
 
	drawCell := func(text string, font *model.PdfFont, borderStyle creator.CellBorderStyle, borderSide creator.CellBorderSide, borderWidth float64, borderColor creator.Color, lineStyle draw.LineStyle) {
		p := c.NewStyledParagraph()
		chunk := p.Append(text)
		chunk.Style.Font = font
 
		cell := table.NewCell()
		cell.SetBorder(borderSide, borderStyle, borderWidth)
		cell.SetBorderColor(borderColor)
		cell.SetBorderLineStyle(lineStyle)
		cell.SetHorizontalAlignment(creator.CellHorizontalAlignmentCenter)
		cell.SetContent(p)
	}
 
	// Draw table header.
	drawCell("Border right single width 2", fontBold, creator.CellBorderStyleSingle, creator.CellBorderSideRight, 2, creator.ColorBlack, draw.LineStyleSolid)
	drawCell("Border right double", fontBold, creator.CellBorderStyleDouble, creator.CellBorderSideRight, 1, creator.ColorBlack, draw.LineStyleSolid)
 
	// Draw table content.
	drawCell("Border top single width 2", fontBold, creator.CellBorderStyleSingle, creator.CellBorderSideTop, 2, creator.ColorBlack, draw.LineStyleSolid)
	drawCell("Border bottom single width 2", fontBold, creator.CellBorderStyleSingle, creator.CellBorderSideBottom, 2, creator.ColorBlack, draw.LineStyleSolid)
 
	drawCell("Border all double", fontBold, creator.CellBorderStyleDouble, creator.CellBorderSideAll, 1, creator.ColorBlack, draw.LineStyleSolid)
	drawCell("No border", fontBold, creator.CellBorderStyleSingle, creator.CellBorderSideAll, 0, creator.ColorBlack, draw.LineStyleSolid)
 
	drawCell("Border bottom single green", fontBold, creator.CellBorderStyleSingle, creator.CellBorderSideBottom, 1, creator.ColorGreen, draw.LineStyleSolid)
	drawCell("Border top double red", fontBold, creator.CellBorderStyleDouble, creator.CellBorderSideTop, 1, creator.ColorRed, draw.LineStyleSolid)
 
	drawCell("Border all single yellow", fontBold, creator.CellBorderStyleSingle, creator.CellBorderSideAll, 1, creator.ColorYellow, draw.LineStyleSolid)
	drawCell("Border right double dashed", fontBold, creator.CellBorderStyleDouble, creator.CellBorderSideRight, 1, creator.ColorBlack, draw.LineStyleDashed)
 
	drawCell("Border bottom double solid", fontBold, creator.CellBorderStyleDouble, creator.CellBorderSideBottom, 1, creator.ColorBlack, draw.LineStyleSolid)
	drawCell("Border bottom double dashed green", fontBold, creator.CellBorderStyleDouble, creator.CellBorderSideBottom, 1, creator.ColorGreen, draw.LineStyleDashed)
 
	drawCell("Border left double blue", fontBold, creator.CellBorderStyleDouble, creator.CellBorderSideLeft, 1, creator.ColorBlue, draw.LineStyleSolid)
	drawCell("Border right double red", fontBold, creator.CellBorderStyleDouble, creator.CellBorderSideRight, 1, creator.ColorRed, draw.LineStyleSolid)
 
	drawCell("Border all double yellow", fontBold, creator.CellBorderStyleDouble, creator.CellBorderSideAll, 1, creator.ColorYellow, draw.LineStyleSolid)
	drawCell("Border all double dashed blue", fontBold, creator.CellBorderStyleDouble, creator.CellBorderSideAll, 1, creator.ColorBlue, draw.LineStyleDashed)
 
	sc.Add(table)
}
 
func contentBackground(c *creator.Creator, ch *creator.Chapter, font, fontBold *model.PdfFont) {
	// Create subchapter.
	sc := ch.NewSubchapter("Cell background")
	sc.SetMargins(0, 0, 30, 0)
	sc.GetHeading().SetFont(font)
	sc.GetHeading().SetFontSize(13)
	sc.GetHeading().SetFontColor(creator.ColorRGBFrom8bit(72, 86, 95))
 
	// Create subchapter description.
	desc := c.NewStyledParagraph()
	desc.SetMargins(0, 0, 10, 0)
	desc.Append("The background color of the cells is also customizable.")
 
	sc.Add(desc)
 
	// Create table.
	table := c.NewTable(4)
	table.SetMargins(0, 0, 10, 0)
 
	drawCell := func(text string, font *model.PdfFont, bgColor creator.Color) {
		p := c.NewStyledParagraph()
		p.SetMargins(2, 2, 0, 0)
		chunk := p.Append(text)
		chunk.Style.Font = font
		chunk.Style.Color = creator.ColorWhite
 
		cell := table.NewCell()
		cell.SetBorder(creator.CellBorderSideAll, creator.CellBorderStyleSingle, 1)
		cell.SetBackgroundColor(bgColor)
		cell.SetContent(p)
		cell.SetHorizontalAlignment(creator.CellHorizontalAlignmentCenter)
		cell.SetIndent(0)
	}
 
	// Draw table content.
	for i := 0; i < 15; i++ {
		drawCell("Content", fontBold, creator.ColorRGBFrom8bit(byte(i*20), byte(i*7), byte(i*4)))
		drawCell("Content", fontBold, creator.ColorRGBFrom8bit(byte(i*10), byte(i*20), byte(i*4)))
		drawCell("Content", fontBold, creator.ColorRGBFrom8bit(byte(i*15), byte(i*6), byte(i*9)))
		drawCell("Content", fontBold, creator.ColorRGBFrom8bit(byte(i*6), byte(i*7), byte(i*25)))
	}
 
	sc.Add(table)
}
view raw tables/pdf_tables_styling.go delivered with ❤ by emgithub

The import section in lines 9-17 imports the necessary packages and libraries. The init function in lines 19-26 loads you metered license key and authenticates your request.

The main function in lines 28-53 which is the entry point to the example code calls stylingContent function to create the document and writes it to file using c.WriteToFile("unipdf-style-tables.pdf") in line 50.

In lines 55-75 the stylingContent function is defined where the styled table is drawn. Here a new page is created using c.NewPage() and content with borders and content with background are created by calling contentBorders and contentBackground functions respectively. Finally the content which is inside a chapter object drawn using c.Draw(ch).

The function contentBorders in lines 77-141 creates a table with different content borders. Cell borders are set using cell.SetBorder method. The color and line style of the border are set using SetBorderColor and SetBorderLineStyle methods. The SetBorder method of a tableCell takes two arguments, which determine the side where the border should be added and the style of the border added. The border side could be either of the following values. CellBorderSideLeft, CellBorderSideRight,CellBorderSideTop, CellBorderSideBottom or CellBorderSideAll.

And the border style could be CellBorderStyleNone,CellBorderStyleSingle or CellBorderStyleDouble.

A content with background is created using the function contentBackground. The background color of cell is set using cell.SetBackgroundColor(bgColor) which is done in line 171.

Run the code 

go run pdf_tables_styling.go

Sample output

PDF table styling

Got any Questions?

We're here to help you.

Contact us