Text fields

Text

There are multiple options to configure an input field as text. A few parameters are available to all of them:

Text

This field may only contain unformatted plain text.

Text (Multi)

A text (multi) property may contain multiple text fields, though it is not possible to enrich them with any kind of markup. Nevertheless, you still can make spell checking available and you may also set a maximum number of text fields (by default, there is no limitation on the number of text fields within this property).

Text (Fixed Size)

This is an input field for content depending on size and font. The width, height and font of the field each can be configured by parameters. The field wraps words at the end of text lines automatically with hyphens and supports spell checking. The content is saved in XML format to preserve manual and automatic line breaks. On the right you can see an example of the format in which the content of such a field is saved.

<property name="sophora-demo:fixedSizeText">
	<value>&lt;?xml version="1.0" encoding="UTF-8"?&gt;&#xD;
		&lt;sophora&gt;&#xD;
			&lt;logicalContent&gt;&#xD;
				&lt;line&gt;A text field of 400 x 300 pixels per page in font "Arial" (16 pt). Only one page is allowed. This field type supports automatic hyphenation.&lt;/line&gt;&#xD;
				&lt;manualhyphenations /&gt;&#xD;
			&lt;/logicalContent&gt;&#xD;
			&lt;visualContent&gt;&#xD;
				&lt;line&gt;A text field of 400 x 300 pixels per page in &lt;/line&gt;&#xD;
				&lt;line&gt;font "Arial" (16 pt). Only one page is allo-&lt;/line&gt;&#xD;
				&lt;line&gt;wed. This field type supports automatic hy-&lt;/line&gt;&#xD;
				&lt;line&gt;phenation.&lt;/line&gt;&#xD;
			&lt;/visualContent&gt;&#xD;
		&lt;/sophora&gt;
	</value>
</property>

Text (with Styles)

This field may contain rich text, i.e. formatted text with bold or italic letters etc.

Text (with Teaser Image)

This field type allows you to provide a teaser image in addition to the unformatted text. A teaser image is added to the document as a new component, when the user drags an image document and drops it onto the label associated with this input field.

In order to add a teaser image to an input field of the type Text (with Teaser Image), the document needs not only the string property configured as such. It also needs an additional nodetype that you have to add in the document's CND beforehand, in our example we call it sophora-demo:teaserImage. This property name is the one you have to enter into the Image Child Node parameter field in the property configuration of your text property. The child node sophora-demo:teaserImage itself, on the other hand, shall not appear anywhere in the documents formular tabs. Nevertheless, you do have to configure it on the components tab - drag it there on the components tab of the child node editor. Finally, you have to select the image reference node type (not the image node type itself) or the component box node type that can contain images as a valid child node type for sophora-demo:teaserImage.

Text (with Teaser Image and Style)

This input field is a combination of both the text with teaser image and the text with styles. All configuration parameters can be found in the section of the respective input field types and work just the same.

Copytext

The copytext is Sophora's most convenient and advanced field type for writing texts. The copytext supports different paragraph styles, paragraph images and boxes. The input field type Copytext requires the node type sophora-extension-nt:copytext as valid child node.

The following instructions will help you to configure the necessary node type configurations. If you do not have a node type configuration for the mentioned node types, you have to create a new one.

In the nodetype sophora-extension-nt:copytext, you should

• add its child node sophora-extension:paragraph to the components tab
• add a label to it (e.g. Paragraph)
• add sophora-extension-nt:paragraph as a valid child node type to it

In the nodetype sophora-extension-nt:paragraph, you should

• add the child nodes sophora-extension:paragraphbox and sophora-extension:paragraphimage to the components tab
• add the respective labels to it (e.g. Paragraph Box)
• add subtypes of sophora-extension-nt:group as valid child node types to the paragraph box and sophora-extension-nt:paragraphimage to the paragraph images

In the nodetype sophora-extension-nt:paragraphimage, you should

• add its childnode sophora-extension:image to the components tab
• add a label to it (e.g. Image)
• add all reference document types for images as valid child node types

Now you are ready to configure a copytext field into a document. In the configuration of the childnode you want to configure as a copytext, you need to select Copytext as the input field type and sophora-extension-nt:copytext as the valid child node name. You also have to select the set of paragraph types you would like to enable for this copytext instance. Additionally you can select a default paragraph type. New paragraphs will be created with this type seleted. Otherwise, the default paragraph type is automatically determined from the set of enabled paragraph types.

Paragraph Table Settings

Paragraph tables support additional settings such as alignment, that can be activated using toggle buttons. Each button represents a single value out of a select value provider, that can be used to set a CSS class in the rendering of the table.

To enable the use of these settings, you have to perform the following configuration steps:

• In the nodetype editor of sophora-extension-nt:copytextTableSettings, move the property sophora-extension:tableSettings onto the Base tab.
• Modify the property's settings; select Checkbox (Multi) as input field type.
• Select a select value provider of your choice and set the additionally required settings.