History

leestott 7cfaffabb5 🌐 Update translations via Co-op Translator		3 weeks ago
..
README.md	🌐 Update translations via Co-op Translator	3 weeks ago
assignment.md	🌐 Update translations via Co-op Translator	3 weeks ago

README.md

Unescape Escape

Sukurkite žaidimą naudodami įvykius

Klausimynas prieš paskaitą

Įvykiais pagrįstas programavimas

Kuriant naršyklės pagrindu veikiančią programą, mes suteikiame vartotojui grafinę naudotojo sąsają (GUI), kurią jis gali naudoti sąveikai su mūsų sukurta programa. Dažniausias būdas sąveikauti su naršykle yra spustelėjimas ir teksto įvedimas įvairiuose elementuose. Tačiau kaip kūrėjai susiduriame su iššūkiu – mes nežinome, kada vartotojas atliks šiuos veiksmus!

Įvykiais pagrįstas programavimas yra programavimo tipas, kurį turime naudoti kurdami savo GUI. Jei šiek tiek išskaidysime šią frazę, pastebėsime, kad pagrindinis žodis čia yra įvykis. Įvykis, pagal Merriam-Webster, apibrėžiamas kaip „kažkas, kas įvyksta“. Tai puikiai apibūdina mūsų situaciją. Mes žinome, kad kažkas įvyks, dėl ko norėsime vykdyti tam tikrą kodą, tačiau nežinome, kada tai įvyks.

Norėdami pažymėti kodo dalį, kurią norime vykdyti, sukuriame funkciją. Kalbant apie procedūrinį programavimą, funkcijos vykdomos tam tikra tvarka. Tas pats galioja ir įvykiais pagrįstam programavimui. Skirtumas yra kaip funkcijos bus iškviečiamos.

Norėdami apdoroti įvykius (mygtuko paspaudimą, teksto įvedimą ir pan.), registruojame įvykių klausytojus. Įvykio klausytojas yra funkcija, kuri laukia, kol įvyks įvykis, ir vykdo veiksmus atsakydama. Įvykių klausytojai gali atnaujinti naudotojo sąsają, siųsti užklausas serveriui ar atlikti kitus veiksmus, reaguodami į vartotojo veiksmus. Įvykio klausytoją pridedame naudodami addEventListener ir pateikdami funkciją, kurią reikia vykdyti.

NOTE: Verta paminėti, kad yra daugybė būdų sukurti įvykių klausytojus. Galite naudoti anoniminius arba pavadintus funkcijų metodus. Taip pat galite naudoti įvairias trumpesnes alternatyvas, pvz., nustatyti click savybę arba naudoti addEventListener. Mūsų užduotyje sutelksime dėmesį į addEventListener ir anoniminius metodus, nes tai yra vienas dažniausių būdų, kuriuos naudoja žiniatinklio kūrėjai. Be to, tai yra lankstiausias metodas, nes addEventListener veikia su visais įvykiais, o įvykio pavadinimą galima pateikti kaip parametrą.

Dažni įvykiai

Yra dešimtys įvykių, kuriuos galite stebėti kurdami programą. Iš esmės bet koks vartotojo veiksmas puslapyje sukelia įvykį, suteikdamas jums daug galimybių užtikrinti, kad vartotojas gautų norimą patirtį. Laimei, dažniausiai jums reikės tik kelių įvykių. Štai keletas dažniausiai naudojamų (įskaitant du, kuriuos naudosime kurdami savo žaidimą):

click: Vartotojas spustelėjo kažką, dažniausiai mygtuką ar nuorodą
contextmenu: Vartotojas spustelėjo dešinįjį pelės mygtuką
select: Vartotojas pažymėjo tekstą
input: Vartotojas įvedė tekstą

Žaidimo kūrimas

Mes sukursime žaidimą, kad išnagrinėtume, kaip veikia įvykiai JavaScript kalboje. Mūsų žaidimas išbandys žaidėjo spausdinimo įgūdžius – vieną iš labiausiai neįvertintų įgūdžių, kuriuos turėtų turėti visi kūrėjai. Visi turėtume praktikuoti savo spausdinimą! Bendras žaidimo veikimo principas atrodys taip:

Žaidėjas paspaudžia pradžios mygtuką ir gauna citatą, kurią reikia perrašyti
Žaidėjas kuo greičiau perrašo citatą teksto laukelyje
- Kai baigiamas kiekvienas žodis, kitas yra paryškinamas
- Jei žaidėjas padaro klaidą, teksto laukelis nusidažo raudonai
- Kai žaidėjas baigia citatą, rodoma sėkmės žinutė su praėjusiu laiku

