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
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
|
# To Do App (Front End)
A basic and simple To Do App. **This is just the front end part. The back end
part is on a different repository in this same account. Go check it out!**
## Try it yourself!
### Online
You can try this program online. Go to the following link:
[https://hisiste.github.io/ToDo-App-Front-End/](https://hisiste.github.io/ToDo-App-Front-End/)
**_NOTE: It doesn't save any info, as the Back End is not implemented here.
After restarting the page, all info will be deleted._**
**_NOTE 2: You will see a lot of errors on the console part of the page. This is
normal. It will try to communicate with the API but won't find it. Regardless,
this is still usable and you can experiment with it._**
### Locally
You need to have [Node](https://nodejs.org/en) installed on your computer. It is
recommended to use version 20.x or above.
You can run it locally using the following commands:
1. Clone this repository.
```
git clone https://github.com/Hisiste/ToDo-App-Front-End.git
```
1. Enter the folder and install the dependencies.
```
cd ToDo-App-Front-End && npm install
```
1. Run a server.
```
npm run dev
```
It will display an output similar to this:
```
VITE v4.3.7 ready in 1080 ms
➜ Local: http://localhost:5173/
➜ Network: use --host to expose
➜ press h to show help
```
There you have your URL!
1. Be sure to also clone the Back End and run it to save your to dos!
## Goals
The program currently has/lacks the following functionality:
- [x] Create a "to do" specifying the name, a priority, and a due date.
- [x] Ability to edit name, priority and due date for existing "to do" tasks.
- Be able to specify a due date or clear the due date (not interested in
when to finish that "to do"?).
- [x] Be able to filter "to do's" specifying the name (or part of the name),
the priority and if they are done/undone.
- [x] Be able to sort the "to do's" by priority and/or due date.
- For example, be able to sort items where their due date is soon and sort
them also by priority to see what tasks are more urgent or less urgent.
- [x] Mark "to do's" as done (clicking in a checkbox) or to undone a "to do".
- The undone functionality is just there if there is a mistake. :D
- [ ] Since it is possible that you can have a lot of "to do's", there's the
need to paginate the list of "to do's".
- [ ] Ability to know, in average, the time between creation and done for all
"to do's". This should be shown in general for all done "to do's" and
also grouped by priority.
## How to use
### Creating to do's
You will see a button with the text `+ New To Do`. After clicking it, a modal
should appear with the following inputs:
- `ID` $\rightarrow$ The id it will be assigned. It is automatic and disabled
by default.
- `Text` $\rightarrow$ The name of the to do.
- `Due date` $\rightarrow$ The date for which the to do is due. **It only
accepts days and not hours, minutes nor seconds.**
- `Completed` $\rightarrow$ If the to do is already completed or not.
- `Priority` $\rightarrow$ The priority of the to do. It could be either
_Low_, _Medium_ or _High_.
### Editing / deleting a to do
You can find a table where every to do is shown. Every row corresponds to a
single task. The last column (`Actions`) is where you can find two buttons for
each row:
- `Edit` $\rightarrow$ A modal should appear in the same layout as if you
where creating a new to do. Except that the fields are already filled with
the corresponding info of the current to do. After accepting the new values,
the to do will be updated.
- `Delete` $\rightarrow$ After clicking this button, the to do will be
instantly deleted. You won't be prompted before. **This is not reversible.**
### Sorting the to do's
On the table's heading you will find `Priority` and `Due Date`. Click on any of
those headings to start sorting the to do's. The symbol next to the column name
will start changing, telling the current way of sorting. The possible sorting's
symbols are as follows:
- **<span>⁛</span>** $\rightarrow$ Currently not sorting.
- **<span>↑</span>** $\rightarrow$ Sorting in descending order. Highest
goes top.
- **<span>↓</span>** $\rightarrow$ Sorting in ascending order. Lowest
goes top.
|
