Skip to content
This repository has been archived by the owner on May 4, 2019. It is now read-only.

Latest commit

 

History

History
58 lines (33 loc) · 1.74 KB

README.md

File metadata and controls

58 lines (33 loc) · 1.74 KB

Note: This project is no longer maintained, there is a version being updated and with additional options by Arjan Haverkamp, here: https://github.com/av01d/fontselect-jquery-plugin

Fontselect jQuery Plugin

A font selector to choose from fonts available as part of the Google Web Fonts api.

Let users easily select and preview a font from Google's large range of free fonts.

Documentation

To create a font selector simply run the plugin on a standard html input element.

How to use

    $('input.fonts').fontselect();

Options

Fontselect has one argument, an options object that you might want to customise:

  • style: the class to give the new font selector

  • placeholder: text to use when no font is selected yet

  • lookahead: a number of fonts to try and preload ahead in the select box

      $('input.fonts').fontselect({
        style: 'font-select',
        placeholder: 'Select a font',
        lookahead: 2
      });
    

Events

Fontselect triggers the change event on the original element when a font is selected. An example is included to show how this could be used to update the font on the current page.

    $('input.fonts').fontselect().change(function(){
    
      // replace + signs with spaces for css
      var font = $(this).val().replace(/\+/g, ' ');
      
      // log font name
      console.log(font);
    });

License / Credits

This plugin is released under the MIT license. It is simple and easy to understand and places almost no restrictions on what you can do with the code. More Information

Download

Releases are available for download from GitHub.