›_ ebskola.lv
← 9.4 9.6 →

9.5 Interaktivitāte pārlūkprogrammā

Stundas uzdevums: Pievienot interaktivitāti, izmantojot session_state, callback-us un dinamisku satura atjauninājumu.

SR 2.4.7. Lietotāja saskarne SR 2.4.14. Vadības struktūras

70 min darba sadalījums: 1. uzdevums (~20 min) - atjauno teorijas piemēru vai minimālo prototipu; 2. uzdevums (~25 min) - pielieto to galvenajā uzdevumā; 3. uzdevums (~25 min) - pārbaudi rezultātu, izlabo kļūdas un tikai beigās pieraksti vienu secinājumu. Papildus/4. līmeņa uzdevums ir paredzēts tikai tad, ja pamatdarbs ir pabeigts.

Pirms sāc: izmanto iepriekš apgūto un šīs lapas teorijas/koda piemērus. Ja vajadzīga jauna komanda vai rīks, vispirms atrodi tās paraugu teorijas sadaļā.

Teorija: session_state un interaktivitāte

st.session_state ir Streamlit galvenā funkcija interaktivitātei - datu glabāšana starp pārlādēm.

import streamlit as st

# Inicializācija (tikai pirmoreiz)
if "klikski" not in st.session_state:
    st.session_state.klikski = 0
if "saraksts" not in st.session_state:
    st.session_state.saraksts = []

# Atjaunināšana
if st.button("Klikšķini mani"):
    st.session_state.klikski += 1

st.write(f"Klikšķi: {st.session_state.klikski}")

# Forma - apkopo visus inputus pirms iesniegšanas
with st.form("speletajs"):
    vards = st.text_input("Vārds")
    punkti = st.number_input("Punkti")
    iesniegt = st.form_submit_button("Pievienot")

if iesniegt:
    st.session_state.saraksts.append({"vards": vards, "punkti": punkti})

st.dataframe(st.session_state.saraksts)

Praktiskie uzdevumi

1. uzdevums - Iesildies ar gatavu piemēru

Šis ir īss iesildīšanās uzdevums. Nokopē sagatavi, ielīmē to pareizajā koda vietā un palaid. Šeit pietiek droši izmēģināt tēmu 9.5 Interaktivitāte pārlūkprogrammā; detalizētu izpratni veidosi nākamajos uzdevumos.

Kopējamais piemērs vai sagatave: izmanto šo bloku kā starta punktu, nevis kā gala risinājumu.

import streamlit as st

# Inicializācija (tikai pirmoreiz)
if "klikski" not in st.session_state:
    st.session_state.klikski = 0
if "saraksts" not in st.session_state:
    st.session_state.saraksts = []

# Atjaunināšana
if st.button("Klikšķini mani"):
    st.session_state.klikski += 1

st.write(f"Klikšķi: {st.session_state.klikski}")

# Forma - apkopo visus inputus pirms iesniegšanas
with st.form("speletajs"):
    vards = st.text_input("Vārds")
    punkti = st.number_input("Punkti")
    iesniegt = st.form_submit_button("Pievienot")

if iesniegt:
    st.session_state.saraksts.append({"vards": vards, "punkti": punkti})

st.dataframe(st.session_state.saraksts)
  1. Atver darba failu vai rīku. Python fragmentu ievieto main.py failā un palaid no termināļa.
  2. Nokopē visu piemēra bloku no šī uzdevuma un ielīmē to norādītajā vietā.
  3. Palaid kodu tieši tādu, kāds tas ir, un pārliecinies, ka parādās rezultāts, izvade vai vismaz nav kļūdas paziņojuma.
  4. Atrodi vienu drošu vietu, ko drīkst mainīt: tekstu, skaitli, krāsu, mainīgā vērtību vai testa ierakstu.
  5. Maini tikai šo vienu vērtību un palaid kodu vēlreiz.
  6. Salīdzini rezultātu pirms un pēc izmaiņas. Ja parādās kļūda, atcel pēdējo izmaiņu un palaid vēlreiz.
  7. Turpini pie 2. uzdevuma tikai tad, kad šis mazais piemērs darbojas.

