Skip to the content...

Welcome to the David Walsh Blog. I'm a MooTools, Dojo, jQuery, CSS, and PHP Web Developer located in Madison, Wisconsin, United States. Please contact me if I can make your experience on my website better.

Pretty Word Wrapper with MooTools or PHP

7 Responses »

Details, details, details. Details are what take a good site to the next level. Small details like link nudging (jQuery, MooTools), simple but stylish CSS enhancements, and opacity effects are the cheeky effects that give your website the edge over similar websites. The detail we'll be addressing today is "widowed" text. A "widow" occurs when only one word of a long string wraps to the next line. An example would be:

Widow

No offense to raging cougars out there but widows look wonky. The best way to prevent widows is to add a " " between the last and second-to-last words in a string. Doing this, the example above would split to the next like at "or" so that two words would be on the second line. Today I'll show you how to accomplish this using a tiny MooTools class or PHP.

The MooTools JavaScript

//class
var WordWrapper = new Class({
	
	Implements: [Options],
	
	options: {
		elements: 'h1',
		minWords: 3
	},
	
	initialize: function(options) {
		this.elements = $$(options.elements);
		this.elements.each(function(el) {
			this.apply(el);
		},this);
	},
	
	apply: function(element) {
		var original = element.get('html'), arr = original.split(' ');
		if(arr.length >= this.options.minWords) {
			//join the last and second to last
			arr[arr.length - 2] += ' ' + arr[arr.length - 1];
			arr.pop();
			element.set('html',arr.join(' '));
		}
	}	
});

The MooTools plugin offers just a few options: the elements to apply this too and the minimum number of words the element must have before the substitution takes place. The usage is just as easy as you'd expect:

//usage
window.addEvent('domready',function() {
	var ww = new WordWrapper({
		elements: 'h2'
	});
});

//sample results
//"This Is The First Attempt" becomes: This Is The First Attempt
//"Leave Me" is not long enough to modify
//"Que?" is not long enough to modify
//"I Am, I Am SuperMan, And I Can Do Anything" becomes: I Am, I Am SuperMan, And I Can Do Anything

Awesome....but what about a PHP version? Sure, why not?

The PHP

function word_wrapper($text,$minWords = 3) {
	$return = $text;
	$arr = explode(' ',$text);
	if(count($arr) >= $minWords) {
		$arr[count($arr) - 2].= ' '.$arr[count($arr) - 1];
		array_pop($arr);
		$return = implode(' ',$arr);
	}
	return $return;
}

And Voila! Now you can update any text before it hits the DOM!

The jQuery

Wanna see how you'd accomplish this feat with jQuery? Hop over to Chris Coyier's CSS-Tricks blog post to find out!

Discussion

  1. chris the developer
    August 28, 2009 @ 9:36 am

    Wouldn’t it be more safe-mode friendly if you used document.getElements() instead of $$?

  2. August 28, 2009 @ 9:40 am

    @Chris the Developer: How so?

  3. francis
    August 28, 2009 @ 9:43 am

    Took me a while to understand what this was doing until I noticed that the &nbsp is replaced by a blank space ‘ ‘ in the code!
    Should read: $arr[count($arr) - 2].= ‘&nbsp’.$arr[count($arr) - 1];

  4. August 28, 2009 @ 9:44 am

    Thanks Francis! Stupid WordPress…

  5. August 28, 2009 @ 10:41 am

    Ineresting approach, I use a little function that cuts the text off after a certain amount of characters and then adds … to it. Of course I’m checking correctly for things like, cutting at the first space before the max amount of chars, taking care of commas and hyphens, etc

  6. dutchie
    August 28, 2009 @ 1:56 pm

    Hmm.. I like this idea, but still the www is not a thing like print is in combination with InDesign (I reffuse to mention Quark, lol), which have advanced widow cut rules etc. build in. I mean, it’s not always appropriate to move the two last words to the next line as a default in various languages/situations.. then I rather blame the browser’s neanderthaler rudeness :)

    But again, it’s an original idea which probably makes the headlines in most cases a bit nicer, and the JS is small (and php is fast).

  7. greg
    September 15, 2009 @ 8:45 am

    You can stream line you code a little by changing the

    arr[arr.length - 2] += ‘ ’ + arr[arr.length - 1];

    arr.pop();

    with
    arr[arr.length - 2] += ‘ ’ + arr.pop();

    You can do the same with the PHP too.

    since the array Pop method both removes the last item in the array AND returns its value. Though this will not make a huge impact on the performance of the code it is code practice.

Be Heard!

Share your thoughts with fellow developers of all skill levels! I want to hear from you!

Name*:
Email*:
Website:  
Wrap your code with <code> tags, f00!