إنشاء لعبة Tic-Tac-Toe مع TypeScript و React و Mocha

نقدم لك ترجمة لمقال نشره جوش كوتلر نُشر على blog.bitsrc.io. تعرف على كيفية إنشاء تطبيق Tic-Tac-Toe باستخدام React و TypeScript.



لعبة تيك تاك تو بسيطة تم إنشاؤها على أساس وحدات وتحميلها على موقع بت . يمكنك تغيير مكونات لعبتي واختبارها عبر الإنترنت على Bit PlayGround باستخدام NPM أو Yarn أو Bit. للقيام بذلك ، انتقل إلى مجموعة المكونات الخاصة بي .

عند إنشاء ألعاب Tic-Tac-Toe بطريقة معيارية ، من الصعب العثور على سبب لاستخدام مكونات واجهة المستخدم مرة أخرى. لذلك ، ركزت بشكل رئيسي على المرافق اللعبة.

بالنسبة للبرمجة ، اخترت TypeScript - قمت بترجمة الشفرة باستخدام TypeScript على موقع Bit الإلكتروني . ثم استخدم إطار موكا للاختبار.

لتثبيت مكونات من مشروعي ، قم أولاً بتكوين bit.dev كسجل المجال (انسخ والصق على جهازك). يجب أن يتم ذلك مرة واحدة فقط! إذا استمرت في استخدام موقع Bit الإلكتروني ، فلن تحتاج إلى إعادة تكوينه.

npm config set '@bit:registry' https://node.bit.dev 

ثم تثبيت المكون باستخدام مديري حزم Yarn أو NPM:

 npm i @bit/joshk.tic-tac-toe-game.game yarn add @bit/joshk.tic-tac-toe-game.game 

مكون اللعبة


مكون اللعبة هو المكون الرئيسي للتطبيق الخاص بي - تم إنشاؤه باستخدام أحد مكونات اللوحة ومكونين Prime React .

لقد استخدمت مكونات زر والإدخال النص لشاشة الإعداد - يمكنك اختبار ورؤية التعليمات البرمجية الخاصة بهم هنا .



تثبيت مكونات PrimeReact في مشروعك:

 yarn add @bit/primefaces.primereact.inputtext yarn add @bit/primefaces.primereact.button 

بعد تحديد المعلمات ، يمكنك النقر فوق "تشغيل" و ... العب!

مكون المجلس


يقوم مكون اللوحة بإنشاء جدول ديناميكي باستخدام Props ، ويقوم بتعيين قائمة الانتظار للاعبين وتحديد الفائز. يمكنك اختبار ورؤية الرمز هنا .



مكون مربع


مكوّن Square هو خلية عادية تتلقى قيمة بلون اختياري وترسل حدثًا إلى مكون Board عندما تتغير القيمة. يمكنك اختبار ورؤية الرمز هنا .



وظيفة خلية فارغة


وظيفة الخلية الفارغة هي وظيفة مساعدة لوظيفة Winner-calc ، والتي تتحقق مما إذا كانت هناك خلايا فارغة في جدول اللعبة.

تتيح لك البت رؤية المستندات المكونة ونتائج الاختبار:



رمز الوظيفة
 /** * @description * check if 2d array have an empty cell * @param {{Array.<string[]>}} matrix 2d array * @param {number} rowsNum number of rows * @param {number} colsNum number of columns * @returns {boolean} return true if empty cell was found, and false if not. * @example * import haveEmptyCell from '@bit/joshk.tic-tac-toe-game.utils.have-empty-cell'; * * const matrix = [ * ['X', 'O', 'X'], * ['O', 'X', 'O'], * ['O', 'X', 'O'] * ]; * const result = haveEmptyCell(matrix, 3, 3); * * export default result * @example * import haveEmptyCell from '@bit/joshk.tic-tac-toe-game.utils.have-empty-cell'; * * const matrix = [ * ['X', 'O', 'X'], * ['O', '', 'O'], * ['O', 'X', 'O'] * ]; * const result = haveEmptyCell(matrix, 3, 3); * * export default result * @example * import haveEmptyCell from '@bit/joshk.tic-tac-toe-game.utils.have-empty-cell'; * * const matrix = [ * ['X', 'O', 'X'], * ['O', , 'O'], * ['O', 'X', 'O'] * ]; * const result = haveEmptyCell(matrix, 3, 3); * * export default result * @example * import haveEmptyCell from '@bit/joshk.tic-tac-toe-game.utils.have-empty-cell'; * * const matrix = [ * ['X', 'O', 'X'], * ['O', null, 'O'], * ['O', 'X', 'O'] * ]; * const result = haveEmptyCell(matrix, 3, 3); * * export default result */ function haveEmptyCell(matrix: Array<Array<string>>, rowsNum: number, colsNum: number): boolean { let empty: boolean = false; for (let x = 0; x < rowsNum; x++) { for (let y = 0; y < colsNum; y++) { const element: any = matrix[x][y]; if (!element) { empty = true; break; } } if (empty) break; } return empty; } export default haveEmptyCell 