Sukurkime savo žaidimą ir sužinokime apie įvykius!

Failų struktūra

Mums reikės trijų failų: index.html, script.js ir style.css. Pradėkime juos nustatyti, kad darbas būtų lengvesnis.

Sukurkite naują aplanką savo darbui, atidarydami konsolę arba terminalą ir įvesdami šią komandą:

# Linux or macOS
mkdir typing-game && cd typing-game

# Windows
md typing-game && cd typing-game

Atidarykite Visual Studio Code

code .

Pridėkite tris failus į aplanką Visual Studio Code su šiais pavadinimais:
- index.html
- script.js
- style.css

Sukurkite naudotojo sąsają

Jei išnagrinėsime reikalavimus, žinome, kad mums reikės kelių elementų mūsų HTML puslapyje. Tai šiek tiek primena receptą, kuriam reikia ingredientų:

Vietos, kur būtų rodoma citata, kurią vartotojas turi perrašyti
Vietos, kur būtų rodomos žinutės, pvz., sėkmės žinutė
Teksto laukelio spausdinimui
Pradžios mygtuko

Kiekvienam iš jų reikės ID, kad galėtume su jais dirbti savo JavaScript kode. Taip pat pridėsime nuorodas į CSS ir JavaScript failus, kuriuos sukursime.

Sukurkite naują failą pavadinimu index.html. Pridėkite šį HTML:

<!-- inside index.html -->
<html>
<head>
  <title>Typing game</title>
  <link rel="stylesheet" href="style.css">
</head>
<body>
  <h1>Typing game!</h1>
  <p>Practice your typing skills with a quote from Sherlock Holmes. Click **start** to begin!</p>
  <p id="quote"></p> <!-- This will display our quote -->
  <p id="message"></p> <!-- This will display any status messages -->
  <div>
    <input type="text" aria-label="current word" id="typed-value" /> <!-- The textbox for typing -->
    <button type="button" id="start">Start</button> <!-- To start the game -->
  </div>
  <script src="script.js"></script>
</body>
</html>

Paleiskite programą

Visada geriausia kurti iteratyviai, kad pamatytumėte, kaip viskas atrodo. Paleiskime savo programą. Visual Studio Code turi puikų plėtinį, vadinamą Live Server, kuris tiek talpins jūsų programą lokaliai, tiek atnaujins naršyklę kiekvieną kartą, kai išsaugosite pakeitimus.

Įdiekite Live Server, sekdami nuorodą ir spustelėdami Install
- Naršyklė paragins atidaryti Visual Studio Code, o tada Visual Studio Code paragins atlikti diegimą
- Jei reikia, paleiskite Visual Studio Code iš naujo
Kai įdiegta, Visual Studio Code paspauskite Ctrl-Shift-P (arba Cmd-Shift-P), kad atidarytumėte komandų paletę
Įveskite Live Server: Open with Live Server
- Live Server pradės talpinti jūsų programą
Atidarykite naršyklę ir eikite į https://localhost:5500
Dabar turėtumėte matyti sukurtą puslapį!

Pridėkime šiek tiek funkcionalumo.

Pridėkite CSS

Sukūrę HTML, pridėkime CSS pagrindiniam stiliui. Turime paryškinti žodį, kurį žaidėjas turėtų spausdinti, ir nuspalvinti teksto laukelį, jei įvestas tekstas yra neteisingas. Tai padarysime naudodami dvi klases.

Sukurkite naują failą pavadinimu style.css ir pridėkite šią sintaksę.

/* inside style.css */
.highlight {
  background-color: yellow;
}

.error {
  background-color: lightcoral;
  border: red;
}

✅ Kalbant apie CSS, galite išdėstyti savo puslapį taip, kaip jums patinka. Skirkite šiek tiek laiko ir padarykite puslapį patrauklesnį:

Pasirinkite kitą šriftą
Nuspalvinkite antraštes
Pakeiskite elementų dydį

JavaScript

Sukūrę naudotojo sąsają, dabar sutelkime dėmesį į JavaScript, kuris suteiks logiką. Mes tai suskaidysime į kelis žingsnius:

Bet pirmiausia, sukurkite naują failą pavadinimu script.js.

Pridėkite konstantas

Mums reikės kelių elementų, kurie palengvins programavimą. Vėlgi, tai šiek tiek primena receptą, kuriam reikia ingredientų:

