Skip to main content

Adapter Pattern

The Adapter Pattern translates an interface for an object or class into an interface compatible with a specific system.

Adapters basically allow objects or classes to function together which normally couldn't due to their incompatible interfaces. The adapter translates calls to its interface into calls to the original interface and the code required to achieve this is usually quite minimal.

One example of an adapter we may have used is the jQuery jQuery.fn.css() method. It helps normalize the interfaces to how styles can be applied across a number of browsers, making it trivial for us to use a simple syntax which is adapted to use what the browser actually supports behind the scenes:

// Cross browser opacity:
// opacity: 0.9; Chrome 4+, FF2+, Saf3.1+, Opera 9+, IE9, iOS 3.2+, Android 2.1+
// filter: alpha(opacity=90); IE6-IE8

// Setting opacity
$('.container').css({ opacity: 0.5 });

// Getting opacity
var currentOpacity = $('.container').css('opacity');

The corresponding jQuery core cssHook which makes the above possible can be seen below:

get: function(elem, computed) {
// IE uses filters for opacity
return ropacity.test(
(computed && elem.currentStyle ? elem.currentStyle.filter : elem.style.filter) || ''
)
? parseFloat(RegExp.$1) / 100 + ''
: computed
? '1'
: '';
}

set: function(elem, value) {
var style = elem.style,
currentStyle = elem.currentStyle,
opacity = jQuery.isNumeric(value) ? 'alpha(opacity=' + value * 100 + ')' : '',
filter = (currentStyle && currentStyle.filter) || style.filter || '';

// IE has trouble with opacity if it does not have layout
// Force it by setting the zoom level
style.zoom = 1;

// if setting opacity to 1, and no other filters
//exist - attempt to remove filter attribute #6652
if (value >= 1 && jQuery.trim(filter.replace(ralpha, '')) === '') {
// Setting style.filter to null, "" & " " still leave
// "filter:" in the cssText if "filter:" is present at all,
// clearType is disabled, we want to avoid this style.removeAttribute
// is IE Only, but so apparently is this code path...
style.removeAttribute('filter');

// if there there is no filter style applied in a css rule, we are done
if (currentStyle && !currentStyle.filter) {
return;
}
}

// otherwise, set new filter values
style.filter = ralpha.test(filter)
? filter.replace(ralpha, opacity)
: filter + ' ' + opacity;
}