SpreadsheetConverter offers you lots of basic graphical widgets that make your web page easier to use and to give it a better appearance. This is the online help page for many of these widgets. 

This is an introduction to the use of widgets in spreadsheets to improve the functionality and appearance of the converted web page. If you haven’t used widgets before, you may want to read the Introduction to widgets in SpreadsheetConverter before you continue.

Be aware that most of these widgets have no corresponding representation when used in Excel. Some of them are unfortunately totally invisible in Excel. You have to convert the spreadsheet to web format to see the widget in action.

This page describes the widgets available in the HTML, Node.js and ASP.Net flavors. There is a similar page describing the widgets in the iPhone/Android flavor.

Text field

Text fields are mainly used in electronic forms to mark the fields where the user will enter data that is not used in calculations, e.g. a name or an address. You insert a Text field widget by clicking the Text field widget in the widgets tab in the SpreadsheetConverter settings panel. You can then set different properties for the Text field:

  • A Required field requires input from the user. This option is mainly used for electronic forms, where a form must contain a minimum of information to be meaningful. For Text fields, a Required field cannot be empty. If it is, it will not be possible to submit the form.
  • Multiline is used to give a text area more than one line and to make it scrollable. Use this option only for text fields that you have made sufficiently large in the spreadsheet, e.g. by merging two or more cells. You can achieve the same result by enabling Wrap Text for the merged cell in Excel.
  • Make hidden field is used when you want a cell to be visible in the spreadsheet, but not in the converted web page. This also allows you to provide information to a form processing script without showing it in the form. As an example, if the link to the form contains a language code (/form.htm?lang=sv), it will be preserved by the form if your form has a text field named lang, and it will be forwarded with the form when the form is submitted for processing. The autosave process will normally save the latest value for all input fields. If you want the value in the link to override the autosaved value, you have to disable Browser Storage on the Workbook tab.
  • Name your widgets if you want to pass data into them from the link to the form (see above). For electronic forms it is also much easier to process the form if all input fields have names. You can name your fields in the widgets or give them cell names in Excel. Widget names can start with numbers or an underscore, which is required when integrating with products like Salesforce.
  • The default value of a text field is empty. To provide a different default value, enter text into the cell.

textfield    textfieldProperty

Check box

Use check boxes only for statements that must be either true or false, there is no room for doubt, like “British citizen”. You insert a Check box widget by clicking the Check box widget in the widgets tab in the SpreadsheetConverter settings panel. A Check box will provide a true/false value that you can test for in other places in the form, or when the form is submitted for processing.

  • Name your widgets if you want to pass data into them from the link to the form (see below). For electronic forms it is also much easier to process the form if all input fields have names. You can name your fields in the widgets or give them cell names in Excel. Widget names can start with numbers or an underscore, which is required when integrating with products like Salesforce.
  • The default value of a check box is FALSE (unchecked). To change the default, type TRUE into the cell.
  • You can set the value of a checkbox widget from the link. Use the format /form.htm?example=TRUE. The autosave process will normally save the latest value for all input fields. If you want the value in the link to override the autosaved value, you have to disable Browser Storage on the Workbook tab.

checkbox    checkboxproperty

Dropdown list

Drop-down lists are used to select between a limited number of choices. The menu opens when you click on it. When you have made your choice, only the selected choice is visible. You insert a Dropdown list widget by clicking the Dropdown List widget in the widgets tab in the SpreadsheetConverter settings panel. List the labels in each line in the empty space. You can then set different properties for the Dropdown List:

  • Required field requires input from the user. This option is mainly used for electronic forms, where a form must contain a minimum of information to be meaningful. For Drop-down lists, the user must move the menu away from the option that is selected by default. If the default option is left selected, it will not be possible to submit the form.
  • Show default text instructs the widget to add a dummy choice at the top of the list that implies that no “real” option has been selected yet – typically it’s is also used as a prompt, as in
    “Rate the course, 4 is the best”.
  • List labels are the possible choices in the menu.
  • Name your widgets if you want to pass data into them from the link to the form (see below). For electronic forms it is also much easier to process the form if all input fields have names. You can name your fields in the widgets or give them cell names in Excel. Widget names can start with numbers or an underscore, which is required when integrating with products like Salesforce.
  • The default value of a drop-down list is the first choice in the list. To provide a different default value, move one of the other choices to the top of the list.
  • You can select an option in the dropdown widget from the link. Use the format /form.htm?example=Banana. The autosave process will normally save the latest value for all input fields. If you want the value in the link to override the autosaved value, you have to disable Browser Storage on the Workbook tab.
  • The basic Dropdown widget can only have one static list of choices. If you need a multi-level menu structure, e.g. select country then city, or want to prepare the list of choices with formulas in the spreadsheet, use the Dynamic Dropdown widget instead.

dropdownlist    dropdownlistproperty

Hyperlink and Button

Any cell in your worksheet can contain a web address in the form of a Universal Resource Locator or URL:

An Excel spreadsheet with a URL in that is not converted to a link

