Text Label

This article describes how to configure the text label component and each of its properties.

The text label displays text within a Squirrel project. It can be styled to suit a project theme.

Select Text Label from the text category of the component library. Move the mouse cursor over the canvas and click to add a text label to your project:

Text Label Properties

The Text Label properties consist of LABEL TEXT, TEXT STYLING, BACKGROUND, and a DYNAMIC VISIBILITY drawers. This guide will not describe the dynamic visibility properties as these are generic to each visible component, a separate guide and tutorial on dynamic visibility can be found here.

LABEL TEXT:

• • Text to display – This property contains the text content that will be displayed in the Text Label. This can be set in two ways:
    • Typing text or pasting text directly into the property field.
    • Binding to a cell, or cells in the spreadsheet. (Binding to more than one cell will add the contents of those cells as a comma separated list within the text label.)

• Allow scrolling – Checking this property will add a vertical scrollbar to the text label if the text content is larger than the text label.

STYLING:

• • Font – Choose a font style from the dropdown list

• • Size – Change the font size of the text label in 3 ways:
    • Using the spinner buttons
    • Typing in a value
    • Binding to a value in a spreadsheet cell

• • Line height – Use this property to adjust the line spacing of the text label. Choose one of the options from the dropdown list.

• B I U – Use these toggle buttons (bold, italic, underline) to change the format of the text label. When toggled to on, the button is blue:

• • Text color – The text will be shown in the colour that matches the value entered in the property field. This can be set in 3 ways:
    • Clicking the coloured rectangle and using the colour picker
    • Typing in a colour value
    • Binding to a colour value in a spreadsheet cell

• • Opacity – This determines the transparency of the text. This property can be set in 3 different ways:
    • Using the spinner buttons
    • Typing in a value
    • Binding to value in a spreadsheet cell

• Text alignment – Choose to align the text to the left, right, or centre. The current selection is indicated by the blue button:

• Content alignment – Choose to vertically align the text content to the top, centre or bottom of the text label component. The current selection is indicated by the blue button:

• • Padding – This property defines the space between the text label border and the text label content. It can be set in 3 ways:
    • Using the spinner buttons
    • Typing in a value
    • Binding to value in a spreadsheet cell

• Capitalization – Change the letter case of the text label content to either uppercase first letter, all uppercase letters or all lowercase. Deselecting all of the buttons will return the content to its original case format. The current selection is indicated by the blue button:

• Number format – This property is only available if a Capitalization property hasn’t been selected. Select an option from the dropdown:
  • Automatic – This option will automatically format a number displayed within the text label.
  • Percentage – Adds a percentage symbol to the end of the number value.
  • Currency –
    • Currency symbol – select an option from the dropdown box. The chosen currency symbol will be added to the number value.
  • Number – Defines the value as a number
  • DateTime –
    • Date format – Set the date format by choosing an option from the dropdown box.
    • Include time – Check the include time option to include time data.
    • Time format – Set the time format by choosing an option from the dropdown box.
  • Decimal places – Available when percentage, currency or number is selected in the Number format property. Enter a value to ensure that any decimal number displayed in the text label is shown reduced to that number of decimal spaces.
  • Use thousands separator – Available when currency or number is selected in the Number format property. Check this option to group the value into thousands. This allows rapid judgement of the number of digits for example 100,000,000 is much easier to read than 100000000.

BACKGROUND:

• • Fill – When checked, the background of the text label will be filled with a colour that matches the value entered in the property field. This can be set in 3 ways:
    • Clicking the coloured rectangle next to the Fill checkbox and using the colour picker
    • Typing in a colour value
    • Binding to a colour value in a spreadsheet cell

• • Opacity – This determines the transparency of the background of the text label. This is only available when the Fill checkbox is checked. Opacity can be set in 3 different ways:
    • Using the spinner buttons
    • Typing in a value
    • Binding to value in a spreadsheet cell

• Border – This property is unchecked by default. Check to add a border to the text label. Set the colour and opacity properties as above.