Como usar uma caixa de listagem em uma aplicação NativeScript?

Dec 02, 2025Deixe um recado

Ei! Como fornecedor de list box, estou muito feliz em compartilhar com vocês como usar uma list box em um aplicativo NativeScript. NativeScript é uma estrutura incrível que permite criar aplicativos móveis multiplataforma usando JavaScript, TypeScript ou Angular. E as caixas de listagem são uma parte fundamental de muitos aplicativos, ajudando os usuários a selecionar itens em um conjunto de opções. Vamos mergulhar de cabeça!

Configurando seu projeto NativeScript

Em primeiro lugar, você precisa ter um projeto NativeScript instalado e funcionando. Se você ainda não instalou o NativeScript, pode fazê-lo via npm. Basta abrir seu terminal e executar:

npm instalar -g script nativo

Depois de instalado, crie um novo projeto NativeScript. Você pode usar o seguinte comando:

tns criar MyListBoxApp --template tns-template-blank-ts cd MyListBoxApp

Isso cria um novo aplicativo NativeScript baseado em TypeScript chamadoMyListBoxAppe então navega até o diretório do projeto.

Adicionando uma caixa de listagem ao seu aplicativo

Agora, vamos adicionar uma caixa de listagem ao nosso aplicativo. No NativeScript, você pode usar oVisualização de listacomponente, que é bastante semelhante a uma caixa de listagem. Abra oapp.component.htmlarquivo em seu projeto. Substitua o conteúdo existente pelo seguinte código:

<Page xmlns="http://schemas.nativescript.org/tns.xsd"> <StackLayout> <ListView [items]="listItems"> <ng-template let-item="item"> <Label [text]="item"></Label> </ng-template> </ListView> </StackLayout> </Page>

Neste código, adicionamos umVisualização de listadentro de umStackLayout. OVisualização de listaestá vinculado a um array chamadolistaItensque definiremos no arquivo TypeScript. Ode - modeloé usado para definir como cada item da lista deve ser exibido. Neste caso, estamos apenas mostrando o item como texto em umRótulo.

A seguir, abra oapp.component.tsarquivo e adicione o seguinte código:

importar {Componente} de "@angular/core"; @Component({ selector: "ns - app", templateUrl: "./app.component.html" }) export class AppComponent { public listItems = ["Item 1", "Item 2", "Item 3", "Item 4"]; }

Aqui, definimos olistaItensarray com alguns itens de amostra. Agora, se você executar seu aplicativo usandotns executa o Androidoutns execute ios, você deverá ver uma lista desses quatro itens na tela.

Tratamento da seleção de itens

Uma das coisas mais importantes sobre uma caixa de listagem é ser capaz de lidar com a seleção de itens. No NativeScript, você pode fazer isso adicionando um ouvinte de evento aoVisualização de lista. Modifique oapp.component.htmlarquivo da seguinte forma:

<Page xmlns="http://schemas.nativescript.org/tns.xsd"> <StackLayout> <ListView [items]="listItems" (itemTap)="onItemTap($event)"> <ng-template let-item="item"> <Label [text]="item"></Label> </ng-template> </ListView> </StackLayout> </Página>

Adicionamos umitemTapevento para oVisualização de listae vinculá-lo a um método chamadoonItemTap. Agora, atualize oapp.component.tsarquivo:

importar {Componente} de "@angular/core"; importar { ItemEventData } de "tns - core - módulos/ui/list - view"; @Component({ selector: "ns - app", templateUrl: "./app.component.html" }) export class AppComponent { public listItems = ["Item 1", "Item 2", "Item 3", "Item 4"]; onItemTap(args: ItemEventData) { const item selecionado = this.listItems[args.index]; console.log(`Você selecionou: ${selectedItem}`); } }

NoonItemTapmétodo, estamos obtendo o índice do item tocado doargumentosobjeto e, em seguida, usar esse índice para obter o item selecionado dolistaItensvariedade. Também estamos registrando o item selecionado no console.

Personalizando a caixa de listagem

Você pode personalizar a aparência da sua caixa de listagem de várias maneiras. Por exemplo, você pode alterar a cor de fundo, o tamanho da fonte e muito mais. Vamos alterar a cor de fundo de cada item da lista. Atualize oapp.component.htmlarquivo:

<Page xmlns="http://schemas.nativescript.org/tns.xsd"> <StackLayout> <ListView [items]="listItems" (itemTap)="onItemTap($event)"> <ng-template let-item="item"> <Label [text]="item" backgroundColor="lightblue"></Label> </ng-template> </ListView> </StackLayout> </Page>

Agora, cada item da lista terá um fundo azul claro. Você também pode usar CSS para estilizar sua caixa de listagem. Crie um novo arquivo chamadoapp.component.cssno mesmo diretório do seuapp.component.htmleapp.component.tsarquivos. Adicione o seguinte código:

ListView { fonte - tamanho: 20; } Rótulo { preenchimento: 10; }

Então, noapp.component.tsarquivo, adicione a seguinte linha dentro do@Componentedecorador:

styleUrls: ["./app.component.css"]

Isso aplicará os estilos CSS à sua caixa de listagem.

Usando dados do mundo real

Em um cenário do mundo real, você provavelmente desejará preencher sua caixa de listagem com dados de uma API ou banco de dados. Vamos supor que temos uma API que retorna um array de itens. Podemos usar oHttpClientemódulo em Angular para fazer uma solicitação HTTP. Primeiro, importe os módulos necessários noapp.component.tsarquivo:

importar {Componente} de "@angular/core"; importar { ItemEventData } de "tns - core - módulos/ui/list - view"; importar {HttpClient} de "@angular/common/http"; @Component({ selector: "ns - app", templateUrl: "./app.component.html", styleUrls: ["./app.component.css"] }) export class AppComponent { public listItems = []; construtor (http privado: HttpClient) { this.fetchData(); } fetchData() { this.http.get<any[]>("https://api.example.com/items").subscribe( (data) => { this.listItems = data; }, (error) => { console.error("Erro ao buscar dados:", erro); } ); } onItemTap(args: ItemEventData) { const item selecionado = this.listItems[args.index]; console.log(`Você selecionou: ${selectedItem}`); } }

Neste código, estamos usando oHttpClientepara fazer uma solicitação GET para uma API. Quando os dados são buscados com sucesso, nós os atribuímos aolistaItensvariedade.

Adicionando links para produtos relevantes

Como fornecedor de list box, também quero mencionar alguns dos produtos que minha empresa oferece. Você pode conferir nossoImpulsor 1,Caixa de água ultrassônica, eCorpo do tuboem nosso site. Esses produtos são de alta qualidade e podem ser um ótimo complemento para seus projetos.

03570061

Conclusão e apelo à ação

Então, aí está! É assim que você pode usar uma caixa de listagem em um aplicativo NativeScript. Esteja você criando um aplicativo de lista de tarefas simples ou um aplicativo de comércio eletrônico complexo, as caixas de listagem são uma ferramenta poderosa. Se você estiver interessado em adquirir nossas caixas de listagem para seus projetos, sinta-se à vontade para entrar em contato para uma discussão sobre compras. Estamos aqui para ajudá-lo a encontrar as melhores soluções para suas necessidades.

Referências

  • Documentação NativeScript
  • Documentação Angular
  • Documentação TypeScript