From 5a9c852c41acc118a5f3cc2dd0bf53094e0cfedb Mon Sep 17 00:00:00 2001 From: Willian Silva Date: Wed, 23 Sep 2020 15:04:27 -0300 Subject: [PATCH 1/2] docs: Translate file 'guide/component-edge-cases' --- src/guide/component-edge-cases.md | 30 +++++++++++++++--------------- 1 file changed, 15 insertions(+), 15 deletions(-) diff --git a/src/guide/component-edge-cases.md b/src/guide/component-edge-cases.md index 969227fc21..79560a8ce4 100644 --- a/src/guide/component-edge-cases.md +++ b/src/guide/component-edge-cases.md @@ -1,36 +1,36 @@ -# Handling Edge Cases +# Tratamento de casos extremos -> This page assumes you've already read the [Components Basics](components.md). Read that first if you are new to components. +> Essa página pressupõe que você leu os [Componentes Básicos](component-basics.md). Leia isso primeiro se você for novo em componentes. -:::tip Note -All the features on this page document the handling of edge cases, meaning unusual situations that sometimes require bending Vue's rules a little. Note however, that they all have disadvantages or situations where they could be dangerous. These are noted in each case, so keep them in mind when deciding to use each feature. +:::tip Nota +Todos os recursos dessa página documentam o tratamento de casos extremos, ou seja, situações incomuns que às vezes exigem que as regras do Vue sejam um pouco distorcidas. Observe, entretanto, que todos eles têm desvantagens ou situações onde podem ser perigosos. Eles são notados em cada caso, então lembre-se deles ao decidir usar cada recurso. ::: -## Controlling Updates +## Controle de Atualizações -Thanks to Vue's Reactivity system, it always knows when to update (if you use it correctly). There are edge cases, however, when you might want to force an update, despite the fact that no reactive data has changed. Then there are other cases when you might want to prevent unnecessary updates. +Graças ao sistema de reatividade do Vue, ele sempre sabe quando atualizar (se você usá-lo corretamente). No entanto, há casos extremos onde você talvez queira forçar uma atualização, apesar do fato de que nenhum dado reativo foi alterado. Também há casos onde você talvez queira prevenir atualizações desnecessárias. -### Forcing an Update +### Forçando uma Atualização -If you find yourself needing to force an update in Vue, in 99.99% of cases, you've made a mistake somewhere. For example, you may be relying on state that isn't tracked by Vue's reactivity system, e.g. with `data` property added after component creation. +Se você precisar forçar uma atualização no Vue, em 99.99% dos casos, você cometeu um erro em algum lugar. Por exemplo, você pode estar contando com um estado que não é monitorado pelo sistema de reatividade do Vue, por exemplo, com a propriedade `data` adicionada após a criação do componente. -However, if you've ruled out the above and find yourself in this extremely rare situation of having to manually force an update, you can do so with [`$forceUpdate`](../api/instance-methods.html#forceupdate). +No entanto, se você descartou as opções acima e se encontra nessa situação extremamente rara de ter que forçar manualmente uma atualização, você pode fazer isso com [`$forceUpdate`](../api/instance-methods.html#forceupdate). -### Cheap Static Components with `v-once` +### Componentes estáticos baratos com `v-once` -Rendering plain HTML elements is very fast in Vue, but sometimes you might have a component that contains **a lot** of static content. In these cases, you can ensure that it's only evaluated once and then cached by adding the `v-once` directive to the root element, like this: +Renderizar elementos HTML simples é muito rápido no Vue, mas às vezes você pode ter um componente que contém **muito** conteúdo estático. Nesses casos, você pode garantir que ele seja avaliado somente uma vez e então armazená-lo em cache adicionando a diretiva `v-once` ao elemento raiz, como este: -``` js +```js app.component('terms-of-service', { template: `

Terms of Service

