diff --git a/docs/ko/guides/glossary-guide.md b/docs/ko/guides/glossary-guide.md index b3a7706cc4df67..b1688f2a8b6a2c 100644 --- a/docs/ko/guides/glossary-guide.md +++ b/docs/ko/guides/glossary-guide.md @@ -22,9 +22,9 @@ ## 용어 안내서 `참고 링크` 우선 순위 -- 1. 해당 단어에 대한 의견을 나눈 PR 링크 -- 2. 적절한 ko MDN 문서 링크 -- 3. 적절한 en-us MDN 문서 링크 +1. 해당 단어에 대한 의견을 나눈 PR 링크 +2. 적절한 ko MDN 문서 링크 +3. 적절한 en-us MDN 문서 링크 ## Section Title diff --git a/files/es/learn/common_questions/web_mechanics/pages_sites_servers_and_search_engines/index.md b/files/es/learn/common_questions/web_mechanics/pages_sites_servers_and_search_engines/index.md index 04c01fd0868190..21d9737960e25f 100644 --- a/files/es/learn/common_questions/web_mechanics/pages_sites_servers_and_search_engines/index.md +++ b/files/es/learn/common_questions/web_mechanics/pages_sites_servers_and_search_engines/index.md @@ -1,6 +1,8 @@ --- title: ¿Cuál es la diferencia entre la página web, el sitio web, el servidor web y el motor de búsqueda? slug: Learn/Common_questions/Web_mechanics/Pages_sites_servers_and_search_engines +l10n: + sourceCommit: 9de3d03957f1d66f02f45400a6981372aa368c1f --- {{QuicklinksWithSubPages("Learn/Common_questions")}} @@ -30,12 +32,12 @@ En este artículo se describen varios conceptos referidos a la web: Páginas web ## Resumen -Como cualquier área de conocimiento, la web viene con un montón de jerga. No te preocupes, no te abrumaremos con todo esto (tenemos un glosario por si tienes curiosidad). Sin embargo, hay unos términos básicos que necesitas entender al principio, ya que escucharás estas expresiones todo el tiempo mientras lees. A veces es fácil de confundir estos términos, puesto que hacen referencia a funcionalidades relacionadas pero diferentes. De hecho, a veces veras estos términos mal utilizados en las noticias y en otros lugares ¡por lo que llegar a mezclarlos es entendible! +Como cualquier área de conocimiento, la web viene con un montón de jerga. No te preocupes, no te abrumaremos con todo esto (tenemos un [glosario](/es/docs/Glossary) por si tienes curiosidad). Sin embargo, hay unos términos básicos que necesitas entender al principio, ya que escucharás estas expresiones todo el tiempo mientras lees. A veces es fácil de confundir estos términos, puesto que hacen referencia a funcionalidades relacionadas pero diferentes. De hecho, a veces veras estos términos mal utilizados en las noticias y en otros lugares ¡por lo que llegar a mezclarlos es entendible! Cubriremos estos términos y tecnologías con más detalle mientras exploramos más, pero estas definiciones rápidas serán un gran comienzo para ti: - Página web - - : Un documento que se puede mostrar en un navegador web como Firefox, Google Chrome, Microsoft Internet Explorer o Edge, o Safary de Apple. A menudo se las denomina simplemente "páginas". + - : Un documento que se puede mostrar en un navegador web como Firefox, Google Chrome, Microsoft Edge, o Safari de Apple. A menudo se las denomina simplemente "páginas". - Sitio web - : Es una colección de páginas web agrupadas y que normalmente se conectan entre sí de varias maneras. A menudo llamados simplemente "sitios". - Servidor web @@ -56,7 +58,9 @@ Vamos a comparar la biblioteca con un servidor web: - Los libros en cada sección son como páginas web. Un sitio web puede tener varias páginas web, por ejemplo, la sección de Ciencias (el sitio web) tendrá libros sobre calor, sonido, termodinámica, estadísticas, etc. (las páginas web). Cada una de las páginas web puede ser encontrada en una ubicación única (URL). - El índice de búsqueda es como el motor de búsqueda. Cada libro tiene su propia ubicación única en la biblioteca (dos libros no se pueden mantener en el mismo lugar) que se especifica mediante el número de catálogo. -_No esta disponible aprendizaje activo aun. [Por favor, considere la posibilidad de contribuir](/es/docs/MDN/Getting_started)._ +## Aprendizaje activo + +_Todavía no hay ningún aprendizaje activo disponible. [Por favor, considere la posibilidad de contribuir](/es/docs/MDN/Getting_started)._ ## Profundizando @@ -64,30 +68,32 @@ Entonces, vamos a profundizar en cómo estos cuatro términos serán relacionado ### Página web -Una **página web** es un simple documento que puede ser mostrado por un {{Glossary("browser")}}. Estos documentos están escritos en lenguaje {{Glossary("HTML")}} (el que veremos en más detalle en [otros artículos](/es/docs/Web/HTML)). Una página web puede incluir una variedad de diferentes tipos de recursos, tales como: +Una **página web** es un simple documento que puede ser mostrado por un {{Glossary("browser", "navegador")}}. Estos documentos están escritos en lenguaje {{Glossary("HTML")}} (el que veremos en más detalle en [otros artículos](/es/docs/Web/HTML)). Una página web puede incluir una variedad de diferentes tipos de recursos, tales como: - _información de estilos_ — para controlar la apariencia de una página - _scripts_ — que agrega interactividad a la página - _medios_ — imágenes, sonidos, y vídeos. > [!NOTE] -> Los buscadores pueden mostrar distintos tipos de documentos, como archivos {{Glossary("PDF")}} o imágenes. Pero el término **página web** específicamente hace referencia a documentos HTML. Para los demás, usaremos sólo el termino **document**(documento). +> Los navegadores pueden mostrar distintos tipos de documentos, como archivos {{Glossary("PDF")}} o imágenes. Pero el término **página web** específicamente hace referencia a documentos HTML. Para los demás, usaremos sólo el término **document**(documento). -Todas las páginas web disponibles en la red son accesibles mediante una dirección única. Para acceder a una página, simplemente escribe su direcciones en la barra de búsqueda de tu navegador: +Todas las páginas web disponibles en la red son accesibles mediante una dirección única. Para acceder a una página, simplemente escribe su dirección en la barra de búsqueda de tu navegador: ![Ejemplo de dirección de una página web en la barra de direcciones del navegador](web-page.jpg) -Un _sitio web_ es una colección de páginas web vinculadas (más sus recursos asociados) que comparten un único nombre de dominio. Cada página web de un sitio web determinado proporciona enlaces explícitos —habitualmente en forma de porciones del texto en que se puede hacer clic— que permiten al usuario moverse de una página del sitio a otra. +### Sitio web + +Un _sitio web_ es una colección de páginas web vinculadas (más sus recursos asociados) que comparten un único nombre de dominio. Cada página web de un sitio web determinado proporciona enlaces explícitos —habitualmente en forma de porciones de texto sobre los que se puede hacer clic— que permiten al usuario moverse de una página del sitio a otra. -Para acceder a un sitio web, escribe su nombre de dominio en la barra de direcciones de tu buscador, y él te mostrará la página principal del sitio web, o _homepage_ (informalmente denominada "el home"): +Para acceder a un sitio web, escribe su nombre de dominio en la barra de direcciones de su navegador, y el navegador mostrará la página principal del sitio web, o _página de inicio_ (conocida casualmente como "inicio"): ![Ejemplo de nombre de dominio de un sitio web en la barra de direcciones del navegador](web-site.jpg) -_Página web_ y _sitio web_ son especialmente fáciles de confundir cuando un _sitio_ contiene una única _página web_ Tales sitios son denominados _sitios de una sola página._ +Note que también es posible tener _sitios web de una sola página_: un sitio que consta de una sola página web, la cual es actualizada dinamicamente con nuevo contenido cuando es necesario. ### Servidor web -Un _servidor web_ es una computadora que aloja uno o mas _sitios web_. "Alojar" (_hosting_) significa que todas las _páginas web_ y sus archivos soportes están disponibles en esa computadora. El _servidor web_ enviará cualquier _página web_ del _sitio web_ que aloja, al navegador de cualquier usuario, por cada solicitud del usuario. +Un _servidor web_ es una computadora que aloja uno o mas _sitios web_. "Alojar" (_hosting_) significa que todas las _páginas web_ y sus archivos base están disponibles en esa computadora. El _servidor web_ enviará cualquier _página web_ del _sitio web_ que aloja, al navegador de cualquier usuario, por cada solicitud del usuario. No confundir _sito web_ y _servidor web_. Por ejemplo, la expresión "Mi sitio web no responde", en realidad significa que el _servidor web_ no responde y, por lo tanto, el _sitio web_ no está disponible. Más importante aún, dado que un servidor web puede alojar varios sitios web, la expresión _servidor web_ nunca se utiliza para designar un sitio web, pues podría causar una gran confusión. En nuestro ejemplo anterior, si dijéramos: "Mi servidor web no responde", significaría que múltiples sitios web alojados en ese servidor web no están disponibles. @@ -95,7 +101,7 @@ No confundir _sito web_ y _servidor web_. Por ejemplo, la expresión "Mi sitio w Los buscadores son una fuente común de confusión en la web. Un buscador es un tipo especial de sitio web que ayuda a los usuarios a encontrar páginas web de otros sitios web. -Hay muchos por ahí: [Google](https://www.google.com/), [Bing](https://www.bing.com/), [Yandex](https://www.yandex.com/), [DuckDuckGo](https://duckduckgo.com/),y muchos mas. Algunos son genéricos, otros están especializados en ciertos temas. Utilice los que prefiera. +Hay muchos por ahí: [Google](https://www.google.com/), [Bing](https://www.bing.com/), [Yandex](https://www.yandex.com/), [DuckDuckGo](https://duckduckgo.com/),y muchos más. Algunos son genéricos, otros están especializados en ciertos temas. Utilice los que prefiera. Muchos principiantes en la web confunden motores de búsqueda con navegadores. Aclaremos esto: Un _**navegador**_ es una pieza de software que obtiene y muestra páginas web; un **_buscador_** es un sitio web que ayuda a las personas a encontrar páginas web alojadas en otros sitios web. La confusión surge porque la primera vez que alguien inicia un navegador, el navegador muestra la página principal de un motor de búsqueda. Esto tiene sentido, porque, obviamente, lo primero que quieres hacer con un navegador es encontrar una página web para mostrar. No confundas la infraestructura (el navegador) con el servicio (el buscador). La distinción te ayudará un poco, pero incluso algunos profesionales hablan imprecisamente, así que no te sientas angustiado por eso. diff --git a/files/es/web/css/animation-fill-mode/index.md b/files/es/web/css/animation-fill-mode/index.md index 30e0c7c6b796da..cc7bcd1f61f824 100644 --- a/files/es/web/css/animation-fill-mode/index.md +++ b/files/es/web/css/animation-fill-mode/index.md @@ -37,21 +37,27 @@ animation-fill-mode: unset; - `none` - : La animación no aplicará los estilos antes ni después de su ejecución. - `forwards` + - : El objeto sobre el que se aplica la animación quedará con los valores y estilos que le aplique el último keyframe de la ejecución de la animación. El último valor dependerá del valor de {{ cssxref("animation-direction") }} y {{ cssxref("animation-iteration-count") }}: + | `animation-direction` | `animation-iteration-count` | ultimo keyframe encontrado | | --------------------- | --------------------------- | -------------------------- | - | `normal` | even o odd | `100%` or `to` | - | `reverse` | even o odd | `0%` or `from` | - | `alternate` | even | `0%` or `from` | - | `alternate` | odd | `100%` or `to` | - | `alternate-reverse` | even | `100%` or `to` | - | `alternate-reverse` | odd | `0%` or `from` | + | `normal` | even o odd | `100%` or `to` | + | `reverse` | even o odd | `0%` or `from` | + | `alternate` | even | `0%` or `from` | + | `alternate` | odd | `100%` or `to` | + | `alternate-reverse` | even | `100%` or `to` | + | `alternate-reverse` | odd | `0%` or `from` | + - `backwards` + - : La animación aplicará los valores definidos en el primer [keyframe](/es/docs/CSS/@keyframes) tan pronto como se aplique al objeto, y los retendrá durante el tiempo de {{ cssxref("animation-delay") }}. El primer keyframe dependerá del valor de {{ cssxref("animation-direction") }}: - | `animation-direction` | primer keyframe | + + | `animation-direction` | primer keyframe | | ------------------------------- | --------------- | - | `normal` o `alternate` | `0%` or `from` | - | `reverse` o `alternate-reverse` | `100%` or `to` | + | `normal` o `alternate` | `0%` or `from` | + | `reverse` o `alternate-reverse` | `100%` or `to` | + - `both` - : La animación seguirá las reglas de las opciones forwards y backwards, extendiendo las propiedades de la animación en ambas direcciones. diff --git a/files/ja/web/api/wheelevent/wheelevent/index.md b/files/ja/web/api/wheelevent/wheelevent/index.md index 11c4942de4287d..4d2eaa312d910f 100644 --- a/files/ja/web/api/wheelevent/wheelevent/index.md +++ b/files/ja/web/api/wheelevent/wheelevent/index.md @@ -27,7 +27,9 @@ new WheelEvent(type, options) - : イベント名の文字列です。 大文字と小文字は区別され、ブラウザーは常に `wheel` に設定します。 - `options` {{optional_inline}} + - : _{{domxref("MouseEvent/MouseEvent", "MouseEvent()")}} で定義するプロパティに加え_、以下のプロパティを持つことができるオブジェクトです。 + - `deltaX` {{optional_inline}} - : 浮動小数点数で、水平スクロール量を `deltaMode` の単位で表します。 既定値は `0.0` です。 @@ -38,12 +40,14 @@ new WheelEvent(type, options) - : 浮動小数点数で、 Z 軸のスクロール量を `deltaMode` の単位で表します。 既定値は `0.0` です。 - `deltaMode` {{optional_inline}} + - : デルタ値のスクロール量の単位を表す整数です。既定値は `0x00` です。指定できる値は以下の通りです。 - | 定数 | 値 | 説明 | + + | 定数 | 値 | 説明 | | ----------------- | ------ | ------------------------------------ | | `DOM_DELTA_PIXEL` | `0x00` | デルタ値はピクセル数で指定されます。 | - | `DOM_DELTA_LINE` | `0x01` | デルタ値は行数で指定されます。 | - | `DOM_DELTA_PAGE` | `0x02` | デルタ値はページ数で指定されます。 | + | `DOM_DELTA_LINE` | `0x01` | デルタ値は行数で指定されます。 | + | `DOM_DELTA_PAGE` | `0x02` | デルタ値はページ数で指定されます。 | ### 返値 diff --git a/files/ko/web/css/animation-iteration-count/index.md b/files/ko/web/css/animation-iteration-count/index.md index 6745e5c7d90659..30c77fbe607c44 100644 --- a/files/ko/web/css/animation-iteration-count/index.md +++ b/files/ko/web/css/animation-iteration-count/index.md @@ -111,7 +111,6 @@ animation-iteration-count: unset; ## 같이 보기 -- [CSS 애니메이션 사용하기 - ](/ko/docs/Web/CSS/CSS_animations/Using_CSS_animations) +- [CSS 애니메이션 사용하기](/ko/docs/Web/CSS/CSS_animations/Using_CSS_animations) - JavaScript {{domxref("AnimationEvent")}} API - 애니메이션과 관련된 다른 CSS 속성: {{cssxref("animation")}}, {{cssxref("animation-composition")}}, {{cssxref("animation-delay")}}, {{cssxref("animation-direction")}}, {{cssxref("animation-duration")}}, {{cssxref("animation-fill-mode")}}, {{cssxref("animation-name")}}, {{cssxref("animation-play-state")}}, {{cssxref("animation-timeline")}}, {{cssxref("animation-timing-function")}} diff --git a/files/ko/web/javascript/reference/global_objects/symbol/species/index.md b/files/ko/web/javascript/reference/global_objects/symbol/species/index.md index be23fbb19c5c8d..78fad31c9976a0 100644 --- a/files/ko/web/javascript/reference/global_objects/symbol/species/index.md +++ b/files/ko/web/javascript/reference/global_objects/symbol/species/index.md @@ -9,8 +9,7 @@ l10n: **`Symbol.species`** 정적 데이터 속성은 [잘 알려진 심볼](/ko/docs/Web/JavaScript/Reference/Global_Objects/Symbol#잘_알려진_심볼) `Symbol.species`을 나타냅니다. 객체의 복사본을 생성하는 메서드는 생성자 함수가 복사본을 만들 때 사용할 객체에서 이 심볼을 검색할 수 있습니다. -> [!WARNING] -> `Symbol.species`가 존재하면 임의의 코드가 실행될 수 있으며 보안 취약점이 발생할 수 있습니다. 또한 특정 최적화를 훨씬 더 어렵게 만듭니다. 엔진 구현자는 [이 기능을 제거할지 여부를 조사](https://github.com/tc39/proposal-rm-builtin-subclassing)하고 있습니다. 가능하면 이 기능을 사용하지 마세요. +> **경고:** `Symbol.species`가 존재하면 임의의 코드가 실행될 수 있으며 보안 취약점이 발생할 수 있습니다. 또한 특정 최적화를 훨씬 더 어렵게 만듭니다. 엔진 구현자는 [이 기능을 제거할지 여부를 조사](https://github.com/tc39/proposal-rm-builtin-subclassing)하고 있습니다. 가능하면 이 기능을 사용하지 마세요. {{EmbedInteractiveExample("pages/js/symbol-species.html")}} diff --git a/files/ru/web/http/authentication/index.md b/files/ru/web/http/authentication/index.md index d272e5aeb1539f..d31e968ba9d8c2 100644 --- a/files/ru/web/http/authentication/index.md +++ b/files/ru/web/http/authentication/index.md @@ -170,8 +170,7 @@ https://username:password@www.example.com/ ``` **Использование таких URL-адресов устарело**. В браузере Chrome в URL-адресах часть -`username:password@` даже[ -вырезана](https://bugs.chromium.org/p/chromium/issues/detail?id=82250#c7) из соображений безопасности. В браузере Firefox, проверяется, действительно ли сайт требует +`username:password@` даже[вырезана](https://bugs.chromium.org/p/chromium/issues/detail?id=82250#c7) из соображений безопасности. В браузере Firefox, проверяется, действительно ли сайт требует аутентификации и если нет, тогда Firefox предупредит пользователя запросом (prompt) "You are about to log in to the site "www\.example.com" with the username "username", but the website does not require authentication. This may be an attempt to trick you.". diff --git a/files/zh-cn/glossary/breadcrumb/index.md b/files/zh-cn/glossary/breadcrumb/index.md index 50d098c155b10b..850cc3c8f7c12e 100644 --- a/files/zh-cn/glossary/breadcrumb/index.md +++ b/files/zh-cn/glossary/breadcrumb/index.md @@ -21,8 +21,7 @@ l10n: ## 参见 - [面包屑导航](/zh-CN/docs/Web/CSS/Layout_cookbook/Breadcrumb_Navigation) -- [ - Google 搜索中心:面包屑结构化数据](https://developers.google.cn/search/docs/appearance/structured-data/breadcrumb) +- [Google 搜索中心:面包屑结构化数据](https://developers.google.cn/search/docs/appearance/structured-data/breadcrumb) - [APG 指南:Breadcrumb 示例](https://www.w3.org/WAI/ARIA/apg/patterns/breadcrumb/examples/breadcrumb/) - [理解成功标准 2.4.8 | W3C 理解 WCAG 2.2](https://www.w3.org/WAI/WCAG22/Understanding/location) - [理解技术 65 | W3C 理解 WCAG 2.2](https://www.w3.org/WAI/WCAG22/Techniques/general/G65) diff --git a/files/zh-cn/learn/html/introduction_to_html/advanced_text_formatting/index.md b/files/zh-cn/learn/html/introduction_to_html/advanced_text_formatting/index.md index 82adde8ff3c9cb..936eb083921c75 100644 --- a/files/zh-cn/learn/html/introduction_to_html/advanced_text_formatting/index.md +++ b/files/zh-cn/learn/html/introduction_to_html/advanced_text_formatting/index.md @@ -32,7 +32,7 @@ HTML 中有许多其他元素可以用于格式化文本,我们没有在 [HTML ## 描述列表 -在 HTML 基础部分,我们讨论了如何在 HTML 中[标记基本的列表](/zh-CN/docs/Learn/HTML/Introduction_to_HTML/HTML_text_fundamentals#列表_lists),但是我们没有提到你偶尔会遇到的第三种类型的列表——**描述列表**(description list)。这种列表的目的是标记一组项目及其相关描述,例如术语和定义,或者是问题和答案等。让我们看一组术语和定义的示例: +在 HTML 文本处理基础中,我们讨论了如何在 HTML 中[标记基本的列表](/zh-CN/docs/Learn/HTML/Introduction_to_HTML/HTML_text_fundamentals#列表),并且提到了你偶尔会遇到的第三种列表类型——**描述列表**(description list)。这种列表的目的是标记一组项目及其相关描述,例如术语和定义,或者是问题和答案等。让我们看一组术语和定义的示例: ```plain 内心独白 @@ -183,12 +183,12 @@ window.addEventListener("load", updateCode); // make it write a tab at the caret position instead textarea.onkeydown = (e) => { - if (e.keyCode === 9) { + if (e.code === "Tab") { e.preventDefault(); insertAtCaret("\t"); } - if (e.keyCode === 27) { + if (e.code === "Escape") { textarea.blur(); } }; @@ -417,12 +417,12 @@ window.addEventListener("load", updateCode); // make it write a tab at the caret position instead textarea.onkeydown = (e) => { - if (e.keyCode === 9) { + if (e.code === "Tab") { e.preventDefault(); insertAtCaret("\t"); } - if (e.keyCode === 27) { + if (e.code === "Escape") { textarea.blur(); } }; @@ -576,12 +576,12 @@ window.addEventListener("load", updateCode); // make it write a tab at the caret position instead textarea.onkeydown = (e) => { - if (e.keyCode === 9) { + if (e.code === "Tab") { e.preventDefault(); insertAtCaret("\t"); } - if (e.keyCode === 27) { + if (e.code === "Escape") { textarea.blur(); } }; diff --git a/files/zh-cn/learn/html/introduction_to_html/creating_hyperlinks/index.md b/files/zh-cn/learn/html/introduction_to_html/creating_hyperlinks/index.md index a1bfacffae8a16..941801abcdb857 100644 --- a/files/zh-cn/learn/html/introduction_to_html/creating_hyperlinks/index.md +++ b/files/zh-cn/learn/html/introduction_to_html/creating_hyperlinks/index.md @@ -48,7 +48,7 @@ slug: Learn/HTML/Introduction_to_HTML/Creating_hyperlinks ### 块级链接 -就像之前提到的那样,任何内容,甚至[块级内容](/zh-CN/docs/Learn/HTML/Introduction_to_HTML/Getting_started#块级元素和内联元素)都可以作为链接出现。如果想让标题元素变为链接,就把它包裹在锚点元素(``)内,像这个代码段一样: +就像之前提到的那样,任何内容,甚至{{Glossary("Block/CSS", "块级元素")}}都可以作为链接出现。如果想让标题元素变为链接,就把它包裹在锚点元素(``)内,像这个代码段一样: ```html @@ -63,7 +63,7 @@ slug: Learn/HTML/Introduction_to_HTML/Creating_hyperlinks ### 图片链接 -如果有需要作为链接的图片,使用 {{htmlelement("a")}} 元素来包裹要引用图片的 {{htmlelement("img")}} 元素。 +如果有需要作为链接的图片,使用 {{htmlelement("a")}} 元素来包裹要引用图片的 {{htmlelement("img")}} 元素。下面的示例使用相对路径来引用本地存储的 SVG 图像文件。 ```css hidden img { @@ -75,7 +75,7 @@ img { ```html - + ``` @@ -92,10 +92,11 @@ img { ```html
- 我创建了一个指向Mozilla 主页 + Mozilla 主页的超链接。
``` @@ -207,13 +208,15 @@ URL 使用路径查找文件。路径指定文件系统中你感兴趣的文件 **好的**链接文本:[下载 Firefox](https://www.mozilla.org/zh-CN/firefox/new/?redirect_source=firefox-com) ```html example-good - + ``` -**不好的**链接文本:[点击这里](https://www.mozilla.org/firefox/)下载 Firefox +**不好的**链接文本:[点击这里](https://www.mozilla.org/zh-CN/firefox/)下载 Firefox ```html example-bad -点击这里 下载 Firefox
++ 点击这里 下载 Firefox +
``` 其他提示: @@ -312,7 +315,7 @@ URL 使用路径查找文件。路径指定文件系统中你感兴趣的文件 ``` > [!NOTE] -> 每个字段的值必须使用 URL 编码,即使用[百分号转义的](https://zh.wikipedia.org/wiki/百分号编码)非打印字符(不可见字符如制表符、换行符、分页符)和空格。同时注意使用问号(`?`)来分隔主 URL 与参数值,以及使用 & 符来分隔 `mailto:` URL 中的各个参数。这是标准的 URL 查询标记方法。阅读 [GET 方法](/zh-CN/docs/Learn/Forms/Sending_and_retrieving_form_data#get_方法)以了解哪种 URL 查询标记方法是更常用的。 +> 每个字段的值必须使用 URL 编码,即使用{{Glossary("Percent-encoding", "百分号转义")}}的非打印字符(不可见字符如制表符、换行符、分页符)和空格。同时注意使用问号(`?`)来分隔主 URL 与参数值,以及使用 & 符来分隔 `mailto:` URL 中的各个参数。这是标准的 URL 查询标记方法。阅读 [GET 方法](/zh-CN/docs/Learn/Forms/Sending_and_retrieving_form_data#get_方法)以了解哪种 URL 查询标记方法是更常用的。 这里有一些其他的示例 `mailto` 链接: diff --git a/files/zh-cn/learn/javascript/first_steps/what_is_javascript/index.md b/files/zh-cn/learn/javascript/first_steps/what_is_javascript/index.md index f8e726a49b3718..290412060f85b1 100644 --- a/files/zh-cn/learn/javascript/first_steps/what_is_javascript/index.md +++ b/files/zh-cn/learn/javascript/first_steps/what_is_javascript/index.md @@ -33,42 +33,40 @@ JavaScript 是一种脚本编程语言,它可以在网页上实现复杂的功 这三层依次建立,秩序井然。以简单文本标签作为示例。首先用 HTML 将文本标记起来,从而赋予它结构和目的: ```html -Player 1: Chris
+ ``` -![作为纯文本段落出现的“Player 1: Chris”](just-html.png) +![没有样式的“Player 1: Chris”按钮](just-html.png) 然后我们可以为它加一点 CSS 让它更好看: ```css -p { +button { font-family: "helvetica neue", helvetica, sans-serif; letter-spacing: 1px; text-transform: uppercase; - text-align: center; - border: 2px solid rgb(0 0 200 / 0.6); - background: rgb(0 0 200 / 0.6); - color: rgb(255 255 255 / 1); - box-shadow: 1px 1px 2px rgb(0 0 200 / 0.4); + border: 2px solid rgb(200 200 0 / 60%); + background-color: rgb(0 217 217 / 60%); + color: rgb(100 0 0 / 100%); + box-shadow: 1px 1px 2px rgb(0 0 200 / 40%); border-radius: 10px; padding: 3px 10px; - display: inline-block; cursor: pointer; } ``` -![已添加样式的“Player 1: Chris”段落](html-and-css.png) +![已添加样式的“Player 1: Chris”按钮](html-and-css.png) 最后,我们可以再加上一些 JavaScript 来实现动态行为: ```js -const para = document.querySelector("p"); +const button = document.querySelector("button"); -para.addEventListener("click", updateName); +button.addEventListener("click", updateName); function updateName() { - const name = prompt("Enter a new name"); - para.textContent = `Player 1: ${name}`; + const name = prompt("请输入新的名字"); + button.textContent = `Player 1: ${name}`; } ``` @@ -100,7 +98,7 @@ API 通常分为两类。 - {{domxref("Document_Object_Model","文档对象模型 API","","nocode")}} 能通过创建、移除和修改 HTML,为页面动态应用新样式等手段来操作 HTML 和 CSS。比如当某个页面出现了一个弹窗,或者显示了一些新内容(像上文小演示中看到那样),这就是 DOM 在运行。 - {{domxref("Geolocation","地理位置 API","","nocode")}} 获取地理信息。这就是为什么[谷歌地图](https://www.google.com/maps)可以找到你的位置,而且标示在地图上。 - {{domxref("Canvas_API","画布(Canvas)","","nocode")}} 和 {{domxref("WebGL_API","WebGL","","nocode")}} API 可以创建生动的 2D 和 3D 图像。人们正运用这些 web 技术制作令人惊叹的作品。参见 [Chrome Experiments](https://experiments.withgoogle.com/collection/chrome) 以及 [webglsamples](https://webglsamples.org/)。 -- 诸如 {{domxref("HTMLMediaElement")}} 和 {{domxref("WebRTC API", "WebRTC","","nocode")}} 等[影音类 API](/zh-CN/docs/Web/Guide/Audio_and_video_delivery) 让你可以利用多媒体做一些非常有趣的事,比如在网页中直接播放音乐和影片,或用自己的网络摄像头获取录像,然后在其他人的电脑上展示(试用简易版[截图演示](http://chrisdavidmills.github.io/snapshot/)以理解这个概念)。 +- 诸如 {{domxref("HTMLMediaElement")}} 和 {{domxref("WebRTC API", "WebRTC","","nocode")}} 等[影音类 API](/zh-CN/docs/Web/Media/Audio_and_video_delivery) 让你可以利用多媒体做一些非常有趣的事,比如在网页中直接播放音乐和影片,或用自己的网络摄像头获取录像,然后在其他人的电脑上展示(试用简易版[截图演示](http://chrisdavidmills.github.io/snapshot/)以理解这个概念)。 > [!NOTE] > 上述很多演示都不能在旧浏览器中运行。推荐你在测试代码时使用诸如 Firefox、Chrome、Edge 或者 Opera 等现代浏览器。当代码即将交付生产环境时(也就是真实的客户即将使用真实的代码时),你还需要深入考虑[跨平台测试](/zh-CN/docs/Learn/Tools_and_testing/Cross_browser_testing)。 @@ -123,7 +121,7 @@ API 通常分为两类。 ![当页面加载时,HTML、CSS 和 JavaScript 代码共同创建浏览器标签页中的内容](execution.png) -JavaScript 的一个非常常见的用途是通过文档对象模型 API(如上所述)动态修改 HTML 和 CSS,以更新用户界面。请注意,网页文档中的代码通常按照其在页面上出现的顺序加载和执行。如果 JavaScript 先于要修改的 HTML 和 CSS 加载和运行,则可能发生错误。你将在本文后面的[脚本加载策略](#脚本加载策略)部分了解到解决这个问题的方法。 +JavaScript 的一个非常常见的用途是通过文档对象模型 API(如上所述)动态修改 HTML 和 CSS,以更新用户界面。 ### 浏览器安全 @@ -137,19 +135,19 @@ JavaScript 的一个非常常见的用途是通过文档对象模型 API(如 当浏览器执行到一段 JavaScript 代码时,通常会按从上往下的顺序执行这段代码。这意味着你需要注意代码书写的顺序。比如,我们回到第一个例子中的 JavaScript 代码: ```js -const para = document.querySelector("p"); +const button = document.querySelector("button"); -para.addEventListener("click", updateName); +button.addEventListener("click", updateName); function updateName() { const name = prompt("输入一个新的名字:"); - para.textContent = `玩家 1:${name}`; + button.textContent = `玩家 1:${name}`; } ``` -这里我们选定一个文本段落(第 1 行),然后给它附上一个事件监听器(第 3 行),使得在它被点击时,`updateName()` 代码块(5 – 8 行)便会运行。`updateName()` 代码块(这类可以重复使用的代码块称为“函数”)向用户请求一个新名字,然后把这个名字插入到段落中以更新显示。 +首先使用 `document.querySelector` 选定一个按钮,然后使用 `addEventListener` 给它附上一个事件监听器(第 3 行),使得在它被点击时,`updateName()` 代码块(5 – 8 行)便会运行。`updateName()` 代码块(这类可以重复使用的代码块称为“函数”)向用户请求一个新名字,然后把这个名字插入到段落中以更新显示。 -如果你互换了代码里最初两行的顺序,会导致问题。浏览器[开发者控制台](/zh-CN/docs/Learn/Common_questions/Tools_and_setup/What_are_browser_developer_tools)将返回一个错误:`TypeError: para is undefined`。这意味着 `para` 对象还不存在,所以我们不能为它增添一个事件监听器。 +如果互换了代码里最初两行的顺序,会导致问题。[浏览器开发者控制台](/zh-CN/docs/Learn/Common_questions/Tools_and_setup/What_are_browser_developer_tools)将返回一个错误:`Uncaught ReferenceError: Cannot access 'button' before initialization`。这意味着 `button` 对象还未初始化,所以我们不能为它增添事件监听器。 > [!NOTE] > 这是一个很常见的错误,在引用对象之前必须确保该对象已经存在。 @@ -184,7 +182,7 @@ JavaScript 是轻量级解释型语言。浏览器接受到 JavaScript 代码, 1. 首先,下载示例文件 [apply-javascript.html](https://github.com/mdn/learning-area/blob/main/javascript/introduction-to-js-1/what-is-js/apply-javascript.html)。放在一个方便的文件夹里。 2. 分别在浏览器和文本编辑器中打开这个文件。你会看到这个 HTML 文件创建了一个简单的网页,其中有一个可点击按钮。 -3. 然后转到文本编辑器,在 `