Une remarque ? Une suggestion ?...

Merci de participer à l'amélioration de ce site. Prenez le temps de rédiger votre remarque le plus précisément possible :

text-decoration-skip - Propriété CSS

text-decoration-skip
text-decoration-skip-self
text-decoration-skip-box
text-decoration-skip-inset
text-decoration-skip-spaces
text-decoration-skip-ink

Résumé des caractéristiques de la propriété text-decoration-skip

Description rapide
Propriété raccourcie définissant certaines particularités relatives aux décorations.
Statut
Problèmes de compatibilité
Pourcentages
Ne s'appliquent pas.
Valeur initiale
Voir les propriétés individuelles.
Héritée par défaut
Oui
Type d'animation
Discrète : lors d'une animation, la propriété text-decoration-skip passe d'une valeur à l'autre sans transition.
Module W3C
Module CSS - Décoration du texte
Références (W3C)
Statut du document:: WD (document de travail)

Description.

La définition de la propriété text-decoration-skip n'est pas encore stabilisée par le W3C. La plupart des navigateurs, soit ne la traitent pas du tout, soit ne connaissent que la sous-propriété text-decoration-skip-ink.

La rédaction de cette page est différée.

La propriété text-decoration-skip définit le comportement des traits de décoration (souligné, surligné, barré) dans certains cas particuliers comme les espaces, lorsque le trait coupe un jambage, ou dans le cas de l'héritage.

text-decoration-skip est une propriété résumée qui permet de définir les valeurs des propriétés suivantes :

Voir aussi la propriété résumée text-decoration qui définit les traits de décoration à tracer.

Syntaxes pour text-decoration-skip (propriété résumée).

  • text-decoration-skip: auto;

    Toutes les sous-propriétés sont initialisées à leur valeur par défaut.

  • text-decoration-skip: none;

    Toutes les sous-propriétés sont fixées à la valeur none.

  • text-decoration-skip: initial; text-decoration-skip: inherit; text-decoration-skip: revert; text-decoration-skip: revert-layer; text-decoration-skip: unset;

    La valeur initiale est : Voir les propriétés individuelles..

Syntaxes pour text-decoration-skip-box.

  • text-decoration-skip: none;

  • text-decoration-skip: all;

Syntaxes pour text-decoration-skip-inset.

  • text-decoration-skip: none;

  • text-decoration-skip: auto;

Syntaxes pour text-decoration-skip-ink.

  • text-decoration-skip: auto;

  • text-decoration-skip: none;

  • text-decoration-skip: all;

Syntaxes pour text-decoration-skip-self.

  • text-decoration-skip: none;

    Rien n'est supprimé : les textes de décoration de l'élément parent sont tracés sur cet élément et propagé aux descendants.

  • text-decoration-skip: object;

    Ne pas tracer les traits de décoration issus du parent si l'élément est une image ou du type inlne-box.

Syntaxes pour text-decoration-skip-spaces.

  • text-decoration-skip: none;

  • text-decoration-skip: all;

  • text-decoration-skip: start; text-decoration-skip: end;

Manipulation de la propriété text-decoration-skip par programme.

Les exemples de code ci-après travaillent sur la propriété text-decoration-skip-ink, qui est, pour le moment, la plus souvent reconnue par les navigateurs, mais il sera facile de modifier les codes pour une autre propriété.

Modifier la valeur de text-decoration-skip-ink en Javascript.

Ce code produit un effet équivalent à celui d'un attribut style ajouté à l'élément. La valeur définie sera donc prioritaire sur d'éventuelles valeurs définies précédemment. Deux syntaxes sont données : la première avec le nom de la propriété écrit en kebab-case (text-decoration-skip-ink), et une deuxième syntaxe avec la notation camel-case (textDecorationSkipInk).

Javascript
let el = document.getElementById('id'); el.style['text-decoration-skip-ink'] = 'none'; let el = document.getElementById('id'); el.style.textDecorationSkipInk = 'none';

Lire la valeur de text-decoration-skip-ink avec Javascript.

Ce code est le symétrique du précédent : il retrouve la valeur de text-decoration-skip-ink définie via l'attribut style d'un élément. Pour retrouver la valeur définie via un sélecteur CSS, reportez-vous à l'exemple plus bas.

