An article summary contains optional information about an article such as headline, summary, publication date, author and label. Some of these components are passed in as render props, and others are passed in as a config object, either containing props to be passed on to the appropriate component, or an Abstract Syntax Tree ("AST") which a component can handle by itself.
These components make up the core of an article summary and so, although not required, are made up of specific components.
- date publication - article summary wraps the
DatePublication
component and simply passes on the date props it receives - label - article summary passes label props onto either
ArticleLabel
orVideoLabel
Components that can be specified by the consumer can be passed in as render props.
- headline -
ArticleSummaryHeadline
lays out an accessible article headline - content -
ArticleSummaryContent
handles an AST, but is passed into the summary as a render prop
- byline - passes the given AST to
ArticleByline
orArticleBylineWithLinks
Please read CONTRIBUTING.md before contributing to this package
Please see our main README.md to get the project running locally
The code can be formatted and linted in accordance with the agreed standards.
yarn fmt
yarn lint
This package uses yarn (latest) to run unit tests on each platform with jest.
yarn test:web
Visit the official storybook to see our available article summary templates.
We intend to roll out type checking (TypeScript) throughout the Times Components repo. The components that are allowed within article summary props will be controlled with TypeScript.