Dynamically scale lines of text within a container, without jQuery.
Clone or download
Pull request Compare This branch is 61 commits ahead, 34 commits behind zachleat:master.
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Failed to load latest commit information.
assets
demo
dist
grunt
src
test
.csslintrc
.editorconfig
.gitattributes
.gitignore
.jshintrc
.travis.yml
CONTRIBUTING.md
Gruntfile.js
LICENSE.md
README.md
package.json

README.md

Big Ideas Text wordmark


Big Ideas Text

Dynamically scale lines of text within a container. No jQuery required.

Build Status

Getting started

Big Ideas Text aims to be as easy to use as the original BigText. If it’s not, please open an issue. Get the latest version of the CSS file here:

Get the latest version of Big Ideas Text

Alternatively, install it with npm and use the build tool of your choice:

With npm

npm install big-ideas-text

Requirements

  1. jQuery No jQuery required!
  2. A block level parent element. Big Ideas Text will force all children to be block level as well.

Learn More

Big Ideas Text works best on browsers that support subpixel font scaling. In order to best serve sizes to all browsers, it will adjust word-spacing as well as font-size.

Examples

Simple Example

<div id="example">
  <span>Don’t get any</span>
  <span>big ideas</span>
  <span>They’re not gonna happen</span>
</div>
<script>
  var ex = document.getElementById('example');
  bigText(ex);
</script>

Using a List (ordered/unordered)

<ol id="example">
  <li>Don’t get any</li>
  <li>big ideas</li>
  <li>They’re not gonna happen</li>
</ol>
<script>
  var ex = document.getElementById('example');
  bigText(ex);
</script>

Restrict to a subset of children

Opt-in children with JS

<div id="example">
  <p>Don’t get any</p>
  <span>big ideas</span>
  <p>They’re not gonna happen</p>
</div>
<script>
  var ex = document.getElementById('example');
  bigText(ex, {
    childSelector: '> p'
  });
</script>

Opt-out lines using markup

<ol id="example">
  <li>Don’t get any</li>
  <li class="bigIdeasText-exempt">big ideas</li>
  <li>They’re not gonna happen</li>
</ol>
<script>
  var ex = document.getElementById('example');
  bigText(ex);
</script>

Mix and Match Typefaces

<ol id="example">
  <li>Don’t get any</li>
  <li>
    <span style="font-family: 'Avenir Next', sans-serif">big</span>
    <span style="font-family: 'Georgia', serif">ideas</span>
  </li>
  <li>They’re not gonna happen</li>
  <li></li>
</ol>
<script>
  var ex = document.getElementById('example');
  bigText(ex);
</script>

Also works with letter-spacing, word-spacing, and text-transform.

Use Big Ideas Text with the WebFontLoader

Whatever web font service you are using, it’s likely built upon WebFontLoader. You can use its active callback to initialise Big Ideas Text once your fonts have loaded.

<script>
  WebFontConfig = {
    google: { families: [ 'Fira+Sans::latin' ] },
    active: function() {
      var ex = document.getElementById('example')
      bigText(ex);
    }
  };
</script>
<script async defer  src="//ajax.googleapis.com/ajax/libs/webfont/1/webfont.js"></script>
<div id="example">
  <span>Don’t get any</span>
  <span>big ideas</span>
  <span>They’re not gonna happen</span>
</div>

Change the default max font size

Shorter lines means larger text sizes. If you’d like to specify a maximum font size:

<div id="example">
    <span>BIG</span>
</div>
<script>
  var ex = document.getElementById('example');
  bigText(ex, {
      maxfontsize: 60 // Default is `528px`
  });
</script>

Adding a default min font size

The following span houses a a super long line that will probably be resized to epically small proportions. A minimum font size will improve the situation.

<div id="example">
    <span>Don’t get any big ideas / They’re not gonna happen / You paint yourself white / And fill up with noise / But there’ll be something missing</span>
</div>
<script>
  $('#bigtext').bigtext({
      minfontsize: 16 // Default is `null`
  });
</script>

Another one of these?

You have a few options if you’d like to scale text in this manner. If your text is static and unchanging, take a look at:

If your text is dynamic, I’d reccomend using this plugin. If you are already have jQuery as a dependency and don’t plan on changing that anytime soon, Zack Leatherman’s original BigText plugin might be the right option.

I’m in the process of writing a comparison of all four libraries (akin to this post). If you’d like an email when it’s done, you can sign up for my web typography newsletter.

Extra Features

Responsive support

Big Ideas Text includes its own debounced resize event.

Debug Mode

Big Ideas Text uses an off-canvas detached node to improve performance when sizing. Setting DEBUG_MODE to true will leave this detached node on the canvas for visual inspection for problem resolution.

var ex = document.getElementById('example');
bigText(ex).DEBUG_MODE = true;

Caveats

Lines Wrapping Pre-BigText The starting font-size must be small enough to guarantee that each individual line is not wrapping pre-Big Ideas Text. If the line is too long, Big Ideas Text will not size it correctly.

Contributing

Thanks for considering contributing! There’s information about how to get started with Big Ideas Text locally here.

License

The MIT License (MIT)

Copyright © 2014 Kenneth Ormandy

Zack Leatherman wrote the original BigText.
Brent Jackson inspired the Radiohead-themed name
The lyrics in the examples are from Radiohead’s Nude, colloquially Big Ideas (Don’t Get Any).
Thanks to my friends and co-workers at Chloi Inc.