الفائز حساب وظيفة


حساب الفائز هو دالة تقوم بحساب الفائز على الطائرات الأفقية والرأسية والقطرية.

تتيح لك البت رؤية المستندات المكونة ونتائج الاختبار:



رمز الوظيفة
 /** * @description * check winner horizontal, vertical and diagonal * @param {Array.<string[]>} matrix 2d array with X and O * @param {number} rowsNum number of rows * @param {number} colsNum number of columns * @param {number} numToWin the number of matching to win * @param {number} lastRow the row number of the square player click * @param {number} lastCol the column number of the square player click * @returns {string} return the winner, X or O or '' if no one win. * @example * import winnerCalc from '@bit/joshk.tic-tac-toe-game.utils.winner-calc'; * * const matrix = [ * ['O', 'O', 'X'], * ['O', 'X', ''], * ['X', '', ''] * ]; * const result = winnerCalc(matrix, 3, 3, 3, 0, 2); * * export default result */ import haveEmptyCell from '../HaveEmptyCell' function winnerCalc(matrix: Array<Array<string>>, rowsNum: number, colsNum: number, numToWin: number, lastRow: number, lastCol: number): string { let winner: string = ''; let match: number = 0; const lastValue: string = matrix[lastRow][lastCol]; //check Horizontal for (let c = 0; c < colsNum; c++) { let currentValue = matrix[lastRow][c]; if (currentValue === lastValue) match++; else match = 0; if (match === numToWin) { winner = lastValue; break; } } if (winner !== '') return winner; match = 0; //check Vertical for (let r = 0; r < rowsNum; r++) { let currentValue = matrix[r][lastCol]; if (currentValue === lastValue) match++; else match = 0; if (match === numToWin) { winner = lastValue; break; } } if (winner !== '') return winner; //check diagonal top-left to bottom-right - include middle match = 0; for (let r = 0; r <= rowsNum - numToWin; r++) { let rowPosition = r; for (let column = 0; column < colsNum && rowPosition < rowsNum; column++) { const currentValue = matrix[rowPosition][column]; if (currentValue === lastValue) match++; else match = 0; if (match === numToWin) { winner = lastValue; break; } rowPosition++; } if (winner !== '') break; } if (winner !== '') return winner; //check diagonal top-left to bottom-right - after middle match = 0; for (let c = 1; c <= colsNum - numToWin; c++) { let columnPosition = c; for (let row = 0; row < rowsNum && columnPosition < colsNum; row++) { let currentValue = matrix[row][columnPosition]; if (currentValue === lastValue) match++; else match = 0; if (match === numToWin) { winner = lastValue; break; } columnPosition++; } if (winner !== '') break; } if (winner !== '') return winner; //check diagonal bottom-left to top-right - include middle match = 0; for (let r = rowsNum - 1; r >= rowsNum - numToWin - 1; r--) { let rowPosition = r; for (let column = 0; column < colsNum && rowPosition < rowsNum && rowPosition >= 0; column++) { let currentValue = matrix[rowPosition][column]; if (currentValue === lastValue) match++; else match = 0; if (match === numToWin) { winner = lastValue; break; } rowPosition--; } if (winner !== '') break; } if (winner !== '') return winner; //check diagonal bottom-left to top-right - after middle match = 0; for (let c = 1; c < colsNum; c++) { let columnPosition = c; for (let row = rowsNum - 1; row < rowsNum && row >= 0 && columnPosition < colsNum && columnPosition >= 1; row--) { console.log(`[${row}][${columnPosition}]`); let currentValue = matrix[row][columnPosition]; if (currentValue === lastValue) match++; else match = 0; if (match === numToWin) { winner = lastValue; break; } columnPosition++; } if (winner !== '') break; } if (winner !== '') return winner; if(haveEmptyCell(matrix, rowsNum, colsNum) === false) { winner = '-1'; } return winner; } export default winnerCalc 


المشروع متاح في مجموعتي على Bit وفي مستودع GitHub الخاص بي.

لا تتردد في التعليق على هذا المقال والاشتراك في بلدي التغريد .

Source: https://habr.com/ru/post/ar456000/


All Articles