Huge News!Announcing our $40M Series B led by Abstract Ventures.Learn More
Socket
Sign inDemoInstall
Socket

font-picker

Package Overview
Dependencies
Maintainers
1
Versions
29
Alerts
File Explorer

Advanced tools

Socket logo

Install Socket

Detect and block malicious and high-risk dependencies

Install

font-picker

Font selector component for Google Fonts

  • 2.0.0
  • Source
  • npm
  • Socket score

Version published
Weekly downloads
1.2K
decreased by-47.61%
Maintainers
1
Weekly downloads
 
Created
Source

Font Picker

license PRs welcome

A simple, customizable font picker allowing users to preview, select, and use Google Fonts on your website.

  • Automatic font download and generation of the required CSS styles
  • Efficient font previews (previews are loaded dynamically and full fonts are only downloaded on selection)
  • No dependencies

Demo

If you use React, see Font Picker for React.

Demo

Getting started

1. Setup

  • Using script tags: Download the latest release and include the font-picker.js file in your HTML:
<script type="text/javascript" src="path/to/font-picker.js"></script>
<script type="text/javascript">
    const fontPicker = new FontPicker(
        'YOUR_API_KEY', // Google API key
        'Open Sans', // default font
        { limit: 50 } // additional options
    );
</script>
  • Using NPM: Install the font-picker package from NPM and import/require it in a JavaScript file:
npm install font-picker
import { FontPicker } from 'font-picker';

const fontPicker = new FontPicker(
    'YOUR_API_KEY', // Google API key
    'Open Sans', // default font
    { limit: 50 } // additional options
);

2. Displaying the font picker

Create an empty <div> with the ID "font-picker" in your HTML file. This is where the font picker will be generated.

<div id="font-picker"></div>

3. Applying the selected font

Add the class "apply-font" to all HTML elements you want to apply the selected font to.

When the user selects a font, it will automatically be downloaded and applied to all HTML elements of the "apply-font" class.

Class names

See demo/index.html for an example.

Customization

Parameters

The following parameters can be passed to the constructor of the FontPicker class:

  • apiKey (required): Google API key (can be generated here)
  • defaultFont: Font that is selected on initialization (default: 'Open Sans')
  • options: Object with additional (optional) parameters:
    • name: If you have multiple font pickers on your site, you need to give them unique names (which may only consist of letters and digits). These names must also be appended to the font picker's ID and the .apply-font class name; e.g. if { name: 'main' }, use #font-picker-main and .apply-font-main
    • families: If only specific fonts shall appear in the list, specify their names in an array (default: all font families)
    • categories: Array of font categories – possible values: 'sans-serif', 'serif', 'display', handwriting', 'monospace' (default: all categories)
    • variants: Array of variants which the fonts must include and which will be downloaded; the first variant in the array will become the default variant (and will be used in the font picker and the .apply-font class); e.g. ['regular', 'italic', '700', '700italic'] (default: ['regular'])
    • limit: Maximum number of fonts to be displayed in the list (the least popular fonts will be omitted; default: 100)
    • sort: Sorting attribute for the font list – possible values: 'alphabetical' (default), 'popularity'
  • onChange: Function which is executed whenever the user changes the active font and its stylesheet finishes downloading

Functions

The FontPicker class has the following functions:

  • getActiveFont(): Returns an object with information about the currently selected font
  • setActiveFont(fontFamily): Change the active font programatically

Contributing

To build the project locally, do the following:

  • git clone
  • npm install
  • npm start to generate the library bundle using Rollup and serve the demo website for previewing the component

Keywords

FAQs

Package last updated on 18 Apr 2018

Did you know?

Socket

Socket for GitHub automatically highlights issues in each pull request and monitors the health of all your open source dependencies. Discover the contents of your packages and block harmful activity before you install or update your dependencies.

Install

Related posts

SocketSocket SOC 2 Logo

Product

  • Package Alerts
  • Integrations
  • Docs
  • Pricing
  • FAQ
  • Roadmap
  • Changelog

Packages

npm

Stay in touch

Get open source security insights delivered straight into your inbox.


  • Terms
  • Privacy
  • Security

Made with ⚡️ by Socket Inc