Blockquote component


About

The vf-blockquote highlights a section that is quoted from an external source.

Usage

The vf-blockquote should be used to highlight texts from external sources like quotes and testimonials. It should be used for more than decorative purposes, ensuring that the text being quoted is relevant to the content of the page and adds value to the content.

It should not be confused with a pull quote which highlights a section of text from the same source/page.

Quotes should be as concise as possible. The impact of the blockquote is diminished when it has long texts as this overwhelms the reader.

Provide proper attribution such as the name, source and relevant information to give credibility to the quote. The component allows you to add the image of the person, the name (Which can be linked to a profile or source page) and other attribution details.

The blockquote is designed to be used on a white background, it is advisable to avoid using it on backgrounds with gradients, images or other colours. If the background colour is changed, ensure the contrast ratio between the texts and the background meet accessibility standards.

$3

- Quoting external sources such as individuals, experts, publications etc.
- Testimonials and feedback can be highlighted using the vf-blockquote.

$3

- Self-quoting or usage as a pull quote should be avoided in the context of the page/content. This component should not be used to highlight a portion of text from the same content.
- Vf-blockquotes should not be used solely for decorative purposes, ensuring that the quoted text adds value to the content.

$3

When using vf-blockquote with headings that have smaller font sizes such as 24 px, it is recommended to use the small-vf-blockquote variant as the default blockquote variant has a font size of 28px and could compete with smaller heading sizes for attention.
When showing multiple quotes in a section, such as testimonials or multiple endorsements the small variant is recommended.

$3

- This component targets WCAG 2.1 AA accessibility.

$3

As of version 1.2.1 vf-blockquote has experimental Angular support.
This package was generated with Angular version 15.2.0 and has been tested on application with Angular version 15.2.0.

1. Install yarn add @visual-framework/vf-blockquote
2. Import in your app.module
``
import { VfBlockquoteAngularModule } from '@visual-framework/vf-blockquote/vf-blockquote.angular';

@NgModule({
imports: [VfBlockquoteAngularModule, YourOtherModules],
...
})
`
3. Can be used as
`

`
4. Styling changes

In angular.json add the following in architect -> build -> options -> assets:
`
{
"glob": "*/",
"input": "./node_modules/@visual-framework/vf-font-plex-mono/assets/IBM-Plex-Mono",
"output": "./assets/fonts/IBM-Plex-Mono"
},
{
"glob": "*/",
"input": "./node_modules/@visual-framework/vf-font-plex-sans/assets/IBM-Plex-Sans",
"output": "./assets/fonts/IBM-Plex-Sans"
}
`
You should install vf-sass-starter for the styles and then add below code in your main SCSS file.
`
$vf-font-plex-mono-prefix: '/assets/fonts';
$vf-font-plex-sans-prefix: '/assets/fonts';
@import '../node_modules/@visual-framework//vf-sass-starter/index.scss';
@import "../node_modules/@visual-framework/vf-text/vf-text.scss";
@import "../node_modules/@visual-framework/vf-profile/vf-profile.scss";
@import '../node_modules/@visual-framework/vf-blockquote/vf-blockquote.scss';
`

5. Usage:

`

`

$3

As of version 1.2.1 vf-blockquote has experimental React support which has been tested on react version 18.2.0

1. Install yarn add @visual-framework/vf-blockquote
2. Import in the JS file where you want to include this component
`
import VfBlockquote from '@visual-framework/vf-blockquote/vf-blockquote.react';

Make sure you have the jsx support enabled with babel. Alternatively, you can also copy the vf-blockquote.react.js file from below to your react project and import as per the location.
`
3. Can be used as
`

`
4. Styling changes

You should install vf-sass-starter for the styles and then add below code in your main SCSS file
`
$vf-font-plex-mono-prefix: '~@visual-framework/vf-font-plex-mono/assets';
$vf-font-plex-sans-prefix: '~@visual-framework/vf-font-plex-sans/assets';

@import '~@visual-framework//vf-sass-starter/index.scss';
@import "~@visual-framework/vf-profile/vf-profile.scss";
@import "~@visual-framework/vf-text/vf-text.scss";
@import '~@visual-framework/vf-blockquote/vf-blockquote.scss';
`

5. Usage:

`

`

Install

This component is distributed with npm. After installing npm, you can install the vf-blockquote with this command.

`
$ yarn add --dev @visual-framework/vf-blockquote
`

$3

The source files included are written in Sass(scss). You can point your Sass include-path at your node_modules directory and import it like this.

`
@import "@visual-framework/vf-blockquote/index.scss";
`

Make sure you import Sass requirements along with the modules. You can use a project boilerplate or the vf-sass-starter`

Help

- Read the Visual Framework troubleshooting
- Open a ticket
- Chat on Slack