diff --git a/components/blog-index.js b/components/blog-index.js index 6a5e9b55..fdfb7f6b 100644 --- a/components/blog-index.js +++ b/components/blog-index.js @@ -14,7 +14,7 @@ export default function BlogIndex({ more = "Read more" }) { style={{ color: "inherit", textDecoration: "none" }} className="block font-semibold mt-8 text-2xl " > - {page.meta?.title || page.frontMatter?.title || page.name} + {page.frontMatter?.title || page.meta?.title || page.name}

diff --git a/pages/blog/swr-v1.en-US.mdx b/pages/blog/swr-v1.en-US.mdx index 64689997..2a041e43 100644 --- a/pages/blog/swr-v1.en-US.mdx +++ b/pages/blog/swr-v1.en-US.mdx @@ -1,4 +1,5 @@ --- +title: 'Annoncing SWR 1.0' image: https://assets.vercel.com/image/upload/v1630059453/swr/v1.png description: 'Almost 2 years ago we open sourced SWR, the tiny data-fetching React library that people love. Today we are reaching another milestone: the 1.0 version of SWR.' date: August 27th, 2021 diff --git a/pages/blog/swr-v1.es-ES.mdx b/pages/blog/swr-v1.es-ES.mdx index 2a72913c..a3d39ac0 100644 --- a/pages/blog/swr-v1.es-ES.mdx +++ b/pages/blog/swr-v1.es-ES.mdx @@ -1,4 +1,5 @@ --- +title: 'Announcing SWR 1.0' image: https://assets.vercel.com/image/upload/v1630059453/swr/v1.png description: 'Almost 2 years ago we open sourced SWR, the tiny data-fetching React library that people love. Today we are reaching another milestone: the 1.0 version of SWR.' date: August 27th, 2021 diff --git a/pages/blog/swr-v1.ja.mdx b/pages/blog/swr-v1.ja.mdx index 1faaa9f1..f03a7eed 100644 --- a/pages/blog/swr-v1.ja.mdx +++ b/pages/blog/swr-v1.ja.mdx @@ -1,4 +1,5 @@ --- +title: 'SWR 1.0 の発表' image: https://assets.vercel.com/image/upload/v1630059453/swr/v1.png description: 'ほぼ二年前、みんなが愛する小さなデータフェッチ React ライブラリである SWR をオープンソースにしました。そして本日、私たちは大きな節目を迎えました： SWR の 1.0 バージョンです。' date: August 27th, 2021 diff --git a/pages/blog/swr-v1.ko.mdx b/pages/blog/swr-v1.ko.mdx index 4ff588a5..773c0605 100644 --- a/pages/blog/swr-v1.ko.mdx +++ b/pages/blog/swr-v1.ko.mdx @@ -1,4 +1,5 @@ --- +title: 'SWR 1.0 알림' image: https://assets.vercel.com/image/upload/v1630059453/swr/v1.png description: '약 2년 전에 우리는 사람들이 사랑하는 조그만 데이터 가져오기 React 라이브러리인 SWR을 공개했습니다. 오늘 우리는 SWR 버전 1.0이라는 또 다른 마일스톤에 도달하였습니다.' date: 2021년 8월 27일 diff --git a/pages/blog/swr-v1.pt-BR.mdx b/pages/blog/swr-v1.pt-BR.mdx index b3f43eea..e96d8d70 100644 --- a/pages/blog/swr-v1.pt-BR.mdx +++ b/pages/blog/swr-v1.pt-BR.mdx @@ -1,4 +1,5 @@ --- +title: 'Anunciando SWR 1.0' image: https://assets.vercel.com/image/upload/v1630059453/swr/v1.png description: 'Há quase 2 anos, abrimos o SWR para código aberto, a pequena biblioteca React de data fetching que as pessoas adoram. Hoje estamos alcançando outro marco: a versão 1.0 do SWR.' date: 27 de Agosto de 2021 @@ -9,7 +10,7 @@ import { Bleed } from 'nextra-theme-docs' import Authors, { Author } from 'components/authors' -# Anunciando SWR v1.0 [#announcing-swr-10] +# Anunciando SWR v1.0 [#announcing-swr-10] @@ -18,9 +19,9 @@ import Authors, { Author } from 'components/authors' Quase 2 anos atrás nós liberamos o SWR em [código aberto](https://twitter.com/vercel/status/1188911002626097157), a pequena biblioteca React de data fetching que as pessoas adoram. Hoje estamos atingindo mais um marco: a versão 1.0 do SWR! -## O que há de novo [#whats-new] +## O que há de novo [#whats-new] -### Tamanho Menor [#smaller-size] +### Tamanho Menor [#smaller-size] [Desempenho](/docs/advanced/performance) é um dos recursos mais importantes do SWR. Na versão 1.0, tornamos a biblioteca significativamente menor **sem remover nenhum recurso existente**: @@ -39,7 +40,7 @@ import useSWRInfinite from 'swr/infinite' Se você não estiver usando `useSWRInfinite`, ele não será incluído em sua aplicação. -### Dados de Fallback [#fallback-data] +### Dados de Fallback [#fallback-data] Na versão 1.0, há uma nova opção `fallback` que você pode fornecer qualquer dado pré-buscado como o valor inicial de todos os hooks SWR com chaves específicas: @@ -59,7 +60,7 @@ Isso é muito útil para cenários como SSG, SSR e mockup de dados para teste. V Para melhor consistência e para evitar confusão, o antigo `initialData` agora foi renomeado para `fallbackData`, que ainda fornece um único valor de fallback para o hook fornecido. -### Modo Imutável [#immutable-mode] +### Modo Imutável [#immutable-mode] Às vezes, você deseja marcar um recurso como **imutável** se ele nunca for alterado. É melhor desabilitar as revalidações automáticas para ele e fazer a solicitação apenas uma vez. Agora existe um hook auxiliar para tornar isso mais fácil: @@ -73,7 +74,7 @@ useSWRImmutable(key, fetcher, options) Ele possui exatamente a mesma API que o hook `useSWR`, mas nunca será revalidado no foco da guia ou na recuperação da rede. Há também uma nova opção, `revalidateIfStale`, que você pode usar para controlar o comportamento com precisão. Mais informações podem ser encontradas [aqui](/docs/revalidation#desabilitar-revalidações-automáticas). -### Cache Provider Personalizado [#custom-cache-provider] +### Cache Provider Personalizado [#custom-cache-provider] Por padrão, o SWR usa um único cache global para armazenar todos os dados. Na versão 1.0, você pode personalizá-lo com a nova opção `provider`: @@ -91,7 +92,7 @@ Esta nova API de cache provider também é mais compatível com a renderização Você pode ler a documentação dos [cache providers](/docs/advanced/cache) para obter mais detalhes. -### useSWRConfig() [#useswrconfig] +### useSWRConfig() [#useswrconfig] Há uma nova Hook API para retornar todas as configurações globais, incluindo o cache provider atual e a função global `mutate`: @@ -107,7 +108,7 @@ function Foo () { Mais informações podem ser encontradas [aqui](/docs/global-configuration#acesso-às-configurações-globais). -### Middleware [#middleware] +### Middleware [#middleware] O SWR Middleware fornece uma nova maneira de construir e reutilizar abstrações em cima de hooks SWR: @@ -122,11 +123,11 @@ Muitas ideias novas podem ser implementadas com esse recurso, e criamos alguns e Verifique a [API de middleware](/docs/middleware) para obter mais detalhes. -### Melhorias e Melhor Cobertura de Teste [#improvements-and-better-test-coverage] +### Melhorias e Melhor Cobertura de Teste [#improvements-and-better-test-coverage] Desde 0.x, fizemos centenas de pequenas melhorias e correções de bugs. O SWR agora tem 157 testes que cobrem a maioria dos casos extremos na busca de dados. Leia o [Changelog](https://github.com/vercel/swr/releases) para mais detalhes. -### Traduções de Documentação [#docs-translations] +### Traduções de Documentação [#docs-translations] Graças aos nossos [contribuidores](https://github.com/vercel/swr-site/graphs/contributors) e ao [recurso i18n da Nextra](https://nextra.vercel.app/features/i18n), agora oferecemos Documentação do SWR em seis idiomas diferentes: @@ -137,9 +138,9 @@ Graças aos nossos [contribuidores](https://github.com/vercel/swr-site/graphs/co - [Coreano](https://swr.vercel.app/ko) - [Russo](https://swr.vercel.app/ru) -## Guia de Migração [#migration-guide] +## Guia de Migração [#migration-guide] -### Atualizar imports do `useSWRInfinite` [#update-useswrinfinite-imports] +### Atualizar imports do `useSWRInfinite` [#update-useswrinfinite-imports] `useSWRInfinite` precisa ser importado de `swr/infinite`: @@ -155,7 +156,7 @@ Se você está usand os tipos correspondentes, atualize o caminho de importaçã + import { SWRInfiniteConfiguration, SWRInfiniteResponse } from 'swr/infinite' ``` -## Mude `revalidate` para `mutate` [#change-revalidate-to-mutate] +## Mude `revalidate` para `mutate` [#change-revalidate-to-mutate] `useSWR` não mais retorna o método `revalidate`, mude para `mutate`: @@ -171,14 +172,14 @@ Se você está usand os tipos correspondentes, atualize o caminho de importaçã + mutate() ``` -### Renomeie `initialData` para `fallbackData` [#rename-initialdata-to-fallbackdata] +### Renomeie `initialData` para `fallbackData` [#rename-initialdata-to-fallbackdata] ```diff - useSWR(key, fetcher, { initialData: ... }) + useSWR(key, fetcher, { fallbackData: ... }) ``` -### Não Há Mais Fetcher Padrão [#no-more-default-fetcher] +### Não Há Mais Fetcher Padrão [#no-more-default-fetcher] O SWR não fornece mais o fetcher padrão (uma chamada `fetch` que analisa os dados como JSON). A maneira mais fácil de migrar a alteração é usar o componente ``: @@ -191,7 +192,7 @@ O SWR não fornece mais o fetcher padrão (uma chamada `fetch` que analisa os da useSWR(key, (url) => fetch(url).then(res => res.json())) ``` -### Recomenda-se usar o `mutate` retornado pelo hook [#recommend-to-use-the-hook-returned-mutate] +### Recomenda-se usar o `mutate` retornado pelo hook [#recommend-to-use-the-hook-returned-mutate] Esta **não** é uma mudança importante, mas agora _recomendaremos_ usar sempre o `mutate` retornado do hook `useSWRConfig`: @@ -211,7 +212,7 @@ Esta **não** é uma mudança importante, mas agora _recomendaremos_ usar sempre Se você não estiver usando um cache provider, a importação global atual `import { mutate } from 'swr'` ainda funciona. -### Tipos Renomeados [#renamed-types] +### Tipos Renomeados [#renamed-types] Se você está usando TypeScript, os seguintes nomes de tipo foram alterados para consistência: @@ -225,7 +226,7 @@ Se você está usando TypeScript, os seguintes nomes de tipo foram alterados par | `SWRInfiniteResponseInterface` | `SWRInfiniteResponse` | mudado para `swr/infinite` | | `SWRInfiniteConfigInterface` | `SWRInfiniteConfiguration` | mudado para `swr/infinite` | -### Usuários de Recursos Beta e Não Oficiais [#beta-and-unofficial-feature-users] +### Usuários de Recursos Beta e Não Oficiais [#beta-and-unofficial-feature-users] Se você estiver usando uma versão beta do SWR ou qualquer API não documentada, esteja ciente das seguintes alterações: @@ -234,17 +235,17 @@ Se você estiver usando uma versão beta do SWR ou qualquer API não documentada - `revalidateWhenStale` foi renomeado para `revalidateIfStale`. - `middlewares` foi renomeado para `use`. -### Changelog [#changelog] +### Changelog [#changelog] Leia o Changelog completo no [GitHub](https://github.com/vercel/swr/releases). -## Qual é o Próximo Passo [#whats-next] +## Qual é o Próximo Passo [#whats-next] Em versões futuras, continuaremos melhorando a biblioteca, mantendo a estabilidade. Também pretendemos adotar futuras versões do React, já que vários novos recursos e melhorias na versão 1.0 já estão se preparando para isso. Além disso, também estamos trabalhando em novos recursos para melhorar a experiência de busca de dados no React e a experiência de uso desta biblioteca. Se você tiver algum feedback sobre esta versão, por favor [nos avise](https://github.com/vercel/swr/discussions). -## Agradecimentos [#thank-you] +## Agradecimentos [#thank-you] Agradecimentos especiais a [Toru Kobayashi](https://twitter.com/koba04) e [Yixuan Xu](https://twitter.com/yixuanxu94) por suas contribuições para a biblioteca, e [Paco Coursey](https://twitter.com/pacocoursey), [uttk](https://github.com/uttk), [Tomohiro SHIOYA](https://github.com/shioyang), [Markoz Peña](https://github.com/markozxuu), [SeulGi Choi](https://github.com/cs09g), [Fang Lu](https://github.com/huzhengen), [Valentin Politov](https://github.com/valentinpolitov) por seu trabalho nas traduções e documentos. Este lançamento não pode acontecer sem eles. diff --git a/pages/blog/swr-v1.ru.mdx b/pages/blog/swr-v1.ru.mdx index e4f06fcf..d6665040 100644 --- a/pages/blog/swr-v1.ru.mdx +++ b/pages/blog/swr-v1.ru.mdx @@ -1,4 +1,5 @@ --- +title: 'Представляем SWR 1.0' image: https://assets.vercel.com/image/upload/v1630059453/swr/v1.png description: 'Почти 2 года назад мы сделали SWR — крошечную React библиотеку с открытым исходным кодом для выборки данных, которую люди полюбили. Сегодня мы приближаемся к еще одной вехе: версии 1.0 SWR!' date: 27 августа 2021 г. diff --git a/pages/blog/swr-v1.zh-CN.mdx b/pages/blog/swr-v1.zh-CN.mdx index 9c2ec1e9..facf791b 100644 --- a/pages/blog/swr-v1.zh-CN.mdx +++ b/pages/blog/swr-v1.zh-CN.mdx @@ -1,4 +1,5 @@ --- +title: 'SWR 1.0 发布' image: https://assets.vercel.com/image/upload/v1630059453/swr/v1.png description: '大约两年前，我们开源了 SWR——广受大家喜爱的小巧 React 数据请求库。今天，我们迎来了另一个里程碑：SWR 1.0 版本发布了！' date: August 27th, 2021 diff --git a/pages/blog/swr-v2.en-US.mdx b/pages/blog/swr-v2.en-US.mdx index a6567a04..0f763076 100644 --- a/pages/blog/swr-v2.en-US.mdx +++ b/pages/blog/swr-v2.en-US.mdx @@ -1,4 +1,5 @@ --- +title: 'Announcing SWR 2.0' image: https://assets.vercel.com/image/upload/v1670542323/swr/v2.png description: 'Announcing SWR 2.0: new mutation APIs and improved optimistic UI capabilities, new DevTools, better support for concurrent rendering, and more.' date: December 9th, 2022 diff --git a/pages/blog/swr-v2.es-ES.mdx b/pages/blog/swr-v2.es-ES.mdx index a6567a04..0f763076 100644 --- a/pages/blog/swr-v2.es-ES.mdx +++ b/pages/blog/swr-v2.es-ES.mdx @@ -1,4 +1,5 @@ --- +title: 'Announcing SWR 2.0' image: https://assets.vercel.com/image/upload/v1670542323/swr/v2.png description: 'Announcing SWR 2.0: new mutation APIs and improved optimistic UI capabilities, new DevTools, better support for concurrent rendering, and more.' date: December 9th, 2022 diff --git a/pages/blog/swr-v2.ja.mdx b/pages/blog/swr-v2.ja.mdx index 96ddd4e0..1fc97054 100644 --- a/pages/blog/swr-v2.ja.mdx +++ b/pages/blog/swr-v2.ja.mdx @@ -1,4 +1,5 @@ --- +title: 'SWR 2.0 の発表' image: https://assets.vercel.com/image/upload/v1670542323/swr/v2.png description: '本日、SWR 2.0 のリリースを発表できることに興奮しています！新しいバージョンには、新しいミューテーション API や楽観的更新パターンに対する改善、DevTools、React の並行処理機能のサポートといった多くの改善と新しい機能が含まれています。' date: December 9th, 2022 diff --git a/pages/blog/swr-v2.ko.mdx b/pages/blog/swr-v2.ko.mdx index a6567a04..9c192d73 100644 --- a/pages/blog/swr-v2.ko.mdx +++ b/pages/blog/swr-v2.ko.mdx @@ -1,4 +1,5 @@ --- +title: 'SWR 2.0 발표' image: https://assets.vercel.com/image/upload/v1670542323/swr/v2.png description: 'Announcing SWR 2.0: new mutation APIs and improved optimistic UI capabilities, new DevTools, better support for concurrent rendering, and more.' date: December 9th, 2022 diff --git a/pages/blog/swr-v2.pt-BR.mdx b/pages/blog/swr-v2.pt-BR.mdx index 3a76e53f..a77b1dbc 100644 --- a/pages/blog/swr-v2.pt-BR.mdx +++ b/pages/blog/swr-v2.pt-BR.mdx @@ -1,4 +1,5 @@ --- +title: 'Anunciando SWR 2.0' image: https://assets.vercel.com/image/upload/v1670542323/swr/v2.png description: "Anunciando SWR 2.0: Novas APIs de mutação e melhorias nas capacidades de UI otimista, novas ferramentas de desenvolvedor, melhor suporte para renderização concorrente e muito mais." date: December 9th, 2022 diff --git a/pages/blog/swr-v2.ru.mdx b/pages/blog/swr-v2.ru.mdx index e651fcf8..6fac6c9e 100644 --- a/pages/blog/swr-v2.ru.mdx +++ b/pages/blog/swr-v2.ru.mdx @@ -1,4 +1,5 @@ --- +title: 'Представляем SWR 2.0' image: https://assets.vercel.com/image/upload/v1670542323/swr/v2.png description: 'Представляем SWR 2.0: новые API-интерфейсы мутации и улучшения сценариев оптимистичного UI, новые инструменты разработчика, улучшенную поддержку одновременного рендеринга и многое другое.' date: 9 декабря 2022 г. diff --git a/pages/blog/swr-v2.zh-CN.mdx b/pages/blog/swr-v2.zh-CN.mdx index c8305f7a..6e43c7cd 100644 --- a/pages/blog/swr-v2.zh-CN.mdx +++ b/pages/blog/swr-v2.zh-CN.mdx @@ -1,4 +1,5 @@ --- +title: 'SWR 2.0 发布' image: https://assets.vercel.com/image/upload/v1670542323/swr/v2.png description: 'SWR 2.0 发布：新的数据更改 API、经过优化的乐观 UI 功能、新的 DevTools、以及对并发渲染的更好支持，以及更多功能。' date: December 9th, 2022 diff --git a/pages/docs/_meta.fr-FR.json b/pages/docs/_meta.fr-FR.json index 7afd4e1a..8803821e 100644 --- a/pages/docs/_meta.fr-FR.json +++ b/pages/docs/_meta.fr-FR.json @@ -7,11 +7,11 @@ "arguments": "Arguments", "mutation": "Mutation & Revalidation", "error-handling": "Gestion des erreurs", - "conditional-fetching": "Récupération de données Conditionnelle", + "conditional-fetching": "Récupération des données Conditionnelle", "pagination": "Pagination", "subscription": "Abonnement", "prefetching": "Préchargement des données", - "with-nextjs": "Utilisation avec Next.js", + "with-nextjs": "Next.js SSG et SSR", "typescript": "TypeScript", "suspense": "Suspense", "middleware": "Middleware", diff --git a/pages/docs/api.fr-FR.mdx b/pages/docs/api.fr-FR.mdx index 483d2949..517d4aad 100644 --- a/pages/docs/api.fr-FR.mdx +++ b/pages/docs/api.fr-FR.mdx @@ -27,7 +27,7 @@ Plus d'informations [ici](/docs/advanced/understanding). - `suspende = false`: activer le mode React Suspense [(détails)](/docs/suspense) - `fetcher(args)`: la fonction fetcher - `revalidateIfStale = true`: revalider automatiquement même s'il y a des données obsolètes [(détails)](/docs/revalidation#disable-automatic-revalidations) -- `revalidateOnMount`: activer ou désactiver la revalidation automatique lorsque le composant est monté +- `revalidateOnMount`: activer ou désactiver la revalidation automatique lorsque le composant est monté [(détails)](/docs/revalidation#revalidate-on-mount) - `revalidateOnFocus = true`: revalider automatiquement lorsque la fenêtre est mise au premier plan [(détails)](/docs/revalidation) - `revalidateOnReconnect = true`: revalider automatiquement lorsque le navigateur retrouve une connexion réseau (via `navigator.onLine`) [(détails)](/docs/revalidation) - `refreshInterval` [(détails)](/docs/revalidation): diff --git a/pages/docs/prefetching.fr-FR.mdx b/pages/docs/prefetching.fr-FR.mdx index e1a2febb..bd409aca 100644 --- a/pages/docs/prefetching.fr-FR.mdx +++ b/pages/docs/prefetching.fr-FR.mdx @@ -96,7 +96,7 @@ const Page = () => { } ``` -## Données prérenplie [#pre-fill-data] +## Données préremplie [#pre-fill-data] Si vous souhaitez préremplir des données existantes dans le cache SWR, vous pouvez utiliser l'option `fallbackData`. Par exemple : diff --git a/pages/docs/revalidation.fr-FR.mdx b/pages/docs/revalidation.fr-FR.mdx index c847974b..a1849a68 100644 --- a/pages/docs/revalidation.fr-FR.mdx +++ b/pages/docs/revalidation.fr-FR.mdx @@ -86,3 +86,15 @@ useSWRImmutable(key, fetcher) `revalidateIfStale` contrôle si SWR doit revalider lorsqu'il est monté et qu'il y a des données obsolètes. Ces 2 hooks ci-dessus font **exactement la même chose**. Une fois que les données sont mises en cache, elles ne les demanderont plus jamais. + +## Revalidation sur le Montage[#revalidate-on-mount] + +Il est utile de forcer la revalidation de SWR lors le composant est monté. Par défaut, la valeur de `revalidateOnMount` est définie sur undefined. + +Un hook SWR se monte comme suit : + +- Premièrement, il vérifie si `revalidateOnMount` est défini. Il démarre la requête si c'est vrai, s'arrête si c'est faux. + +`revalidateIfStale` est utile pour contrôler le comportement de montage. Par défaut, `revalidateIfStale` est défini sur true. + +Si `revalidateIfStale` est défini sur true, il ne récupère les données que si il y a des données en cache, sini il ne récupère pas les données. \ No newline at end of file diff --git a/translations/text.js b/translations/text.js index 6d22b6e8..79d6ad3a 100644 --- a/translations/text.js +++ b/translations/text.js @@ -42,7 +42,8 @@ export const featuresMap = { "fr-FR": { lightweight: "Léger", realtime: "Temps réel", - backendAgnostic: "Indépendant du Backend", + backendAgnostic: "Backend Indépendant", + remoteLocal: "Distant + Locale" }, "pt-BR": { lightweight: "Leve", @@ -78,7 +79,7 @@ export const headDescriptionMap = { export const feedbackLinkMap = { "en-US": "Question? Give us feedback →", "es-ES": "¿Dudas? Danos tu feedback →", - "fr-FR": "Question? Donnez-nous votre avis →", + "fr-FR": "Question? Donnez-nous des retours →", "pt-BR": "Dúvidas? Nos dê feedback →", "zh-CN": "有疑问？给我们反馈 →", ko: "질문이 있으신가요? 피드백을 남겨주세요 →",