Cómo hacer búsquedas de usuarios en Github usando Angular

imagen

Este artículo es una respuesta a:


El propósito del artículo es:

  • demuestre que puede escribir rápidamente una aplicación simple en Angular, aunque este no es su pasatiempo principal,
  • Muestra las ventajas de la aplicación en Angular.

El propósito del artículo NO es:

  • encender otro holivar.

A cualquiera que esté interesado, le pregunto debajo del gato.

Preparación


Para trabajar con Angular, debe instalar la CLI angular globalmente

npm install -g @angular/cli 

Crea una nueva aplicación
 ng new github-ui cd github-ui 

Cree inmediatamente componentes y errores del usuario, y un servicio para recibir datos de github

 ng generate component components/user ng generate component components/error ng generate service services/github 

Y conéctelos al módulo de aplicación principal.

También conectamos los módulos HttpClient (para trabajar con solicitudes http) y ReactiveForms (para trabajar con formularios).

app.module.ts

 import { BrowserModule } from '@angular/platform-browser'; import { NgModule } from '@angular/core'; import { ReactiveFormsModule } from '@angular/forms'; import { HttpClient } from '@angular/common/http'; import { AppComponent } from './app.component'; import { UserComponent } from './components/user/user.component'; import { ErrorComponent } from './components/error/error.component'; import { GithubService } from './services/github.service'; @NgModule({ declarations: [AppComponent, UserComponent, ErrorComponent], imports: [BrowserModule, ReactiveFormsModule, HttpClient], providers: [GithubService], bootstrap: [AppComponent] }) export class AppModule {} 

Modelos de datos


Porque Angular usa el mecanografiado y mecanografiado nos da mecanografía, es una buena práctica describir los modelos de datos.

Esto tiene las siguientes ventajas:

  • conveniente autocompletar cuando se trabaja con la aplicación,
  • coincidencia de tipos en la etapa de compilación,
  • hace que otros desarrolladores entiendan con qué datos están trabajando.

models / user.model.ts
 export class User { login: string; id: number; node_id: string; avatar_url: string; gravatar_id: string; url: string; html_url: string; followers_url: string; following_url: string; gists_url: string; starred_url: string; subscriptions_url: string; organizations_url: string; repos_url: string; events_url: string; received_events_url: string; type: string; site_admin: boolean; name: string; company: string; blog: string; location: string; email: string; hireable: string; bio: string; public_repos: number; public_gists: number; followers: number; following: number; created_at: string; updated_at: string; } 


Servicio de recepción de datos.


Es costumbre colocar el trabajo con las solicitudes del servidor en Angular en los servicios .

En el servicio creado anteriormente, agregue un método para obtener datos del usuario.

services / github.service.ts

 import { Injectable } from '@angular/core'; import { HttpClient } from '@angular/common/http'; import { Observable } from 'rxjs'; import { User } from '../models/user.model'; @Injectable() export class GithubService { //      http constructor(private http: HttpClient) {} //     getUser(name: string): Observable<User> { const url = `https://api.github.com/users/${name}`; return this.http.get<User>(url); } } 

Búsqueda de usuario


Angular tiene RxJ incorporados desde la caja. Con la ayuda de este y el módulo para trabajar con formularios, podemos suscribirnos para cambiar el valor de control y obtener datos del usuario.

app.component.html

 <div class="container" [class.ready]="!!user"> <input [formControl]="findControl" placeholder="GitHub username" /> <app-user *ngIf="user" [user]="user"></app-user> <app-error *ngIf="error"></app-error> </div> 

app.component.ts

 import { Component, OnInit } from '@angular/core'; import { FormControl } from '@angular/forms'; import { GithubService } from './services/github.service'; import { User } from './models/user.model'; import { filter, switchMap, debounceTime, catchError } from 'rxjs/operators'; import { EMPTY } from 'rxjs'; @Component({ selector: 'app-root', templateUrl: './app.component.html', styleUrls: ['./app.component.css'] }) export class AppComponent implements OnInit { //     findControl = new FormControl(); //   error: boolean = false; //   user: User = null; //  githubService    constructor(private githubService: GithubService) {} //    ngOnInit() { this.findControl.valueChanges .pipe( //       filter(value => value.length > 2), //     debounceTime(1000), //    switchMap(value => this.githubService.getUser(value).pipe( //   catchError(err => { this.user = null; this.error = true; return EMPTY; }) ) ) ) //   .subscribe(user => { this.user = user; this.error = false; }); } } 

Otros componentes


Los componentes restantes son "estúpidos", es decir no contienen lógica, solo muestran los datos recibidos.

componente de usuario
 <div class="github-card user-card"> <div class="header User"></div> <a class="avatar" [href]="'https://github.com/'+user.login"> <img [src]="user.avatar_url+'&s=80'" [alt]="user.name" /> </a> <div class="content"> <h1>{{user.name}}</h1> <ul class="status"> <li> <a [href]="'https://github.com/'+user.login+'?tab=repositories'"> <strong>{{user.public_repos}}</strong>Repos </a> </li> <li> <a [href]="'https://gist.github.com/'+user.login"> <strong>{{user.public_gists}}</strong>Gists </a> </li> <li> <a [href]="'https://github.com/'+user.login+'/followers'"> <strong>{{user.followers}}</strong>Followers </a> </li> </ul> </div> </div> 

 import { Component, Input, ChangeDetectionStrategy } from '@angular/core'; import { User } from '../../models/user.model'; @Component({ selector: 'app-user', templateUrl: './user.component.html', styleUrls: ['./user.component.css'], changeDetection: ChangeDetectionStrategy.OnPush }) export class UserComponent { @Input() user: User; } 


componente de error
 <div class="error"> <h2>Oops!</h2> <b> User not found. </b> <p>Please try searching again.</p> </div> 

 import { Component, OnInit, ChangeDetectionStrategy } from '@angular/core'; @Component({ selector: 'app-error', templateUrl: './error.component.html', styleUrls: ['./error.component.css'], changeDetection: ChangeDetectionStrategy.OnPush }) export class ErrorComponent {} 


Ventajas de usar Angular


  • separación de la adquisición de datos de trabajar con ellos,
  • separación de la plantilla de la lógica,
  • Estructura escalable clara y comprensible,
  • módulos incorporados para trabajar con formularios y servidor,
  • RxJs incorporados para operación asincrónica,
  • escritura fuerte; comprobación de errores de compilación.

Código fuente


github
demostración en vivo

Conclusiones


Como se muestra arriba, cualquier aplicación (especialmente una pequeña) se puede escribir usando diferentes bibliotecas, frameworks o JS puro .

Más importante es el conocimiento de las herramientas que utiliza, y la comprensión de cuán adecuadas son en una situación dada.

¡Todo éxito en el aprendizaje y código limpio!

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


All Articles