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} };
62 unoff => 'l1', # unofficial
64 cr => 'l4', # candidate
65 pr => 'l4', # proposed
66 rec => 'l5', # recommendation
67 other => 'l5', # non-w3
68 ietf => 'l5', # standard
71 if (my ($somerow) = values %{ $caniuse->{data} }) {
72 while (my ($browser, $row) = each %{ $somerow->{stats} }) {
73 $versions{$browser} = [ sort { paddedver($a) cmp paddedver($b) } keys %$row ];
76 my @browsers = grep { $versions{$_} }
77 qw(trident gecko webkit_saf ios_saf webkit_chr android presto op_mob op_mini);
83 my $zero = $#$_ - 2; # baseline index
84 ($_->[$zero - 2] => .5), # past
85 ($_->[$zero - 1] => 10 ), # previous
86 ($_->[$zero + 2] => 0 ), # future
87 ($_->[$zero + 1] => .5), # next
88 ($_->[$zero ] => 30 ), # current
89 } $caniuse->{agents}->{$_}->{versions}
92 }; # fallback hash based on release semantics
93 my $scorediv = (max(map { ref $_ eq 'HASH' && sum(values %$_) } values %$canihas) // 1) / 100;
95 print '<table class="mapped">';
97 printf '<colgroup span="%d">', scalar @{ $versions{$_} } for @browsers;
100 my $header = join('',
102 '<th colspan="3">feature',
104 sprintf('<th colspan="%d" title="%.1f%%">%s',
105 scalar @{ $versions{$_} },
106 sum(values %{ $canihas->{$_} }),
108 my $name = $caniuse->{agents}->{$_}->{browser};
109 length $name < 16 ? $name : $caniuse->{agents}->{$_}->{abbr};
115 print '<thead>', $header;
116 # preceding row without any colspan to work around gecko bug
119 for my $browser (@browsers) {
120 printf('<td title="%.1f%%"%s>%s',
121 $canihas->{$browser}->{$_},
123 defined $_ && !$_ && ' class="ex"'
124 } $caniuse->{agents}->{$browser}->{verrelease}->{$_}),
126 ) for @{ $versions{$browser} };
132 # relative amount of support for given feature
133 state $statspts = { y=>10, 'y x'=>9, a=>5, 'a x'=>5, j=>2, 'p j'=>2, p=>1 };
135 if (my $row = shift) {
137 while (my ($browser, $versions) = each %$row) {
138 ref $versions eq 'HASH' or next;
139 while (my ($version, $_) = each %$versions) {
140 $rank += $canihas->{$browser}->{$version} * $statspts->{$_};
146 while (my ($browser, $vercols) = each %versions) {
147 my $div = 0; # multiplier exponent (decreased to lower value)
148 my @vers = map { $row->{$browser}->{$_} } @$vercols;
149 if (my $current = $caniuse->{agents}->{$browser}->{versions}->[-3]) {
150 my @future; # find upcoming releases (after current)
151 for (reverse @$vercols) {
152 last if $_ eq $current;
153 push @future, pop @vers;
154 $_ eq 'u' and $_ = $vers[-1] for $future[-1]; # inherit latest value if unknown
156 splice @vers, -1, 0, @future; # move ahead to decrease precedence
158 $rank += $statspts->{$_} * 2**($div--) for reverse @vers;
165 featurescore($caniuse->{data}->{$b}->{stats})
166 <=> featurescore($caniuse->{data}->{$a}->{stats})
167 } keys %{ $caniuse->{data} }) {
168 my $row = $caniuse->{data}->{$id};
169 my $data = $row->{stats} or next; # skip metadata [summary]
170 printf '<tr id="%s">', $id;
171 for ($row->{categories}) {
172 my $cell = $_ ? lc $_->[0] : '-';
176 sprintf('<a href="%s" onclick="%s">%s</a>',
178 sprintf("try { %s; return false } catch(err) { return true }",
179 "document.getElementById('$id').classList.toggle('target')",
184 print '<div class=aside>';
185 s/\.?$/./, print "<p>$_</p>" for map { ref $_ ? @$_ : $_ || () }
186 $row->{description}, $row->{notes};
187 printf 'Resources: %s.', join(', ',
188 map { qq(<a href="$_->{url}">$_->{title}</a>) } @$_
189 ) for grep { @$_ } $row->{links} // ();
191 for ($row->{status}) {
192 my $cell = $_ // '-';
193 $cell = sprintf '<a href="%s">%s</a>', $_, $cell for $row->{spec} // ();
194 printf '<td title="%s" class="l %s">%s',
195 $caniuse->{statuses}->{$_}, $CSTATUS{$_} // '', $cell;
197 for my $browser (@browsers) {
199 for my $ver (@{ $versions{$browser} }, undef) {
200 unless (!defined $prev
201 or ref $data->{$browser} eq 'HASH'
202 && $data->{$browser}->{$prev} ~~ $data->{$browser}->{$ver}) {
203 my $usage = sum(map { $canihas->{$browser}->{$_} } @span);
204 printf '<td class="%s" colspan="%d" title="%.1f%%">%s',
207 ref $data->{$browser} ne 'HASH' ? 'u' :
208 $data->{$browser}->{$prev} // 'u'
210 !$usage ? ('p0') : ('p',
211 sprintf('p%01d', $usage / 10),
212 sprintf('p%02d', $usage),
214 sprintf('pp%02d', $usage / $scorediv),
226 state $maxscore = featurescore({ # yes for every possible version
227 map { $_ => { map {$_ => 'y'} @{$versions{$_}} } } keys %versions
229 print '<td>', int featurescore($caniuse->{data}->{$id}->{stats}) / $maxscore * 100;
231 print '<tfoot>', $header;
235 # normalised version number comparable as string (cmp)
236 shift =~ /^(\d*)(.*)/;
237 return sprintf('%02d', $1 || 0) . $2;
241 my @span = ($_[0], @_>1 ? $_[-1] : ());
246 return join('‒', @span);
254 <table class="glyphs"><tr>
255 <td class="X l5">supported
256 <td class="X l3">partial
257 <td class="X l2">external (js/plugin)
258 <td class="X l1">missing
259 <td class="X l0">unknown
260 <td class="X l0 ex">prefixed
263 <p><: if ($usage) { :>
265 <span class=" p0">0</span> -
266 <span class="p p0 p00">.01</span> -
267 <span class="p p0 p05">1-9</span> -
268 <span class="p p1">10</span> -
269 <span class="p p2">20</span> -
270 <span class="p p5">majority</span>
272 <table class="glyphs"><tr>
273 <td class="p p1">previous version</td>
274 <td class="p p3">current</td>
275 <td class="p p0 p00">upcoming (within months)</td>
276 <td class=" p0">future (within a year)</td>
281 <ul class="legend legend-set">
282 <li>default <strong>style</strong> is
283 <:= defined $get{style} && 'set to ' :><em><:= $style :></em>
284 <li><strong>usage</strong> source is
285 <:= !defined $get{usage} && 'default ' :><:= defined $usage ? "<em>$usage</em>" : 'not included (<em>0</em>)' :>