Przewiń do treści 

Potrzebujemy zachowań, nie dziedziczenia!

Opublikowany:
Autor:
Comandeer
Kategorie:
Standardy sieciowe
HTML i CSS
JavaScript
Daj się poznać 2017

This article is also available in English!

Choć tydzień temu obwieściłem śmierć Web Components, nie byłbym sobą, gdybym nie usiadł na chwilę i nie zaczął myśleć, czemu pewne rzeczy nie działały tak jak powinny i co się schrzaniło. Najbardziej interesowała mnie kwestia owego nieszczęsnego atrybutu [is], o który toczone są zażarte boje. I wówczas zrozumiałem, że W3C po prostu źle podeszło do tematu.

OOP a DOM

Jeśli coś się nazywa Obiektowym Modelem Dokumentu, to jakbyśmy nie próbowali nagiąć faktów, nie uciekniemy od prostego stwierdzenia, że mimo wszystko to część starego i dobrego OOP (DFM – Document Functional Model; rzucam Wam wyzwanie, wielbiciele FP!). Z tego też powodu Web Components (WC) również, chcąc nie chcąc, w tę metodologię wpisywać się muszą – ot, choćby dla starej, poczciwej zasady zachowania konsekwencji i spójności.

Najbardziej ucierpiały na tym Custom Elements (CE), które są niczym innym jak klasami rozszerzającymi natywny DOM-owy konstruktor HTMLElement. Jeśli tego podstawowego warunku nie spełnimy, przeglądarka się zbuntuje przy próbie stworzenia takiego elementu:

customElements.define( 'wtf-w3c', class {} );
document.createElement( 'wtf-w3c' ); // Uncaught TypeError: Failed to construct 'CustomElement': The result must implement HTMLElement interface

customElements.define( 'rly-wtf-w3c', class extends HTMLElement {} );

document.createElement( 'rly-wtf-w3c' ); // Totally fine!

Skoro sprawę postawiono tak jasno, oczywiste jest, że wszystko, co kręci się wokół WC, będzie w większym lub mniejszym stopniu związane z obiektówką. Tak też się stało w przypadku [is], które ma wprowadzać możliwość “rozszerzania natywnych elementów”… czyli mówiąc inaczej: dziedziczenia po nich.

“Po co mam dziedziczyć po przycisku?!!!”

To pytanie najlepiej oddaje bezsensowność takiego podejścia. No bo pomyślmy: czy kiedykolwiek przy tworzeniu aplikacji stwierdziliśmy, że jakiś przycisk powinien odziedziczyć po innym? Tak fantazyjnego podejścia nie ma nawet w BEM, gdzie zamiast dziedziczyć modyfikujemy:

<button class="button">Jestem przyciskiem!</button>
<button class="button button_big">Jestem DUŻYM przyciskiem!</button>

W przypadku CE natomiast duży przycisk jest klasą dziedziczącą po wbudowanej klasie przycisku:

<script>customElements.define( 'big-button', class extends HTMLButtonElement {}, { extends: 'button' } );</script>
<button is="big-button">Jestem DUŻYM przyciskiem!</button>

Nie oszukujmy się: nie wygląda to zbyt ładnie. Sam natomiast mechanizm dziedziczenia przywodzi mi na myśl prymitywne przykłady podstaw obiektowości w niemal każdej książce do Javy czy PHP (class Dog extends Animal…). Podczas gdy React od dawna zachęca do kompozycji, oficjalny standard utknął na poziomie zabaw z obiektami.

Kłopoty z dziedziczeniem

Wyobraźmy sobie, że mamy przycisk otwierający menu, który wykonaliśmy jako CE:

<button is="nav-toggler" for="nav">Otwórz/zamknij menu</button>

Jego zadanie jest proste: otwierać i zamykać menu, przy okazji ustawiając odpowiednie atrybuty ARIA. Pytanie brzmi: czy myślimy o tym przycisku jako przycisku, który jest przyciskiem przeznaczonym do otwierania i zamykania menu, czy może raczej o przycisku, który służy do otwierania i zamykania menu? Mówiąc inaczej: czy to, co dany przycisk robi, sprawia, że jest to inny rodzaj przycisku – mimo że wygląda dokładnie tak samo? Specyfikacja CE twierdzi, że tak: button i button[is=nav-toggler] to dwa zupełnie różne elementy.