- ... a lot of static content ... + ... muito conteúdo estático ...
- ` + `, }) ``` :::tip -Once again, try not to overuse this pattern. While convenient in those rare cases when you have to render a lot of static content, it's simply not necessary unless you actually notice slow rendering - plus, it could cause a lot of confusion later. For example, imagine another developer who's not familiar with `v-once` or simply misses it in the template. They might spend hours trying to figure out why the template isn't updating correctly. +Mais uma vez, tente não abusar desse padrão. Embora seja conveniente nos raros casos em que você precisa renderizar muito conteúdo estático, isso simplesmente não é necessário, a menos que você realmente observe uma renderização lenta - além disso, pode causar muita confusão posteriormente. Por exemplo, imagine outro desenvolvedor que não está familiarizado com o `v-once` ou simplesmente não o veja no template. Eles podem passar horas tentando descobrir porque o template não está sendo atualizado corretamente. ::: From 1a2363f4b4098569c974603e153bb126b86d1300 Mon Sep 17 00:00:00 2001 From: Erick Eduardo Petrucelli Date: Thu, 24 Sep 2020 13:53:30 -0300 Subject: [PATCH 2/2] Changes to keep good standards established on V2 --- src/guide/component-edge-cases.md | 26 +++++++++++++------------- 1 file changed, 13 insertions(+), 13 deletions(-) diff --git a/src/guide/component-edge-cases.md b/src/guide/component-edge-cases.md index 79560a8ce4..cf95ac436c 100644 --- a/src/guide/component-edge-cases.md +++ b/src/guide/component-edge-cases.md @@ -1,36 +1,36 @@ -# Tratamento de casos extremos +# Lidando com Casos Extremos -> Essa página pressupõe que você leu os [Componentes Básicos](component-basics.md). Leia isso primeiro se você for novo em componentes. +> Esta página assume que você já leu o [Básico sobre Componentes](component-basics.md). Leia lá primeiro se o desenvolvimento de componentes for novidade para você. -:::tip Nota -Todos os recursos dessa página documentam o tratamento de casos extremos, ou seja, situações incomuns que às vezes exigem que as regras do Vue sejam um pouco distorcidas. Observe, entretanto, que todos eles têm desvantagens ou situações onde podem ser perigosos. Eles são notados em cada caso, então lembre-se deles ao decidir usar cada recurso. +::: tip NOTA +Todos os recursos dessa página documentam o tratamento de casos extremos, ou seja, situações incomuns que às vezes exigem que as regras do Vue sejam levemente contornadas. Observe, entretanto, que todos eles têm desvantagens ou situações onde podem ser perigosos. Estes detalhes são expostos em cada caso, portanto, lembre-se ao decidir usar cada recurso. ::: -## Controle de Atualizações +## Controlando Atualizações -Graças ao sistema de reatividade do Vue, ele sempre sabe quando atualizar (se você usá-lo corretamente). No entanto, há casos extremos onde você talvez queira forçar uma atualização, apesar do fato de que nenhum dado reativo foi alterado. Também há casos onde você talvez queira prevenir atualizações desnecessárias. +Graças ao sistema de reatividade do Vue, ele sempre sabe quando atualizar a interface (se você usá-lo corretamente). Porém, há casos incomuns em que possa querer forçar uma atualização, mesmo que nenhum dado reativo tenha mudado. Também há casos em que possa querer prevenir atualizações desnecessárias. ### Forçando uma Atualização -Se você precisar forçar uma atualização no Vue, em 99.99% dos casos, você cometeu um erro em algum lugar. Por exemplo, você pode estar contando com um estado que não é monitorado pelo sistema de reatividade do Vue, por exemplo, com a propriedade `data` adicionada após a criação do componente. +Se você precisar forçar uma atualização no Vue, em 99,99% dos casos você cometeu um erro em algum lugar. Por exemplo, você pode estar contando com um estado que não é monitorado pelo sistema de reatividade do Vue, por exemplo, contando com uma propriedade `data` adicionada após a criação do componente. -No entanto, se você descartou as opções acima e se encontra nessa situação extremamente rara de ter que forçar manualmente uma atualização, você pode fazer isso com [`$forceUpdate`](../api/instance-methods.html#forceupdate). +No entanto, se você descartou a opção acima e se encontra nessa situação extremamente rara de ter que forçar manualmente uma atualização, você pode fazer isso com [`$forceUpdate`](../api/instance-methods.html#forceupdate). -### Componentes estáticos baratos com `v-once` +### Componentes Estáticos Econômicos com `v-once` -Renderizar elementos HTML simples é muito rápido no Vue, mas às vezes você pode ter um componente que contém **muito** conteúdo estático. Nesses casos, você pode garantir que ele seja avaliado somente uma vez e então armazená-lo em cache adicionando a diretiva `v-once` ao elemento raiz, como este: +Renderizar elementos HTML puros é algo bem rápido no Vue mas, algumas vezes, você pode ter um componente que possui **uma grande quantidade** de conteúdo estático. Nesses casos, você pode garantir que ele seja avaliado somente uma vez e então armazenado em cache, adicionando a diretiva `v-once` ao elemento raiz, como mostrado abaixo: ```js app.component('terms-of-service', { template: `
-

Terms of Service

+

Termos de serviço

... muito conteúdo estático ...
`, }) ``` -:::tip -Mais uma vez, tente não abusar desse padrão. Embora seja conveniente nos raros casos em que você precisa renderizar muito conteúdo estático, isso simplesmente não é necessário, a menos que você realmente observe uma renderização lenta - além disso, pode causar muita confusão posteriormente. Por exemplo, imagine outro desenvolvedor que não está familiarizado com o `v-once` ou simplesmente não o veja no template. Eles podem passar horas tentando descobrir porque o template não está sendo atualizado corretamente. +::: tip DICA +Como de costume, tente não abusar deste padrão. Embora seja conveniente nos raros casos em que você precisar renderizar muito conteúdo estático, isso simplesmente não é necessário a menos que você realmente observe uma renderização lenta - além disso, pode causar muita confusão posteriormente. Por exemplo, imagine outro desenvolvedor que não está familiarizado com o `v-once` ou simplesmente não o notou no _template_. Ele pode vir a perder horas tentando entender o porquê de o _template_ não estar sendo atualizado. :::