Javascript
let el = document.getElementById('id'); let value = el.style['text-decoration-skip-ink']; let el = document.getElementById('id'); let value = el.style.textDecorationSkipInk;

Lire la valeur calculée de text-decoration-skip-ink avec Javascript.

La valeur calculée est celle qui résulte de l'évaluation de la cascade des héritages, de la résolution des conflits éventuels (voir les règles de priorité), ou, en dernier recours, la valeur calculée sera la valeur initiale de la propriété.

Javascript
let el = document.getElementById('id'); let value = window.getComputedStyle(el).getPropertyValue('text-decoration-skip-ink');

Modifier la valeur de text-decoration-skip-ink avec JQuery.

JQuery
$('#id').css('text-decoration-skip-ink', 'none');

Lire la valeur calculée de text-decoration-skip-ink avec JQuery.

JQuery
let value = $('#id').css('text-decoration-skip-ink');

Autres exemples de code.

D'autres exemples de code Javascript et JQuery sont donnés sur la page Javascript et CSS.

Testez vous-même.

Les boutons ci-dessous appliquent la valeur saisie à la propriété et affichent ensuite, pour le premier bouton, la valeur telle qu'elle as été appliquée, et pour le deuxième bouton; la valeur calculée. Dans le cas de ces propriétés, il n'y a pas de différences car les seules valeurs possibles sont des valeurs prédéfinies.

Simulateur.

text-decoration-skip-self :
text-decoration-skip-box :
text-decoration-skip-inset :
text-decoration-skip-spaces :
text-decoration-skip-ink :
Trait souligné - Trait surligné - Trait rayé

Prise en charge par les navigateurs (compatibilité).

La propriété text-decoration-skip et ses dérivées sont relativement récentes et partiellement prises en charge (2022). La valeur all appliquée à text-decoration-skip-ink pose également des problèmes de compatibilité.

Colonne 1
Support de la propriété en tant que propriété résumée.
Colonne 2
Support de la syntaxe générale de la propriété text-decoration-skip-ink.
Colonne 3
Support de la valeur all pour la propriété text-decoration-skip-ink.
1
text-decoration-skip
2
text-decoration-skip-ink
3
text-decoration-skip-ink
all
Estimation de la prise en charge en pourcentage du parc actuel.
18%
90%
20%

Navigateurs sur ordinateurs :

Navigateurs sur mobiles :

Navigateurs obsolètes ou marginaux :

Androïd Brower

Chrome

Chrome pour Androïd

Edge

Firefox

Firefox pour Androïd

Internet Explorer

Opéra

Opéra Mobile

Safari

Safari sur IOS

Samsung Internet

Voir aussi, dans le même module de standardisation que text-decoration-skip.

Les spécifications CSS éditées par le W3C sont organisées en modules. text-decoration-skip fait partie du Module CSS - Décoration du texte (CSS Text Decoration Module). Les définitions suivantes sont également décrites dans ce même module.

Propriétés.

Choisit le soulignement, le surlignement ou la rayure du texte.
Définit la couleur du trait de décoration.
Type de décoration : souligné, barré, etc.
Définit comment les décorations héritées des éléments parents doivent être appliquées.
Définit si les lignes de décoration (essentiellement le souligné) s'interrompent au niveau des jambages.
Définit comment les décorations de l'élément lui même (et non pas celles des éléments parents) doivent être appliquées.
Définit si les décoration du ou des éléments parents doivent être appliquées à cet élément.
Définit si les lignes de décoration (soulignement, rayure...) concernent les espaces.
Type de trait pour la décoration : plein, pointillé, etc.
Définit l'épaisseur des traits de décoration (souligné, barré, surligné).
Mise en exergue du texte.
Définit la couleur des caractères de mise en exergue.
Position des caractères de mise en exergue.
Définit si les mises en exergue doivent s'interrompre sur les espaces, les signes de ponctuation, etc.
Style de mise en exergue.
Définit tous les paramètres d'une ombre appliquée au texte.
Définit la position du trait de soulignement, par rapport à la position de base.
Définit l'emplacement des traits de soulignement.