4 use List::Util qw(sum max);
7 title => 'browser compatibility cheat sheet',
11 keywords => [qw'html css browser feature'],
12 stylesheet => [qw'circus dark mono red light'],
13 data => ['browser-support.inc.pl'],
17 <h1>Browser compatibility</h1>
19 <p>Alternate view of Fyrd's <a href="http://caniuse.com/">when can I use...</a> page<:
20 my ($canihas, $usage);
21 given ($get{usage} // 'wm') {
26 printf "<p>Invalid browser usage data request: <em>%s</em>",
27 'identifier must be alphanumeric name or <q>0</q>';
29 $canihas = do "browser-usage-$_.inc.pl" or do {
30 printf "<p>Browser usage data not found: <em>%s</em>", $! || $@;
34 my $ref = $canihas->{-source} || 'unknown';
35 $ref = sprintf '<a href="%s">%s</a>', $_, $ref for $canihas->{-url} || ();
36 $ref .= " $_" for $canihas->{-date} || ();
37 print "\nwith $ref browser usage statistics";
44 my $caniuse = do 'browser-support.inc.pl' or die $! || $@;
46 # mark last two (future) versions as unreleased, ensure current isn't
47 map { $_->[-1] => 0, $_->[-2] => 0, $_->[-3] => undef } $_->{versions}
48 } for values %{ $caniuse->{agents} };
63 unoff => 'l1', # unofficial
65 cr => 'l4', # candidate
66 pr => 'l4', # proposed
67 rec => 'l5', # recommendation
68 other => 'l5', # non-w3
69 ietf => 'l5', # standard
72 if (my ($somerow) = values %{ $caniuse->{data} }) {
73 while (my ($browser, $row) = each %{ $somerow->{stats} }) {
74 $versions{$browser} = [ sort { paddedver($a) cmp paddedver($b) } keys %$row ];
77 my @browsers = grep { $versions{$_} }
78 qw(trident gecko webkit_saf ios_saf webkit_chr android presto op_mob op_mini);
84 my $zero = $#$_ - 2; # baseline index
85 ($_->[$zero - 2] => .5), # past
86 ($_->[$zero - 1] => 10 ), # previous
87 ($_->[$zero + 2] => 0 ), # future
88 ($_->[$zero + 1] => .5), # next
89 ($_->[$zero ] => 30 ), # current
90 } $caniuse->{agents}->{$_}->{versions}
93 }; # fallback hash based on release semantics
94 my $scorediv = (max(map { ref $_ eq 'HASH' && sum(values %$_) } values %$canihas) // 1) / 100;
96 print '<table class="mapped">';
98 printf '<colgroup span="%d">', scalar @{ $versions{$_} } for @browsers;
101 my $header = join('',
103 '<th colspan="3">feature',
105 sprintf('<th colspan="%d" title="%.1f%%">%s',
106 scalar @{ $versions{$_} },
107 sum(values %{ $canihas->{$_} }),
109 my $name = $caniuse->{agents}->{$_}->{browser};
110 length $name < 16 ? $name : $caniuse->{agents}->{$_}->{abbr};
116 print '<thead>', $header;
117 # preceding row without any colspan to work around gecko bug
120 for my $browser (@browsers) {
121 printf('<td title="%.1f%%"%s>%s',
122 $canihas->{$browser}->{$_},
124 defined $_ && !$_ && ' class="ex"'
125 } $caniuse->{agents}->{$browser}->{verrelease}->{$_}),
127 ) for @{ $versions{$browser} };
133 # relative amount of support for given feature
134 state $statspts = { y=>10, 'y x'=>10, a=>5, 'a x'=>5, j=>2, 'p j'=>2, p=>1 };
136 if (my $row = shift) {
138 while (my ($browser, $versions) = each %$row) {
139 ref $versions eq 'HASH' or next;
140 while (my ($version, $_) = each %$versions) {
141 $rank += $canihas->{$browser}->{$version} * $statspts->{$_};
147 while (my ($browser, $vercols) = each %versions) {
148 my $div = 0; # multiplier exponent (decreased to lower value)
149 my @vers = map { $row->{$browser}->{$_} } @$vercols;
150 if (my $current = $caniuse->{agents}->{$browser}->{versions}->[-3]) {
151 my @future; # find upcoming releases (after current)
152 for (reverse @$vercols) {
153 last if $_ eq $current;
154 push @future, pop @vers;
155 $_ eq 'u' and $_ = $vers[-1] for $future[-1]; # inherit latest value if unknown
157 splice @vers, -1, 0, @future; # move ahead to decrease precedence
159 $rank += $statspts->{$_} * 2**($div--) for reverse @vers;
166 featurescore($caniuse->{data}->{$b}->{stats})
167 <=> featurescore($caniuse->{data}->{$a}->{stats})
168 } keys %{ $caniuse->{data} }) {
169 my $row = $caniuse->{data}->{$id};
170 my $data = $row->{stats} or next; # skip metadata [summary]
171 printf '<tr id="%s">', $id;
172 for ($row->{categories}) {
173 my $cell = $_ ? lc $_->[0] : '-';
177 sprintf('<a href="%s" onclick="%s">%s</a>',
179 sprintf("try { %s; return false } catch(err) { return true }",
180 "document.getElementById('$id').classList.toggle('target')",
185 print '<div class=aside>';
186 s/\.?$/./, print "<p>$_</p>" for map { ref $_ ? @$_ : $_ || () }
187 $row->{description}, $row->{notes};
188 printf 'Resources: %s.', join(', ',
189 map { qq(<a href="$_->{url}">$_->{title}</a>) } @$_
190 ) for grep { @$_ } $row->{links} // ();
192 for ($row->{status}) {
193 my $cell = $_ // '-';
194 $cell = sprintf '<a href="%s">%s</a>', $_, $cell for $row->{spec} // ();
195 printf '<td title="%s" class="l %s">%s',
196 $caniuse->{statuses}->{$_}, $CSTATUS{$_} // '', $cell;
198 for my $browser (@browsers) {
200 for my $ver (@{ $versions{$browser} }, undef) {
201 unless (!defined $prev
202 or ref $data->{$browser} eq 'HASH'
203 && $data->{$browser}->{$prev} ~~ $data->{$browser}->{$ver}) {
204 my $usage = sum(map { $canihas->{$browser}->{$_} } @span);
205 printf '<td class="%s" colspan="%d" title="%.1f%%">%s',
208 ref $data->{$browser} ne 'HASH' ? 'u' :
209 $data->{$browser}->{$prev} // 'u'
211 !$usage ? ('p0') : ('p',
212 sprintf('p%01d', $usage / 10),
213 sprintf('p%02d', $usage),
215 sprintf('pp%02d', $usage / $scorediv),
227 state $maxscore = featurescore({ # yes for every possible version
228 map { $_ => { map {$_ => 'y'} @{$versions{$_}} } } keys %versions
230 print '<td>', int featurescore($caniuse->{data}->{$id}->{stats}) / $maxscore * 100;
232 print '<tfoot>', $header;
236 # normalised version number comparable as string (cmp)
237 shift =~ /^(\d*)(.*)/;
238 return sprintf('%02d', $1 || 0) . $2;
242 my @span = ($_[0], @_>1 ? $_[-1] : ());
247 return join('‒', @span);
255 <table class="glyphs"><tr>
256 <td class="X l5">supported
257 <td class="X l3">partial
258 <td class="X l2">external (js/plugin)
259 <td class="X l1">missing
260 <td class="X l0">unknown
261 <td class="X l0 ex">prefixed
264 <p><: if ($usage) { :>
266 <span class=" p0">0</span> -
267 <span class="p p0 p00">.01</span> -
268 <span class="p p0 p05">1-9</span> -
269 <span class="p p1">10</span> -
270 <span class="p p2">20</span> -
271 <span class="p p5">majority</span>
273 <table class="glyphs"><tr>
274 <td class="p p1">previous version</td>
275 <td class="p p3">current</td>
276 <td class="p p0 p00">upcoming (within months)</td>
277 <td class=" p0">future (within a year)</td>
282 <ul class="legend legend-set">
283 <li>default <strong>style</strong> is
284 <:= defined $get{style} && 'set to ' :><em><:= $style :></em>
285 <li><strong>usage</strong> source is
286 <:= !defined $get{usage} && 'default ' :><:= defined $usage ? "<em>$usage</em>" : 'not included (<em>0</em>)' :>