Notice that Excel considers this to be just plain text. Nothing will happen if you click on this cell. If you convert this spreadsheet to a web page, the URL is generated as plain text there too, and clicking on it will have no effect.

To turn a URL into a working link, you have to insert a hyperlink into the cell. You can let Excel create a hyperlink automatically every time you enter a URL into a cell, or you can use the Insert Hyperlink command:

Inserting a hyperlink in Excel

Notice that the Text to display in the link, often referred to as the link’s anchor text, can be different from the link’s Address. You can usually see that a cell contains a hyperlink anyway, because of its classic formatting in blue with an underline:

A cell in Excel that contains a hyperlink

By default, SpreadsheetConverter preserves hyperlinks on the converted web page. The anchor text will be displayed and linked to the requested URL.

A link in Excel can also be calculated with the
=HYPERLINK(Address, Text to display)

function. In this case the Address portion of the link is assembled dynamically according to the formula you have specified. The URL may be determined conditionally using the IF function or the address assembled from other cells. The Address to use in a given situation can even be selected with the VLOOKUP function from a list of links. The Text to display operand of the Hyperlink function allows you to define the anchor text for the link.

The Hyperlink widget in SpreadsheetConverter provides a few additional useful features:

  • A Style setting that allow you to present the link also as a button, either in the cell or in the SpreadsheetConverter toolbar. The link’s anchor text will be used on the button. The design of the button can be modified by a theme.
  • A Placement setting where you specify if you want the link or button to be placed in the cell or in the SpreadsheetConverter toolbar.
  • An Open In setting that lets you specify how you want the linked page to open: in the same browser tab, in a new browser tab, in the same frame of the web page or in the parent frameset. In the generated HTML, this selection is reflected in the HTML target parameter for the link, which will be omitted, set to _blank, set to _self or set to _parent, respectively.
  • Name your widgets if you want to pass data into them from the link to the form (see the Text field widget above). For electronic forms it is also much easier to process the form if all input fields have names. You can name your fields in the widgets or give them cell names in Excel. Widget names can start with numbers or an underscore, which is required when integrating with products like Salesforce.

hyperlink    hyperlinkproperty

Radio buttons

Radio buttons simulate the behavior of old car radios. When one of the buttons is pressed, the corresponding radio station (option) is selected. Simultaneously, all the other buttons pop out, leaving only the selected button  in the pushed-in position.

Radio buttons are used to select between a limited number of choices. The good thing about radio buttons is that you see all the available choices. The bad thing is that this may consume a lot of screen space. You insert a Radio buttons widget by clicking the Radio Button widget in the widgets tab in the SpreadsheetConverter settings panel. You can then set different properties for the Radio button widget:

  • Required field requires input from the user. This option is mainly used for electronic forms, where a form must contain a minimum of information to be meaningful. For Radio buttons, one of the buttons must be “pressed”. If no button is selected, it will not be possible to submit the form.
  • Button labels are the names for each button. You get one button for each label you enter.
  • In a Vertical Layout, the buttons are aligned in a column. Select the number of Columns to use for the choices.
  • In a Horizontal Layout, the buttons are aligned in a row. Select the number of Rows to use for the choices.
  • Name your widgets if you want to pass data into them from the link to the form (see below). For electronic forms it is also much easier to process the form if all input fields have names. You can name your fields in the widgets or give them cell names in Excel. Widget names can start with numbers or an underscore, which is required when integrating with products like Salesforce.
  • The default value of a radio button is the first choice in the list. To provide a different default value, move one of the other choices to the top of the list.
  • You can select an option in the radio button from the link. Use the format /form.htm?example=Banana. The autosave process will normally save the latest value for all input fields. If you want the value in the link to override the autosaved value, you have to disable Browser Storage on the Workbook tab.

radiobutton    radiobuttonproperty

Ratings

Ratings widgets are used to rate, or grade, an experience or a product with symbols like stars. It’s an effective way of expressing one’s opinion about something. You insert a Ratings widget by clicking the Ratings widget in the widgets tab in the SpreadsheetConverter settings panel.

  • The Number of rating steps determines the number of stars in the widget.
  • Name your widgets if you want to pass data into them from the link to the form (see below). For electronic forms it is also much easier to process the form if all input fields have names. You can name your fields in the widgets or give them cell names in Excel. Widget names can start with numbers or an underscore, which is required when integrating with products like Salesforce.
  • The default value of a rating widget is 0. To provide a different default value, enter an integer within the number of rating steps into the cell.
  • You can assign a value to a rating widget from the link. Use the format /form.htm?example=4. The autosave process will normally save the latest value for all input fields. If you want the value in the link to override the autosaved value, you have to disable Browser Storage on the Workbook tab.

rating    ratingproperty

Sliders

A Slider allows the user to select a value by moving a handle to a particular position on the widget. Sliders are real-time and cause the entire spreadsheet to be continuously recalculated with each new value of the slider as you move it.

