<(common.inc.plp)><:
use 5.010;
+use utf8;
+use List::Util qw(sum max);
Html({
title => 'browser compatibility cheat sheet',
description =>
"caniuse.",
keywords => [qw'html css browser feature'],
- stylesheet => [qw'light dark circus mono red'],
- data => ['caniuse.js'],
+ stylesheet => [qw'circus dark mono red light'],
+ data => ['browser-support.inc.pl'],
});
:>
<h1>Browser compatibility</h1>
-<p>Alternate view of Fyrd's <a href="http://caniuse.com/">when can I use...</a> site.</p>
+<p>Alternate view of Fyrd's <a href="http://caniuse.com/">when can I use...</a> page<:
+my ($canihas, $usage);
+given ($get{usage} // 'wm') {
+ when (!$_) {
+ # none
+ }
+ when (!/^\w+$/) {
+ printf "<p>Invalid browser usage data request: <em>%s</em>",
+ 'identifier must be alphanumeric name or <q>0</q>';
+ }
+ $canihas = do "browser-usage-$_.inc.pl" or do {
+ printf "<p>Browser usage data not found: <em>%s</em>", $! || $@;
+ break;
+ };
+ $usage = $_;
+ my $ref = $canihas->{-source} || 'unknown';
+ $ref = sprintf '<a href="%s">%s</a>', $_, $ref for $canihas->{-url} || ();
+ $ref .= " $_" for $canihas->{-date} || ();
+ print "\nwith $ref browser usage statistics";
+}
+:>.
+</p>
+<div id="browser">
<:
-use JSON;
-use File::Slurp 'read_file';
-my $source = read_file('caniuse.js');
-for ($source) { # cleanup
- # convert seperate variables to hash keys
- s/\A/{/;
- s/^caniuse\.(\w+) = /"$1":/gm;
- s/;$/,/gm;
- s/,\s*\Z/\n}/;
- # fractions not supported by barekey
- s/(?<=[,{]) (\d*\.\d) (?=:')/"$1"/gx;
- # escapes not supported in singlequote
- s{'((?:[^\\']+|\\.)*)'}{
- my $_ = $1;
- s/"/\\"/g;
- s/\\'/'/g;
- qq("$_");
- }ge;
-}
-my $caniuse = from_json($source, {
-# allow_singlequote => 1,
- allow_barekey => 1,
-});
+my $caniuse = do 'browser-support.inc.pl' or die $! || $@;
my %CSTATS = (
- n => 'di-b',
- y => 'di-aa',
- a => 'di-d',
- j => 'di-prop',
- p => 'di-prop',
- 'y x' => 'di-a',
+ 'n' => 'l1',
+ 'y' => 'l5',
+ 'y x' => 'l5 ex',
+ 'a' => 'l3',
+ 'a x' => 'l3 ex',
+ 'p j' => 'l2',
+ 'j' => 'l2',
+ 'p' => 'l2',
+ 'u' => 'l0',
);
my %CSTATUS = (
- unoff => 'di-rare', # unofficial
- wd => 'di-b', # draft
- pr => 'di-prop', # proposed
- cr => 'di-d', # candidate
- rec => 'di-a', # recommendation
- ietf => 'di-aa', # standard
+ unoff => 'l1', # unofficial
+ wd => 'l3', # draft
+ cr => 'l4', # candidate
+ pr => 'l4', # proposed
+ rec => 'l5', # recommendation
+ other => 'l5', # non-w3
+ ietf => 'l5', # standard
);
-my @browsers = qw(trident gecko webkit_saf presto);
my %versions;
if (my ($somerow) = values %{ $caniuse->{data} }) {
while (my ($browser, $row) = each %{ $somerow->{stats} }) {
$versions{$browser} = [ sort { paddedver($a) cmp paddedver($b) } keys %$row ];
}
}
+my @browsers = grep { $versions{$_} }
+ qw(trident gecko webkit_saf ios_saf webkit_chr android presto op_mob op_mini);
-print '<table class="glyphs dimap">';
-print '<col>' x 2;
+$canihas ||= {
+ map {
+ $_ => +{
+ map {
+ my $zero = $#$_ - 2; # baseline index
+ ($_->[$zero - 2] => .5), # past
+ ($_->[$zero - 1] => 10 ), # previous
+ ($_->[$zero + 2] => 0 ), # future
+ ($_->[$zero + 1] => .5), # next
+ ($_->[$zero ] => 30 ), # current
+ } $caniuse->{agents}->{$_}->{versions}
+ }
+ } @browsers
+}; # fallback hash based on release semantics
+my $scorediv = (max(map { ref $_ eq 'HASH' && sum(values %$_) } values %$canihas) // 1) / 100;
+
+print '<table class="mapped">';
+print '<col>' x 3;
printf '<colgroup span="%d">', scalar @{ $versions{$_} } for @browsers;
print "\n";
-print '<thead><tr>';
-print "<th>$_" for qw(feature status);
-printf '<th colspan="%d">%s',
- scalar @{ $versions{$_} }, $caniuse->{agents}->{$_}->{browser}
- for @browsers;
+my $header = join('',
+ '<tr>',
+ '<th colspan="3">feature',
+ (map {
+ sprintf('<th colspan="%d" title="%.1f%%">%s',
+ scalar @{ $versions{$_} },
+ sum(values %{ $canihas->{$_} }),
+ do {
+ my $name = $caniuse->{agents}->{$_}->{browser};
+ length $name < 16 ? $name : $caniuse->{agents}->{$_}->{abbr};
+ },
+ )
+ } @browsers),
+ '<th>%',
+);
+print '<thead>', $header;
# preceding row without any colspan to work around gecko bug
-print '<tr>';
-print '<td>' x $_ for 2, map { scalar @{ $versions{$_} } } @browsers;
+print "\n<tr>";
+print '<td>' x 3;
+for my $browser (@browsers) {
+ printf('<td title="%.1f%%">%s',
+ $canihas->{$browser}->{$_}, showversions($_),
+ ) for @{ $versions{$browser} };
+}
+print '<td>' x 1;
print "</thead>\n";
-sub featurerank {
+sub featurescore {
# relative amount of support for given feature
- state $statspts = { y=>10, 'y x'=>9, a=>5, j=>2, p=>1 };
- my ($id) = @_;
+ state $statspts = { y=>10, 'y x'=>9, a=>5, 'a x'=>5, j=>2, 'p j'=>2, p=>1 };
my $rank = 0;
- if (my $row = $caniuse->{data}->{$id}->{stats}) {
+ if (my $row = shift) {
+ if ($canihas) {
+ while (my ($browser, $versions) = each %$row) {
+ ref $versions eq 'HASH' or next;
+ while (my ($version, $_) = each %$versions) {
+ $rank += $canihas->{$browser}->{$version} * $statspts->{$_};
+ }
+ }
+ return $rank;
+ }
+
while (my ($browser, $vercols) = each %versions) {
my $div = 0; # multiplier exponent (decreased to lower value)
my @vers = map { $row->{$browser}->{$_} } @$vercols;
}
for my $id (sort {
- featurerank($b) <=> featurerank($a)
+ featurescore($caniuse->{data}->{$b}->{stats})
+ <=> featurescore($caniuse->{data}->{$a}->{stats})
} keys %{ $caniuse->{data} }) {
my $row = $caniuse->{data}->{$id};
my $data = $row->{stats} or next; # skip metadata [summary]
printf '<tr id="%s">', $id;
- printf '<th title="%s">%s', $row->{description}, $row->{title};
- printf '<td title="%s" class="%s">%s', $caniuse->{statuses}->{$_}, $CSTATUS{$_} // '', $_ for $row->{status};
+ for ($row->{categories}) {
+ my $cell = $_ ? lc $_->[0] : '-';
+ print '<th>', $cell;
+ }
+ print '<td>', map {
+ sprintf('<a href="%s" onclick="%s">%s</a>',
+ "#$id",
+ sprintf("try { %s; return false } catch(err) { return true }",
+ "document.getElementById('$id').classList.toggle('target')",
+ ),
+ $_,
+ );
+ } $row->{title};
+ print '<div class=aside>';
+ s/\.?$/./, print "<p>$_</p>" for map { ref $_ ? @$_ : $_ || () }
+ $row->{description}, $row->{notes};
+ printf 'Resources: %s.', join(', ',
+ map { qq(<a href="$_->{url}">$_->{title}</a>) } @$_
+ ) for grep { @$_ } $row->{links} // ();
+ print '</div>';
+ for ($row->{status}) {
+ my $cell = $_ // '-';
+ $cell = sprintf '<a href="%s">%s</a>', $_, $cell for $row->{spec} // ();
+ printf '<td title="%s" class="l %s">%s',
+ $caniuse->{statuses}->{$_}, $CSTATUS{$_} // '', $cell;
+ }
for my $browser (@browsers) {
my ($prev, @span);
for my $ver (@{ $versions{$browser} }, undef) {
unless (!defined $prev
- or $data->{$browser}->{$prev} ~~ $data->{$browser}->{$ver}) {
- printf '<td class="%s" colspan="%d">%s',
- $CSTATS{ $data->{$browser}->{$prev} },
+ or ref $data->{$browser} eq 'HASH'
+ && $data->{$browser}->{$prev} ~~ $data->{$browser}->{$ver}) {
+ my $usage = sum(map { $canihas->{$browser}->{$_} } @span);
+ printf '<td class="%s" colspan="%d" title="%.1f%%">%s',
+ join(' ',
+ X => $CSTATS{
+ ref $data->{$browser} ne 'HASH' ? 'u' :
+ $data->{$browser}->{$prev} // 'u'
+ },
+ !$usage ? ('p0') : ('p',
+ sprintf('p%01d', $usage / 10),
+ sprintf('p%02d', $usage),
+ ),
+ sprintf('pp%02d', $usage / $scorediv),
+ ),
scalar @span,
- join('‒', $span[0], @span > 1 ? $span[-1] : ());
+ $usage,
+ showversions(@span),
undef $prev;
@span = ();
}
$prev = $ver;
}
}
- print '<td>', int featurerank($id);
+ state $maxscore = featurescore({ # yes for every possible version
+ map { $_ => { map {$_ => 'y'} @{$versions{$_}} } } keys %versions
+ });
+ print '<td>', int featurescore($caniuse->{data}->{$id}->{stats}) / $maxscore * 100;
}
+print '<tfoot>', $header;
print '</table>';
sub paddedver {
# normalised version number comparable as string (cmp)
shift =~ /^(\d*)(.*)/;
- return sprintf('%02d', $1) . $2;
+ return sprintf('%02d', $1 || 0) . $2;
}
-:>
+sub showversions {
+ my @span = ($_[0], @_>1 ? $_[-1] : ());
+ for (@span) {
+ s/^\./0./;
+ s/x$/.*/;
+ }
+ return join('‒', @span);
+}
+
+:></div>
+
<hr>
<div class="legend">
<table class="glyphs"><tr>
- <td class="X di-aa">supported
- <td class="X di-a">prefixed
- <td class="X di-d">partial
- <td class="X di-prop">external (js/plugin)
- <td class="X di-b">missing
+ <td class="X l5">supported
+ <td class="X l3">partial
+ <td class="X l2">external (js/plugin)
+ <td class="X l1">missing
+ <td class="X l0">unknown
+ <td class="X l0 ex">prefixed
</table>
+ <p><: if ($usage) { :>
+ Usage percentage:
+ <span class=" p0">0</span> -
+ <span class="p p0 p00">.01</span> -
+ <span class="p p0 p05">1-9</span> -
+ <span class="p p1">10</span> -
+ <span class="p p2">20</span> -
+ <span class="p p5">majority</span>
+<: } else { :>
+ <table class="glyphs"><tr>
+ <td class="p p1">previous version</td>
+ <td class="p p3">current</td>
+ <td class="p p0 p00">upcoming (within months)</td>
+ <td class=" p0">future (within a year)</td>
+ </table>
+<: } :> </p>
+
<div class="right">
<ul class="legend legend-set">
<li>default <strong>style</strong> is
<:= defined $get{style} && 'set to ' :><em><:= $style :></em>
+ <li><strong>usage</strong> source is
+ <:= !defined $get{usage} && 'default ' :><:= defined $usage ? "<em>$usage</em>" : 'not included (<em>0</em>)' :>
</ul>
</div>
</div>