<text>

<text> 
The <text> tag defines a text area, that can hold multiline characters. The contents entered here, can be customized using the text attributes.  
Parent tag : <pc>
Child tag   : <prefix>, <suffix>
Attributes
typeThe type attribute specifies the kind of text to be displayed.
valueThe value attribute defines the specific value to be displayed in the text area. 
criteriaThe criteria attribute specifies a fetching criteria for filtering the text to be displayed.
numberScaleThe numberScale attribute adds a pseudo-metric symbol to the numeric value in the text.
decimalPlacesThe decimalPlaces attribute specifies the number of digits to be displayed after a decimal point. 
thousandsSeparatorThe thousandsSeparator attribute specifies the symbol to be used to separate each group of thousands.  
decimalSeparatorThe decialSeparator attribute specifies a symbol to be used to separate the integer part of a number from the fractinal part.
fontFamilyThe fontFamily attribute specifies a font style for the text. 
sizeThe size attribute defines a font size for the text. 
boldThe bold attribute adds a bold font style to the text. 
italicThe italic attribute italicizes the font.
colorThe color attribute specifies a font color for the text.
bgColorThe bgColor attribute specifies a background color for the <text> element.
paddingThe padding attribute generates a specified amount of space between all sides of the text content and it's container. 
paddingTopThe paddingTop attribute generates a specified amount of space between the top of the text content and it's container.
paddingRightThe paddingRight attribute generates a specified amount of space between the right of the text content and it's container.
paddingBottomThe paddingBottom attribute generates a specified amount of space between the bottom of the text content and it's container.
paddingLeftThe paddingLeft attribute generates a specified amount of space between the left of teh text content and it's container.
marginThe margin attribute generates a specified amount of space between all sides of the text container and it's parent. 
marginTopThe marginTop attribute generates a specified amount of space between the top of the text container and it's parent.
marginRightThe marginRight attribute generates a specified amount of space between the right of the text container and it's parent.
marginBottomThe marginBottom attribute generates a specified amount of space between the bottom of the text container and it's parent.
marginLeftThe marginLeft attribute generates a specified amount of space between the left of the text container and it's parent.
actionThe action attribute specifies the action to be triggered on click of the text.
urlThe url attribute specifies the resource location to be opened on click of the text.
componentLinkNameThe componentLinkName attribute specifies the link name of the Zoho Creator component to be opened on click of the text.
appLinkNameThe appLinkName attribute specifies the name of the Zoho Creator application to which the associated component belongs.
functionNameThe functionName attribute specifies the name of the custom function in the Zoho Creator application to be triggered on click of the text.
parametersThe parameters attribute specifies the parameter to be associated to an action.
successMessageThe successMessage attribute specifies the message to be displayed on successful execution of the specified function.
targetThe target attribute specifies the location where the linked action will open on click of the text. 
popupWidthThe popupWidth attribute specifies a width for the pop-up window where the link will be opened.
popupHeightThe popupHeight attribute specifies a height for the pop-up window where the link will be opened.
type
Possible Values
  • Text
  • Form Data

Default Value

  • Text
value
Possible Values
typevalueExample

Text

Specify a static string

<text  type='Text'  value='Hello World'/>

Form Data

Fetches a value from a Zoho Creator application's form, based on the said aggregate.

<text type='Form Data'  value='appLinkName.componentLinkname.fieldLinkName.aggregate'/>#

Note:  

  • #An aggregate must be specifies for the Form Data attribute.
  • The aggregate values that can be computed are: sum, minimum, maximum, median, average, count, distinctCount

AggregateDescriptionSyntax

sum

Computes the sum of all the values in a specified form field.

<text  type='Form Data'  value='appLinkName.formlinkname.fieldlinkname.sum'/>

minimum

Computes the minimum of all values in a specified form field.

<text  type='Form Data'  value='appLinkName.formlinkname.fieldlinkname.minimum'/>
maximumComputes the maximum of all values in a specified form field.<text  type='Form Data'  value='appLinkName.formlinkname.fieldlinkname.maximum'/>
medianComputes the median of all values in a specified form field.<text  type='Form Data'  value='appLinkName.formlinkname.fieldlinkname.median'/>
averageComputes the average of all values in a specified form field.<text  type='Form Data'  value='appLinkName.formlinkname.fieldlinkname.average'/>
countComputes the count of all the records in a specified form.<text  type='Form Data'  value='appLinkName.formlinkname.ID.count'/>
distinctCountComputes the distinct number of occurances of a value in a specified form field.<text  type='Form Data'  value='appLinkName.formlinkname.fieldlinkname.dictinctCount'/>

  • value acts as a source attribute. i.e: Attributes including size, bold, italic, fontFamily, color and bgColor  are styling attributes for the text content and applicable only when a value is specified.
criteria
Syntax
<text type='Form Data'  value='Student_management.term_exam.marks.maximum' criteria='class==&quot;12&quot;'/> 