Masyvo su visų citatų sąrašu
Tuščio masyvo, kuriame bus saugomi dabartinės citatos žodžiai
Vietos, kurioje bus saugomas žodžio, kurį žaidėjas šiuo metu spausdina, indeksas
Laiko, kada žaidėjas paspaudė pradžios mygtuką

Taip pat norėsime nuorodų į naudotojo sąsajos elementus:

Teksto laukelį (typed-value)
Citatų rodymo vietą (quote)
Žinutės vietą (message)

// inside script.js
// all of our quotes
const quotes = [
    'When you have eliminated the impossible, whatever remains, however improbable, must be the truth.',
    'There is nothing more deceptive than an obvious fact.',
    'I ought to know by this time that when a fact appears to be opposed to a long train of deductions it invariably proves to be capable of bearing some other interpretation.',
    'I never make exceptions. An exception disproves the rule.',
    'What one man can invent another can discover.',
    'Nothing clears up a case so much as stating it to another person.',
    'Education never ends, Watson. It is a series of lessons, with the greatest for the last.',
];
// store the list of words and the index of the word the player is currently typing
let words = [];
let wordIndex = 0;
// the starting time
let startTime = Date.now();
// page elements
const quoteElement = document.getElementById('quote');
const messageElement = document.getElementById('message');
const typedValueElement = document.getElementById('typed-value');

✅ Pridėkite daugiau citatų į savo žaidimą

NOTE: Mes galime gauti elementus bet kada kode naudodami document.getElementById. Kadangi reguliariai kreipsimės į šiuos elementus, vengsime klaidų su eilutėmis naudodami konstantas. Tokios sistemos kaip Vue.js arba React gali padėti geriau valdyti kodo centralizavimą.

Skirkite minutę ir pažiūrėkite vaizdo įrašą apie const, let ir var naudojimą

🎥 Spustelėkite aukščiau esančią nuotrauką, kad pamatytumėte vaizdo įrašą apie kintamuosius.

Pridėkite pradžios logiką

Norėdami pradėti žaidimą, žaidėjas paspaus pradžios mygtuką. Žinoma, mes nežinome, kada jis tai padarys. Čia į pagalbą ateina įvykio klausytojas. Įvykio klausytojas leis mums laukti, kol kažkas įvyks (įvykis), ir vykdyti kodą atsakant. Mūsų atveju norime vykdyti kodą, kai vartotojas paspaudžia pradžios mygtuką.

Kai vartotojas paspaudžia pradžios mygtuką, turime pasirinkti citatą, nustatyti naudotojo sąsają ir pradėti stebėti dabartinį žodį bei laiką. Žemiau pateiktas JavaScript kodas, kurį reikia pridėti; aptarsime jį po kodo bloko.

// at the end of script.js
document.getElementById('start').addEventListener('click', () => {
  // get a quote
  const quoteIndex = Math.floor(Math.random() * quotes.length);
  const quote = quotes[quoteIndex];
  // Put the quote into an array of words
  words = quote.split(' ');
  // reset the word index for tracking
  wordIndex = 0;

  // UI updates
  // Create an array of span elements so we can set a class
  const spanWords = words.map(function(word) { return `<span>${word} </span>`});
  // Convert into string and set as innerHTML on quote display
  quoteElement.innerHTML = spanWords.join('');
  // Highlight the first word
  quoteElement.childNodes[0].className = 'highlight';
  // Clear any prior messages
  messageElement.innerText = '';

  // Setup the textbox
  // Clear the textbox
  typedValueElement.value = '';
  // set focus
  typedValueElement.focus();
  // set the event handler

  // Start the timer
  startTime = new Date().getTime();
});

Išskaidykime kodą!

Nustatome žodžių stebėjimą
- Naudodami Math.floor ir Math.random atsitiktinai pasirenkame citatą iš quotes masyvo
- Konvertuojame quote į words masyvą, kad galėtume stebėti žodį, kurį žaidėjas šiuo metu spausdina
- wordIndex nustatome į 0, nes žaidėjas pradės nuo pirmojo žodžio
Nustatome naudotojo sąsają
- Sukuriame spanWords masyvą, kuriame kiekvienas žodis yra span elemente
  - Tai leis mums paryškinti žodį ekrane
- join masyvą, kad sukurtume eilutę, kurią galime naudoti atnaujindami innerHTML quoteElement
  - Tai parodys citatą žaidėjui
- Nustatome pirmojo span elemento className į highlight, kad jis būtų paryškintas geltonai
- Išvalome messageElement, nustatydami innerText į ''
Nustatome teksto laukelį
- Išvalome dabartinę value typedValueElement
- Nustatome focus į typedValueElement
Pradedame laikmatį, iškviesdami getTime

