---
title: DropCapStyle
framework: applenewsformat
role: symbol
role_heading: Object
path: applenewsformat/dropcapstyle
---

# DropCapStyle

The object for defining the drop cap text style to use in the first paragraph in a text component.

## Declaration

```data
object DropCapStyle
```

## Properties

numberOfLines: The approximate number of text lines this drop cap spans. For example, if numberOfLines is set to 3, and the top of the drop cap is aligned with the top of the first line, the bottom of the drop cap drops to the bottom of the third line, although the actual drop amount can vary depending on the device and its orientation. Minimum: 2 Maximum: 10 backgroundColor: The background color of the drop cap. By default, no background color is applied, making the background effectively transparent. fontName: The PostScript name of the font to use for the drop cap. By default, the drop cap inherits the font of the component it’s in. numberOfCharacters: A number that indicates the characters to render in the drop cap style. Minimum: 1 Maximum: 4 Default value: 1 numberOfRaisedLines: The number of text lines this drop cap raises. For example: When numberOfRaisedLines is 3, and numberOfLines is 5, the top of the drop cap raises above the first line by 3 lines and and the bottom of the drop cap drops to the bottom of the second line. padding: A number that sets the padding of the drop cap in points. When padding is applied, the drop cap is smaller than the box that surrounds it. Default value: 0 textColor: The color of the drop cap. The color defaults to the color of the associated text.

## Mentioned in

Defining and Applying Text Styles

## Discussion

Discussion Use a DropCapStyle object to define a drop cap that a ComponentTextStyle object can use. You can apply drop caps to the first paragraph of the following components: Author Body Byline Caption Heading Illustrator Intro Photographer PullQuote note: Using a divider between paragraphs splits text into separate components. This affects the rendering of dropCapStyle. If you want to include a divider between paragraphs and you don’t want the paragraph after the divider to have a drop cap, use separate text components for the block of text before and after the divider. Then make sure that you don’t have dropCapStyle in the text component following the divider. You can use this object in TextStyle and ComponentTextStyle. Example {   "componentTextStyles": {     "exampleStyle": {       "fontName": "HelveticaNeue",       "fontSize": 20,       "dropCapStyle": {         "numberOfLines": 5,         "numberOfRaisedLines": 2,         "numberOfCharacters": 1,         "fontName": "HelveticaNeue",         "textColor": "#FFF",         "backgroundColor": "#000",         "padding": 5       }     }   } }

## See Also

### Text Styles

- [Defining and Applying Text Styles](applenews/defining-and-applying-text-styles.md)
- [Applying Apple News Format Fonts](applenews/applying-apple-news-format-fonts.md)
- [TextStyle](applenewsformat/textstyle.md)
- [ComponentTextStyle](applenewsformat/componenttextstyle.md)
- [ListItemStyle](applenewsformat/listitemstyle.md)
- [InlineTextStyle](applenewsformat/inlinetextstyle.md)