Bike Guide

Appearance

Row Attributes ​

A row attribute is a key : value pair attached to a row.

Attributes let you store extra information with a row. A priority, a due date, an estimate. Or your own custom attributes. You can then filter, style, or otherwise act on your outline based on those attribute values.

Context menu ​

Let's create an attribute using the context menu:

  1. Right click on a row to show context menu
  2. Choose Priority > 1 from the menu

You've now assigned the @priority : 1 attribute to your row. The attribute is visible as a badge at the end of the row. Click that badge to pick a different priority, filter by priority, or remove the attribute. That's the essence of row attributes: you can add them, see them, and act on them.

Attribute Editor ​

The attribute editor is a more general way to add, edit, or remove attributes. You can open it with Format > Row Attributes… or by right-clicking a row and choosing Row Attributes…. You can also move the cursor to the end of a row's text and press Command-Right.

Once visible, use the filter to select an existing attribute and value.

Few tricks:

  • Use Return to commit the attribute value.
  • Use Command-Return to commit an attribute value, and leave the editor open.
  • Use Command-Delete to delete the selected attribute (or click the trash icon).
  • Type a new attribute name, and select the last "add" option to create a new attribute.
  • Use Escape to close the editor without committing changes.

Commands ​

There are also commands for setting common attributes such as "Priority: 1" and "Due: Soon". Use the command palette (Command-Shift-P) to find them. You can also assign your own keybindings to these commands in Settings > Commands. Or even add buttons to the toolbar or status bar for them using Settings > Interface Explorer.

Badges ​

Attributes are made visible in the outline through badges. Badges are small labels that follow the row text, like the P1 badge we created above. Click a badge to edit its value, right-click it to remove the attribute. See Row Badges for the details.

See also ​