Notice: This page requires JavaScript to function properly.
Please enable JavaScript in your browser settings or update your browser.
Aprenda Trabalhando com Parâmetros de Consulta | Recursos Avançados do React Router
Essenciais do React Router

bookTrabalhando com Parâmetros de Consulta

O useSearchParams é um hook que fornece acesso aos parâmetros de consulta (parâmetros de busca) da URL atual. Parâmetros de consulta são pares chave-valor que aparecem após o ponto de interrogação (?) em uma URL. Por exemplo, na URL http://example.com/products?category=electronics&page=2, os parâmetros de consulta são category=electronics e page=2.

O que o useSearchParams retorna?

O hook useSearchParams retorna um array com dois elementos: um objeto que representa os parâmetros de consulta atuais e uma função para atualizar esses parâmetros. Veja como utilizar o hook:

import { useSearchParams } from "react-router-dom";

function MyComponent() {
  const [searchParams, setSearchParams] = useSearchParams();

  // `searchParams` is an object representing the current query parameters
  // `setSearchParams` is a function to update the query parameters
}

O objeto searchParams

O objeto searchParams é uma instância da classe URLSearchParams. Ele fornece métodos convenientes para interagir com parâmetros de consulta, tais como:

  • get(key): Recupera o valor associado a uma chave específica;
  • getAll(key): Recupera todos os valores associados a uma chave específica;
  • set(key, value): Define ou atualiza o valor de uma chave específica;
  • append(key, value): Adiciona um novo valor a uma chave existente;
  • delete(key): Remove uma chave específica e seu valor associado;
  • toString(): Retorna os parâmetros de consulta como uma string (por exemplo, "?category=electronics&page=2").

A função setSearchParams

A função setSearchParams permite atualizar os parâmetros de consulta na URL. É possível passar um objeto com pares chave-valor para definir novos parâmetros ou modificar os existentes. Veja um exemplo de como utilizá-la:

// Suppose the current URL is `http://example.com/products?category=electronics&page=2`

setSearchParams({ category: "clothing", color: "blue" });

// The URL is now `http://example.com/products?category=clothing&color=blue`

Tudo estava claro?

Como podemos melhorá-lo?

Obrigado pelo seu feedback!

Seção 3. Capítulo 5

Pergunte à IA

expand

Pergunte à IA

ChatGPT

Pergunte o que quiser ou experimente uma das perguntas sugeridas para iniciar nosso bate-papo

Suggested prompts:

Can you explain how to read a specific query parameter using useSearchParams?

How do I update or add a new query parameter with setSearchParams?

What happens to the existing parameters when I use setSearchParams?

Awesome!

Completion rate improved to 4.17

bookTrabalhando com Parâmetros de Consulta

Deslize para mostrar o menu

O useSearchParams é um hook que fornece acesso aos parâmetros de consulta (parâmetros de busca) da URL atual. Parâmetros de consulta são pares chave-valor que aparecem após o ponto de interrogação (?) em uma URL. Por exemplo, na URL http://example.com/products?category=electronics&page=2, os parâmetros de consulta são category=electronics e page=2.

O que o useSearchParams retorna?

O hook useSearchParams retorna um array com dois elementos: um objeto que representa os parâmetros de consulta atuais e uma função para atualizar esses parâmetros. Veja como utilizar o hook:

import { useSearchParams } from "react-router-dom";

function MyComponent() {
  const [searchParams, setSearchParams] = useSearchParams();

  // `searchParams` is an object representing the current query parameters
  // `setSearchParams` is a function to update the query parameters
}

O objeto searchParams

O objeto searchParams é uma instância da classe URLSearchParams. Ele fornece métodos convenientes para interagir com parâmetros de consulta, tais como:

  • get(key): Recupera o valor associado a uma chave específica;
  • getAll(key): Recupera todos os valores associados a uma chave específica;
  • set(key, value): Define ou atualiza o valor de uma chave específica;
  • append(key, value): Adiciona um novo valor a uma chave existente;
  • delete(key): Remove uma chave específica e seu valor associado;
  • toString(): Retorna os parâmetros de consulta como uma string (por exemplo, "?category=electronics&page=2").

A função setSearchParams

A função setSearchParams permite atualizar os parâmetros de consulta na URL. É possível passar um objeto com pares chave-valor para definir novos parâmetros ou modificar os existentes. Veja um exemplo de como utilizá-la:

// Suppose the current URL is `http://example.com/products?category=electronics&page=2`

setSearchParams({ category: "clothing", color: "blue" });

// The URL is now `http://example.com/products?category=clothing&color=blue`

Tudo estava claro?

Como podemos melhorá-lo?

Obrigado pelo seu feedback!

Seção 3. Capítulo 5
some-alt