You insert a Sliders widget by clicking the Horizontal Slider widget (value increases from left to right) or Vertical Slider widget (value increases from top to bottom) in the widgets tab in the SpreadsheetConverter settings panel.

  • The Minimum value is the value the widget contains at the slider’s left- or uppermost position, depending on its orientation.
  • The Maximum value is the value that the cell contains when the slider is in its lower- or rightmost position, depending on its orientation.
  • Use the Tick Interval if you want tick marks along the slider.
  • Name your widgets if you want to pass data into them from the link to the form (see below). For electronic forms it is also much easier to process the form if all input fields have names. You can name your fields in the widgets or give them cell names in Excel. Widget names can start with numbers or an underscore, which is required when integrating with products like Salesforce.
  • Choose slider orientation from Style.
  • The default value of a slider is the minimum value you specify.
  • You can assign a value to a slider widget from the link. Use the format /form.htm?example=42. The autosave process will normally save the latest value for all input fields. If you want the value in the link to override the autosaved value, you have to disable Browser Storage on the Workbook tab.

slider    sliderproperty

Action Buttons

 

The Submit, Update and Reset buttons are normally standard action buttons in the toolbar.

Screenshot of the toolbar in the converted web page

However, sometimes you may want to place an action button elsewhere, perhaps to simplify the user interface. Using widgets, action buttons can be inserted in any cell in the calculator. The text of all buttons can also be changed.

Submit Action button

The Submit button send the form to a web server for processing. Insert a Submit button at the end of your long form to save your users from having to scroll to the nearest toolbar.

Update Action button

For smaller calculators, SpreadsheetConverter automatically updates all cells in a spreadsheet if one of the values is changed, just like Excel does. For a very complex web calculator, you have the option of switching to manual updating of the calculator in the Advanced Settings in the Options menu. In that case, an Update button is needed to manually initiate the updating of the spreadsheet.

You can now place also the Update button in any cell, perhaps right after your most popular input fields.

Reset Action button

The Reset button clears all input fields in a form. It is rarely used, except in situations where a large number of fields contain values that never will be re-used. You can now make the Reset button available where-ever users need it.

Calculated Cells

The Calculated cell widget can be used to assign a name to a calculated cell, or to make it invisible. You insert a Calculated cell widget by clicking the Calculated Cell widget in the widgets tab in the SpreadsheetConverter settings panel. Calculated cells in a form or calculator are locked for user input in order to preserve the formula.

  • Name your widgets in electronic forms since it becomes much easier to process the form if all input fields have names. You can name your fields in the widgets or give them cell names in Excel. Widget names can start with numbers or an underscore, which is required when integrating with products like Salesforce.
  • Make hidden field is used when you want a cell to be visible in the spreadsheet, but not in the converted web page. This also allows you to provide information to a form processing script without showing it in the form. As an example, if you use a cell to keep track of how long it took a user to fill in a form, you may want to hide this calculation. Even though the field is hidden, it is forwarded with the form when the form is submitted for processing.
  • Calculated cells get their default values from the formulas in the cell.

calculated    calculatedproperty

 

Calendar widgets

Calendar widgets make it much easier for the user to pick the right date. It also makes it easier to count from one date to another. The widgets ensure that any date picked from the calendar is valid, and formats it correctly for the recipient of the electronic web form using the regional settings.

The default value of a calendar field is current date. Date will be formatted according to your computer’s regional settings.

  • The Button calendar is represented by a plain text field with button in the form, and the Full calendar appears only when you press the button – and disappears again when you have selected a date.
  • The Pop-up calendar appears as a plain text field in the form, but once you have focus on the widget, the Full calendar appears – and disappears again when a date has been set.
  • Name your widgets if you want to pass data into them from the link to the form. As an example, if the link to the form contains an Excel serial day number (/form.htm?date=20376), it will be preserved by the form if your spreadsheet has a cell named date, and it will be forwarded with the form when the form is submitted for processing. The autosave process will normally save the latest value for all input fields. If you want the value in the link to override the autosaved value, you have to disable Browser Storage on the Workbook tab. For electronic forms it is also much easier to process the form if all input fields have names. You can name your fields in the widgets or give them cell names in Excel. Widget names can start with numbers or an underscore, which is required when integrating with products like Salesforce.

calendar    calendarproperty

File Attachments widget

If your users want to include files with their form submissions, e.g. a CV with a job application or an image with an error report, add a File Attachments widget to your form.

Hide Rows/Sheets widget

You can hide certain rows in your spreadsheet, and even entire worksheets, depending on the contents of a controlling cell. Learn more about the Hide Rows/Sheets widget. 

Google Map widget

The Google Map widget allows you to use interactive maps in the converted web page. Learn more about the Google Map widget. 

Dynamic Dropdown widget

If you want the options in a dropdown menu taken from cells in the spreadsheet, learn more about the Dynamic Dropdown widget.

Link Image widget

Save all relevant image links in your spreadsheet or create formulas that can build the right image link dynamically from user input. Use the Link Image widget to select the image that is shown. 

Add/Edit Responsive Block widget

Responsive blocks allow you to dynamically adapt the layout of the converted web page to the screen width of any device. Learn more about how to Add/Edit Responsive Blocks.