Note:  

  • criteria attribute is optional. 
  • criteria attribute can be used to add an additional filter to display a specified aggregate. 
numberScale
Possible Values
  • K (Thousand)
  • M (Million)
  • B (Billion)

Example

Syntax<text value='thisapp.Products.Unit_Price.sum' numberScale='K'/>
Output 

Note:  

  • numberScale attribute is optional. 
 decimalPlaces
Possible Values
  • A number from 0-3.

Example

Syntax<text value='thisapp.Products.Unit_Price.sum' decimalPlaces='2'/>
Output 

Note:  

  • decimalPlaces attribute is optional. 
thousandsSeparator
Possible Values
  • , (Comma symbol) 
  • . (Period symbol )

Example

Syntax<text value='thisapp.Products.Unit_Price.sum' thousandSeparator=','/>
Output 

Note:  

  • thousandseparator attribute is optional. 
decimalSeparator
Possible Values
  • , (Comma symbol) 
  • . (Period symbol) 

Example

Syntax<text value='thisapp.Products.Unit_Price.sum' decimalSeparator='.'/>
Output 

Note:  

  • decimalseparator attribute is optional. 
size
Possible Values
  • A number from 1 - 9 that defines the size of the text. 

Default Value

  • 4

Example

Syntax

<text type='Text' value='Hello World' size='8'/>

          

Output 

Note:

  • size attribute is optional.
bold
Possible Values
  • true
  • false

Default Value

  • ​​false

Example

Syntax<text type='Text' value='Hello World' bold='true'/>
Output 

Note:

  • bold attribute is optional.
italic
Possible Values
  • true
  • false

Default Value

  • false

Example

Syntax<text type='Text' value='Hello World' italic='true'/>
Output

Note:

  • italic attribute is optional.

 

color
Possible Values
  • A hexadecimal color value. You can refer this page for hexadecimal color codes.

Example

Syntax<text type='Text' value='Hello World' color='#FF00FF'/>
Output

 

Note:

  • color attribute is optional.
fontFamily
Possible Values 
  • Arial
  • Georgia
  • Lato
  • Proxima nova
  • Roboto
  • Roboto slab

Example 

Syntax<text type='Text' value='Hello World' fontFamily='Georgia'/>
Output 

 

Note:  

  • fontFamily attribute is optional. Applicable only when a value is specified.
  • If no fontFamily is specified for a value, the text acquires the fontFamily of the application theme. Each application theme uses a different fontFamily.
bgColor
Possible Values 
  • A hexadecimal color value. Refer this page for hexadecimal color codes.

Example

Syntax<text value='Hello World' bgColor='#047B33'/>
Output 

 

Note:  

  • bgColor attribute is optional. Applicable only when a value is specified.
padding
Possible Values 
  • A numeric value in pixels
Syntax<text value='Hello World' padding='20px'/>
Output 

Note:  

  • padding attribute is optional.
paddingTop
Possible Values 
  • A numeric value in pixels
Syntax<text value='Hello World' paddingTop='50px'/>
Output 

Note:  

  • paddingTop attribute is optional.
paddingRight
Possible Values 
  • A numeric value in pixels
Syntax<text value='Hello World' paddingRight='20px'/>
Output 

Note:  

  • paddingRight attribute is optional.
paddingBottom
Possible Values 
  • A numeric value in pixels
Syntax<text value='Hello World' margin='50px'/>
Output 

Note:  

  • paddingBottom attribute is optional
paddingLeft
Possible Values 
  • A numeric value in pixels
Syntax<text value='Hello World' margin='20px'/>
Output 

Note:  

  • paddingLeft attribute is optional
margin
Possible Values 
  • A numeric value in pixels

Example

Syntax<text value='Hello World' margin='50px'/>
Output 

 

Note:  

  • margin attribute is optional
marginTop
Possible Values 
  • A numeric value in pixels

Example

Syntax<text value='Hello World' marginTop='50px'/>
Output 

 

Note:  

  • marginTop attribute is optional
marginRight
Possible Values 
  • A numeric value in pixels

Example

Syntax<text value='Hello World' marginRight='400px'/>
Output 

 

Note:  

  • marginRight attribute is optional
marginBottom
Possible Values 
  • A numeric value in pixels

Example

Syntax<text value='Hello World'' marginBottom='50px'/>
Output 

 

Note:  

  • marginBottom attribute is optional
marginLeft
Possible Values 
  • A numeric value in pixels

Example

Syntax<text value='Hello World' marginLeft='400px'/>
Output 

 

Note:  

  • marginLeft attribute is optional
action
Possible Values 
  • Link
  • Form
  • Report
  • Page
  • Function 

Example

actionSyntax

Link

<text value='Hello World'  action='Link'   url='A URL to be opened '/>*

Form

