Skip to content

Commit

Permalink
Merge branch 'main' into pt-br-learn-forms-your_first_form-fix-img-link
Browse files Browse the repository at this point in the history
  • Loading branch information
Snoopy1866 authored Jan 5, 2025
2 parents e395a1e + c2e2d17 commit ee5708d
Show file tree
Hide file tree
Showing 171 changed files with 12,813 additions and 5,939 deletions.
2 changes: 1 addition & 1 deletion docs/ru/README.md
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
# Участие в переводе

Для начала ознакомьтесь с [правилами внесения изменений в MDN][https://github.com/mdn/translated-content/blob/main/CONTRIBUTING.md], [информацией о переводе документов MDN](https://github.com/mdn/translated-content/blob/main/docs/README.md) и [Руководством по составлению документации](/ru/docs/MDN/Guidelines).
Для начала ознакомьтесь с [правилами внесения изменений в MDN](https://github.com/mdn/translated-content/blob/main/CONTRIBUTING.md), [информацией о переводе документов MDN](https://github.com/mdn/translated-content/blob/main/docs/README.md) и [руководствами по составлению документации](/ru/docs/MDN/Writing_guidelines).

## Использование ссылок

Expand Down
26 changes: 13 additions & 13 deletions docs/zh-cn/glossary.md
Original file line number Diff line number Diff line change
Expand Up @@ -42,19 +42,19 @@

### JavaScript

| 英文词汇 | 翻译 | 备注 | 引用来源 |
| ------------------ | ---------------- | ---------------------------------------------------------------------------------------- | --------------------------------------------------------------------------- |
| bare module | 裸模块 | Vite.js 官方将其翻译为“裸模块”,其意为“没有任何路径的模块”。 | https://github.com/mdn/translated-content/pull/12852#discussion_r1174339277 |
| brand check | 特定类型检查 | 通过一段代码来对特定的数据类型进行检查。 | https://github.com/mdn/translated-content/pull/13381#discussion_r1205437483 |
| constructor | 构造函数 | | https://github.com/mdn/translated-content/issues/18211 |
| exotic object | 特异对象 | | |
| handler | 处理器 | | https://github.com/mdn/translated-content/issues/18211 |
| interface | 接口 | | https://zh.wikipedia.org/wiki/介面_(資訊科技) |
| normative optional | 可选标准 | | https://github.com/mdn/translated-content/pull/13627#discussion_r1224014687 |
| primitive | 原始值/类型 | 基本类型包括对象,而原始类型不包括对象。 | https://github.com/mdn/translated-content/pull/14040#discussion_r1276966303 |
| unscopable | 非作用域(属性) | | https://github.com/mdn/translated-content/pull/12793#discussion_r1170694183 |
| well-known symbol | 内置通用符号 | | https://github.com/mdn/translated-content/pull/10338#discussion_r1036997921 |
| tree shake | 摇树优化 | 入口文件虽然依赖了某个模块,但实际只使用其中的某些功能,通过该优化可以删除未使用的代码。 | https://github.com/mdn/translated-content/pull/18335#discussion_r1505225794 |
| 英文词汇 | 翻译 | 备注 | 引用来源 |
| ------------------ | ---------------------- | ---------------------------------------------------------------------------------------- | --------------------------------------------------------------------------- |
| bare module | 裸模块 | Vite.js 官方将其翻译为“裸模块”,其意为“没有任何路径的模块”。 | https://github.com/mdn/translated-content/pull/12852#discussion_r1174339277 |
| brand check | 特定类型检查 | 通过一段代码来对特定的数据类型进行检查。 | https://github.com/mdn/translated-content/pull/13381#discussion_r1205437483 |
| constructor | 构造函数 | | https://github.com/mdn/translated-content/issues/18211 |
| exotic object | 特异对象 | | |
| handler | 处理器 | | https://github.com/mdn/translated-content/issues/18211 |
| interface | 接口 | | https://zh.wikipedia.org/wiki/介面_(資訊科技) |
| normative optional | 可选标准 | | https://github.com/mdn/translated-content/pull/13627#discussion_r1224014687 |
| primitive | 原始值/类型 | 基本类型包括对象,而原始类型不包括对象。 | https://github.com/mdn/translated-content/pull/14040#discussion_r1276966303 |
| unscopable | 不可绑定作用域(属性) | | https://github.com/mdn/translated-content/pull/12793#discussion_r1170694183 |
| well-known symbol | 内置通用符号 | | https://github.com/mdn/translated-content/pull/10338#discussion_r1036997921 |
| tree shake | 摇树优化 | 入口文件虽然依赖了某个模块,但实际只使用其中的某些功能,通过该优化可以删除未使用的代码。 | https://github.com/mdn/translated-content/pull/18335#discussion_r1505225794 |

## 标题/表格

Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -14,7 +14,7 @@ El primer artículo de nuestra serie te proporciona una primera experiencia de c
<th scope="row">Prerrequisitos:</th>
<td>
Conocimientos básicos de informática y de
<a href="/es/docs/Learn/HTML/Introduccion_a_HTML">lenguaje HTML</a>.
<a href="/es/docs/Learn/HTML/Introduction_to_HTML">lenguaje HTML</a>.
</td>
</tr>
<tr>
Expand Down Expand Up @@ -47,7 +47,7 @@ Diseñar formularios es un paso importante cuando creas un sitio web o una aplic

En este artículo, vamos a crear un formulario de contacto sencillo. Hagamos un esbozo.

![Esbozo aproximado del formulario que vamos a construir](/files/4579/form-sketch-low.jpg)
![Esbozo aproximado del formulario que vamos a construir](form-sketch-low.jpg)

Nuestro formulario va a tener tres campos de texto y un botón. Le pedimos al usuario su nombre, su correo electrónico y el mensaje que desea enviar. Al pulsar el botón sus datos se enviarán a un servidor web.

Expand All @@ -57,15 +57,15 @@ De acuerdo, intentemos crear el HTML para nuestro formulario. Vamos a utilizar l

Antes de continuar, haz una copia local de nuestra [plantilla HTML simple](https://github.com/mdn/learning-area/blob/master/html/introduction-to-html/getting-started/index.html): introduce aquí tu formulario HTML.

### El elemento {{HTMLelement("form")}}
### El elemento `form`

Todos los formularios comienzan con un elemento {{HTMLelement("form")}}, como este:

```html
<form action="/my-handling-form-page" method="post"></form>
```

Este elemento define formalmente un formulario. Es un elemento contenedor, como un elemento {{HTMLelement("section")}} o {{HTMLelement("footer")}}, pero específico para contener formularios; también admite algunos atributos específicos para la configuración de la forma en que se comporta el formulario. Todos sus atributos son opcionales, pero es una práctica estándar establecer siempre al menos los atributos [`action`](/es/docs/Web/HTML/Attributes/action) y [`method`](/es/docs/Web/HTML/Attributes/method):
Este elemento define formalmente un formulario. Es un elemento contenedor, como un elemento {{HTMLelement("section")}} o {{HTMLelement("footer")}}, pero específico para contener formularios; también admite algunos atributos específicos para la configuración de la forma en que se comporta el formulario. Todos sus atributos son opcionales, pero es una práctica estándar establecer siempre al menos los atributos [`action`](/es/docs/Web/HTML/Element/form#action) y [`method`](/es/docs/Web/HTML/Element/form#method):

- El atributo `action` define la ubicación (URL) donde se envían los datos que el formulario ha recopilado cuando se validan.
- El atributo `method` define con qué método HTTP se envían los datos (generalmente `get` o `post`).
Expand All @@ -75,7 +75,7 @@ Este elemento define formalmente un formulario. Es un elemento contenedor, como
Por ahora, añade el elemento {{htmlelement("form")}} anterior a tu elemento HTML {{htmlelement("body")}}.

### Los elementos {{HTMLelement("label")}}, {{HTMLelement("input")}} y {{HTMLelement("textarea")}}
### Los elementos `<label>`, `<input>` y `<textarea>`

Nuestro formulario de contacto no es complejo: la parte para la entrada de datos contiene tres campos de texto, cada uno con su elemento {{HTMLelement("label")}} correspondiente:

Expand Down Expand Up @@ -106,7 +106,7 @@ En términos de código HTML, para implementar estos controles de formulario nec

Actualiza el código de tu formulario para que se vea como el anterior.

Los elementos {{HTMLelement("li")}} están ahí para estructurar nuestro código convenientemente y facilitar la aplicación de estilo (ver más adelante en el artículo). Por motivos de usabilidad y accesibilidad incluimos una etiqueta explícita para cada control de formulario. Ten en cuenta el uso del atributo [`for`](/es/docs/Web/HTML/Attributes/for) en todos los elementos {{HTMLelement("label")}}, que toma como valor el [`id`](/es/docs/Web/HTML/Attributes/id) del control de formulario con el que está asociado; así es como asocias un formulario con su etiqueta.
Los elementos {{HTMLelement("li")}} están ahí para estructurar nuestro código convenientemente y facilitar la aplicación de estilo (ver más adelante en el artículo). Por motivos de usabilidad y accesibilidad incluimos una etiqueta explícita para cada control de formulario. Ten en cuenta el uso del atributo [`for`](/es/docs/Web/HTML/Attributes/for) en todos los elementos {{HTMLelement("label")}}, que toma como valor el [`id`](/es/docs/Web/HTML/Global_attributes/id) del control de formulario con el que está asociado; así es como asocias un formulario con su etiqueta.

Hacer esto presenta muchas ventajas porque la etiqueta está asociada al control del formulario y permite que los usuarios con ratón, panel táctil y dispositivos táctiles hagan clic en la etiqueta para activar el control correspondiente, y también proporciona accesibilidad con un nombre que los lectores de pantalla leen a sus usuarios. Encontrarás más detalles sobre las etiquetas de los formularios en [Cómo estructurar un formulario web](/es/docs/Learn/Forms/How_to_structure_a_web_form).

Expand All @@ -115,7 +115,7 @@ En el elemento {{HTMLelement("input")}}, el atributo más importante es `type`.
- En nuestro ejemplo sencillo, usamos el valor {{HTMLelement("input/text")}} para la primera entrada, el valor predeterminado para este atributo. Representa un campo de texto básico de una sola línea que acepta cualquier tipo de entrada de texto.
- Para la segunda entrada, usamos el valor {{HTMLelement("input/email")}}, que define un campo de texto de una sola línea que solo acepta una dirección de correo electrónico. Esto convierte un campo de texto básico en una especie de campo «inteligente» que efectúa algunas comprobaciones de validación de los datos que el usuario escribe. También hace que aparezca un diseño de teclado más apropiado para introducir direcciones de correo electrónico (por ejemplo, con un símbolo @ por defecto) en dispositivos con teclados dinámicos, como teléfonos inteligentes. Encontrarás más información sobre la validación de formularios en el artículo de [Validación de formularios por parte del cliente](/es/docs/Learn/Forms/Form_validation) más adelante.

Por último, pero no por ello menos importante, ten en cuenta la sintaxis de `<input>` en contraposición con la de `<textarea></textarea>`. Esta es una de las rarezas del HTML. La etiqueta `<input>` es un elemento vacío, lo que significa que no necesita una etiqueta de cierre. El elemento {{HTMLElement("textarea")}} no es un elemento vacío, lo que significa que debe cerrarse con la etiqueta de cierre adecuada. Esto tiene un impacto en una característica específica de los formularios: el modo en que defines el valor predeterminado. Para definir el valor predeterminado de un elemento {{HTMLElement("input")}}, debes usar el atributo [`value`](/es/docs/Web/HTML/Attributes/value) de esta manera:
Por último, pero no por ello menos importante, ten en cuenta la sintaxis de `<input>` en contraposición con la de `<textarea></textarea>`. Esta es una de las rarezas del HTML. La etiqueta `<input>` es un elemento vacío, lo que significa que no necesita una etiqueta de cierre. El elemento {{HTMLElement("textarea")}} no es un elemento vacío, lo que significa que debe cerrarse con la etiqueta de cierre adecuada. Esto tiene un impacto en una característica específica de los formularios: el modo en que defines el valor predeterminado. Para definir el valor predeterminado de un elemento {{HTMLElement("input")}}, debes usar el atributo [`value`](/es/docs/Web/HTML/Element/input#value) de esta manera:

```html
<input type="text" value="por defecto este elemento se llena con este texto" />
Expand All @@ -129,7 +129,7 @@ Por defecto, este elemento contiene este texto
</textarea>
```

### El elemento {{HTMLelement("button")}}
### El elemento `button`

El marcado de nuestro formulario está casi completo; solo necesitamos añadir un botón para permitir que el usuario envíe sus datos una vez que haya completado el formulario. Esto se hace con el elemento {{HTMLelement("button")}}; añade lo siguiente justo encima de la etiqueta de cierre `</form>`:

Expand Down Expand Up @@ -240,9 +240,9 @@ Guarda y vuelve a cargar, y observa que tu formulario presenta un aspecto mucho
## Enviar los datos del formulario a un servidor web

La última parte, y quizás la más complicada, es manejar los datos del formulario en el lado del servidor. El elemento {{HTMLelement("form")}} define dónde y cómo enviar los datos gracias a los atributos [`action`](/es/docs/Web/HTML/Attributes/action) y [`method`](/es/docs/Web/HTML/Attributes/method).
La última parte, y quizás la más complicada, es manejar los datos del formulario en el lado del servidor. El elemento {{HTMLelement("form")}} define dónde y cómo enviar los datos gracias a los atributos [`action`](/es/docs/Web/HTML/Element/form#action) y [`method`](/es/docs/Web/HTML/Element/form#method).

Proporcionamos un nombre ([`name`](/es/docs/Web/HTML/Attributes/name)) a cada control de formulario. Los nombres son importantes tanto en el lado del cliente como del servidor; le dicen al navegador qué nombre debe dar a cada dato y, en el lado del servidor, dejan que el servidor maneje cada dato por su nombre. Los datos del formulario se envían al servidor como pares de nombre/valor.
Proporcionamos un nombre (`name`) a cada control de formulario. Los nombres son importantes tanto en el lado del cliente como del servidor; le dicen al navegador qué nombre debe dar a cada dato y, en el lado del servidor, dejan que el servidor maneje cada dato por su nombre. Los datos del formulario se envían al servidor como pares de nombre/valor.

Para poner nombre a los diversos datos que se introducen en un formulario, debes usar el atributo `name` en cada control de formulario que recopila un dato específico. Veamos de nuevo algunos de nuestros códigos de formulario:

Expand Down
2 changes: 1 addition & 1 deletion files/fr/web/api/location/reload/index.md
Original file line number Diff line number Diff line change
Expand Up @@ -23,7 +23,7 @@ Il est toutefois possible que vous rencontriez des occurrences de `location.relo

Historiquement, une version de Netscape Navigator a introduit la prise en charge de cet argument et cela s'est retrouvé dans Firefox. À un moment, le groupe de travail du W3C sur les API Web [a ouvert le sujet](https://www.w3.org/2005/06/tracker/webapi/issues/69) pour étudier son ajout à la spécification pour `location.reload()`. Toutefois, il n'a jamais été ajouté formellement.

En résumé, ce paramètre booléen ne fait pas partie de la spécification actuelle `location.reload()` et n'en a en fait jamais fait partie.
En résumé, ce paramètre booléen ne fait pas partie de la spécification actuelle de `location.reload()` et n'en a d'ailleurs jamais fait partie.

## Spécifications

Expand Down
Original file line number Diff line number Diff line change
@@ -1,7 +1,7 @@
---
title: "CycleTracker : les service workers"
slug: Web/Progressive_web_apps/Tutorials/CycleTracker/Service_workers
short-title: Service workers
slug: Web/Progressive_web_apps/Tutorials/CycleTracker/Service_workers
---

{{PWASidebar}}
Expand Down
Loading

0 comments on commit ee5708d

Please sign in to comment.