diff --git a/README.md b/README.md index 50b3103..edd7749 100644 --- a/README.md +++ b/README.md @@ -1,10 +1,12 @@ # jsHtml2Ods -Conversion d'un tableau HTML en fichier ODS disponible en téléchargement +Conversion d'un tableau HTML en fichier ODS disponible en téléchargement. + +Le principe de cette bibliothèque est de pouvoir écrire un lien proposant une version ODS (en fait au format .fods) d'un tableau HTML existant. L'exportation est opérationnelle sans aucune modification du tableau mais l'aspect du fichier résultant peut être substantiellement amélioré en ajoutant des attributs spéciaux (`data-od-*`) aux éléments du tableau et en proposant des styles suivant la syntaxe CSS. ## Attributs -L'exporation peut être configurée à l'aide d'attributs nommés `data-od-*`. Ils sont tous facultatifs. +L'exporation peut être configurée à l'aide d'attributs nommés `data-od-*`. Ils sont tous facultatifs et sont placés au niveau des différents éléments composants le tableau. ### Élément `` @@ -24,9 +26,9 @@ L'exporation peut être configurée à l'aide d'attributs nommés `data-od-*`. I ### Éléments `
` ou `` -- `data-od-style` : style de la cellule +- `data-od-style` : style de la cellule (en cas d'absence de valeur, un élément `` a comme style *Header* et un élément `` a comme style *Standard*) - `data-od-type` : type des données de la cellule (valeurs possibles : `number`, `date` ou `currency`) -- `data-od-text` : texte de la cellule (alias : `data-od-text`), voir ci-dessous +- `data-od-text` : texte de la cellule (alias : `data-text`), voir ci-dessous - `data-od-currency` : code ISO en trois lettres de la monnaie de la cellule, n'a d'intérêt que si la cellule est de type `currency` et peut être défini au niveau de l'élément `` #### Texte d'une cellule @@ -35,4 +37,54 @@ Par défaut, le texte de la cellule dans le fichier résultant est le texte brut Au lieu de l'attribut `data-od-text`, la valeur peut être définie dans l'attribut `data-text`, ce qui permet la comptabilité avec l'extension JQuery TableSorter. Si les deux attributs sont présents, `data-od-text` a la préséance. -Lorsque le texte de la cellule est le texte brut de l'élément, il est possible d'ignorer un élément enfant **direct** de l'élément `
` ou `` en lui donnant l'attribut `data-od-hidden` avec n'importe quelle valeur non nulle (1 ou true sont conseillés) +Lorsque le texte de la cellule est le texte brut de l'élément, il est possible d'ignorer un élément enfant **direct** de l'élément `` ou `` en lui donnant l'attribut `data-od-hidden` avec n'importe quelle valeur non nulle (1 ou true sont conseillés). + +## Définition des styles via une syntaxe CSS + +Dans le format OpenDocument, la mise en forme des éléments (colonne, ligne, cellule) sont définies par des styles attachés aux éléments. Si de nombreux noms de propriété rappellent ceux des propriétés courantes du CSS, il y a quelques différences de taille : + +- Un élément possède un style et un seul +- La seule hiérachie possible est un parent pour un style +- Il n'y a évidemment aucune possibilité de définition en « cascade » via les sélecteurs CSS. + +Pour définir des styles dans le fichier résultant (par exemple, mettre un fond rouge à une cellule), jsHtml2Ods propose un mécanisme de conversion d'éléments suivant la syntaxe CSS vers le format XML d'OpenDocument. + +**Point important** : il s'agit d'une forme de détournement du CSS, aucun sélecteur CSS ne va fonctionner de manière habituelle ; l'idée est de pouvoir définir les styles de l'exportation au même endroit que le reste du HTML, c'est à dire dans les fichiers CSS chargés pa la page (ou le CSS d'éléments `