pc Tag | Zoho Creator Help

pc tag

<pc> 

The <pc> tag defines a column within a panel row. 
Parent tag : <pr>
Child tag   : <pr>, <text>, <image>, <button>

Attributes
1. width

The width attribute defines a width for the <pc>. 

Example

Syntax

<pr width='fill'>

<pc width='50%' bgColor='#2A70E7'>

<text type='Text' value='Zoho Creator'/> 

</pc>

<pc width='50%' bgColor='#00D9B1'>

<text type='Text' value='Zoho Creator'/> 

</pc>

</pr>

Output

Note:  

  • width attribute is applicable to <pc> only when <pr width='fill'>

2. padding

The padding attribute generates a specified amount of space between the all sides of the <pc> and it's child element. 

Possible Values
  • A numeric value in pixels 

Example

Syntax

<pr width='fill'>

<pc width='100%' padding='20px'></pc>

</pr>

Output

Note:  

  • padding attribute is optional.

3. paddingTop

The paddingTop attribute generates a specified amount of space between the top side of the <pc> and it's child element.

Possible Values 
  • A numeric value in pixels

Example

Syntax

<pr width='fill'>

<pc width='100%' paddingTop='50px'></pc>

</pr>

Output

Note:  

  • paddingTop attribute is optional

4. paddingRight

The paddingRight attribute generates a specified amount of space between the right side of the <pc> and its child element.

Possible Values 
  • A numeric value in pixels

Example

Syntax

<pr width='fill'>

<pc width='100%'>

<pr>

<pc>

<text value='Zoho Creator'/></pc>

<pc paddingRight='25px' bgColor='#00D9B1'>

<text value='Zoho Creator'/></pc>

</pr>

</pc>

</pr>

Output

Note:  

  • paddingRight attribute is optional

5. paddingBottom

The paddingBottom attribute generates a specified amount of space between the bottom side of the <pc> and it's child element.

Possible Values 
  • A numeric value in pixels

Example

Syntax

<pr width='fill'>

<pc width='100%' paddingBottom='50px'></pc>

</pr>

Output

Note:  

  • paddingBottom attribute is optional

6. paddingLeft

The paddingLeft attribute generates a specified amount of space between the the left side of the <pc> and it's child element.

Possible Values 
  • A numeric value in pixels

Example

Syntax

<pr width='fill'>

<pc width='100%'>

<pr>

<pc>

<text value='Zoho Creator'/></pc>

<pc paddingLeft='25px' bgColor='#00D9B1'>

<text value='Zoho Creator'/></pc>

</pr>

</pc>

</pr>

Output


Note:  

  • paddingLeft attribute is optional

7. bgColor

The bgColor attribute specifies a background color for the <pc> element.

Possible Values
  • A hexadecimal color value. Refer this link for hexadecimal color codes.

Default Value

  • #FFFFFF

Example

Syntax<pc bgColor='#2A70E7'>
Output

 

8. hAlign

The hAlign attribute specifies the horizontal positioning of the contents within the <pc>.

Possible Values 
  • left
  • center
  • right

Default Value 

  • center

Example

Syntax

<pc hAlign='left'>

<text type='Text' value='Zoho Creator'/>

</pc>

Output


9. vAlign

The vAlign attribute specifies the vertical positioning of the contents within the <pc>.

Possible Values 
  • top
  • middle
  • bottom 

Default Value 

  • middle 

Example 

Syntax

<pc vAlign='top'>

<text type='Text' value='Zoho Creator'/>

</pc>

Output

 
10. action

The action attribute specifies the action to be triggered on click of the <pc>.

Possible Values 
  • Link
  • Form
  • Report
  • Page
  • ExecuteFunction 

Example

actionSyntax

Link

<pc   action='Link'   url='A URL to be opened '></pc>*

Form

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

* 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.

11. url

The url attribute specifies the resource location to be opened on click of the <pc>. 

Possible Values 
  • A url pointing to another website
  • A url pointing to a component within your Zoho Creator Account

Example 

Note:  

  • url attribute is optional. 
  • It is applicable only when <action='Link'> 

12. componentLinkName

The componentLinkName attribute specifies the link name of the Zoho Creator component to be opened on click of the <pc>.

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<pc action='Form' componentLinkName='User_Details'></pc>
Report<pc action='Report' componentLinkName='User_Details_Report'></pc>
Page<pc action='Page' componentLinkName='User_Dashboard'></pc>

