A place to cache linked articles (think custom and personal wayback machine)
You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.

index.html 40KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453454455456457458459460461462463464465466467468469470471472473474475476477478479480481482483484485486487488489490491492493494495496497498499500501502503504505506507508509510511512513514515516517518519520521522523524525526527528529530531532533534535536537538539540541542543544545546547548549550551552553554555556557558559560561562563564565566567568569570571572573574575576577578579580581582583584585586587588589590591592593594595596597598599600601602603604605606607608609610611612613614615616617618619620621622623624625626627628629630631632633634635636637638639640641642643644645646647648649650651652653654655656657658659660661662663664665666667668669670671672673674675676677678679680681682683684685686687688689690691692693694695696697698699700701702703704705706707708709710711712713714715716717718719720721722723724725726727728729730731732733734735736737738739740741742743744745746747748749750751752753754755756757758759760761762763764765766767768769770771772773774775776777778779780781782783784785786787788789790791792793794795796797798799800801802803804805806807808809810811812813814815816817818819820821822823824825826827828829830831832833834835836837838839840841842843844845846847848849850851852853854855856857858859860861862863864865866867868869870871872873874875876877878879880881882883884885886887888889890891892893894895896897898899900901902903904905906907
  1. <!doctype html><!-- This is a valid HTML5 document. -->
  2. <!-- Screen readers, SEO, extensions and so on. -->
  3. <html lang=fr>
  4. <!-- Has to be within the first 1024 bytes, hence before the <title>
  5. See: https://www.w3.org/TR/2012/CR-html5-20121217/document-metadata.html#charset -->
  6. <meta charset=utf-8>
  7. <!-- Why no `X-UA-Compatible` meta: https://stackoverflow.com/a/6771584 -->
  8. <!-- The viewport meta is quite crowded and we are responsible for that.
  9. See: https://codepen.io/tigt/post/meta-viewport-for-2015 -->
  10. <meta name=viewport content="width=device-width,minimum-scale=1,initial-scale=1,shrink-to-fit=no">
  11. <!-- Required to make a valid HTML5 document. -->
  12. <title>The state of Web Components (archive) — David Larlet</title>
  13. <!-- Generated from https://realfavicongenerator.net/ such a mess. -->
  14. <link rel="apple-touch-icon" sizes="180x180" href="/static/david/icons/apple-touch-icon.png">
  15. <link rel="icon" type="image/png" sizes="32x32" href="/static/david/icons/favicon-32x32.png">
  16. <link rel="icon" type="image/png" sizes="16x16" href="/static/david/icons/favicon-16x16.png">
  17. <link rel="manifest" href="/manifest.json">
  18. <link rel="mask-icon" href="/static/david/icons/safari-pinned-tab.svg" color="#5bbad5">
  19. <link rel="shortcut icon" href="/static/david/icons/favicon.ico">
  20. <meta name="apple-mobile-web-app-title" content="David Larlet">
  21. <meta name="application-name" content="David Larlet">
  22. <meta name="msapplication-TileColor" content="#da532c">
  23. <meta name="msapplication-config" content="/static/david/icons/browserconfig.xml">
  24. <meta name="theme-color" content="#f0f0ea">
  25. <!-- That good ol' feed, subscribe :p. -->
  26. <link rel=alternate type="application/atom+xml" title=Feed href="/david/log/">
  27. <meta name="robots" content="noindex, nofollow">
  28. <meta content="origin-when-cross-origin" name="referrer">
  29. <!-- Canonical URL for SEO purposes -->
  30. <link rel="canonical" href="https://hacks.mozilla.org/2015/06/the-state-of-web-components/">
  31. <style>
  32. /* http://meyerweb.com/eric/tools/css/reset/ */
  33. html, body, div, span,
  34. h1, h2, h3, h4, h5, h6, p, blockquote, pre,
  35. a, abbr, address, big, cite, code,
  36. del, dfn, em, img, ins,
  37. small, strike, strong, tt, var,
  38. dl, dt, dd, ol, ul, li,
  39. fieldset, form, label, legend,
  40. table, caption, tbody, tfoot, thead, tr, th, td,
  41. article, aside, canvas, details, embed,
  42. figure, figcaption, footer, header, hgroup,
  43. menu, nav, output, ruby, section, summary,
  44. time, mark, audio, video {
  45. margin: 0;
  46. padding: 0;
  47. border: 0;
  48. font-size: 100%;
  49. font: inherit;
  50. vertical-align: baseline;
  51. }
  52. /* HTML5 display-role reset for older browsers */
  53. article, aside, details, figcaption, figure,
  54. footer, header, hgroup, menu, nav, section { display: block; }
  55. body { line-height: 1; }
  56. blockquote, q { quotes: none; }
  57. blockquote:before, blockquote:after,
  58. q:before, q:after {
  59. content: '';
  60. content: none;
  61. }
  62. table {
  63. border-collapse: collapse;
  64. border-spacing: 0;
  65. }
  66. /* http://practicaltypography.com/equity.html */
  67. /* https://calendar.perfplanet.com/2016/no-font-face-bulletproof-syntax/ */
  68. /* https://www.filamentgroup.com/lab/js-web-fonts.html */
  69. @font-face {
  70. font-family: 'EquityTextB';
  71. src: url('/static/david/css/fonts/Equity-Text-B-Regular-webfont.woff2') format('woff2'),
  72. url('/static/david/css/fonts/Equity-Text-B-Regular-webfont.woff') format('woff');
  73. font-weight: 300;
  74. font-style: normal;
  75. font-display: swap;
  76. }
  77. @font-face {
  78. font-family: 'EquityTextB';
  79. src: url('/static/david/css/fonts/Equity-Text-B-Italic-webfont.woff2') format('woff2'),
  80. url('/static/david/css/fonts/Equity-Text-B-Italic-webfont.woff') format('woff');
  81. font-weight: 300;
  82. font-style: italic;
  83. font-display: swap;
  84. }
  85. @font-face {
  86. font-family: 'EquityTextB';
  87. src: url('/static/david/css/fonts/Equity-Text-B-Bold-webfont.woff2') format('woff2'),
  88. url('/static/david/css/fonts/Equity-Text-B-Bold-webfont.woff') format('woff');
  89. font-weight: 700;
  90. font-style: normal;
  91. font-display: swap;
  92. }
  93. @font-face {
  94. font-family: 'ConcourseT3';
  95. src: url('/static/david/css/fonts/concourse_t3_regular-webfont-20190806.woff2') format('woff2'),
  96. url('/static/david/css/fonts/concourse_t3_regular-webfont-20190806.woff') format('woff');
  97. font-weight: 300;
  98. font-style: normal;
  99. font-display: swap;
  100. }
  101. /* http://practice.typekit.com/lesson/caring-about-opentype-features/ */
  102. body {
  103. /* http://www.cssfontstack.com/ Palatino 99% Win 86% Mac */
  104. font-family: "EquityTextB", Palatino, serif;
  105. background-color: #f0f0ea;
  106. color: #07486c;
  107. font-kerning: normal;
  108. -moz-osx-font-smoothing: grayscale;
  109. -webkit-font-smoothing: subpixel-antialiased;
  110. text-rendering: optimizeLegibility;
  111. font-variant-ligatures: common-ligatures contextual;
  112. font-feature-settings: "kern", "liga", "clig", "calt";
  113. }
  114. pre, code, kbd, samp, var, tt {
  115. font-family: 'TriplicateT4c', monospace;
  116. }
  117. em {
  118. font-style: italic;
  119. color: #323a45;
  120. }
  121. strong {
  122. font-weight: bold;
  123. color: black;
  124. }
  125. nav {
  126. background-color: #323a45;
  127. color: #f0f0ea;
  128. display: flex;
  129. justify-content: space-around;
  130. padding: 1rem .5rem;
  131. }
  132. nav:last-child {
  133. border-bottom: 1vh solid #2d7474;
  134. }
  135. nav a {
  136. color: #f0f0ea;
  137. }
  138. nav abbr {
  139. border-bottom: 1px dotted white;
  140. }
  141. h1 {
  142. border-top: 1vh solid #2d7474;
  143. border-bottom: .2vh dotted #2d7474;
  144. background-color: #e3e1e1;
  145. color: #323a45;
  146. text-align: center;
  147. padding: 5rem 0 4rem 0;
  148. width: 100%;
  149. font-family: 'ConcourseT3';
  150. display: flex;
  151. flex-direction: column;
  152. }
  153. h1.single {
  154. padding-bottom: 10rem;
  155. }
  156. h1 span {
  157. position: absolute;
  158. top: 1vh;
  159. left: 20%;
  160. line-height: 0;
  161. }
  162. h1 span a {
  163. line-height: 1.7;
  164. padding: 1rem 1.2rem .6rem 1.2rem;
  165. border-radius: 0 0 6% 6%;
  166. background: #2d7474;
  167. font-size: 1.3rem;
  168. color: white;
  169. text-decoration: none;
  170. }
  171. h2 {
  172. margin: 4rem 0 1rem;
  173. border-top: .2vh solid #2d7474;
  174. padding-top: 1vh;
  175. }
  176. h3 {
  177. text-align: center;
  178. margin: 3rem 0 .75em;
  179. }
  180. hr {
  181. height: .4rem;
  182. width: .4rem;
  183. border-radius: .4rem;
  184. background: #07486c;
  185. margin: 2.5rem auto;
  186. }
  187. time {
  188. display: bloc;
  189. margin-left: 0 !important;
  190. }
  191. ul, ol {
  192. margin: 2rem;
  193. }
  194. ul {
  195. list-style-type: square;
  196. }
  197. a {
  198. text-decoration-skip-ink: auto;
  199. text-decoration-thickness: 0.05em;
  200. text-underline-offset: 0.09em;
  201. }
  202. article {
  203. max-width: 50rem;
  204. display: flex;
  205. flex-direction: column;
  206. margin: 2rem auto;
  207. }
  208. article.single {
  209. border-top: .2vh dotted #2d7474;
  210. margin: -6rem auto 1rem auto;
  211. background: #f0f0ea;
  212. padding: 2rem;
  213. }
  214. article p:last-child {
  215. margin-bottom: 1rem;
  216. }
  217. p {
  218. padding: 0 .5rem;
  219. margin-left: 3rem;
  220. }
  221. p + p,
  222. figure + p {
  223. margin-top: 2rem;
  224. }
  225. blockquote {
  226. background-color: #e3e1e1;
  227. border-left: .5vw solid #2d7474;
  228. display: flex;
  229. flex-direction: column;
  230. align-items: center;
  231. padding: 1rem;
  232. margin: 1.5rem;
  233. }
  234. blockquote cite {
  235. font-style: italic;
  236. }
  237. blockquote p {
  238. margin-left: 0;
  239. }
  240. figure {
  241. border-top: .2vh solid #2d7474;
  242. background-color: #e3e1e1;
  243. text-align: center;
  244. padding: 1.5rem 0;
  245. margin: 1rem 0 0;
  246. font-size: 1.5rem;
  247. width: 100%;
  248. }
  249. figure img {
  250. max-width: 250px;
  251. max-height: 250px;
  252. border: .5vw solid #323a45;
  253. padding: 1px;
  254. }
  255. figcaption {
  256. padding: 1rem;
  257. line-height: 1.4;
  258. }
  259. aside {
  260. display: flex;
  261. flex-direction: column;
  262. background-color: #e3e1e1;
  263. padding: 1rem 0;
  264. border-bottom: .2vh solid #07486c;
  265. }
  266. aside p {
  267. max-width: 50rem;
  268. margin: 0 auto;
  269. }
  270. /* https://fvsch.com/code/css-locks/ */
  271. p, li, pre, code, kbd, samp, var, tt, time, details, figcaption {
  272. font-size: 1rem;
  273. line-height: calc( 1.5em + 0.2 * 1rem );
  274. }
  275. h1 {
  276. font-size: 1.9rem;
  277. line-height: calc( 1.2em + 0.2 * 1rem );
  278. }
  279. h2 {
  280. font-size: 1.6rem;
  281. line-height: calc( 1.3em + 0.2 * 1rem );
  282. }
  283. h3 {
  284. font-size: 1.35rem;
  285. line-height: calc( 1.4em + 0.2 * 1rem );
  286. }
  287. @media (min-width: 20em) {
  288. /* The (100vw - 20rem) / (50 - 20) part
  289. resolves to 0-1rem, depending on the
  290. viewport width (between 20em and 50em). */
  291. p, li, pre, code, kbd, samp, var, tt, time, details, figcaption {
  292. font-size: calc( 1rem + .6 * (100vw - 20rem) / (50 - 20) );
  293. line-height: calc( 1.5em + 0.2 * (100vw - 50rem) / (20 - 50) );
  294. margin-left: 0;
  295. }
  296. h1 {
  297. font-size: calc( 1.9rem + 1.5 * (100vw - 20rem) / (50 - 20) );
  298. line-height: calc( 1.2em + 0.2 * (100vw - 50rem) / (20 - 50) );
  299. }
  300. h2 {
  301. font-size: calc( 1.5rem + 1.5 * (100vw - 20rem) / (50 - 20) );
  302. line-height: calc( 1.3em + 0.2 * (100vw - 50rem) / (20 - 50) );
  303. }
  304. h3 {
  305. font-size: calc( 1.35rem + 1.5 * (100vw - 20rem) / (50 - 20) );
  306. line-height: calc( 1.4em + 0.2 * (100vw - 50rem) / (20 - 50) );
  307. }
  308. }
  309. @media (min-width: 50em) {
  310. /* The right part of the addition *must* be a
  311. rem value. In this example we *could* change
  312. the whole declaration to font-size:2.5rem,
  313. but if our baseline value was not expressed
  314. in rem we would have to use calc. */
  315. p, li, pre, code, kbd, samp, var, tt, time, details, figcaption {
  316. font-size: calc( 1rem + .6 * 1rem );
  317. line-height: 1.5em;
  318. }
  319. p, li, pre, details {
  320. margin-left: 3rem;
  321. }
  322. h1 {
  323. font-size: calc( 1.9rem + 1.5 * 1rem );
  324. line-height: 1.2em;
  325. }
  326. h2 {
  327. font-size: calc( 1.5rem + 1.5 * 1rem );
  328. line-height: 1.3em;
  329. }
  330. h3 {
  331. font-size: calc( 1.35rem + 1.5 * 1rem );
  332. line-height: 1.4em;
  333. }
  334. figure img {
  335. max-width: 500px;
  336. max-height: 500px;
  337. }
  338. }
  339. figure.unsquared {
  340. margin-bottom: 1.5rem;
  341. }
  342. figure.unsquared img {
  343. height: inherit;
  344. }
  345. @media print {
  346. body { font-size: 100%; }
  347. a:after { content: " (" attr(href) ")"; }
  348. a, a:link, a:visited, a:after {
  349. text-decoration: underline;
  350. text-shadow: none !important;
  351. background-image: none !important;
  352. background: white;
  353. color: black;
  354. }
  355. abbr[title] { border-bottom: 0; }
  356. abbr[title]:after { content: " (" attr(title) ")"; }
  357. img { page-break-inside: avoid; }
  358. @page { margin: 2cm .5cm; }
  359. h1, h2, h3 { page-break-after: avoid; }
  360. p3 { orphans: 3; widows: 3; }
  361. img {
  362. max-width: 250px !important;
  363. max-height: 250px !important;
  364. }
  365. nav, aside { display: none; }
  366. }
  367. ul.with_columns {
  368. column-count: 1;
  369. }
  370. @media (min-width: 20em) {
  371. ul.with_columns {
  372. column-count: 2;
  373. }
  374. }
  375. @media (min-width: 50em) {
  376. ul.with_columns {
  377. column-count: 3;
  378. }
  379. }
  380. ul.with_two_columns {
  381. column-count: 1;
  382. }
  383. @media (min-width: 20em) {
  384. ul.with_two_columns {
  385. column-count: 1;
  386. }
  387. }
  388. @media (min-width: 50em) {
  389. ul.with_two_columns {
  390. column-count: 2;
  391. }
  392. }
  393. .gallery {
  394. display: flex;
  395. flex-wrap: wrap;
  396. justify-content: space-around;
  397. }
  398. .gallery figure img {
  399. margin-left: 1rem;
  400. margin-right: 1rem;
  401. }
  402. .gallery figure figcaption {
  403. font-family: 'ConcourseT3'
  404. }
  405. footer {
  406. font-family: 'ConcourseT3';
  407. display: flex;
  408. flex-direction: column;
  409. border-top: 3px solid white;
  410. padding: 4rem 0;
  411. background-color: #07486c;
  412. color: white;
  413. }
  414. footer > * {
  415. max-width: 50rem;
  416. margin: 0 auto;
  417. }
  418. footer a {
  419. color: #f1c40f;
  420. }
  421. footer .avatar {
  422. width: 200px;
  423. height: 200px;
  424. border-radius: 50%;
  425. float: left;
  426. -webkit-shape-outside: circle();
  427. shape-outside: circle();
  428. margin-right: 2rem;
  429. padding: 2px 5px 5px 2px;
  430. background: white;
  431. border-left: 1px solid #f1c40f;
  432. border-top: 1px solid #f1c40f;
  433. border-right: 5px solid #f1c40f;
  434. border-bottom: 5px solid #f1c40f;
  435. }
  436. </style>
  437. <h1>
  438. <span><a id="jumper" href="#jumpto" title="Un peu perdu ?">?</a></span>
  439. The state of Web Components (archive)
  440. <time>Pour la pérennité des contenus liés. Non-indexé, retrait sur simple email.</time>
  441. </h1>
  442. <section>
  443. <article>
  444. <h3><a href="https://hacks.mozilla.org/2015/06/the-state-of-web-components/">Source originale du contenu</a></h3>
  445. <p>Web Components have been on developers&#8217; radars for quite some time now. They were first introduced by <a href="http://twitter.com/slightlylate">Alex Russell</a> at<a href="https://fronteers.nl/congres/2011/sessions/web-components-and-model-driven-views-alex-russell"> Fronteers Conference 2011</a>. The concept shook the community up and became the topic of many future talks and discussions.</p>
  446. <p>In 2013 a Web Components-based framework called <em>Polymer</em> was released by <em>Google</em> to kick the tires of these new APIs, get community feedback and add some sugar and opinion.</p>
  447. <p>By now, 4 years on, Web Components <em>should</em> be everywhere, but in reality <em>Chrome</em> is the only browser with &#8216;some version&#8217; of Web Components. Even with polyfills it&#8217;s clear Web Components won&#8217;t be fully embraced by the community until the majority of browsers are on-board.</p>
  448. <h2>Why has this taken so long?</h2>
  449. <p>To cut a long story short, vendors couldn&#8217;t agree.</p>
  450. <p>Web Components were a <em>Google</em> effort and little negotiation was made with other browsers before shipping. Like most negotiations in life, parties that don&#8217;t feel involved lack enthusiasm and tend not to agree.</p>
  451. <p>Web Components were an ambitious proposal. Initial APIs were high-level and complex to implement (albeit for good reasons), which only added to contention and disagreement between vendors.</p>
  452. <p><em>Google</em> pushed forward, they sought feedback, gained community buy-in; but in hindsight, before other vendors shipped, usability was blocked.</p>
  453. <p>Polyfills meant theoretically Web Components could work on browsers that hadn&#8217;t yet implemented, but these have never been accepted as &#8216;suitable for production&#8217;.</p>
  454. <p>Aside from all this, <em>Microsoft</em> haven&#8217;t been in a position to add many new DOM APIs due to the <a href="http://www.microsoft.com/en-us/windows/browser-for-doing"><em>Edge</em></a> work (nearing completion). And <em>Apple</em>, have been focusing on alternative features for <em>Safari</em>.</p>
  455. <h2>Custom Elements</h2>
  456. <p>Of all the Web Components technologies, Custom Elements have been the least contentious. There is general agreement on the value of being able to define how a piece of UI looks and behaves and being able to distribute that piece cross-browser and cross-framework.</p>
  457. <h3>&#8216;Upgrade&#8217;</h3>
  458. <p>The term &#8216;upgrade&#8217; refers to when an element transforms from a plain old <code>HTMLElement</code> into a shiny custom element with its defined life-cycle and <code>prototype</code>. Today, when elements are upgraded, their <code>createdCallback</code> is called.</p>
  459. <pre><code class="js">var proto = Object.create(HTMLElement.prototype);
  460. proto.createdCallback = function() { ... };
  461. document.registerElement('x-foo', { prototype: proto });</code></pre>
  462. <p>There are <a href="https://wiki.whatwg.org/wiki/Custom_Elements#Upgrading">five proposals</a> so far from multiple vendors; two stand out as holding the most promise.</p>
  463. <h4>&#8216;Dmitry&#8217;</h4>
  464. <p>An evolved version of the <code>createdCallback</code> pattern that works well with ES6 classes. The <code>createdCallback</code> concept lives on, but sub-classing is more conventional.</p>
  465. <pre><code class="js">class MyEl extends HTMLElement {
  466. createdCallback() { ... }
  467. }
  468. document.registerElement("my-el", MyEl);</code></pre>
  469. <p>Like in today&#8217;s implementation, the custom element begins life as <code>HTMLUnknownElement</code> then some time later the prototype is swapped (or &#8216;swizzled&#8217;) with the registered prototype and the <code>createdCallback</code> is called.</p>
  470. <p>The downside of this approach is that it&#8217;s different from how the platform itself behaves. Elements are &#8216;unknown&#8217; at first, then transform into their final form at some point in the future, which can lead to developer confusion.</p>
  471. <h4>Synchronous constructor</h4>
  472. <p>The constructor registered by the developer is invoked by the parser at the point the custom element is created and inserted into the tree.</p>
  473. <pre><code class="js">class MyEl extends HTMLElement {
  474. constructor() { ... }
  475. }
  476. document.registerElement("my-el", MyEl);</code></pre>
  477. <p>Although this seems sensible, it means that any custom elements in the initial downloaded document will fail to upgrade if the scripts that contain their <code>registerElement</code> definition are loaded asynchronously. This is not helpful heading into a world of asynchronous ES6 modules.</p>
  478. <p>Additionally synchronous constructors come with <a href="https://lists.w3.org/Archives/Public/public-webapps/2015JanMar/0731.html">platform issues</a> related to <code>.cloneNode()</code>.</p>
  479. <p>A direction is expected to be decided by vendors at a face-to-face meeting in July 2015.</p>
  480. <h3>is=&#8221;&#8221;</h3>
  481. <p>The <code>is</code> attribute gives developers the ability to layer the behaviour of a custom element on top of a standard built-in element.</p>
  482. <pre><code class="html">&lt;input type="text" is="my-text-input"&gt;</code></pre>
  483. <h4>Arguments for</h4>
  484. <ol>
  485. <li>Allows extending the built-in features of a element that aren&#8217;t exposed as primitives (eg. accessibility characteristics, <code>&lt;form&gt;</code> controls, <code>&lt;template&gt;</code>).</li>
  486. <li>They give means to &#8216;progressively enhance&#8217; an element, so that it remains functional without JavaScript.</li>
  487. </ol>
  488. <h4>Arguments against</h4>
  489. <ol>
  490. <li>Syntax is confusing.</li>
  491. <li>It side-steps the underlying problem that we&#8217;re <a href="https://github.com/domenic/html-as-custom-elements/blob/master/docs/accessibility.md">missing many key accessibility primitives</a> in the platform.</li>
  492. <li>It side-steps the underlying problem that we don&#8217;t have a way to properly extend built-in elements.</li>
  493. <li>Use-cases are limited; as soon as developers introduce Shadow DOM, they lose all built-in accessibility features.</li>
  494. </ol>
  495. <h4>Consensus</h4>
  496. <p>It is generally agreed that <code>is</code> is a &#8216;wart&#8217; on the Custom Elements spec. <em>Google has</em> already implemented <code>is</code> and sees it as a stop-gap until lower-level primitives are exposed. Right now <em>Mozilla</em> and <em>Apple</em> would rather ship a Custom Elements V1 sooner and address this problem properly in a V2 without polluting the platform with &#8216;warts&#8217;.</p>
  497. <p><a href="https://github.com/domenic/html-as-custom-elements"><em>HTML as Custom Elements</em></a> is a project by Domenic Denicola that attempts to rebuild built-in HTML elements with custom elements in an attempt to uncover DOM primitives the platform is missing.</p>
  498. <h2>Shadow DOM</h2>
  499. <p>Shadow DOM yielded the most contention by far between vendors. So much so that features had to be split into a &#8216;V1&#8242; and &#8216;V2&#8242; agenda to help reach agreement quicker.</p>
  500. <h3>Distribution</h3>
  501. <p>Distribution is the phase whereby children of a shadow host get visually &#8216;projected&#8217; into slots inside the host&#8217;s Shadow DOM. This is the feature that enables your component to make use of content the user nests inside it.</p>
  502. <h4>Current API</h4>
  503. <p>The current API is fully declarative. Within the Shadow DOM you can use special <code>&lt;content&gt;</code> elements to define where you want the host&#8217;s children to be visually inserted.</p>
  504. <pre><code class="html">&lt;content select="header"&gt;&lt;/content&gt;</code></pre>
  505. <p>Both <em>Apple</em> and <em>Microsoft</em> pushed back on this approach due to concerns around complexity and performance.</p>
  506. <h4>A new Imperative API</h4>
  507. <p>Even at the <a href="https://www.w3.org/wiki/Webapps/WebComponentsApril2015Meeting">face-to-face meeting</a>, agreement couldn&#8217;t be made on a declarative API, so all vendors agreed to pursue an imperative solution.</p>
  508. <p>All four vendors (<em>Microsoft</em>, <em>Google</em>, <em>Apple</em> and <em>Mozilla</em>) were tasked with specifying this new API before a July 2015 deadline. So far there have been <a href="https://github.com/w3c/webcomponents/blob/gh-pages/proposals/Imperative-API-for-Node-Distribution-in-Shadow-DOM.md">three suggestions</a>. The simplest of the three looks something like:</p>
  509. <pre><code class="js">var shadow = host.createShadowRoot({
  510. distribute: function(nodes) {
  511. var slot = shadow.querySelector('content');
  512. for (var i = 0; i &lt; nodes.length; i++) {
  513. slot.add(nodes[i]);
  514. }
  515. }
  516. });
  517. shadow.innerHTML = '&lt;content&gt;&lt;/content&gt;';
  518. // Call initially ...
  519. shadow.distribute();
  520. // then hook up to MutationObserver</code></pre>
  521. <p>The main obstacle is:<strong> timing</strong>. If the children of the host node change and we redistribute when the <code>MutationObserver</code> callback fires, asking for a layout property will return an incorrect result.</p>
  522. <pre><code class="js">myHost.appendChild(someElement);
  523. someElement.offsetTop; //=&gt; old value
  524. // distribute on mutation observer callback (async)
  525. someElement.offsetTop; //=&gt; new value</code></pre>
  526. <p>Calling offsetTop will perform a synchronous layout <em>before</em> distribution!</p>
  527. <p>This might not seems like the end of the world, but scripts and browser internals often depend on the value of <code>offsetTop</code> being correct to perform many different operations, such as: scrolling elements into view.</p>
  528. <p>If these problems can&#8217;t be solved we may see a retreat back to discussions over a declarative API. This will either be in the form of the current <code>&lt;content select&gt;</code> style, or the newly proposed <a href="https://github.com/w3c/webcomponents/blob/gh-pages/proposals/Slots-Proposal.md">&#8216;named slots&#8217;</a> API (from <em>Apple</em>).</p>
  529. <h4>A new Declarative API &#8211; &#8216;Named Slots&#8217;</h4>
  530. <p>The &#8216;named slots&#8217; proposal is a simpler variation of the current &#8216;content select&#8217; API, whereby the component user must explicitly label their content with the slot they wish it to be distributed to.</p>
  531. <p>Shadow Root of &lt;x-page&gt;:</p>
  532. <pre><code class="html">&lt;slot name="header"&gt;&lt;/slot&gt;
  533. &lt;slot&gt;&lt;/slot&gt;
  534. &lt;slot name="footer"&gt;&lt;/slot&gt;
  535. &lt;div&gt;some shadow content&lt;/div&gt;
  536. </code></pre>
  537. <p>Usage of &lt;x-page&gt;:</p>
  538. <pre><code class="html">&lt;x-page&gt;
  539. &lt;header slot="header"&gt;header&lt;/header&gt;
  540. &lt;footer slot="footer"&gt;footer&lt;/footer&gt;
  541. &lt;h1&gt;my page title&lt;/h1&gt;
  542. &lt;p&gt;my page content&lt;p&gt;
  543. &lt;/x-page&gt;</code></pre>
  544. <p>Composed/rendered tree (what the user sees):</p>
  545. <pre><code class="html">&lt;x-page&gt;
  546. &lt;header slot="header"&gt;header&lt;/header&gt;
  547. &lt;h1&gt;my page title&lt;/h1&gt;
  548. &lt;p&gt;my page content&lt;p&gt;
  549. &lt;footer slot="footer"&gt;footer&lt;/footer&gt;
  550. &lt;div&gt;some shadow content&lt;/div&gt;
  551. &lt;/x-page&gt;</code></pre>
  552. <p>The browser has looked at the direct children of the shadow host (<code>myXPage.children</code>) and seen if any of them have a slot attribute that matches the name of a &lt;slot&gt; element in the host&#8217;s <code>shadowRoot</code>.</p>
  553. <p>When a match is found, the node is <em>visually</em> &#8216;distributed&#8217; in place of the corresponding &lt;slot&gt; element. Any children left undistributed at the end of this matching process are distributed to a default (unamed) &lt;slot&gt; element (if one exists).</p>
  554. <h5>For:</h5>
  555. <ol>
  556. <li>Distribution is more explicit, easier to understand, less &#8216;magic&#8217;.</li>
  557. <li>Distribution is simpler for the engine to compute.</li>
  558. </ol>
  559. <h5>Against:</h5>
  560. <ol>
  561. <li>Doesn&#8217;t explain how built-in elements, like &lt;select&gt;, work.</li>
  562. <li>Decorating content with slot attributes is more work for the user.</li>
  563. <li>Less expressive.</li>
  564. </ol>
  565. <h3>&#8216;closed&#8217; vs. &#8216;open&#8217;</h3>
  566. <p>When a <code>shadowRoot</code> is &#8216;closed&#8217; the it cannot be accessed via <code>myHost.shadowRoot</code>. This gives a component author <em>some</em> assurance that users won&#8217;t poke into implementation details, similar to how you can use closures to keep things private.</p>
  567. <p><em>Apple</em> felt strongly that this was an important feature that they would block on. They argued that implementation details should never be exposed to the outside world and that &#8216;closed&#8217; mode would be a required feature when <a href="https://github.com/w3c/webcomponents/wiki/Isolated-Imports-Proposal">&#8216;isolated&#8217; custom elements</a> became a thing.</p>
  568. <p><em>Google</em> on the other hand felt that &#8216;closed&#8217; shadow roots would prevent some accessibility and component tooling use-cases. They argued that it&#8217;s impossible to accidentally stumble into a <code>shadowRoot</code> and that if people want to they likely have a good reason. JS/DOM is open, let&#8217;s keep it that way.</p>
  569. <p>At the <a href="https://www.w3.org/wiki/Webapps/WebComponentsApril2015Meeting">April meeting</a> it became clear that to move forward, &#8216;mode&#8217; needed to be a feature, but vendors were struggling to reach agreement on whether this should default to &#8216;open&#8217; or &#8216;closed&#8217;. As a result, all agreed that for V1 &#8216;mode&#8217; would be a required parameter, and thus wouldn&#8217;t need a specified default.</p>
  570. <pre><code class="js">element.createShadowRoot({ mode: 'open' });
  571. element.createShadowRoot({ mode: 'closed' });</code></pre>
  572. <h3>Shadow piercing combinators</h3>
  573. <p>A &#8216;piercing combinator&#8217; is a special CSS &#8216;combinator&#8217; that can target elements inside a shadow root from the outside world. An example is /deep/ later renamed to <code>&gt;&gt;&gt;</code>:</p>
  574. <pre><code class="css">.foo &gt;&gt;&gt; div { color: red }</code></pre>
  575. <p>When Web Components were first specified it was thought that these were required, but after looking at <a href="https://github.com/KarstenB/csstransform/blob/master/bootstrap_deep.css">how they were being used</a> it seemed to only bring problems, making it too easy to break the style boundaries that make Web Components so appealing.</p>
  576. <h4>Performance</h4>
  577. <p>Style calculation can be incredibly fast inside a tightly scoped Shadow DOM if the engine doesn&#8217;t have to take into consideration any outside selectors or state. The very presence of piercing combinators forbids these kind of optimisations.</p>
  578. <h4>Alternatives</h4>
  579. <p>Dropping shadow piercing combinators doesn&#8217;t mean that users will never be able to customize the appearance of a component from the outside.</p>
  580. <h5>CSS custom-properties (variables)</h5>
  581. <p>In <em>Firefox OS</em> we&#8217;re using <a href="http://dev.w3.org/csswg/css-variables/">CSS Custom Properties</a> to expose specific style properties that can be defined (or overridden) from the outside.</p>
  582. <p>External (user):</p>
  583. <pre><code class="css">x-foo { --x-foo-border-radius: 10px; }
  584. </code></pre>
  585. <p>Internal (author):</p>
  586. <pre><code class="css">.internal-part { border-radius: var(--x-foo-border-radius, 0); }</code></pre>
  587. <h5>Custom pseudo-elements</h5>
  588. <p>We have also seen interest expressed from several vendors in reintroducing the ability to define custom pseudo selectors that would expose given internal parts to be styled (similar to how we style parts of &lt;input type=&#8221;range&#8221;&gt; today).</p>
  589. <pre class="fragment css visible current-fragment" data-fragment-index="0"><code class=" hljs " contenteditable=""><span class="hljs-tag">x-foo</span><span class="hljs-pseudo">::my-internal-part</span> <span class="hljs-rules">{ <span class="hljs-rule"><span class="hljs-attribute">... }</span></span></span></code></pre>
  590. <p>This will likely be considered for a Shadow DOM V2 specification.</p>
  591. <h5>Mixins &#8211; @extend</h5>
  592. <p>There is <a href="https://tabatkins.github.io/specs/css-extend-rule/">proposed specification</a> to bring <a href="http://sass-lang.com/documentation/file.SASS_REFERENCE.html#extend">SASS&#8217;s @extend</a> behaviour to CSS. This would be a useful tool for component authors to allow users to provide a &#8216;bag&#8217; of properties to apply to a specific internal part.</p>
  593. <p>External (user):</p>
  594. <pre class="css"><code class=" hljs " contenteditable="" data-trim=""><span class="hljs-class">.x-foo-part</span> <span class="hljs-rules">{
  595. <span class="hljs-rule"><span class="hljs-attribute">background-color</span>:<span class="hljs-value"> red</span></span>;
  596. <span class="hljs-rule"><span class="hljs-attribute">border-radius</span>:<span class="hljs-value"> <span class="hljs-number">4px</span></span></span>;
  597. <span class="hljs-rule">}</span></span></code></pre>
  598. <p>Internal (author):</p>
  599. <pre class="css"><code class=" hljs " contenteditable="" data-trim=""><span class="hljs-class">.internal-part</span> <span class="hljs-rules">{
  600. <span class="hljs-rule">@<span class="hljs-attribute">extend .x-foo-part;
  601. }</span></span></span></code></pre>
  602. <h3>Multiple shadow roots</h3>
  603. <p><em>Why would I want more than one shadow root on the same element?</em>, I hear you ask. The answer is: <strong>inheritance</strong>.</p>
  604. <p>Let&#8217;s imagine I&#8217;m writing an <code>&lt;x-dialog&gt;</code> component. Within this component I write all the markup, styling, and interactions to give me an opening and closing dialog window.</p>
  605. <pre><code class="html">&lt;x-dialog&gt;
  606. &lt;h1&gt;My title&lt;/h1&gt;
  607. &lt;p&gt;Some details&lt;/p&gt;
  608. &lt;button&gt;Cancel&lt;/button&gt;
  609. &lt;button&gt;OK&lt;/button&gt;
  610. &lt;/x-dialog&gt;</code></pre>
  611. <p>The shadow root pulls any user provided content into <code>div.inner</code> via the <code>&lt;content&gt;</code> insertion point.</p>
  612. <pre><code class="html">&lt;div class="outer"&gt;
  613. &lt;div class="inner"&gt;
  614. &lt;content&gt;&lt;/content&gt;
  615. &lt;/div&gt;
  616. &lt;/div&gt;</code></pre>
  617. <p>I also want to create <code>&lt;x-dialog-alert&gt;</code> that looks and behaves just like <code>&lt;x-dialog&gt;</code> but with a more restricted API, a bit like <code>alert('foo')</code>.</p>
  618. <pre><code class="html">&lt;x-dialog-alert&gt;foo&lt;/x-dialog-alert&gt;</code></pre>
  619. <pre><code class="js">var proto = Object.create(XDialog.prototype);
  620. proto.createdCallback = function() {
  621. XDialog.prototype.createdCallback.call(this);
  622. this.createShadowRoot();
  623. this.shadowRoot.innerHTML = templateString;
  624. };
  625. document.registerElement('x-dialog-alert', { prototype: proto });
  626. </code></pre>
  627. <p>The new component will have its own shadow root, but it&#8217;s designed to work <em>on top</em> of the parent class&#8217;s shadow root. The <code>&lt;shadow&gt;</code> represents the &#8216;older&#8217; shadow root and allows us to project content inside it.</p>
  628. <pre><code class="html">&lt;shadow&gt;
  629. &lt;h1&gt;Alert&lt;/h1&gt;
  630. &lt;content&gt;&lt;/content&gt;
  631. &lt;button&gt;OK&lt;/button&gt;
  632. &lt;/shadow&gt;</code></pre>
  633. <p>Once you get your head round multiple shadow roots, they become a powerful concept. The downside is they bring a lot of complexity and introduce a lot of edge cases.</p>
  634. <h4>Inheritance without multiple shadows</h4>
  635. <p>Inheritance is still possible without multiple shadow roots, but it involves manually mutating the super class&#8217;s shadow root.</p>
  636. <pre><code class="js">
  637. var proto = Object.create(XDialog.prototype);
  638. proto.createdCallback = function() {
  639. XDialog.prototype.createdCallback.call(this);
  640. var inner = this.shadowRoot.querySelector('.inner');
  641. var h1 = document.createElement('h1');
  642. h1.textContent = 'Alert';
  643. inner.insertBefore(h1, inner.children[0]);
  644. var button = document.createElement('button');
  645. button.textContent = 'OK';
  646. inner.appendChild(button);
  647. ...
  648. };
  649. document.registerElement('x-dialog-alert', { prototype: proto });
  650. </code></pre>
  651. <p><strong>The downsides of this approach are:</strong></p>
  652. <ol>
  653. <li>Not as elegant.</li>
  654. <li>Your sub-component is dependent on the implementation details of the super-component.</li>
  655. <li>This wouldn&#8217;t be possible if the super component&#8217;s shadow root was &#8216;closed&#8217;, as <code>this.shadowRoot</code> would be <code>undefined</code>.</li>
  656. </ol>
  657. <h2>HTML Imports</h2>
  658. <p>HTML Imports provide a way to import all assets defined in one <code>.html</code> document, into the scope of another.</p>
  659. <pre class="html"><code><span class="tag">&lt;link</span> <span class="atn">rel</span><span class="pun">=</span><span class="atv">"import"</span> <span class="atn">href</span><span class="pun">=</span><span class="atv">"/path/to/imports/stuff.html"</span><span class="tag">&gt;</span></code></pre>
  660. <p>As <a href="https://hacks.mozilla.org/2014/12/mozilla-and-web-components/">previously stated,</a> <em>Mozilla</em> is not <em>currently</em> intending to implementing HTML Imports. This is in part because we&#8217;d like to see how ES6 modules pan out before shipping another way of importing external assets, and partly because we don&#8217;t feel they enable much that isn&#8217;t already possible.</p>
  661. <p>We&#8217;ve been working with Web Components in <em>Firefox OS</em> for over a year and have found using existing module syntax (AMD or Common JS) to resolve a dependency tree, registering elements, loaded using a normal <code>&lt;script&gt;</code> tag seems to be enough to get stuff done.</p>
  662. <p>HTML Imports do lend themselves well to a simpler/more declarative workflow, such as the older <a href="https://github.com/MikeMitterer/DART-Sample-PolymerElementConsumer/blob/master/web/poly/components/CustomElements/workbench/HTMLElementElement.html"><code>&lt;element&gt;</code></a> and <a href="https://www.polymer-project.org/0.8/docs/migration.html#registration"><em>Polymer&#8217;s </em>current</a> registration syntax.</p>
  663. <p>With this simplicity has come <a href="http://tjvantoll.com/2014/08/12/the-problem-with-using-html-imports-for-dependency-management/">criticism</a> from the community that Imports don&#8217;t offer enough control to be taken seriously as a dependency management solution.</p>
  664. <p>Before the decision was made a few months ago, <em>Mozilla</em> had a working implementation behind a flag, but struggled through an incomplete specification.</p>
  665. <h3>What will happen to them?</h3>
  666. <p><em>Apple&#8217;s </em><a href="https://github.com/w3c/webcomponents/wiki/Isolated-Imports-Proposal">Isolated Custom Elements</a> proposal makes use of an HTML Imports style approach to provide custom elements with their own document scope;: Perhaps there&#8217;s a future there.</p>
  667. <p>At <em>Mozilla</em> we want to explore how importing custom element definitions can align with upcoming ES6 module APIs. We&#8217;d be prepared to implement if/when they appear to enable developers to do stuff they can&#8217;t already do.</p>
  668. <h2>To conclude</h2>
  669. <p>Web Components are a prime example of how difficult it is to get large features into the browser today. Every API added lives indefinitely and remains as an obstacle to the next.</p>
  670. <p>Comparable to picking apart a huge knotted ball of string, adding a bit more, then tangling it back up again. This knot, our platform, grows ever larger and more complex.</p>
  671. <p>Web Components have been in planning for over three years, but we&#8217;re optimistic <strong>the end is near</strong>. All major vendors are on board, enthusiastic, and investing significant time to help resolve the remaining issues.</p>
  672. <p><strong>Let&#8217;s get ready to componentize the web!</strong></p>
  673. <h4>More</h4>
  674. <ul>
  675. <li>Join the ongoing discussion on the <a href="https://lists.w3.org/Archives/Public/public-webapps/">public-webapps mailing list</a>.</li>
  676. <li>Keep an eye on the <a href="https://github.com/w3c/webcomponents/">W3C Web Components Repo</a>.</li>
  677. <li>Sign-up to the <a href="http://webcomponentsweekly.me/">Web Components Weekly</a> newsletter.</li>
  678. <li>Play with Web Components in Firefox today by turning on &#8216;dom.webcomponents.enabled&#8217; pref in about:config.</li>
  679. </ul>
  680. </article>
  681. </section>
  682. <nav id="jumpto">
  683. <p>
  684. <a href="/david/blog/">Accueil du blog</a> |
  685. <a href="https://hacks.mozilla.org/2015/06/the-state-of-web-components/">Source originale</a> |
  686. <a href="/david/stream/2019/">Accueil du flux</a>
  687. </p>
  688. </nav>
  689. <footer>
  690. <div>
  691. <img src="/static/david/david-larlet-avatar.jpg" loading="lazy" class="avatar" width="200" height="200">
  692. <p>
  693. Bonjour/Hi!
  694. Je suis <a href="/david/" title="Profil public">David&nbsp;Larlet</a>, je vis actuellement à Montréal et j’alimente cet espace depuis 15 ans. <br>
  695. Si tu as apprécié cette lecture, n’hésite pas à poursuivre ton exploration. Par exemple via les <a href="/david/blog/" title="Expériences bienveillantes">réflexions bimestrielles</a>, la <a href="/david/stream/2019/" title="Pensées (dés)articulées">veille hebdomadaire</a> ou en t’abonnant au <a href="/david/log/" title="S’abonner aux publications via RSS">flux RSS</a> (<a href="/david/blog/2019/flux-rss/" title="Tiens c’est quoi un flux RSS ?">so 2005</a>).
  696. </p>
  697. <p>
  698. Je m’intéresse à la place que je peux avoir dans ce monde. En tant qu’humain, en tant que membre d’une famille et en tant qu’associé d’une coopérative. De temps en temps, je fais aussi des <a href="https://github.com/davidbgk" title="Principalement sur Github mais aussi ailleurs">trucs techniques</a>. Et encore plus rarement, <a href="/david/talks/" title="En ce moment je laisse plutôt la place aux autres">j’en parle</a>.
  699. </p>
  700. <p>
  701. Voici quelques articles choisis :
  702. <a href="/david/blog/2019/faire-equipe/" title="Accéder à l’article complet">Faire équipe</a>,
  703. <a href="/david/blog/2018/bivouac-automnal/" title="Accéder à l’article complet">Bivouac automnal</a>,
  704. <a href="/david/blog/2018/commodite-effondrement/" title="Accéder à l’article complet">Commodité et effondrement</a>,
  705. <a href="/david/blog/2017/donnees-communs/" title="Accéder à l’article complet">Des données aux communs</a>,
  706. <a href="/david/blog/2016/accompagner-enfant/" title="Accéder à l’article complet">Accompagner un enfant</a>,
  707. <a href="/david/blog/2016/senior-developer/" title="Accéder à l’article complet">Senior developer</a>,
  708. <a href="/david/blog/2016/illusion-sociale/" title="Accéder à l’article complet">L’illusion sociale</a>,
  709. <a href="/david/blog/2016/instantane-scopyleft/" title="Accéder à l’article complet">Instantané Scopyleft</a>,
  710. <a href="/david/blog/2016/enseigner-web/" title="Accéder à l’article complet">Enseigner le Web</a>,
  711. <a href="/david/blog/2016/simplicite-defaut/" title="Accéder à l’article complet">Simplicité par défaut</a>,
  712. <a href="/david/blog/2016/minimalisme-esthetique/" title="Accéder à l’article complet">Minimalisme et esthétique</a>,
  713. <a href="/david/blog/2014/un-web-omni-present/" title="Accéder à l’article complet">Un web omni-présent</a>,
  714. <a href="/david/blog/2014/manifeste-developpeur/" title="Accéder à l’article complet">Manifeste de développeur</a>,
  715. <a href="/david/blog/2013/confort-convivialite/" title="Accéder à l’article complet">Confort et convivialité</a>,
  716. <a href="/david/blog/2013/testament-numerique/" title="Accéder à l’article complet">Testament numérique</a>,
  717. et <a href="/david/blog/" title="Accéder aux archives">bien d’autres…</a>
  718. </p>
  719. <p>
  720. On peut <a href="mailto:david%40larlet.fr" title="Envoyer un courriel">échanger par courriel</a>. Si éventuellement tu souhaites que l’on travaille ensemble, tu devrais commencer par consulter le <a href="http://larlet.com">profil dédié à mon activité professionnelle</a> et/ou contacter directement <a href="http://scopyleft.fr/">scopyleft</a>, la <abbr title="Société coopérative et participative">SCOP</abbr> dont je fais partie depuis six ans. Je recommande au préalable de lire <a href="/david/blog/2018/cout-site/" title="Attention ce qui va suivre peut vous choquer">combien coûte un site</a> et pourquoi je suis plutôt favorable à une <a href="/david/pro/devis/" title="Discutons-en !">non-demande de devis</a>.
  721. </p>
  722. <p>
  723. Je ne traque pas ta navigation mais mon
  724. <abbr title="Alwaysdata, 62 rue Tiquetonne 75002 Paris, +33.184162340">hébergeur</abbr>
  725. conserve des logs d’accès.
  726. </p>
  727. </div>
  728. </footer>
  729. <script type="text/javascript">
  730. ;(_ => {
  731. const jumper = document.getElementById('jumper')
  732. jumper.addEventListener('click', e => {
  733. e.preventDefault()
  734. const anchor = e.target.getAttribute('href')
  735. const targetEl = document.getElementById(anchor.substring(1))
  736. targetEl.scrollIntoView({behavior: 'smooth'})
  737. })
  738. })()
  739. </script>