vcalame/jsHtml2Ods
1
0
Fork 0
Code Issues Pull Requests Projects Releases 2 Wiki Activity

Suite des attributs

Browse Source
This commit is contained in:
Vincent Calame 2022-07-30 10:09:07 +02:00
parent 248dd12544
commit 7ca9f2f95f
1 changed files with 12 additions and 8 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

20
README.md
View File

@ -2,33 +2,37 @@
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
# Attributs ## 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.
## Élément `<table>` ### Élément `<table>`
- `data-od-sheetname` : nom de la feuille dans le fichier résultant - `data-od-sheetname` : nom de la feuille dans le fichier résultant
- `data-od-currency` : code ISO en trois lettres de la monnaie par défaut de la table - `data-od-currency` : code ISO en trois lettres de la monnaie par défaut de la table
- `data-od-fixed-rows` : nombre de lignes fixes - `data-od-fixed-rows` : nombre de lignes fixes
- `data-od-fixed-columns` : nombre de colonnes fixes - `data-od-fixed-columns` : nombre de colonnes fixes
## Éléments `<col>` ou `<colgroup>` ### Éléments `<col>` ou `<colgroup>`
- `data-od-style` : style de la colonne - `data-od-style` : style de la colonne
- `data-od-width` : largeur de la colonne (avec l'unité, par exemple « 6cm »), prend le pas sur la largeur définie dans le style, permet de définir la largeur sans avoir à définir le style - `data-od-width` : largeur de la colonne (avec l'unité, par exemple « 6cm »), prend le pas sur la largeur définie dans le style, permet de définir la largeur sans avoir à définir le style
## Élément <tr> ### Élément `<tr>`
- `data-od-style` : style de la ligne - `data-od-style` : style de la ligne
## Éléments <td> ou <th> ### Éléments `<td>` ou `<th>`
- `data-od-style` : style de la cellule - `data-od-style` : style de la cellule
- `data-od-type` : type des données de la cellule (valeurs possibles : `number`, `date` ou `currency`) - `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-od-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 <table> - `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 `<table>`
### Texte d'une cellule #### Texte d'une cellule
Par défaut, le texte de la cellule dans le fichier résultant est le texte brut de l'élément <td> ou <th>. Par défaut, le texte de la cellule dans le fichier résultant est le texte brut de l'élément `<td>` ou `<th>`. Il est possible d'indiquer un texte alternatif via l'attribut `data-od-text`. Ce texte alternatif est souvent nécessaire dans le cas de cellule de type `number`, `date` ou `currency` ; en effet, la valeur de la cellule doit être un nombre valide ou une date au format ISO pour être traitée correctement lors de l'exporation.
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 `<td>` ou `<th>` en lui donnant l'attribut `data-od-hidden` avec n'importe quelle valeur non nulle (1 ou true sont conseillés)