<text value='Hello World'   action='Form'   componentLinkName='linkname of the Zoho Creator form to be opened'   appLinkName='linkname of the Zoho Creator application to which the form belongs' />*
Report<text value='Hello World'  action='Report'   componentLinkName='linkname of the Zoho Creator report to be opened'   appLinkName='linkname of the Zoho Creator application to which the report belongs' />*
Page<text value='Hello World'   action='Page'   componentLinkName='linkname of the Zoho Creator page to be opened'   appLinkName='linkname of the Zoho Creator application to which the page belongs' />*
Function<text value='Hello World'  action='Function'   functionName='Name of the custom function to be triggered' />*

* Learn in detail about each of the action types in the following sections.

 

Note:  

  • action attribute is optional.
  • The action attribute acts as a source attribute. i.e: One or more of the following attributes viz: url, componentLinkName, appLinkName, functionName, parameters, successMessage, target, popupWidth and popupHeight will be applicable only when an action  is specified.
url
Possible Values 
  • A url pointing to another website
  • A url pointing to a component within your Zoho Creator Account

Example 

  • <text action='Link' url='https://www.zoho.com/creator/'>

Note:  

  • url attribute is optional.​ 
  • It is applicable only when <action='Link'> 
componentLinkName
Possible Values 
  • Linkname of the Zoho Creator Application component to be opened. Refer to this page for the link names of all the components across all applications in your Zoho Creator Account.

Example 

actionSyntax
Form<text value='Hello World' action='Form' componentLinkName='User_Details'/>
Report<text value='Hello World' action='Report' componentLinkName='User_Details_Report'/
Page<text value='Hello World' action='Page' componentLinkName='User_Dashboard'/>

 

Note:  

  • componentLinkName attribute is optional.​ 
  • It is applicable only when <action='Form'/'Report'/'Page'>
appLinkName
Possible Values 
  • Linkname of the Zoho Creator Application to be opened. Refer to this page for the link names of all the applications in your Zoho Creator Account.

Example

actionSyntax
Form<text value='Hello World' action='Form' componentLinkName='User_Details' appLinkName='Resource_management'/>
Report<text value='Hello World' action='Report' componentLinkName='User_Details_Report' appLinkName='Resource_management'/>
Page<text value='Hello World' action='Page' componentLinkName='User_Dashboard' appLinkName='Resource_management'/>

 

Note:  

  • appLinkName attribute is optional.​ You do not need to specify appLinkName if the component you are associating to the action, belongs to the same application you are currently in.
  • It is applicable only when <action='Form'/'Report'/'Page'/'Function'>
functionName
Possible Values 
  • A custom function defined in any of your Zoho Creator Applications. To get the list of custom functions in your application: Go to Settings -> Extensions ->  Custom Functions

Example

  • <text value='Hello World' action='Function' functionName='send_email'/>

Note:  

  • The functionName can belong to a default namespace or a custom namespace.
  • If the function belongs to a custom namespace : <functionName='namespace_name.function_name'>
  • functionName attribute is optional.
  • It is applicable only when <action='Function'> and a function name must be specified.
parameters
Possible Values 
  • When <action='Form' / 'Report' / 'Page'>, parameters refers to the query string that will be appended to the corresponding component's permalink. Refer to this page to learn about using query strings in permalinks of forms, reports and pages.
  • When <action='Function'>, parameters refers to an argument of the selected custom function.​

Example

actionSyntax

Form

<text value='Hello World'   action='Form' componentLinkName='User_Details'   appLinkName='Resource_management'  parameters='App_name=${name}'/>

OR

<text value='Hello World' action='Form' componentLinkName='User_Details'   appLinkName='Resource_management'  parameters='App_name=Zoho Creator'/>

Report

<text value='Hello World'  action='Report'   componentLinkName='User_Details'   appLinkName='Resource_management' parameters='App_name=${name}' />

or

<text value='Hello World'   action='Form' componentLinkName='User_Details'   appLinkName='Resource_management'  parameters='User_Name='Rob'/>

 

Page<text value='Hello World'   action='Page'   componentLinkName='linkname of the Zoho Creator page to be opened'   appLinkName='linkname of the Zoho Creator application to which the page belongs' parameters='App_name=${name}' />*

 

Note:  

  • parameter attribute is optional.
  • It is applicable only when <action='Form'/'Report'/'Page'/'Function'>
  • parameters can either be a static value like: Name='Rob' or a page parameter.
  • Page parameter must be specified as :  App_name=${name}, where name is the page parameter. 
successMessage
Possible Values
  • A string

Example

  • <text value='Hello World' action='Function' functionName='send_email' successMessage='Sent Successfully!'/>

Note:  

  • successMessage attribute is optional.
  • It is applicable only when <action='Function'>
target
Possible Values 
  • new-window 
  • same-window
  • popup

Default Value 

  • new-window

Note:

  • It is applicable only when <action='Link'/'Form'/'Report'/'Page'>
popupWidth
Possible Values 
  • A numeric value in percentage or pixels 
popupHeight
Possible Values 
  • A numeric value in percentage or pixels 

Share this post : FacebookTwitter

Still can't find what you're looking for?

Write to us: support@zohocreator.com