Explaining pages

Sidor låter dig organisera programmets innehåll

Vårt program

I föregående handledning, lyckades vi ställa in, bygga och kompilera vårt första Kirigami-program. Med grunderna på plats, kan vi börja vår resa mot att skapa ett program med fullständig funktion.

De här handledningarna fokuserar på att skapa ett program som låter användaren se hur många dagar som är kvar till en händelse de väljer. Det betyder inte att du inte kan avvika och försöka skapa något eget. Säkerställ bara att du noggrant observerar hur saker och ting fungerar först, så att du kan justera när saker är annorlunda i din egen kod. Vi rekommenderar också att to tar en titt på Kirigami galleri, som tillhandahåller ett antal användbara exempel på användargränssnitt och enkel åtkomst till all kod.

I det här avsnittet fokuserar vi på sidor, ett av de viktigaste strukturelementen i alla Kirigami-program.

Sidor

Kirigami-program är typiskt organiserade i sidor . De är de olika "skärmarna" i ett program. Du bör ha sidor tillägnade till specifika aspekter i programmets interaktion, och för att göra saker och ting lättare kan du skapa olika QML-filer, en för varje sida.

Sidor organiseras i en sidstapel där de kan läggas till eller tas bort. På en telefon visas bara den översta sidan, medan på en större skärm (skrivbordsdator eller surfplatta) kan flera sidor visas intill varandra om så önskas.

En enda sida på telefonen

Två sidor intill varandra på skrivbordsdatorn

Låt oss gå tillbaka till filen main.qml vi skapade i föregående handledning:

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
// Includes relevant modules used by the QML
import QtQuick 2.15
import QtQuick.Controls 2.15 as Controls
import QtQuick.Layouts 1.15
import org.kde.kirigami 2.20 as Kirigami

// Provides basic features needed for all kirigami applications
Kirigami.ApplicationWindow {
    // Unique identifier to reference this object
    id: root

    // Window title
    // i18nc() makes a string translatable
    // and provides additional context for the translators
    title: i18nc("@title:window", "Hello World")

    // Set the first page that will be loaded when the app opens
    // This can also be set to an id of a Kirigami.Page
    pageStack.initialPage: Kirigami.Page {
        Controls.Label {
            // Center label horizontally and vertically within parent object
            anchors.centerIn: parent
            text: i18n("Hello World!")
        }
    }
}

Vi gör så att vårt program startar på vår Kirigami.Page . Allt vi har inkluderat på den är en beteckning som innehåller "Hello World", men vi kommer att piffa upp den lite grand.

Idén bakom vårt program är att vi ska kunna visa ett antal nedräknare för användaren. Problemet med en normal Kirigami.Page är att den har en fast vertikal storlek, men var inte orolig: Kirigami stöder också rullningsbara sidor. Kirigami.ScrollablePage kommer att vara vår huvudsida nu.

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
import QtQuick 2.15
import QtQuick.Controls 2.15 as Controls
import QtQuick.Layouts 1.15
import org.kde.kirigami 2.20 as Kirigami

Kirigami.ApplicationWindow {
    id: root

    title: i18nc("@title:window", "Day Kountdown")

    pageStack.initialPage: Kirigami.ScrollablePage {
        title: i18nc("@title", "Kountdown")
    }
}

Kirigami-sidor har också snygga titlar placerade inne i verktygsraden, som snabbt anger för användaren vilken sida de är på. Allt vi behöver göra är att ställa in en sidtitel genom att använda egenskapen title i Kirigami.ScrollablePage . Här använder vi en av i18nc() funktionerna som vi utforskade i vår förra handledning i detta syfte.