ZML image tag and its attributes | Zoho Creator Help

Image tag

<image> 
The <image> tag defines an image.
Parent tag : <pc>
Child tag   :  --

Attributes

1. Type

The type attribute specifies the type of image to be added.

Possible Values 
  • icon 
  • computer
  • weburl
Default Values
  • weburl

2. value

The value attribute specifies the path or name of the image or icon.

Possible Values 
  • The value attribute depends on the type.
Type ValueExample

icon  

Specify the icon name using the following syntax:

 icon-class* <space> icon-name

<image type='icon' value='zc-li-solid shopping-tag'/>

gallery

Specify the name of the image as stored in the image library.

<image type='gallery' value='product1.jpeg'/>

weburl

Specify the image url.<image type='weburl' value='https://www.zoho.com/sites/default/files/creator5-logo-2x.png'>/


Notes

 Note:  

  • *icon-class refers to solid or outline icons.
  • Use one of the prebuilt icon-class : zc-li-solid or zc-li-outline
  • Supported image formats: .jpeg, .jpg, .png. Maximum size of upto 2 MB is permissible.
 
3. size

The size attribute specifies the size of the icon.

Possible Values 
  • A number from 1-9.

Default Value

  • 4

Example

Syntax

<image type='icon' value='zc-li-solid weather-fahrenheit' size='4'/>

Output

Notes

Note:  

  • size attribute is applicable only when type='icon'

4. cornerRadius

The cornerRadius attribute defines rounded corners for an image 

Possible Values 
  • A numeric value in pixels

Example

Syntax<image type='icon' value='zc-li-outline travel-world' cornerRadius='5'/>

Output


Notes
 Note:  
  • cornerRadius attribute is optional.

5. color

The color attribute specifies a color for the icon. 

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

Example

Syntax

<image type='icon' value='zc-li-solid sport-tennis-ball' color='#B3EB31'/>

Output

Notes

Note:  

  • color attribute is optional.
  • It is applicable only for <type='icon'/>

6. bgColor

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

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


Notes
Note:  
  • bgColor attribute is optional.

7. width

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

Possible Values 
  • A numeric value in pixels

Example

Syntax<image type='computer' value='scenary.jpg' width='500px'/>
Output


Notes
Note:  
  • width attribute is optional.
 
8. height

The height attribute defines a height for the <image>.

Possible Values 
  • A numeric value in pixels

Example

Syntax<image type='computer' value='eiffel-tower.jpg' height='400px'/>
Output


Notes
Note:  
  • height attribute is optional.

9. padding

The padding attribute generates a specified amount of space between the image and it's border.

Possible Values 
  • A numeric value in pixels
Example
Syntax<image type='computer' value='Custom-apps.jpg' padding='10px'/>
Output 


Notes
Note:  
  • padding attribute is optional.

10. paddingTop

The paddingTop attribute generates a specified amount of space between the image and the top side of it's border.

Possible Values 
  • A numeric value in pixels
Example
Syntax<image type='computer' value='Custom-apps.jpg' paddingTop='10px'/>
Output 


Notes
 Note:  
  • paddingTop attribute is optional.

11. paddingRight

The paddingRight attribute generates a specified amount of space between the image and the right side of its border.

Possible Values 
  • A numeric value in pixels
Example
Syntax<image type='computer' value='Custom-apps.jpg' paddingRight='10px'/>
Output 

 
Notes
Note:  
  • paddingRight attribute is optional.

12. paddingBottom

The paddingBottom attribute generates a specified amount of space between the image and the bottom side of its border.

Possible Values 
  • A numeric value in pixels
Example
Syntax<image type='computer' value='Custom-apps.jpg' paddingBottom='10px'/>
Output 

Notes
 Note:  
  • paddingBottom attribute is optional

13. paddingLeft

The paddingLeft attribute generates a specified amount of space between the image and the left side of its border.

Possible Values 
  • A numeric value in pixels
Example
Syntax<image type='computer' value='Custom-apps.jpg' paddingLeft='10px'/>
Output 

Notes
 Note:  
  • paddingLeft attribute is optional

14. margin

The margin attribute generates a specified amount of space between all foure sides of the image and it's parent container. 

Possible Values 
  • A numeric value in pixels
Example
Syntax<image type='computer' value='Custom-apps.jpg' margin='20px'/>
Output 

Notes
 Note:  
  • margin attribute is optional

15. marginTop

The marginTop attribute generates a specified amount of space between the top side of the image and it's parent container.

Possible Values 
  • A numeric value in pixels
