v1.17.0

What's new in Note Toolbar v1.17?

New Features 🎉

Bottom toolbar position

By popular demand, there is now a Bottom toolbar position, which floats the toolbar at the bottom of your note.

Change to this position using right-click → Set position → Bottom, or via the toolbar's settings.

Styling notes:

• If the border style is enabled, the border surrounds the toolbar.
• Adjust distance from the bottom, left/right padding, and border radius using Style Settings.

Limitations / Known issues:

1. Toolbars with breaks have a gap on the right side (equivalent to the size of the wrapped items).
2. Bottom toolbars + Floating buttons: On mobile, the built-in toolbar disappearing makes it hard to use certain toolbar items (e.g., select text → bold).
   • As a bit of a workaround, consider adding the new Note Toolbar: Open Quick Tools (for current toolbar) to the editor toolbar: Settings → Toolbar → scroll to the bottom of Manage toolbar options → Add global command

💬 Let me know how well it works for you in the discussion thread, or use the Google feedback form ↗.

Quickly access styles from the toolbar's context menu

Get to the Style section of settings for the active toolbar by right-clicking on it (or long-press on mobile) and select Style...

New command: Access Quick Tools for the current toolbar

Use the new Note Toolbar: Open Quick Tools (for current toolbar) command to open a Quick Tools window that shows the items in the toolbar associated with the current note.

💡 Tip: On mobile, consider adding this command to the editor toolbar: Settings → Toolbar → scroll to the bottom of Manage toolbar options → Add global command

Improvements 🚀

• New plugin setting: Show toolbar for the linked note in the File menu, under Note Toolbar Settings → Other, which is defaulted to off. Allows you to selectively enable this feature, which was introduced in 1.13. Thanks @Moyf and @FelipeRearden
• Floating buttons: Support for the autohide and border styles.
  • The border color defaults to the button's icon color, but can be overridden with Style Settings.
• Additional Style Settings:
  • Override the autohide style opacity for toolbars and buttons separately.
  • Inactive opacity settings for mobile and desktop are now separate.

Fixes

• Toolbars in split views are now updated on leaf change, if its config was updated.

Changes

• Updated Ukranian tranlations thanks to @laktiv

---

API Beta: Updates

Thanks @FelipeRearden for feedback and testing!

New Features 🎉

• Added ntb.modal(). See 1.17.1

Improvements 🚀

• Prompt: All options are now passed via an optional options object parameter, with defaults for each:

  let result = await ntb.prompt(options?: {
    default?: string,      // Optional default value for text field; if not provided, no default value is set
    label?: string,        // Optional text shown above the text field, rendered as markdown; default none
    large?: boolean,       // Set true if text box should be larger; if not provided, defaults to false
    placeholder?: string,  // Optional text inside text field; defaults to preset message
  });

• Suggester: Made function easier to use with optional keys (if not provided, returned value is the selected option), also via an optional options parameter:

  let result = await ntb.suggester(
    values: string[] | ((value: T) => string),  // Array of strings representing the text that will be displayed for each item in the suggester prompt. This can also be a function that maps an item to its text representation. Rendered as markdown.
    keys?: T[],  // Optional array containing the keys of each item in the correct order. If not provided, values are returned on selection.
    options?: {
      placeholder?: string,  // shown in the input field; defaults to message
      limit?: number         // Optional limit of the number of items rendered at once (useful to improve performance when displaying large lists). Defaults to no limit.
    });

• Suggester values and Prompt label (options.label) are now rendered as markdown, so they can include markdown and things like Iconize icons.
• Prompt: Reduced size of modal when using the simple prompt, including on mobile.
• Prompt: When using the large option, a modifier key (e.g., cmd) and enter now submits.

Changes

• The API class name has been shortened from NoteToolbar to ntb.
• CSS: Updated all class names from note-toolbar-comp-* to note-toolbar-ui-*; add -ui class for Suggester. Thanks @FelipeRearden
• Examples of the above in the repo have been updated:
  • For Dataview: NtbPrompt.js and NtbSuggester.js
  • For JS Engine: NtbPrompt.js and NtbSuggester.js

See the updated documentation in the User Guide to learn more.