2.2.0 • Published 7 years ago

fyndiq-component-article v2.2.0

Weekly downloads
2
License
MIT
Repository
github
Last release
7 years ago

fyndiq-component-article npm

Preview

An Article component for Fyndiq

Installation

The component can be installed through NPM:

npm i -S fyndiq-component-article

Components

The package fyndiq-component-article exposes several components:

Layout components are high-level components that are responsible for arranging the details in a certain way.

LayoutDetails

This layout component arranges the article in a details view, which is mobile and tablet friendly. Best used for a customer-facing interface.

Usage

import React from 'react'
import {
  Description,
  Images,
  Price,
  Tags,
  LayoutDetails,
} from 'fyndiq-component-article'

// Normal usage
<LayoutDetails
  title="My article title"
  description="My article description"
  images={[
    'http://image-url-1',
    'http://image-url-1',
  ]}
  price="$150"
  tags={['Awesomeness', 'Pretty good article']}
/>

// Advanced usage
<LayoutDetails
  images={
    <Images
      images={['src1', 'src2']}
    />
  }
  title="Article Title"
  description={<span dangerouslySetInnerHtml={{ __html: '<strong>hello</strong>' }} />}
  price={
    <Price oldPrice="$250" noEmphasize>$124</Price>
  }
  tags={<Tags tags={['Awesomeness', 'Pretty good article']} />}
/>

API

NameTypeDescriptionDefault value
classNameStringAdditionnal class for the root element
titleStringTitle of the article
descriptionString or Description elementDescription of the articlenull
imagesArray of string or Images elementImages of the articlenull
tagsArray of string or Tags elementTags of the articlenull
priceString or Price elementPrice of the articlenull

Description

Description of the Article

Usage

import React from 'react'
import { Description } from 'fyndiq-component-article'

// Normal usage
<Description>My Article Description</Description>

// Pass raw HTML (useful when working with Markdown)
<Description>
  <span
    dangerouslySetInnerHtml={
      { __html: '<strong>hello</strong>' }
    }
  />
</Description>

API

NameTypeDescriptionDefault value
childrenNodeContent of the description

Images

Images of the Article. Includes a carrousel-like interaction

Usage

import React from 'react'
import { Images } from 'fyndiq-component-article'

// Normal usage
<Images
  images={[
    'http://image-url-1',
    'http://image-url-2',
  ]}
  alt="alt text for images"
/>

API

NameTypeDescriptionDefault value
imagesArray of stringsURL of the images[]
altStringAlt text for the <img> tags''

Price

Price of the Article.

Usage

import React from 'react'
import { Price } from 'fyndiq-component-article'

// Normal usage
<Price>$100</Price>

// With old price
<Price oldPrice="$150">$100</Price>

API

NameTypeDescriptionDefault value
childrenStringPrice of the articlenull
oldPriceStringOld price of the article''
emphasizeBooleanShow a difference in font-sizes for oldPrice and pricetrue

Tags

Tags of the Article.

Usage

import React from 'react'
import { Tags } from 'fyndiq-component-article'

// Normal usage
<Tags tags={['tag1', 'tag2']} />

API

NameTypeDescriptionDefault value
tagsArray of stringsTags of the article[]