Chapitre sur l'utilisation

This commit is contained in:
Vincent Calame 2022-08-08 22:34:00 +02:00
parent 9f97a117db
commit 760d38cfd6
2 changed files with 57 additions and 3 deletions

View File

@ -6,8 +6,62 @@ Le principe de cette bibliothèque est de pouvoir écrire un lien proposant une
Cette bibliothèque est testée sous Firefox ou Chromium pour des tableaux de petite taille.
## Démonstration de la bibliothèque
## Options disponible
Une démonstration est visible ici : [jshtml2ods.exemole.fr/demo.html](https://jshtml2ods.exemole.fr/demo.html), également disponible via le site [Jsfiddle](https://jsfiddle.net/vcalame/4fxrkzgs/13/) pour faire des tests en direct.
## Utilisation de la bibliothèque
La bibliothèque est contenue dans un seul fichier sans dépendance. La dernière version stable se trouve dans le répertoire *dist/*, voir aussi les versions dans la forge : [forge.chapril.org/vcalame/jsHtml2Ods/releases](https://forge.chapril.org/vcalame/jsHtml2Ods/releases). La dernière version est utilisable directement en ligne : [https://jshtml2ods.exemole.fr/latest/html2ods.js](https://jshtml2ods.exemole.fr/latest/html2ods.js).
L'utilisation se fait en trois étapes :
1. Inclure la bibliothèque
```html
<script type="text/javascript" src="https://jshtml2ods.exemole.fr/latest/html2ods.js"></script>
```
2. Avoir dans le texte un lien et une table dotées d'identifiant HTML
```html
<script type="text/javascript" src="https://jshtml2ods.exemole.fr/latest/html2ods.js"></script>
```
```html
<a href="blob:" download="table.fods" id="link" onclick="fodsLink()">Version ODS</a>
...
<table id="table">
...
</table>
```
3. Définir la fonction fodsLink indiquée dans onclick="fodsLink()"
```html
<script>
function fodsLink() {
let link = document.getElementById("link");
link.href = URL.createObjectURL(
Html2Ods.blob("table")
);
setTimeout(function () {
URL.revokeObjectURL(link.href);
}, 4E4); // 40s
return true;
}
</script>
```
Cette fonction construit un objet de type Blob associé au lien de téléchargement.
## Options disponibles
L'objet options passé en argument peut avoir les propriétés suivantes :

View File

@ -73,11 +73,11 @@ column.Date {
width: 4cm;
}
column.Montant ~ .colonnemontant {
column.Montant ~ .colonnemontant {
width: 3cm;
}
column.NbreTranches ~ .count {
column.NbreTranches ~ .count {
width: 1.5cm;
}