Pridėkite spausdinimo logiką

Kai žaidėjas spausdina, sukuriamas input įvykis. Šis įvykio klausytojas patikrins, ar žaidėjas teisingai spausdina žodį, ir stebės dabartinę žaidimo būseną. Grįžkite į script.js ir pridėkite šį kodą pabaigoje. Po to jį išskaidysime.

// at the end of script.js
typedValueElement.addEventListener('input', () => {
  // Get the current word
  const currentWord = words[wordIndex];
  // get the current value
  const typedValue = typedValueElement.value;

  if (typedValue === currentWord && wordIndex === words.length - 1) {
    // end of sentence
    // Display success
    const elapsedTime = new Date().getTime() - startTime;
    const message = `CONGRATULATIONS! You finished in ${elapsedTime / 1000} seconds.`;
    messageElement.innerText = message;
  } else if (typedValue.endsWith(' ') && typedValue.trim() === currentWord) {
    // end of word
    // clear the typedValueElement for the new word
    typedValueElement.value = '';
    // move to the next word
    wordIndex++;
    // reset the class name for all elements in quote
    for (const wordElement of quoteElement.childNodes) {
      wordElement.className = '';
    }
    // highlight the new word
    quoteElement.childNodes[wordIndex].className = 'highlight';
  } else if (currentWord.startsWith(typedValue)) {
    // currently correct
    // highlight the next word
    typedValueElement.className = '';
  } else {
    // error state
    typedValueElement.className = 'error';
  }
});

Išskaidykime kodą! Pradedame paimdami dabartinį žodį ir vertę, kurią žaidėjas jau įvedė. Tada vykdome logiką, kur tikriname, ar citata baigta, žodis baigtas, žodis teisingas ar (galiausiai) yra klaida.

Citata baigta, jei typedValue yra lygi currentWord, o wordIndex yra lygus vienu mažesniam už words length
- Apskaičiuojame elapsedTime, atimdami startTime iš dabartinio laiko
- Padalijame elapsedTime iš 1 000, kad konvertuotume iš milisekundžių į sekundes
- Parodome sėkmės žinutę
Žodis baigtas, jei typedValue baigiasi tarpu (žodžio pabaiga) ir typedValue yra lygi currentWord
- Nustatome value typedElement į '', kad būtų galima įvesti kitą žodį
- Padidiname wordIndex, kad pereitume prie kito žodžio
- Pereiname per visus quoteElement childNodes, nustatydami className į '', kad grąžintume numatytąjį rodymą
- Nustatome dabartinio žodžio className į highlight, kad pažymėtume jį kaip kitą žodį, kurį reikia įvesti
Žodis šiuo metu įvestas teisingai (bet nebaigtas), jei currentWord prasideda typedValue
- Užtikriname, kad typedValueElement būtų rodomas kaip numatytasis, išvalydami className
Jei pasiekėme šią vietą, turime klaidą
- Nustatome className typedValueElement į error

Išbandykite savo programą

Jūs pasiekėte pabaigą! Paskutinis žingsnis – užtikrinti, kad mūsų programa veikia. Išbandykite! Nesijaudinkite, jei yra klaidų; visi kūrėjai susiduria su klaidomis. Išnagrinėkite pranešimus ir derinkite pagal poreikį.

Paspauskite pradžios mygtuką ir pradėkite spausdinti! Tai turėtų atrodyti šiek

Klausimų viktorina po paskaitos

Peržiūra ir savarankiškas mokymasis

Perskaitykite apie visus įvykius, kuriuos žiniatinklio naršyklė suteikia kūrėjui, ir apsvarstykite scenarijus, kuriuose naudotumėte kiekvieną iš jų.

Užduotis

Sukurti naują klaviatūros žaidimą

Atsakomybės apribojimas:
Šis dokumentas buvo išverstas naudojant AI vertimo paslaugą Co-op Translator. Nors siekiame tikslumo, prašome atkreipti dėmesį, kad automatiniai vertimai gali turėti klaidų ar netikslumų. Originalus dokumentas jo gimtąja kalba turėtų būti laikomas autoritetingu šaltiniu. Kritinei informacijai rekomenduojama naudoti profesionalų žmogaus vertimą. Mes neprisiimame atsakomybės už nesusipratimus ar neteisingą interpretaciją, atsiradusią dėl šio vertimo naudojimo.

README.md Unescape Escape