Note:  

  • componentLinkName attribute is optional. 
  • It is applicable only when <action='Form'/'Report'/'Page'>

13. appLinkName

The appLinkName attribute specifies the name of the Zoho Creator application to which the associated component belongs.

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<pc action='Form' componentLinkName='User_Details' appLinkName='Resource_management'></pc>
Report<pc action='Report' componentLinkName='User_Details_Report' appLinkName='Resource_management'></pc>
Page<pc action='Page' componentLinkName='User_Dashboard' appLinkName='Resource_management'></pc>

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'/'ExecuteFunction'>

14. functionName

The functionName attribute specifies the name of the custom function to be triggered on click of the <pc>.

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

  • <pc action='ExecuteFunction' 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='ExecuteFunction'> and a function name must be specified.

15. parameters

The parameters attribute specifies query parameter to be associated to an action on click of the <pc>.

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='ExecuteFunction'>, parameters refers to an argument of the selected custom function.

Example

actionSyntax

Form

<pc  action='Form' componentLinkName='User_Details'   appLinkName='Resource_management'  parameters='App_name=${name}'></pc>

OR

<pc  action='Form' componentLinkName='User_Details'   appLinkName='Resource_management'  parameters='App_name=Zoho Creator'></pc>

Report

<pc   action='Report'   componentLinkName='User_Details'   appLinkName='Resource_management' parameters='App_name=${name}' ></pc>

or

<button text='button label'   action='Form' componentLinkName='User_Details'   appLinkName='Resource_management'  parameters='User_Name='Rob'></pc>

Page<pc  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}'></pc>*

Note:  

  • parameter attribute is optional.
  • It is applicable only when <action='Form'/'Report'/'Page'/'ExecuteFunction'>
  • 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. 

16. successMessage

The successMessage attribute specifies the message to be displayed on successful execution of the associated function.

Possible Values
  • A string

Example

  • <pc action='ExecuteFunction' functionName='send_email' successMessage='Sent Successfully!'></pc>

Note:  

  • successMessage attribute is optional.
  • It is applicable only when <action='ExecuteFunction'>

17. target

The target attribute specifies the location where the linked action will open on click of the <pc>.

Possible Values 
  • new-window 
  • same-window
  • popup

Default Value 

  • new-window

Note:

  • It is applicable only when <action='Link'/'Form'/'Report'/'Page'>

18. popupWidth

The popupWidth attribute specifies a width for the pop-up window where the link will be opened.

Possible Values 
  • A numeric value in percentage or pixels 

19. bgtype

The bgtype attribute specifies the background image of the <pc>.

Possible Values
  • gallery

Note:

  • bgtype attribute is optional.

20. bgImagePosition

The bgImagePosition attribute specifies the position of the background image in the <pc>.

Possible Values
  • fill
  • fit
  • tile

Default Value

  • fill

Note:

  • It is applicable only when bgtype attribute is set for the <pc>.

21. bgImageRepeat

The bgImageRepeat attribute specifies if the <pc> is being repeated.

Possible Values
  • repeat
  • repeat-x
  • repeat-y
  • no-repeat

Default Value

  • repeat

Note:

  • It is applicable only when bgtype attribute is set for the <pc> and bgImagePosition='tile'

22. bgHorizontalAlign

The bgHorizontalAlign attribute specifies the horizontal alignment of the background image in the <pc>.

Possible Values
  • left
  • center
  • right

Default Value

  • left

Note:

  • It is applicable only when bgtype attribute is set for the <pc> and bgImagePosition is 'fill' or 'fit'

23. bgVerticalAlign

The bgVerticalAlign attribute specifies the vertical alignment of the background image in the <pc>.

Possible Values
  • top
  • center
  • bottom

Default Value

  • top

Note:

  • It is applicable only when bgtype attribute is set for the <pc> and bgImagePosition is 'fill' or 'fit'

24. bgImage

The bgImage attribute specifies which image from the library of your account is set as the <pc> tag's background.

Possible Values
  • Filename of an image from the image library of your account

Note:

  • It is applicable only when bgtype attribute is set for the <pc>.
25. overlayColor

The overlayColor attribute specifies the color which is to be laid over the <pc>.

Possible Values
  • A hexadecimal color value

Default Value

  • #0000007f
Related Topics
  1. <panel>
  2. <pr> (Panel row)
  3. <text>
  4. <prefix>
  5. <suffix>
  6. <image>
  7. <button>