Declarative Dynamic Extensions pour HTML : Abstract dde-version 0.1*

Abstract

DDE est un ensemble d'extensions (dde-version) pour HTML. Chaque extension (dde-unit) est destinée à enrichir le comportement des documents HTML de manière déclarative sans qu'une ligne de code (par exemple JS) ne soit requise.

Chaque version de DDE ("dde-version") est un ensemble connu et déterminé d'extensions ("dde-units"). Dans un document comme celui ci, la présence d'un asterique indique que la dde-version est en cours d'élaboration, qu'elle n'est pas entièrement et définitivement établie.

Chaque extension dde-unit DOIT être définie par un document (idéalement une specification) décrivant ce que PEUT et DOIT être une implémentation de cette extension (dde-unit), sans que celle ci ne soit destinée à un langage de programmation particulier (tel que JS).

Un tel document PEUT comporter des exemples dans un langage donné, mais il DOIT être clair que l'extension décrite n'est pas destinée à un langage de programmation particulier.

Chaque dde-unit a le même numéro de version que l'ensemble dde-version auquel elle appartient. Entre deux dde-versions, il est possible qu'une dde-unit soit inchangée. Dans ce cas on parlera d'alias. Par exemple, si la dde-unit "first-extension" fait partie de l'ensemble dde-version 0.1 et de l'ensemble dde-version 0.2 sans avoir été modifiée, on dira que la dde-unit "first-extension" 0.2 est un alias de la dde-unit "first-extension" 0.1.

dde-version et dde-unit sont des notions abstraites. Elles ne désignent pas des implémentations, elles désignent une définition abstraite, sous forme de document, de ce que peut et doit être une de leur implémentation dans une version donnée.

L'implémentation d'une dde-version est un ensemble d'implémentations de dde-units dans un langage donné (ex JS). Le numéro de version de l'implémentation d'une dde-version PEUT avoir sa logique propre, mais DOIT être préfixé par le numéro de la version de l'ensemble dde-version implémentée. Par exemple, une implémentation de dde-version 0.1 peut avoir pour numéro 0.1.1. Une dde-version n'aura, quant à elle, jamais plus de deux chiffres.

