Format Text in HTML Fields

On this page

Large text fields in the Alloy Navigator Web App use an HTML editor that supports formatting and mentions. The editor has a formatting toolbar, a Source view of the field's HTML, and dialogs for links, images, and tables. It stores pasted or dropped images on the server.

In the Web App

The editor toolbar

The toolbar holds, in this order: Source; the format, font, and font size lists, bold, italic, underline, strikethrough, text color, and background color; the list buttons, outdent, indent, blockquote, the four alignment buttons, horizontal rule, link, unlink, anchor, image, code snippet, and table; and Maximize.

Beneath the toolbar, the field has an AI actions button, which offers a list of instructions that can replace the field's text with the AI's output, and a voice transcription button.

Every dialog of the editor closes with OK or Cancel. If you changed anything in a dialog, Cancel first asks "You have changed some options. Are you sure you want to close the dialog window?"; declining keeps the dialog open.

The editor also varies by where the field appears:

  • On an action form, the field is boxed and has a footer row with a timestamp button (tooltip Timestamp) beside the snippet button. The timestamp button inserts the current date and time, without a user name, into the field you were last editing, even if focus has moved elsewhere since. If the server does not return a timestamp, nothing is inserted.
  • On a record's full form, the field can be blank for a moment when a tab first opens.
  • Some fields start read-only, with only an Edit button and Maximize on the toolbar. Click Edit to switch to the full toolbar. When the field is read-only, the button carries a different caption in place of Edit. Such a field also has the timestamp and snippet buttons in its footer.
  • A tall field that is configured for it collapses behind a show more / show less toggle instead of growing indefinitely.

The timestamp and snippet buttons are disabled when the field is read-only, and in a field with an Edit button also until you click Edit. For inserting snippets, see Snippets.

Switch between the formatted view and Source view

  1. Click Source. The editing area is replaced by the field's HTML, and the Source button is shown pressed.
  2. Edit the HTML, then click Source again to return to the formatted view.

While Source view is on, every other toolbar button except Maximize is disabled; on iOS devices Maximize is disabled too. Source also works on a field you cannot edit, except in a field with an Edit button before you click Edit. Switching to Source view can be undone like an edit.

Clicking into a field while it is in Source view does not make it the field that the timestamp button writes into. A snippet inserted into a field left in Source view goes into the HTML at the cursor position.

  1. Select the text to link, or place the cursor where the link should go.
  2. Click the link button on the toolbar. The link dialog opens on its Link Info tab.
  3. In Display Text, which holds the text you selected, change the text the link shows, if needed.
  4. Under Link Type, choose the URL type (with Protocol), Link to anchor in the text, E-Mail Address (with Message Subject and Message Body), or Phone, and fill in the link's details.
  5. Click OK.

The Display Text box is missing when the selection is an image, a table, or a form control, when it spans more than one link or holds more than one range, or when an embedded widget has focus. When you click OK:

  • With nothing selected, the text in Display Text becomes the new link's text. If the box is empty, the address becomes the text: the e-mail address for an e-mail link, otherwise the link's address.
  • An existing link keeps its text unless you edit the box. A link whose text was its own address is updated to the new address.
  • Over a selection, edited display text replaces the selected content with plain text.
  • A link of the type Link to anchor in the text always opens in the same window.

Insert an image

Do one of the following:

  • Click the image button on the toolbar. In the Image Properties dialog, set the image's URL, alternative text, width, height, border, horizontal and vertical spacing, and alignment, and click OK.
  • Paste an image into the field.
  • Drag an image file into the field.

A pasted image or a dropped image file is uploaded to the server and stored there, and the field links to the stored copy. When a pasted image comes from a web address, the server downloads it and stores it the same way; if the download fails, the image keeps its original web address.

When a pasted image address ends in .webp, .avif, or .svg, nothing is pasted and the message "File format(s) are not supported." appears. A dropped WebP, AVIF, or SVG file is not uploaded this way: it is left to the editor's own handling, and no message appears.

Insert and edit a table

To insert a table, click the table button on the toolbar. In the Table Properties dialog, set Rows, Columns, Headers, Border size, Width, Height, Cell spacing, Cell padding, Alignment, Caption, and Summary, and click OK.

To select several cells, drag with the left mouse button from one cell into another.

The editor's right-click menu opens only over a table, an image, or a link. Right-clicking in a table cell opens, in this order: Cut, Copy, and Paste; the Cell submenu and Select All; the Row submenu; the Column submenu; then Delete Table and Table Properties. Cut and Copy appear only over a selection: a right-click that only places the cursor in a cell starts the menu at Paste. The Cell, Row, and Column submenus are offered only in a cell that is not read-only.

  • Row holds Insert Row Before, Insert Row After, and Delete Rows.
  • Column holds Insert Column Before, Insert Column After, and Delete Columns.
  • Cell holds Insert Cell Before, Insert Cell After, Delete Cells, Merge Cells, Merge Right, Merge Down, Split Cell Horizontally, Split Cell Vertically, and Cell Properties.

The Cell submenu always lists all nine items; an item that the current selection does not allow is shown disabled:

  • Insert Cell Before, Insert Cell After, and Delete Cells are always available.
  • Merge Cells needs two or more selected cells that form a full rectangle and are not the whole table.
  • Merge Right and Merge Down need exactly one selected cell with a different neighboring cell on that side.
  • Split Cell Horizontally and Split Cell Vertically need exactly one selected cell.
  • Cell Properties needs at least one selected cell.

The Cell Properties dialog has these fields:

  • Width and Height, each with a unit list of pixels and percent, set to pixels by default.
  • Word Wrap: Yes, the default, or No.
  • Horizontal Alignment: <not set>, Left, Center, Right, or Justify.
  • Vertical Alignment: <not set>, Top, Middle, Bottom, or Baseline.
  • Cell Type: Data or Header.
  • Rows Span and Columns Span.
  • Background Color and Border Color, each with a Choose button that opens the color picker.

A width or height that is not a number is refused with "Cell width must be a number." or "Cell height must be a number.", and a span that is not a whole number with "Rows span must be a whole number." or "Columns span must be a whole number." When you click OK, each field you changed is applied to every selected cell; fields you did not change are left as they are.

For what Delete, Backspace, Enter, typing, and the arrow keys do over selected cells, see Keyboard Shortcuts.

Mention a person

Typing the mention trigger in the field offers the people you can mention. When you choose one, the editor inserts a link to that person's page.

Only active technicians are offered: requesters and inactive people cannot be mentioned. A person created moments earlier may not be offered at once. For what a mention does next, see Follow, Star and Mention.

Click in the displayed text

When a field's content is shown read-only, outside the editor:

  • Clicking an image opens it in a dialog.
  • Clicking a link to an anchor in the text scrolls to that place.
  • Clicking any other link opens it in a new browser tab.