Component Role Summary
This appendix summarizes all available component roles. Refer to the individual component definitions for more details.
Article body text.
Text that will be treated and positioned as the article title or headline.
Text that will be treated as a heading or subheading, depending on the context. You can use multiple levels of subheadings:
An introduction or other preliminary text. You're not required to mark the introductory text as such, but you may find it useful to do so, in case you later need to style it differently.
Usually a selection from the body text, often used to break up long portions of text or draw attention to a specific section.
A quotation in the article text. A
quoteis treated differently than a
pullquote: a quote is a unique portion of text, while a pullquote duplicates a selection of text.
Caption text for another component in the document, such as a photo.
Text that describes one or more contributors to the article.
The name of an author of the article.
The name of a contributor whose photographs appear in the article.
The name of a contributor whose illustrations appear in the article.
A figure or illustration that adds important context to the article.
An image that identifies a brand, company, or publication.
An image that is a portrait of a person.
A collection of images displayed in a horizontal strip.
A collection of images displayed in a mosaic layout.
A component display a geographical location or area on a map.
A component display a specific point of interest on a map.
A component that can play a video.
A component that contains a link to an embeddable web video (YouTube or Vimeo).
A component that can play audio.
A component that plays an audio file and can also display an accompanying image (such as cover art).
Social Media Roles
A component that embeds a Facebook post in an article.
A component that embeds an Instagram post in an article.
A component that embeds a Twitter tweet in an article.
A component that presents data as rows and columns. The data is provided as Apple News Format JSON within the component.
A component that presents data as rows and columns. The data is provided as an HTML
<table>element within the component.
A component for advertisements that span the full width of the display.
A component for advertisements with a fixed size of 300 x 250 points.
A component with child components that are rendered relative to the parent component. Headers can also include layout and styling information.
A component with child components that are rendered relative to the parent component. Containers can also include layout and styling information.
A horizontal divider line.
A full-width container with child components. See the Section component definition for more details.
A type of section; text that is intended to be viewed as a chapter.
A component that contains text that News personalization will ignore. Contains child components that are rendered relative to the parent component. Can include layout and styling information.