L'implémentation d'une dde-unit suit la même logique. Elle peut exister en version standalone (telle qu'une bibliothèque JS indépendante) mais NE DOIT PAS entrer en conflit avec une éventuelle implémentation native (voire plus loin)

L'implémentation d'une version DDE peut être embarquée (ex par un script JS dans une page) ou native (fournie directement par le navigateur ou une web extension)

Une implémentation native d'une dde-version officielle DOIT fournir le support de toutes les versions officielles précédentes, avec d'éventuelles modifications en cas d'hypothétiques failles de sécurités découvertes entre temps sur ces versions.

Ce document est l'ébauche de la dde-version 0.1. Il ne constitue pas une spécification, car celle ci doit avoir un caractère éminement collectif et suivre un certain nombre de règles. Il est suceptible d'être modifié et de servir de base pour produire une spécification plus officielle pour cette même version. Si une telle spécification voit le jour, elle sera mise en liens sur ce document qui sera archivé et considéré comme obsolète.

Déclaration

Un document HTML utilisant une dde-version DOIT déclarer l'attribut "dde-version" sur l'étément HTML racine en suivant les règles ci dessous.

On indiquera le "mode" (voire plus loin) suivit d'un espace et du numéro de la dde-version. (syntaxe : dde-version="<mode> <numero-version>")

Le numero-version DOIT être composé de 2 chifres séparés par un point et PEUT être suivie de caractères alphanumérique (ces caractères permettront par exemple l'existence de versions alternatives expérimentales non officielles, ou de désigner une branche particulière). Elle NE comporte PAS d'asterisque (celui ci sert à indiqué qu'un document abstrait de définition de dee-version ou de dde-unit n'est pas définitif)

Le "mode" définit la relation entre le document HTML et Javascript. Il existe 3 modes : strict, respectuous, et broken.

Le mode strict indique à l'agent utilisateur que JS n'est ni requis ni utilisé par le document.

Le mode respectuous indique que JS propose une expérience améliorée sans être requis (unobstrusive JS).

Le mode broken indique que le document nécessite JS pour fonctionner correctement. Il est alors RECOMMANDÉ (non requis) d'utiliser l'attribut script-reason sur l'élément HTML racine pour donner un motif à l'usage du mode broken.

Lorsqu’on utilise le mode "broken" ou "respectuous", on est dans le paradigme "application". Et lorsqu’on utilise le mode "strict", on est dans le paradigme "document". Notez que l'en-tête "content-type" ne reflète pas le paradigme utilisé car un document ou une application HTML doit avoir le type text/html (ou application/xhtml+xml) pour être reconnue comme une page Web par le navigateur [SIC].

Abstraitement, les modes ne concernent pas spécifiquement Javascript, mais n'importe quel langage de script, et permettent de dissocier le paradigme utiliser par une page.

Notez qu'une implémentation dde-version DOIT fournir un mécanisme de sécurité pour s'assurer qu'aucun script (en dehors de l'implémentation elle-même si elle est embarquée) ne puisse être exécuter sur une page définie en mode stict. Ce mécanisme est le "script-destroyer"

Une implémentation native DOIT ajouté le mot clef "native" à l'attribut "dde-version" au moment de son initialisation.

Une implémentation embarquée DOIT ajouté le mot clef "embeded" à l'attribut "dde-version" au moment de son initialisation.

Ce suffix ("native" ou "embeded") permet :

<html dde-version="strict 0.1 native">
		

html[dde-version~="native"] .if-native {
	display: inline;
}
		

<span class="if-native">Félicitation. DDE est nativement supporté par votre navigateur.</span>
		

var ddeVersion = document.documentElement.getAttribute('dde-version');
if(ddeVersion.indexOf('native') !== -1) {
	console.log('DDE version already  natively supported. Aborted.');
	return;
}
ddeVersion = ddeVersion.split(' ');
ddeVersion = {
	mode : ddeVersion[0],
	number : ddeVersion[1]
};
		

Explications et comportement général

L'objectif des modes DDE n'est pas de décourager l'usage de Javascript mais d'améliorer l'expérience de ceux qui ne l'utilisent pas.

Le mode "broken" n'est pas moins respectueux que le mode "respectious". Il indique simplement que l'expérience utilisateur sera incomplète si Javascript est incatif.

On considèrera le mode strict comme un indicateur de respect de l'environnement car "no code is natively more green than green code", Mais ceci ne constitue en aucun cas une réprobation de javascript au nom de l'écologie.

En mode "broken", lorsque Javascript est désactivé, une implémentation DDE native DOIT fournir une boîte de dialogue permettant à l'utilisateur de définir s'il autorise cette page ou ce domaine à éxecuter javascript : jamais, toujours, cette fois uniquement. Le focus initial DOIT être placé sur ce dernier choix.

Les documents n'utilisant pas dde mais nécéssitant JS PEUVENT, et DEVRAIENT utiliser le mode broken avec le numéro de version 0 afin que les utilisateurs ayant désactiver JS puisse bénéficier de cette boîte de dialogue si leur navigateur l'implémente. Exemple :

<html dde-version="broken 0" script-reason="motif facultatif">
		

Dans une implémentation native (browser ou webextension), si JS est inactif, la boîte de dialogue affichera :

Cette page nécéssite Javascript pour fonctionner. Motif :
motif facultatif.
Voulez vous activer Javascript sur le domaine https://example.com ?

  Jamais Toujours Uniquement cette fois
		

A l'opposé, les documents HTML n'utilisant ni DDE ni Javascript peuvent utiliser le mode strict avec la version 0 et bénéficier de la pastille full green (environement) ainsi que de la garantie qu'aucun script ne sera executé grace au script-destroyer (sécurité).

Pastilles

Une implémentation native PEUT fournir une pastille indiquant le mode utilisé.

• "Full green" : pastille verte pour le mode strict (no code is more green than green code).
• "Neutral" : pastille neutre (typiquement bleue) pour le mode respectuous.
• "Broken" : pastille orange pour le mode broken.

Extension candidate

Objectifs généraux de dde-version 0.1*

• Fournir les bases d'une appropriation collective des notions dde-version et dde-unit
• Définir ces notions
• Permettre à une communauté de se constituer et de prendre part à la définition générale de dde (ce document)

Liste et descriptions des extensions dde-units fournies par dde-version 0.1*

/* Ignored Layouts */

[
  "one-column", "two-columns" 
]

/* Ignored Zones */

{
  "first": [
    "one_context",
    "another_context"
  ],
  "second": [
    "one_context"
  ]
}

<meta name="csrf-token" content="123456-security-token-ABC000">

Contributions

• Suggérer des modification avant la version définitive de ce document, ou pour une version ultérieur
• Proposer une dde-unit
• Traduire
• Supporter ce projet (dons, encouragement)
• Github : flavi1/declarative-dynamic-extensions
• W3C Community Group (actuellement fermé)

Implémentation(s) actuelle(s)

Contact

flavien.guillon@gmail.com

Projets similaires

Z framework, Turbo Frames, Turbo Streams, intercoolerjs, HTMX, Unpoly, autres ?...)

Licence

Ce document, "abstract dde-version 0.1*", ainsi que les dde-units qui y sont décrites sont sous licence MIT