kivy_les_fichiers_kv
Différences
Ci-dessous, les différences entre deux révisions de la page.
Les deux révisions précédentesRévision précédenteProchaine révision | Révision précédente | ||
kivy_les_fichiers_kv [2018/03/22 14:38] – serge | kivy_les_fichiers_kv [2020/10/29 13:50] (Version actuelle) – ↷ Liens modifiés en raison d'un déplacement. serge | ||
---|---|---|---|
Ligne 1: | Ligne 1: | ||
======Kivy: Les fichiers kv====== | ======Kivy: Les fichiers kv====== | ||
+ | <WRAP center round box 60% centeralign> | ||
+ | **{{tagpage> | ||
+ | **[[http:// | ||
+ | </ | ||
+ | <WRAP center round box 40% centeralign> | ||
+ | **[[les_pages_kivy_en_details|Les pages Kivy en détails]]** | ||
+ | </ | ||
+ | <WRAP center round box 60% centeralign> | ||
+ | {{ media_05: | ||
+ | Avec des commentaires ! | ||
+ | </ | ||
+ | ===== Le langage kivy dans les fichiers *.kv ===== | ||
- | ==== Le langage kivy dans les fichiers | + | * [[https:// |
+ | | ||
- | * https:// | + | ===== Ressources sur les fichiers |
- | * Ce qui suit est une adaptation de http:// | + | |
- | + | ||
- | ==== kv ==== | + | |
* [[http:// | * [[http:// | ||
* [[http:// | * [[http:// | ||
- | * [[http:// | ||
- | === Nommage pour le fichier kv === | + | ===== Nommage pour le fichier kv ===== |
* [[http:// | * [[http:// | ||
- | == Exemple == | + | ==== Exemple |
**app_with_kv.py** | **app_with_kv.py** | ||
Ligne 23: | Ligne 32: | ||
''' | ''' | ||
Application from a .kv | Application from a .kv | ||
- | ====================== | + | |
The root application is created from the corresponding .kv. Check the test.kv | The root application is created from the corresponding .kv. Check the test.kv | ||
file to see what will be the root widget. | file to see what will be the root widget. | ||
Ligne 53: | Ligne 62: | ||
Si vous ne respectez pas la convention, vous n' | Si vous ne respectez pas la convention, vous n' | ||
- | === Comment adapter un main.py avec Builder.load_string() pour un fichier *.kv === | + | ===== Comment adapter un main.py avec Builder.load_string() pour un fichier *.kv ===== |
Permet de comprendre comment les éléments du fichier kv sont lu! | Permet de comprendre comment les éléments du fichier kv sont lu! | ||
- | == Sans kv == | + | === Sans kv === |
**without_kv.py** | **without_kv.py** | ||
Ligne 87: | Ligne 96: | ||
</ | </ | ||
- | == Avec kv == | + | === Avec kv === |
**with_kv.py** | **with_kv.py** | ||
Ligne 116: | Ligne 125: | ||
text: "bla bla !" | text: "bla bla !" | ||
</ | </ | ||
- | === Explications sur les fichiers *.kv === | + | ===== Pricipes des fichiers *.kv ===== |
- | == Règles == | + | === Règles |
Une règle s' | Une règle s' | ||
- | == Un widget racine == | + | === Un widget racine |
Vous pouvez utiliser le langage pour créer tout l' | Vous pouvez utiliser le langage pour créer tout l' | ||
- | == Des templates == | + | === Des templates |
Des templates seront utilisés pour construire des morceaux de votre application, | Des templates seront utilisés pour construire des morceaux de votre application, | ||
- | === Syntaxe d'un fichier kv === | + | ===== Syntaxe d'un fichier kv ===== |
Le fichier peut contenir des défitions de règles, un widget racine et des templates: | Le fichier peut contenir des défitions de règles, un widget racine et des templates: | ||
Ligne 136: | Ligne 145: | ||
<code python> | <code python> | ||
# Syntaxe de la définition d'une règle. Plusieurs règle peuvent partager la même définition. | # Syntaxe de la définition d'une règle. Plusieurs règle peuvent partager la même définition. | ||
- | #(as in CSS). Remarquez les caractère <>; Ils font parti de la définition. | + | #(as in CSS). Remarquez les caractère <>; Ils font partie |
< | < | ||
# .. definitions .. | # .. definitions .. | ||
Ligne 176: | Ligne 185: | ||
La propriété canvas est spéciale: vous pouvez indiquer des instructions de graphisme à l' | La propriété canvas est spéciale: vous pouvez indiquer des instructions de graphisme à l' | ||
- | ==== Expressions Valeur et mots réservés ==== | + | ===== Expressions Valeur et mots réservés |
Lorsque vous indiquez la valeur d'une propriété, | Lorsque vous indiquez la valeur d'une propriété, | ||
- | === self === | + | ==== self ==== |
- | Le mot clé self fait référence à l' | + | Le mot clé self fait référence à l' |
<code python> | <code python> | ||
- | Button: | + | < |
- | text: "My state is {}" | + | |
+ | | ||
</ | </ | ||
- | === root === | + | ==== root ==== |
Ce mot clé n'est disponible que dans la définition des règles, et représente le widget racine de la règle (la première instance de la règle). Ce n'est pas le widget racine de tous les widgets. | Ce mot clé n'est disponible que dans la définition des règles, et représente le widget racine de la règle (la première instance de la règle). Ce n'est pas le widget racine de tous les widgets. | ||
Ligne 222: | Ligne 232: | ||
return root | return root | ||
</ | </ | ||
- | === app === | + | ==== app ==== |
Ce mot clé se réferre toujours à l' | Ce mot clé se réferre toujours à l' | ||
Ligne 233: | Ligne 243: | ||
Avec TestApp(App) retourne testapp | Avec TestApp(App) retourne testapp | ||
- | === args === | + | ==== args ==== |
- | Ce mot clé est disponible dans les on_< | + | Ce mot clé est disponible dans les on_action |
<code python> | <code python> | ||
Ligne 253: | Ligne 263: | ||
Attention, l'id ne sera pas disponible dans l' | Attention, l'id ne sera pas disponible dans l' | ||
- | ==== Lien entre valeurs et propriétés | + | ====Exemple de récupération d'une propriété d'une autre class==== |
+ | Extrait de [[smartcitizen|Kivy: | ||
+ | {{ media_05: | ||
+ | Cet exemple pourrait être un excercice dans une interro surprise! On applique bêtement le cours ! "Mais, M' | ||
+ | * app: Ce mot clé se réferre toujours à l' | ||
+ | * root: Ce mot clé n'est disponible que dans la définition des règles, et représente le widget racine de la règle, soit SmartCitizen | ||
+ | * ids: [[https:// | ||
+ | * get_screen(' | ||
+ | * owner_detail: | ||
- | Lorsque vous utilisez le langage Kivy, vous aurez remarqué que nous effectuons un certains travail en tâche de fond pour faire que les choses se déroulent correctement. Vous devriez savoir que les propriétés | + | ===== Lien entre valeurs et propriétés ===== |
+ | |||
+ | Lorsque vous utilisez le langage Kivy, vous aurez remarqué que nous effectuons un certains travail en tâche de fond pour faire que les choses se déroulent correctement. Vous devriez savoir que les propriétés | ||
Le langage Kivy détecte les propriétés dans votre expression value et créé des callbacks pour mettre à jour automatiquement la propriété en utilisant votre expression lorsqu' | Le langage Kivy détecte les propriétés dans votre expression value et créé des callbacks pour mettre à jour automatiquement la propriété en utilisant votre expression lorsqu' | ||
Ligne 271: | Ligne 291: | ||
<code python> | <code python> | ||
Button: | Button: | ||
- | text: 'Plop world' if self.state == ' | + | text: ' |
</ | </ | ||
Le texte du bouton change en fonction de l' | Le texte du bouton change en fonction de l' | ||
- | ==== Instructions graphiques ==== | + | ===== Instructions graphiques |
- | === Classes dynamiques === | + | ==== Classes dynamiques |
Les classes dynamiques vous permettent de créer de nouveaux widgets à la volée, sans aucune déclaration python au préallable. La syntaxe des classes dynamiques est semblable à celle des règles, mais vous devez spécifier la ou les classes de base. | Les classes dynamiques vous permettent de créer de nouveaux widgets à la volée, sans aucune déclaration python au préallable. La syntaxe des classes dynamiques est semblable à celle des règles, mais vous devez spécifier la ou les classes de base. | ||
Ligne 333: | Ligne 353: | ||
</ | </ | ||
- | ==== Redéfinir le style d'un widget ==== | + | ===== Redéfinir le style d'un widget |
Nous aimerions quelques fois hériter d'un widget de manière à utiliser ses propriétés python sans pour cela utiliser le style défini dans le fichier .kv. Par exemple, nous voudrions hériter d'un label, mais avec nos propres instructions pour le canvas. On peut réaliser cela en mettant un tiret ' | Nous aimerions quelques fois hériter d'un widget de manière à utiliser ses propriétés python sans pour cela utiliser le style défini dans le fichier .kv. Par exemple, nous voudrions hériter d'un label, mais avec nos propres instructions pour le canvas. On peut réaliser cela en mettant un tiret ' | ||
Ligne 354: | Ligne 374: | ||
MyWidget aura a présent ses propres instructions dans son canvas. | MyWidget aura a présent ses propres instructions dans son canvas. | ||
- | ==== Les directives de Lang ==== | + | ===== Les directives de Lang ===== |
Vous pouvez utiliser des directives pour contrôler les fichiers du langage (lang). Une directive doit commencer avec un caractère #: | Vous pouvez utiliser des directives pour contrôler les fichiers du langage (lang). Une directive doit commencer avec un caractère #: | ||
Ligne 402: | Ligne 422: | ||
</ | </ | ||
- | {{tag> | + | =====Définir l' |
+ | |||
+ | <code python> | ||
+ | from kivy.app import App | ||
+ | from kivy.lang import Builder | ||
+ | |||
+ | kv = ''' | ||
+ | < | ||
+ | step: 1 | ||
+ | Label: | ||
+ | text: ' | ||
+ | size: self.texture_size | ||
+ | top: root.center_y - sp(20) | ||
+ | center_x: root.value_pos[0] | ||
+ | ''' | ||
+ | |||
+ | class ShortenText(App): | ||
+ | def build(self): | ||
+ | return Builder.load_string(kv) | ||
+ | |||
+ | ShortenText().run() | ||
+ | </ | ||
+ | équivaut à | ||
+ | <code python> | ||
+ | from kivy.app import App | ||
+ | from kivy.lang import Builder | ||
+ | from kivy.uix.slider import Slider | ||
+ | |||
+ | kv = ''' | ||
+ | < | ||
+ | step: 1 | ||
+ | Label: | ||
+ | text: ' | ||
+ | size: self.texture_size | ||
+ | top: root.center_y - sp(20) | ||
+ | center_x: root.value_pos[0] | ||
+ | ''' | ||
+ | |||
+ | class LabeledSlider(Slider): | ||
+ | pass | ||
+ | |||
+ | class ShortenText(App): | ||
+ | def build(self): | ||
+ | return Builder.load_string(kv) | ||
+ | |||
+ | ShortenText().run() | ||
+ | </ | ||
+ | {{tag> kivy python sb }} |
kivy_les_fichiers_kv.txt · Dernière modification : 2020/10/29 13:50 de serge