2. uzdevums - Ievieto algoritmu projektā

Pievieno šīs stundas paņēmienu kā nelielu, strādājošu projekta daļu.

  1. Izvēlies vienu vietu projektā: datu apstrādi, skatu, formu, API maršrutu, validāciju vai rezultāta izvadi.
  2. Nosauc funkcijas, mainīgos un failus pēc to lomas, piemēram, apstrada_gajienu(), rezultats vai routes.py.
  3. Uzraksti funkciju vai maršrutu, kas nolasa datus, apstrādā tos un atgriež rezultātu.
  4. Savieno šo kodu ar HTML formu, pogu, saiti, API pieprasījumu vai redzamu izvades vietu.
  5. Pievieno vienu īsu komentāru pie sarežģītākās apstrādes vietas.
  6. Pārbaudi, ka esošā projekta daļa joprojām darbojas.
  7. Salabo pirmo atrasto kļūdu pirms paplašini risinājumu.
  8. Veic Git commit ar īsu ziņu par pievienoto funkcionalitāti.

3. uzdevums - Testē kodu un izdari secinājumu

Pārbaudi, vai algoritms darbojas paredzami ar dažādiem datiem.

  1. Izveido trīs testa scenārijus: parastu ievadi, robežgadījumu un kļūdainu vai tukšu ievadi.
  2. Palaid parasto scenāriju un pārbaudi rezultātu pārlūkā, terminālī vai API atbildē.
  3. Palaid robežgadījumu ar mazāko, lielāko vai tukšāko vērtību, ko šis kods var saņemt.
  4. Palaid kļūdaino scenāriju un pārbaudi, vai lietotājs saņem saprotamu atbildi.
  5. Izlabo vienu konkrētu problēmu Python kodā, HTML sasaistē vai datu validācijā.
  6. Pārbaudi labojumu vēlreiz ar visiem trim scenārijiem.
  7. Beigās pieraksti vienu secinājumu: kura koda daļa vislabāk palīdzēja saprast tēmu 9.5 Interaktivitāte pārlūkprogrammā.

Papildu uzdevums - Pievieno mazu funkciju

Ja pamatdarbs ir pabeigts, paplašini projektu ar vienu nelielu programmētu uzlabojumu.

  1. Izvēlies vienu mazu papildinājumu, kas izmanto to pašu šīs stundas paņēmienu.
  2. Pievieno vienu jaunu ievades lauku, API atbildi, validāciju, datu elementu vai redzamu rezultātu.
  3. Savieno papildinājumu ar esošo projektu.
  4. Pārbaudi, ka pamatfunkcija un papildinājums darbojas kopā.
  5. Saglabā izmaiņas ar Git commit tikai pēc veiksmīgas pārbaudes.

Biežākās kļūdas

Koda piemērs

import streamlit as st

st.title("▸ Mans To-Do")

if "todo" not in st.session_state:
    st.session_state.todo = []

with st.form("forma", clear_on_submit=True):
    jauns = st.text_input("Jauns uzdevums")
    ok = st.form_submit_button("+ Pievienot")

if ok and jauns:
    st.session_state.todo.append({"teksts": jauns, "izpildīts": False})

for i, t in enumerate(st.session_state.todo):
    col1, col2 = st.columns([10, 1])
    with col1:
        st.session_state.todo[i]["izpildīts"] = st.checkbox(
            t["teksts"], value=t["izpildīts"], key=f"cb{i}"
        )
    with col2:
        if st.button("✕", key=f"d{i}"):
            st.session_state.todo.pop(i)
            st.rerun()
Pievieno uzdevumus → atzīmē kā izpildītus → dzēš ar ✕.
Saraksts saglabājas starp lapas pārlādēm.
⬅ Iepriekšējā stunda Nākamā stunda ➡