# ParagraphAttribute

> An abstract datatype for specifying an Paragraph style attribute.

- Source: https://titaniumsdk.com/docs/sdk/13.1.0/ParagraphAttribute
- Titanium SDK version: 13.1.0
- Kind: pseudo
- Platforms: iPhone, iPad, macOS
- Since: Titanium SDK 7.5.0

Attributes are added corresponding to value to create paragraph style, 
which when used with attributed string will give styled text.

## Properties

### alignment

- Type: Number
- Platforms: iPhone, iPad, macOS

The text alignment of the receiver.

Accepts: `Titanium.UI.TEXT_ALIGNMENT_CENTER`, `Titanium.UI.TEXT_ALIGNMENT_JUSTIFY`, `Titanium.UI.TEXT_ALIGNMENT_LEFT`, `Titanium.UI.TEXT_ALIGNMENT_RIGHT`

### allowsDefaultTighteningForTruncation

- Type: Boolean
- Platforms: iPhone, iPad, macOS

A Boolean value indicating whether the system may tighten inter-character spacing 
before truncating text.

When this property is set to true, the system tries to reduce the space between characters 
before truncating characters. The system performs this tightening in cases where the text 
would not otherwise fit in the available space. The maximum amount of tightening performed 
by the system is dependent on the font, line width, and other factors. The default value of 
this property is false.

### firstLineHeadIndent

- Type: Number | String
- Platforms: iPhone, iPad, macOS

The indentation of the first line of the receiver.

This property contains the distance (in points) from the leading margin 
of a text container to the beginning of the first line of paragraph. 
This value is always nonnegative float value or dimension string (e.g. '10px').

### headIndent

- Type: Number | String
- Platforms: iPhone, iPad, macOS

The indentation of the lines of lines other than the first.

This property contains the distance (in points) from the leading margin 
of a text container to the beginning of lines other than the first. 
This value is always nonnegative float value or dimension string (e.g. '10px').

### hyphenationFactor

- Type: Number
- Platforms: iPhone, iPad, macOS

The threshold of paragraph for hyphenation.

Valid values lie between 0.0 and 1.0 inclusive. The default value is 0.0. Hyphenation 
is attempted when the ratio of the text width (as broken without hyphenation) to the 
width of the line fragment is less than the hyphenation factor. When the hyphenation 
factor of paragraph is 0.0, the hyphenation factor of layout manager is used instead. 
When both are 0.0, hyphenation is disabled. This property detects the user-selected 
language by examining the first item in preferredLanguages.

### lineBreakMode

- Type: Number
- Platforms: iPhone, iPad, macOS

The mode that should be used to break lines in the receiver.

This property contains the line break mode to be used laying out the text of paragraph.

Accepts: `Titanium.UI.ATTRIBUTE_LINE_BREAK_BY_CHAR_WRAPPING`, `Titanium.UI.ATTRIBUTE_LINE_BREAK_BY_CLIPPING`, `Titanium.UI.ATTRIBUTE_LINE_BREAK_BY_TRUNCATING_HEAD`, `Titanium.UI.ATTRIBUTE_LINE_BREAK_BY_TRUNCATING_MIDDLE`, `Titanium.UI.ATTRIBUTE_LINE_BREAK_BY_TRUNCATING_TAIL`, `Titanium.UI.ATTRIBUTE_LINE_BREAK_BY_WORD_WRAPPING`

### lineHeightMultiple

- Type: Number
- Platforms: iPhone, iPad, macOS

The line height multiple.

The natural line height of the receiver is multiplied by this factor (if positive) 
before being constrained by minimum and maximum line height. The default value of 
this property is 0.0, which means nothing multiplied.

### lineSpacing

- Type: Number | String
- Platforms: iPhone, iPad, macOS

The distance in points between the bottom of one line fragment and the top of the next.

This value is always nonnegative float value or dimension string (e.g. '10px'). This value is 
included in the line fragment heights in the layout manager.

### maximumLineHeight

- Type: Number | String
- Platforms: iPhone, iPad, macOS

The maximum line height of receiver.

This property contains the maximum height in points that any line in the receiver will occupy, 
regardless of the font size or size of any attached graphic. This value is always nonnegative 
float value or dimension string (e.g. '10px'). The default value is 0. 
Glyphs and graphics exceeding this height will overlap neighboring lines; however, a maximum 
height of 0 implies no line height limit. Although this limit applies to the line itself, 
line spacing adds extra space between adjacent lines.

### minimumLineHeight

- Type: Number | String
- Platforms: iPhone, iPad, macOS

The minimum height of receiver.

This property contains the minimum height in points that any line in the receiver will occupy, 
regardless of the font size or size of any attached graphic. This value must be nonnegative float value 
or dimension string (e.g. '10px').
E.g. If you have set minimum height 30 and font size 10. It will make line height 30 which have 
smaller text size and more vertical spacing between text.

### paragraphSpacingAfter

- Type: Number | String
- Platforms: iPhone, iPad, macOS

The space after the end of the paragraph.

This property contains the space (measured in points) added at the end of the paragraph 
to separate it from the following paragraph. This value must be nonnegative float value or 
dimension string (e.g. '10px'). The space between paragraphs is determined by adding the paragraphSpacingAfter 
of previous paragraph and the paragraphSpacingBefore of current paragraph.

### paragraphSpacingBefore

- Type: Number | String
- Platforms: iPhone, iPad, macOS

The distance between the top of paragraph and the beginning of its text content.

This property contains the space (measured in points) between the top of paragraph and 
the beginning of its text content. This value can be float value or dimension string (e.g. '10px').
The default value of this property is 0.0.

### tailIndent

- Type: Number | String
- Platforms: iPhone, iPad, macOS

The trailing indentation of the receiver.

If positive, this value is the distance (in points) from the leading margin 
(for example, the left margin in left-to-right text). If 0 or negative, 
it is the distance (in points) from the trailing margin. This is a float value or 
dimension string (e.g. '10px').

---

- This corpus documents Titanium SDK 13.4.1. Anything here that does not name a version describes 13.4.1.
- Titanium is maintained by TiDev. The Appcelerator toolchain is retired: there is no `appc` CLI, no Appcelerator Studio and no hosted build service. The supported CLI is `titanium` on npm, invoked as `ti`.

