{"id":14641,"date":"2015-09-29T13:10:09","date_gmt":"2015-09-29T12:10:09","guid":{"rendered":"https:\/\/help.instantatlas.com\/dashboard-builder-desktop\/desktop-user-guide\/the-instantatlas-designer\/creating-a-new-design\/button\/text-properties\/"},"modified":"2020-11-26T16:01:07","modified_gmt":"2020-11-26T16:01:07","slug":"text-properties","status":"publish","type":"page","link":"https:\/\/help.instantatlas.com\/instantatlas-desktop\/en\/welcome\/desktop-user-guide\/the-instantatlas-designer\/creating-a-new-design\/button\/text-properties\/","title":{"rendered":"Text"},"content":{"rendered":"

If you view the properties for a text component, you will see that you can specify a rotation value in degrees for display of the text in the report. You will also see a \u2018Use word wrap?\u2019 checkbox and \u2018Word wrap at\u2019 box. If you select the \u2018Use word wrap?\u2019 checkbox you will then be able to enter a value into the \u2018Word wrap at\u2019 box. This determines how far to the right text will run before wrapping onto a new line.<\/p>\n

\"\"<\/a><\/p>\n

Text components can contain dynamic variables which are enclosed with ${…}. Any text that is not enclosed in ${…} is static. Dynamic variables (along with the logic tests discussed below) do bring a lot of flexibility to the look and feel of reports. Dynamic text can also be placed in the title bars of the components or in the table column headers.<\/p>\n

\"\"<\/a><\/p>\n

The image above shows the properties for a text component with dynamic text variables. You can edit the static text and can also add and delete dynamic variables. Right click in the \u2018Text\u2019 box of the dialog to view the list of dynamic variables available. Hold your mouse pointer over each of the variable names to view a description. Click on a variable to insert it into the \u2018Text\u2019 box. Clearly, the text will not be displayed in the report as ${themeName} >> ${indicatorName} ${notEmpty(date, ‘>> ‘)} ${date} ${notEmpty(filterName, ‘>> Filter: ‘)} ${filterName} ${notEmpty(filterValue, ‘>> ‘)} ${filterValue}. Rather, it might be displayed as shown in the image below.<\/p>\n

\"figure73\"<\/a><\/p>\n

You can see that in this case, themeName resolves as \u2018Social deprivation\u2019, indicatorName as \u2018% of population unemployed\u2019, date as \u20182005\u2019, filterName as \u2018Zones\u2019 and filterValue as \u2018Edinburgh South\u2019.<\/p>\n

For the text found in the title of the Map component there are also some logic tests involved. These can be applied to any text strings to prevent errors where no data is associated with the text variable. The first logic test is:<\/p>\n

${notEmpty(date, ‘>> ‘)}<\/p>\n

In plain English this translates as the following:<\/p>\n

\u201cIf, and only if, the value for date is not null and is not an empty bit of text, then write out the following text\u2026\u201d<\/p>\n

So, the rule for this type of dynamic text entry is:<\/p>\n

${test(condition, textIfConditionIsTrue)}<\/p>\n

Another example involving the same logic test is the Scatter Plot component title text:<\/p>\n

\u201c${notEmpty(scatterplotCorrelation, ‘Correlation coefficient (r) = ‘ + scatterplotCorrelation + ‘ >> r-squared = ‘ + scatterplotRSquare + ‘, Regression Equation: y = ‘ + scatterplotGradient + ‘x + ‘ + scatterplotIntercept)}\u201d<\/p>\n

Note that the textIfConditionIsTrue part is \u201craw\u201d (i.e. it\u2019s the JavaScript code that will be evaluated if the condition is true). So, in this case, you need to parcel up the dynamic variables scatterplotCorrelation, scatterplotRSquare, scatterplotGradient and scatterplotIntercept using the + operator and put static text in quotes.<\/p>\n

The available logic tests are:<\/p>\n