Documentation: Make example for Angular.

[kyle-wannacott]

Make example documentation for using TABLE-SORT-JS with VueJS and Angular.
Suitable issue for someone with experience using these frameworks.

There is an example for ReactJS made already in public/docs/react.html.

We need examples for other front-end frameworks such as VueJS and Angular.
Relevant files:
public/docs/vue.html
public/docs/angular.html

• HTML example.
• React in class style.
• React in functional/hooks style.
• Vue 2.0 example.
• Vue 3.0 example.
• Angular example.

[haiderali171]

@LeeWannacott should I do it? As a first contribution?

[kyle-wannacott]

@haiderali171. Sure feel free to do it, as a first contribution 👍

Basically you want to translate the React example into examples for Angular and/or Vue. (I should put another example for React in the function/hooks style in addition to classes.) Look at the React example for how to escape < > tags in html code blocks and how the syntax highlighting works for a code block. I'm just using basic HTML to write the docs.

Just leave a comment if you need any help, or clarification.

Thanks.

[haiderali171]

On it! I will shoot you a comment if I need any help..

[haiderali171]

@LeeWannacott Hey! Just wanted to tell you that I am almost done with the vue example. This example uses the Vue CLI. Was wondering if I should include another way because there is one. And one more thing. Should I make the pull request when I complete the angular example or should I do it indepedently, when the vue example is completed first?

[haiderali171]

If you are up for it.. I can do the react hooks example too if you allow it and when both vue and angular are complete!

[kyle-wannacott]

I have an example for React hooks that I haven't pushed yet. Edit: have pushed it now.

I haven't used Vue. But, If we can get the main ways that people use Vue would be good. If the other way isn't some obscure edge case then sure include it. I should have a look at the Vue documentation.

I would do them as separate/independent PR's on separate branches, but not the end of the world if you do them as one and on master.

You can always make PR's and then turn it into a draft while you are working on it and then ask for review when it's ready.

Thanks.

[haiderali171]

@LeeWannacott Pleasee see my pull request!

[haiderali171]

@LeeWannacott Please see my resolve in the pull request!

[kyle-wannacott]

Vue 2.0 example by haiderali171 merged in commit: 84d2de1

[haiderali171]

@LeeWannacott Hello There, was a bit busy with work but got back to table-sort just today! I've been researching the angular example. There are two ways that one can use an external library (like yours) in Angular. Angular 2+ is a Typescript-based framework and the AngularJS is based on the good ol' Javascript.

The easiest way to use an external library in Angular is using the Angular CLI, which is only available on Angular 2+. But it throws an error of not including type declarations (probably because of Typescript) in the library. It seems you need to add them! So, I'm going to go with the AngularJS example when it's ready until then! What do you say?

[kyle-wannacott]

@haiderali171 I guess Angular using TypeScript makes sense considering Angular tends to be directed towards really large projects.

hmm interesting ... just make the AngularJS example in that case. I'm not sure how adding TypeScript to table-sort-js would work considering TypeScript uses a compiler, would people still be able to download as a script file? Maybe I just need to add type annotations and not actually use the compiler/TypeScript. (Can you post a screenshot of the errors it gives you?, if it's not too much trouble?). Thanks.