Differential D17945 Diff 50909 src/activities/numbers-odd-even/resource/TutorialBase.qml

Changeset View

Standalone View

View Options

src/activities/numbers-odd-even/resource/TutorialBase.qml

  • This file was added.
1​/* GCompris - TutorialBase.qml
2​ *
3​ * Copyright (C) 2019 Deepak Kumar <deepakdk2431@gmail.com>
4​ *
5​ * Authors:
6​ * Deepak Kumar <deepakdk2431@gmail.com>
7​ *
8​ * This program is free software; you can redistribute it and/or modify
9​ * it under the terms of the GNU General Public License as published by
10​ * the Free Software Foundation; either version 3 of the License, or
11​ * (at your option) any later version.
12​ *
13​ * This program is distributed in the hope that it will be useful,
14​ * but WITHOUT ANY WARRANTY; without even the implied warranty of
15​ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
16​ * GNU General Public License for more details.
17​ *
18​ * You should have received a copy of the GNU General Public License
19​ * along with this program; if not, see <https://www.gnu.org/licenses/>.
20​ */
21​import QtQuick 2.6
22​import "../../../core"
23​
24​Rectangle {
25​ id: tutorialRectangle
26​ anchors.fill: parent
27​ color: "#80FFFFFF"
28​ property alias evenNumber: evenNumber.text
amankumarguptaUnsubmitted
Done

Extra empty line.

amankumargupta: Extra empty line.
29​ property alias oddNumber: oddNumber.text
30​ property alias message: message.text
amankumarguptaUnsubmitted
Done

Missing space after "id:" and an id should be a meaningful name.

amankumargupta: Missing space after "id:" and an id should be a meaningful name.
31​ property alias question: question.text
32​ property int order
33​
jjazeixUnsubmitted
Not Done

I still don't understand why you need 2 bools?
isEven (should be renamed to isEvenExpected) is set to true if the question is "choose the even number".
then, when you click on a button, if the number inside is even you should tell if it is good or not.

jjazeix: I still don't understand why you need 2 bools? isEven (should be renamed to isEvenExpected) is…
dekumarAuthorUnsubmitted
Not Done

I need two bools for changing the order of the AnswerButton to be correct.As we need to display three different messages and it should not be assumed that the first box is always the correct answer and also to set the (isCorrectAnswer: ) in answer button we need the second bool.I think the message good or bad can't be set using a single bool because we need to handle a case of odd number too.

dekumar: I need two bools for changing the order of the AnswerButton to be correct.As we need to display…
34​ GCText {
35​ id: question
36​ anchors {
37​ left: parent.left
38​ verticalCenter: parent.verticalCenter
amankumarguptaUnsubmitted
Done

Missing space before {

amankumargupta: Missing space before {
39​ leftMargin: parent.height * 0.1
40​ centerIn: parent.Center
41​ top: parent.top
42​ topMargin: parent.height * 0.05
43​ }
44​ text: qsTr("Choose the even number")
45​ fontSize: mediumSize
jjazeixUnsubmitted
Not Done

It would be better to also have on one of the question, the choice to choose the odd number.
Also, having them being on random order (not always the even first, the odd second).

jjazeix: It would be better to also have on one of the question, the choice to choose the odd number.
46​ color: "black"
amankumarguptaUnsubmitted
Done

extra space after (

amankumargupta: extra space after (
47​ horizontalAlignment: Text.AlignLeft
48​ width: 1.8 * parent.width
49​ height: 1.8 * parent.height
50​ wrapMode: Text.WordWrap
51​ z: 2
52​ }
53​
54​ Row {
jjazeixUnsubmitted
Not Done

it would be better to use a Row to present both numbers and have them take the whole space of the remaining space.
Actually, there are too small.

jjazeix: it would be better to use a Row to present both numbers and have them take the whole space of…
55​ spacing: parent.height * 0.8
56​ anchors.centerIn: parent
amankumarguptaUnsubmitted
Done

space after id:

amankumargupta: space after id:
jjazeixUnsubmitted
Not Done

needs to be renamed to be generic too

jjazeix: needs to be renamed to be generic too
57​ Rectangle {
58​ color: "transparent"
jjazeixUnsubmitted
Not Done

indentation

jjazeix: indentation
59​ border.color: "black"
60​ width: 170
61​ height: 130
jjazeixUnsubmitted
Not Done

having hardcoded width/height make overriding (if you reduce the width at maximum, the rectangles will b eoutside the background gray one).

jjazeix: having hardcoded width/height make overriding (if you reduce the width at maximum, the…
62​ MouseArea {
63​ anchors.fill: parent
jjazeixUnsubmitted
Not Done

it would be better to have a color surrounding the rectangle so the user knows the click boundaries.
Using a Repeater for both element would avoid duplicating the Rectangle item.

jjazeix: it would be better to have a color surrounding the rectangle so the user knows the click…
64​ onClicked: {
65​ if(order === 3 || order === 4) {
jjazeixUnsubmitted
Not Done

this is not a maintainable way to check this. Let's assume we want to add a new question, we would think that we only need to add a new Tutorial like Tutorial5 but then we will probably forget to update here.
It would be better to have a boolean telling if we want to find the odd or even number at TutorialBase level, and use it to both set the text and tell if it is good or not on click.

Both button should share the same code (there is AnswerButton that could maybe be used? It also have user feedback).

jjazeix: this is not a maintainable way to check this. Let's assume we want to add a new question, we…
66​ message.text = qsTr("Great")
jjazeixUnsubmitted
Not Done

are you sure you need to display the same text in if and in else?

jjazeix: are you sure you need to display the same text in if and in else?
67​ }
68​ else if (order === 5) {
amankumarguptaUnsubmitted
Done

extra 1 space after ':' and above too.

amankumargupta: extra 1 space after ':' and above too.
69​ message.text = qsTr("No,this is not an even number.")
70​ }
jjazeixUnsubmitted
Not Done

the numbers shouldn't be harcoded here, else it won't work for the examples

jjazeix: the numbers shouldn't be harcoded here, else it won't work for the examples
jjazeixUnsubmitted
Not Done

missing space after the '.'?

jjazeix: missing space after the '.'?
71​ messageRectangle.visible = true
72​ message.visible = true
amankumarguptaUnsubmitted
Done

indentation

amankumargupta: indentation
jjazeixUnsubmitted
Not Done

indentation

jjazeix: indentation
73​ }
74​ }
jjazeixUnsubmitted
Not Done

there will be 2 spaces after ':', you need to remove the one before when on the next line (same comment applies to other sentences below

jjazeix: there will be 2 spaces after ':', you need to remove the one before when on the next line (same…
75​ }
76​ Rectangle {
amankumarguptaUnsubmitted
Not Done

evenNumber and oddNumber can be refactored.

amankumargupta: evenNumber and oddNumber can be refactored.
77​ color: "transparent"
78​ border.color: "black"
79​ width: 170
80​ height: 130
81​ MouseArea {
82​ anchors.fill: parent
83​ onClicked: {
84​ if(order === 3) {
85​ message.text = qsTr("No,this is not an even number.")
jjazeixUnsubmitted
Not Done

indentation

jjazeix: indentation
86​ }
87​ else if (order === 4) {
jjazeixUnsubmitted
Not Done

missing space after ","

jjazeix: missing space after ","
88​ message.text = qsTr("No,this is not an odd number.")
89​ }
90​ else if(order === 5) {
91​ message.text = qsTr("Great")
92​ }
93​
jjazeixUnsubmitted
Not Done

why is there 3 cases here and only one on the other button? Shouldn't they be "symetrical"?

jjazeix: why is there 3 cases here and only one on the other button? Shouldn't they be "symetrical"?
94​ messageRectangle.visible = true
jjazeixUnsubmitted
Not Done

The checks order seems not logical.
There is a check on !isCorrectAnswer to display a text and two lines below, if it's not even, the text changes directly.
It would look more readable having:

if(isCorrect) {
}
else {
  if(even) {
  }
  else {
  }
}
jjazeix: The checks order seems not logical. There is a check on !isCorrectAnswer to display a text and…
95​ message.visible = true
96​ }
amankumarguptaUnsubmitted
Done

indentation

amankumargupta: indentation
97​ }
98​ }
99​ }
100​
amankumarguptaUnsubmitted
Done

the variable name should be in camel case.

amankumargupta: the variable name should be in camel case.
101​
102​ Row {
103​ id: number
104​ spacing: parent.height * 0.8
105​ anchors.centerIn: parent
amankumarguptaUnsubmitted
Done

indentation

amankumargupta: indentation
106​
107​ GCText {
jjazeixUnsubmitted
Not Done

it should not be a space. Either don't have a default value or set "" (which is the same but better not put anything if not needed)

jjazeix: it should not be a space. Either don't have a default value or set "" (which is the same but…
108​ id: evenNumber
jjazeixUnsubmitted
Not Done

indentation

jjazeix: indentation
109​ text: " "
110​ fontSize: hugeSize
111​ }
112​
113​ GCText {
114​ id: oddNumber
amankumarguptaUnsubmitted
Done

indentation

amankumargupta: indentation
115​ text: " "
amankumarguptaUnsubmitted
Not Done

rightMessage and wrongMessage can be refactored

amankumargupta: rightMessage and wrongMessage can be refactored
116​ fontSize: hugeSize
117​ }
amankumarguptaUnsubmitted
Done

camel case

amankumargupta: camel case
118​}
119​
120​
121​ Rectangle {
122​ id: messageRectangle
amankumarguptaUnsubmitted
Done

indentation

amankumargupta: indentation
123​ anchors {
124​ top: parent.top
125​ topMargin: parent.height * 0.7
126​ left: parent.left
127​ leftMargin: parent.height * 0.7
128​ }
129​ opacity: 0.8
130​ radius: 10
131​ border.width: 6
amankumarguptaUnsubmitted
Done

Indentation

amankumargupta: Indentation
132​ color: "white"
133​ border.color: "#87A6DD"
134​ width: parent.width * 0.4
135​ height: parent.height * 0.3
jjazeixUnsubmitted
Not Done

missing qsTr(). Is there a better way to check that the text has a specific value to set the margin?
With translation, we should not assume anything about the text length

jjazeix: missing qsTr(). Is there a better way to check that the text has a specific value to set the…
136​ visible: false
137​ MouseArea {
138​ anchors.fill: parent
139​ onClicked: {
140​ messageRectangle.visible = false
141​ message.visible = false
142​ }
143​ }
144​
145​ GCText {
146​ id: message
147​ anchors {
148​ top: parent.top
149​ topMargin: parent.height * 0.2
150​ left: parent.left
151​ leftMargin: parent.height * 0.08
152​ }
153​ text: ""
154​ fontSize: largeSize
155​ fontSizeMode: Text.Fit
156​ color: "black"
157​ horizontalAlignment: Text.AlignLeft
158​ width: parent.width
159​ height: parent.height
jjazeixUnsubmitted
Not Done

too much break lines

jjazeix: too much break lines
160​ visible: false
161​ z: 2
162​
163​ }
164​ }
165​}
166​
167​
168​
169​
170​