Jeśli jednak zmienimy [is=nav-toggler] na [data-toggle=nav], dostaniemy Bootstrapowy przycisk do otwierania… czegokolwiek. Ba, równie dobrze możemy to zrobić z linkiem, co sprawi, że mamy od razu wbudowany fallback (jeśli JS nie zadziała, link po prostu przeniesie nas do odpowiedniego fragmentu, który można pokazać choćby przy pomocy :target w CSS). W przypadku CE takiej możliwości nie ma: nav-toggler może być wyłącznie przyciskiem.

Inny przykład? div[is=my-draggable] będzie przesuwalnym div, ale już dialog[is=my-draggable] nie zadziała – wszystko trzeba będzie upychać w div

To sprawia, że zaczynamy tworzyć sztuczne byty. Żeby uczynić konkretne elementy przesuwalnymi, będziemy tworzyć poszczególne klasy dla poszczególnych elementów, które będą powielać dokładnie tę samą funkcjonalność: div[is="div-draggable"], p[is="p-draggable"], blockquote[is="blockquote-draggable"] itd. Nie dość, że przeczy to starej dobrej zasadzie DRY, to od razu widzimy jak bezsensowne są reguły nazewnictwa CE w przypadku rozszerzania wbudowanych elementów (to, co jest sensownym sposobem nazywania nowych elementów – np. dgui-slider – w przypadku podczepiania pod istniejące elementy wygląda dziwnie). Dochodzi tutaj do niepotrzebnego parowania konkretnego zachowania z konkretnym elementem.

Co prawda w dalszym ciągu dyskusji zaproponowano rozbicie elementów HTML na wiele małych interfejsów, ale osobiście widzę w tym jeszcze większe zagrożenie niż prymitywne [is] i dziedziczenie całych elementów. Jeśli bowiem chcemy mieć przycisk, który otwiera menu, po prostu przypinamy event listener do przycisku i już. Nikt o zdrowych zmysłach nie będzie tworzył elementu nav-toggler składającego się z 30 interfejsów tylko po to, żeby zrobić przycisk otwierający menu. A jak już ktoś jest na tyle szalony, to i tak po drodze pewnie zapomni o dodaniu HTMLActivateClickOnSpace i tyle będzie z dostępnego przycisku.

Potrzebujemy zachowań!

A teraz wyobraźmy sobie, gdyby można było zrobić coś takiego:

<script>
	customElements.defineBehavior( 'dgui-draggable', class {
		/**
		 * @param {HTMLElement} element Element, do którego przyczepiono zachowanie.
		 * @param {Mixed[]} param Przekazane parametry. W przypadku przypięcia przez atrybut
		 * dostaniemy zawsze jeden String, w innym wypadku – dowolną liczbę parametrów
		 * o dowolnym typie.
		 */
		constructor( element, ...param ) {

		}
	} );

	customElements.define( 'dgui-floating', class extends HTMLElement {
		static get attachedBehaviors() {
			return [ 'dgui-draggable' ];
		}
	} );
</script>

<div dgui-draggable>Jestem przesuwalnym divem!</div>
<p dgui-draggable>A ja akapitem!</p>
<blockquote dgui-draggable="vertical">A mnie przesuniesz tylko w pionie!</blockquote>
<dialog>Też jestem przesuwalny!</dialog>
<script>
	document.querySelector( 'dialog' ).attachBehavior( 'dgui-draggable', 'para', 'metry' );
</script>
<dgui-floating>A ja mam po prostu wbudowane to zachowanie!</dgui-floating>

W WHATWG toczy się właśnie dyskusja nad zezwoleniem na dowolne niestandardowe atrybuty, która od razu spowodowała pojawienie się głosów, że ma to sens wyłącznie wtedy, gdy będzie można obserwować cykl życia atrybutów. W pełni popieram! Dzięki oddzieleniu zachowań od konkretnych elementów i przeniesieniu ich na poziom atrybutów jesteśmy w stanie przy pomocy jednego i tego samego kodu obsłużyć każdy element HTML. Nie myślimy już sztucznie stworzonymi relacjami pomiędzy poszczególnymi elementami na stronie (czy ten przycisk jest przyciskiem, czy może wyspecjalizowanym przyciskiem?), ale zachowaniami – skupiamy się na tym, co dany element robi, a nie czym dany element jest. Prosto, skutecznie, elegancko.

