Reference Guide

Detailed explanations of every feature and function in Nutshell

Text

The Text component allows you to add text content to a screen. It can be used to add Titles, Headings and Paragraphs to a screen.

Sreenshot

The Text component comes with a bunch of customisable pre-defined text-styles

To add some text, simply drag the Text component from the tool bar onto your screen, and position it where you want it.

Setting a Text Style

Text components come with a selection of pre-defined text styles for things like screen titles, paragraphs and small-print captions. All text components are set to Paragraph by default, but you can change this anytime you want.

Sreenshot

Pre-defined text styles can be selected in the Properties Panel

Select your text component on the Canvas and go to the Properties panel. There you’ll see a dropdown list of Styles. Pick the one you want and hit Save Changes. The text will update to reflect the style you’ve chosen.

If you’re not happy with the default styles, you can adjust the visual appearance of each text style using the Styling properties further down the Properties panel. This provides you with a whole range of styling options, from font size and colour to background colours, borders and even drop-shadows.

Sreenshot

Properties in the Styling section override the currently selected text style

The Styling panel displays appearance controls for the Style you’ve selected within the Style dropdown.

Editing Text

To edit text on-screen, simply double-click the component on the Canvas. A WYSIWYG editor will open, allowing you to edit the content in-place.

Sreenshot

Double-clicking a Text component on the Canvas opens up other formatting options

Using this text editor, you can add emphasis to your content using Bold or Italic styling, insert links and control layout using alignment and lists.

Inserting Links

Worthy of special mention is the ability to add hyperlinks within your text. Links can be used to visit external websites, make telephone calls and launch the end-user’s default email app, using the following URL structures:

To open a web page
http://www.nutshellapps.co.uk
Using the standard format for a hyperlink will open the given URL in a web browser when the end-user taps the link.

To make a call
tel:01914774951
Using this format will ask the end-user if they’d like to call the given number when they tap the link.

To launch an email
mailto:support@nutshellapps.co.uk
Using this format will launch the end-user’s default email app with the given email address as recipient when they tap the link.

Inserting Data Dynamically

You can insert dynamic data into your text. What do we mean by dynamic data? Dynamic data is content that changes based on something your end-user does.

Sreenshot

A simple example of taking data from a form input and inserting into a Text component

For example; imagine that your app asks the end-user for their name on the first screen, and then inserts it into a personalised greeting on the next. In this example, the name is dynamic as it changes to whatever the end-user has typed in.

Resizing a Text Component

To resize a text component, click and drag on a corner of its bounding box.

Text Properties

When a Text component is selected on the Canvas, the following settings are available in the Properties panel:

Basic Settings
Style

Allows you to choose a pre-set style for a block of text, from the following:

  • Title (most often used for the title of the current screen)
  • Subtitle
  • Paragraph (for longer-form content)
  • Heading (for major paragraph sections)
  • Sub-headings (for minor paragraph sub-sections)
  • Small Print (for captions, copyright notices etc.)
  • Fit Height to Content Deprecated: This is a leftover from an earlier version of Nutshell, which is no longer required. It will be removed in a future release.
    Styling
    Various

    A host of options to style your text, that should be pretty familiar if you’ve ever used a basic document editor like Microsoft Word.

    By default, these options reflect the style you’ve chosen in the Basic Settings > Style dropdown.

    Just getting started? Try the Tutorials section for handy quick-start guides.

    Prefer to watch the action? Try our series of short video tutorials.

    Can't find what you're looking for?

    If you can't find the answer to your problem here, please contact Nutshell's support team via our dedicated help desk.