Example
Syntax<image type='computer' value='Custom-apps.jpg' marginTop='20px'/>
Output 

 Note:  
  • marginTop attribute is optional

16. marginRight

The marginRight attribute generates a specified amount of space between the right side of the image and it's parent container.

Possible Values 
  • A numeric value in pixels
Example
Syntax<image type='computer' value='Custom-apps.jpg' marginRight='400px'/>
Output 

 Note:  
  • marginRight attribute is optional

17. marginBottom

The marginBottom attribute generates a specified amount of space between the bottom side of the image and its parent container.

Possible Values 
  • A numeric value in pixels
Example
Syntax<image type='computer' value='Custom-apps.jpg' marginBottom='20px'/>
Output 

 Note:  
  • marginBottom attribute is optional

18. marginLeft

The marginLeft attribute generates a specified amount of space between the left side of the image and its parent container.

Possible Values 
  • A numeric value in pixels
Example
Syntax<image type='computer' value='Custom-apps.jpg' marginLeft='400px'/>
Output

 Note:  
  • marginLeft attribute is optional

19. action

The action attribute specifies the action to be triggered on click of the image.

Possible Values 
  • Link
  • Form
  • Report
  • Page
  • Function 

Example

actionSyntax

Link

<image value='https://www.zoho.com/sites/default/files/creator5-logo-2x.png'  action='Link'   url='A URL to be opened '/>*

Form

<image value='https://www.zoho.com/sites/default/files/creator5-logo-2x.png'   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<image value='https://www.zoho.com/sites/default/files/creator5-logo-2x.png'  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<image value='https://www.zoho.com/sites/default/files/creator5-logo-2x.png'   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<image value='https://www.zoho.com/sites/default/files/creator5-logo-2x.png'   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.

20. url

The url attribute specifies the resource location to be opened on click of the image.

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

21. componentLinkName

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

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<image value='https://www.zoho.com/sites/default/files/creator5-logo-2x.png' action='Form' componentLinkName='User_Details'/>
Report<image value='https://www.zoho.com/sites/default/files/creator5-logo-2x.png' action='Report' componentLinkName='User_Details_Report'/
Page<image value='https://www.zoho.com/sites/default/files/creator5-logo-2x.png' action='Page' componentLinkName='User_Dashboard'/>

 Note:  

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

22. 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<image value='https://www.zoho.com/sites/default/files/creator5-logo-2x.png' action='Form' componentLinkName='User_Details' appLinkName='Resource_management'/>
Report<image value='https://www.zoho.com/sites/default/files/creator5-logo-2x.png' action='Report' componentLinkName='User_Details_Report' appLinkName='Resource_management'/>
Page<image value='https://www.zoho.com/sites/default/files/creator5-logo-2x.png' 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'>

23. functionName

The functionName attribute specifies the name of the custom function in the Zoho Creator application to be triggered on click of the image.

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

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.

24. parameters

The parameters attribute specifies parameter to be associated to an action.

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

<image value='https://www.zoho.com/sites/default/files/creator5-logo-2x.png'   action='Form' componentLinkName='User_Details'   appLinkName='Resource_management'  parameters='App_name=${name}'/>

OR

<image value='https://www.zoho.com/sites/default/files/creator5-logo-2x.png'   action='Form' componentLinkName='User_Details'   appLinkName='Resource_management'  parameters='App_name=Zoho Creator'/>

Report

<image value='https://www.zoho.com/sites/default/files/creator5-logo-2x.png'  action='Report'   componentLinkName='User_Details'   appLinkName='Resource_management' parameters='App_name=${name}' />

or

<image value='https://www.zoho.com/sites/default/files/creator5-logo-2x.png'  action='Form' componentLinkName='User_Details'   appLinkName='Resource_management'  parameters='User_Name='Rob'/>

 

Page<image value='https://www.zoho.com/sites/default/files/creator5-logo-2x.png'  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.

25. successMessage

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

Possible Values
  • A string

Example

Note:  

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

26. target

The target attribute specifies the location where the linked action will open on click of the image.

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

Default Value 

  • new-window

Note:

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

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

28. popupHeight

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

Possible Values 
  • A numeric value in percentage or pixels

Related Topics
  1. <panel>
  2. <pr> (Panel row)
  3. <pc> (Panel column)
  4. <text>
  5. <prefix>
  6. <suffix>
  7. <image>
  8. <button>
You can refer to the below attachment for a comprehensive list of icons (outline and solid) and prebuilt icon-classes.