To co, piszemy polyfill i do W3C?

Komentarze

Przejdź do komentarzy bezpośrednio na Githubie.

Dawne komentarze

Ten blog wcześniej korzystał z systemu komentarzy Disqus. Jednakże pożegnaliśmy się i postanowiłem, że zaimportuję do nowej wersji stare komentarze z niego. Cóż, jego system eksportu na wiele nie pozwala…

  1. Opublikowany:
    Autor:
    piotrekkoszulinski

    Trochę mam dejavu. Podobną drogę przeszliśmy swego czasu z biblioteką UI do CKEditora 5. Z początku wpadliśmy w pułapkę dziedziczenia kiedy to np. konkretna wersja toolbara dziedziczyła z toolbara podstawowego. Nie potrzebowaliśmy na szczęście za dużo czasu by przejrzeć na oczy i zacząć komponować komponenty (masłować masło? :D) z ogólnodostępnych zachowań.

    W przypadku WC zakładam można dziedziczyć zawsze z bazowego HTMLElement, tak? To nie jest takie złe – najprostsze wyjście z tej ciężkiej sytuacji. Chcesz coś nowego, pisz to od zera. NIkt nie każe Ci dziedziczyć akurat z buttona (co rzeczywiście sensu ma niewiele).

    Z drugiej strony, zgadzam się że tego typu podejście mentalnie nastawia nas na pisanie nierozszerzalnych komponentów. Idealnie byłoby gdyby rzeczywiście zezwolić jeszcze na rejestrowanie handlerów atrybutów i na tej podstawie można byłoby robić obie rzeczy – tworzyć komponenty od zera ale i zezwalać na dodawanie funkcjonalności do istniejących (w tym swoich ofc).

    1. Opublikowany:
      Autor:
      Comandeer

      > Idealnie byłoby gdyby rzeczywiście zezwolić jeszcze na rejestrowanie handlerów atrybutów i na tej podstawie można byłoby robić obie rzeczy – tworzyć komponenty od zera ale i zezwalać na dodawanie funkcjonalności do istniejących

      I dokładnie o to mi chodzi. Do tworzenia własnych, całkowicie customowych komponentów nic nie mam, jedynie rozszerzanie już istniejących jest zrobione po prostu dziwacznie.

  2. Opublikowany:
    Autor:
    trusktr

    Hello! Custom Elements are good for some things, but your examples show how NOT to use CE.

    I like your "behaviors" idea. In fact, I've implemented such a thing! See here: https://github.com/w3c/webc...

    (specifically, the following comment has the link to the code implementation and example code: https://github.com/w3c/webc...

    (notice how many downvotes I got in that thread, many people don't like this "behaviors" sort of idea. What's up with them????)

    Also, check out "Custom Attributes", which is closer to your idea: https://github.com/matthewp...

    1. Opublikowany:
      Autor:
      Comandeer

      Hey, TBH I nearly abandoned whole WC idea as I moved from frontend to more backend JS development. But I saw your implementation and Custom Attributes library (heh, I'm still following discussions in WC repo on GH). Especially Custom Attributes seems like my idea. Unfortunately it also seems as abandoned as my idea…

      Could you elaborate why you think that my examples show hot not to use CE?

      1. Opublikowany:
        Autor:
        trusktr

        I don't remember what I was thinking! Interesting how my behaviors turned out similar to yours (but I hadn't seen yours before). I have something similar to your `attachedBehaviors` in [this example](https://github.com/trusktr/..., the difference being that it accepts a function that returns a boolean to indicate if the behavior should be applied, but it also accepts a plain array like yours too.

        I agree with you about the inheritance. The behaviors without inheritance are easy to work with, and also compatible with old browsers (doesn't require native `class`es, etc).

        Honestly I don't remember what I was thinking with that first sentence of mine! I think our behaviors ideas are awesome.