Skip to main content

​
Overview

From titles to paragraphs, captions and more, text elements are a key part of most UI. Play lets you customize your text while staying within the bounds of technical feasibility. You’re able to edit text in the Element Settings Panel.
In macOS, you can add text to your page, canvas, or selection using the T key

​
Properties

In addition to the properties below, glass effect containers also have access to general object properties in the Expression Editor.

​
Text

Enter the text copy. Play also provides auto-fill copy for CTA, Name, Date, Address, City, Short Headline, Long Headline, Paragraph, and Multi-Paragraph from the Context Bar settings. 
Text.text
Type: string
Can get or set the value.

​
Font / Style

Select the font family for the text. Instead of selecting a font family, you can also select one of Apple’s System Styles or a custom Type style from the project by clicking on the four-circle icon. To revert to the default System Font, click the green dot next to the Font / Style property.

​
Weight

Set the weight from the options available for the selected font.

​
Size

Set the font size. (not available for Custom or System Styles) 
Text.size
Type: number
Can get or set the value.

​
Design

Set the font’s design to default, monospaced, rounded, serif, compressed, condensed, or expanded (only available for System Font and System Styles):
  • Compressed: A rounded version of the default style.
  • Monospaced: A monospaced, code-like version of the default style.
  • Serif: A version of the default style with serifs.
  • Compressed: A significantly more narrow version of the default style.
  • Condensed: A slightly more narrow version of the default style.
  • Expanded: A slightly wider version of the default style.

​
Fill

Select the color of the text. 
Text.textColor
Type: color
Can get or set the fill color or an individual color property.

​
Spacing

Set the letter spacing and line height, as a point value or a percent. 
Text.letterSpacing
Type: number
Value: >0
Can get or set the value.
Text.lineHeight
Type: number
Value: >0
Can get or set the value.

​
Align

Set the horizontal (left, center, right, or justified) and vertical (top, center, bottom) alignment.

​
Editable Text

​
Is Editable

Choose if the text can be edited when tapped by the user. Any copy the user enters will be saved as the text element for the Play session. 
Text.isEditable
Type: boolean
Values:
true = editable
false = not editable
Can get or set the value.
Natively, UIKit does not support multi-line text fields, but you can use an editable text element as a multi-line text field.

​
Is Selectable

Choose if the text can be selected when a user double-taps it. The native edit menu will appear, allowing users to drag the selector and use the native options that appear, like Copy, Look Up, Translate, and more. All that functionality is built in and completely native. 
Text.isSelectable
Type: boolean
Values:
true = selectable
false = not selectable
Can get or set the value.

​
Keyboard

Set the keyboard’s type to default, email, number pad, numbers and punctuation, phone pad, or decimal pad. 
Text.keyboardType
Type: string
Values: Default, Email, Number Pad, Numbers and Punctuation, Phone Pad, Decimal Pad
Can get or set the value.

​
Return Key

Set the return key’s CTA to Go, Google, Join, Next, Route, Search, Send, Done, or Continue.

​
Dismiss Keyboard on Return Key

Choose if the keyboard should close when the user hits the return key.

​
Auto-Capitalization

Choose if the text field will automatically capitalize characters:
  • None: No characters will automatically be capitalized
  • All Characters: Capitalizes all characters
  • Sentences: Capitalizes the first character in sentences
  • Words: Capitalizes the first character in words
Text.textAutoCapitalizationType
Type: string
Values: None, All Characters, Sentences, Characters
Can get or set the value.

​
Auto-Correction

Choose if the text field will use auto-correction.

​
Text Content Type

Set the text field’s expected input type so the system has information. Set the type to None, URL, City, State, City And State, Country, Credit Card Number, Date, Time or Duration, Email Address, Flight Number, Shipment Tracking Number, Full Street Address, Name, Name Prefix, Name Suffix, Given Name, Family Name, Job Title, Postal Code, Sublocality, Username, Password, New Password, or One Time Code 
Text.textContentType
Type: string
Values: None, URL, City, State, City And State, Country, Credit Card Number, Date, Time or Duration, Email Address, Flight Number, Shipment Tracking Number, Full Street Address, Name, Name Prefix, Name Suffix, Given Name, Family Name, Job Title, Postal Code, Sublocality, Username, Password, New Password, One Time Code
Can get or set the value.

​
Dismiss Button

Choose if the dismiss button is visible on your text field.

​
Customize

​
Transform

Set if the text should be all uppercase, lowercase, title case, or as typed.

​
Decoration

Choose to underline or strike through the text.

​
Text Linking

Add a URL link from a text element by highlighting the text and pasting the URL.

​
Resources

Related Triggers & Actions

Text Event Trigger

Set Text Action

⌘I