Atlassian uses cookies to improve your browsing experience, perform analytics and research, and conduct advertising. Accept all cookies to indicate that you agree to our use of cookies on your device. Atlassian cookies and tracking notice, (opens new window)
Teams
, (opens new window)
Scaffolding Forms & Templates for Confluence Data Center
Results will update as you type.
  • Overview
  • Get started
  • Use cases
  • Administrator guide
  • Developer Guide
  • Macro reference
    • Attachment Data
    • Attachment Options
    • Content Options
    • Data Section (Beta)
    • Date Data
    • Evaluate Data
    • Excerpt Data
    • Get Data
    • Group Data
    • Hidden Data
    • Label Options
    • List Data
    • List Option
    • Live Template
    • Number Data
    • Repeating Data
    • Set Data
    • Table Data
    • Text Data
    • User Options
  • Tutorials
  • Migrate from Scaffolding Data Center to Scaffolding Cloud
  • Release notes
  • Help and support
    You‘re viewing this with anonymous access, so some content might be blocked.
    /
    Text Data
    Updated Jun 18

    Text Data

    Overview

    The Text Data macro allows editing of free text data.

    On this page:

    • 1 Overview
    • 2 Parameters
    • 3 Editor View
    • 4 Notes
    • 5 Tutorial Examples

    On this page:

    • 1 Overview
    • 2 Parameters
    • 3 Editor View
    • 4 Notes
    • 5 Tutorial Examples

    Parameters

    Name

    Required

    Migratable to Cloud?

    Default Value

    Description

    Name

    Required

    Migratable to Cloud?

    Default Value

    Description

    Field Name

     Yes

    No



    The name of the text data field.

    The name must be unique.

    Type

     Optional

    No

    • area - if the macro is created with the Rich Text Editor.

    • line - if the macro is created with wiki markup.

    The type of field.

    Applies to plain text content only.

    Can be:

    • area - a multi-line text area field

    • line - a single-line text area field

    • password - a single-line password field

    Only applicable for forms mode.

    Content Type

     Optional

    No

    • rich text - if the macro is created with the Rich Text Editor.

    • wiki - if the macro is created with wiki markup.

    The type of content in the field.

    Can be:

    • richtext

    • text

    • noformat

    • quote

    • code

    • wiki

    To input a field within a Text Data with Content Type set to richtext or quote, click the field to initiate a rich text editor. This is only applicable to forms mode.

    Required

     Optional

    No

    false

    If true the field cannot be empty. 

    Language

     Optional

    No



    The programming language to use for formatting the content is Java or XML.

    This is only used when the Content Type is set to code. For example, content=code:JavaScript.

    Any language that is valid for the {code} macro can be used.

     

    Hide Full Text

     Optional

    No

    false

    Clip text and display a Show more button if the text is more than one line. v5.2.0 and later only

    Minimum Length

     Optional

    No



    If specified, the text must be at least this many characters long.

    Maximum Length

     Optional

    No



    If specified, the text must be at most this many characters long.

    Pattern

     Optional

    No



    Specify the text that the content in the Text Data macro must match.

    You can use regular expressions with this parameter.

    Consult this Knowledge Base article on the use of regular expressions with Scaffolding.

    Pattern Error Message

     Optional

    No



    If the Pattern parameter is specified, this is displayed if the saved value does not match when the user clicks Save.

    Width

     Optional

    No



    The width of the text field.

    Can be in one of the following formats:

    • pixels (e.g. 250px)

    • percentage (e.g. 100%)

    Only applicable for forms mode.

    Height

     Optional

    No



    The height of the text field.

    Can be in one of the following formats:

    • pixels (e.g. 250px)

    • percentage (e.g. 100%)

    Only applicable for forms mode.

    Editor View

    Notes

    Links to other pages inside a Text Data may break when the linked page is moved to another space. Clicking the broken link (pictured below) will prompt the user to create a new page.

    Page link

    Tutorial Examples

    • Page:
      Text Data
    • Page:
      Hide a Scaffolding dynamic table in a collapsible section using the Composition Tabs app
    • Page:
      Track a workflow status
    • Page:
      Create a project details form
    • Page:
      Generate a chart from a Scaffolding dynamic table using the Reporting app
    • Page:
      Store data and use that data for calculations
    • Page:
      Retrieve data from a table
    • Page:
      Group and retrieve data
    • Page:
      Collect and display data in a structured way
    • Page:
      Create editable sections on a page
    • Page:
      Create an FAQ form
    • Page:
      Create a simple form with Scaffolding macros
    • Page:
      Create a dynamic table
    {"serverDuration": 15, "requestCorrelationId": "4c348954f8e04f408f153bdc340d7540"}