Skip to content

Commit 4356f64

Browse files
authored
Merge pull request #181 from reactjs/sync-d615c5b7
Sync with reactjs.org @ d615c5b
2 parents a1d3e63 + 7114cd1 commit 4356f64

31 files changed

+86
-87
lines changed

content/docs/accessibility.md

Lines changed: 19 additions & 19 deletions
Original file line numberDiff line numberDiff line change
@@ -19,8 +19,8 @@ The [Web Content Accessibility Guidelines](https://www.w3.org/WAI/intro/wcag) pr
1919
The following WCAG checklists provide an overview:
2020

2121
- [WCAG checklist from Wuhcag](https://www.wuhcag.com/wcag-checklist/)
22-
- [WCAG checklist from WebAIM](http://webaim.org/standards/wcag/checklist)
23-
- [Checklist from The A11Y Project](http://a11yproject.com/checklist.html)
22+
- [WCAG checklist from WebAIM](https://webaim.org/standards/wcag/checklist)
23+
- [Checklist from The A11Y Project](https://a11yproject.com/checklist.html)
2424

2525
### WAI-ARIA {#wai-aria}
2626

@@ -114,7 +114,7 @@ Every HTML form control, such as `<input>` and `<textarea>`, needs to be labeled
114114
The following resources show us how to do this:
115115

116116
- [The W3C shows us how to label elements](https://www.w3.org/WAI/tutorials/forms/labels/)
117-
- [WebAIM shows us how to label elements](http://webaim.org/techniques/forms/controls)
117+
- [WebAIM shows us how to label elements](https://webaim.org/techniques/forms/controls)
118118
- [The Paciello Group explains accessible names](https://www.paciellogroup.com/blog/2017/04/what-is-an-accessible-name/)
119119

120120
Although these standard HTML practices can be directly used in React, note that the `for` attribute is written as `htmlFor` in JSX:
@@ -129,13 +129,13 @@ Although these standard HTML practices can be directly used in React, note that
129129
Error situations need to be understood by all users. The following link shows us how to expose error texts to screen readers as well:
130130

131131
- [The W3C demonstrates user notifications](https://www.w3.org/WAI/tutorials/forms/notifications/)
132-
- [WebAIM looks at form validation](http://webaim.org/techniques/formvalidation/)
132+
- [WebAIM looks at form validation](https://webaim.org/techniques/formvalidation/)
133133

134134
## Focus Control {#focus-control}
135135

136136
Ensure that your web application can be fully operated with the keyboard only:
137137

138-
- [WebAIM talks about keyboard accessibility](http://webaim.org/techniques/keyboard/)
138+
- [WebAIM talks about keyboard accessibility](https://webaim.org/techniques/keyboard/)
139139

140140
### Keyboard focus and focus outline {#keyboard-focus-and-focus-outline}
141141

@@ -152,13 +152,13 @@ Provide a mechanism to allow users to skip past navigation sections in your appl
152152
Skiplinks or Skip Navigation Links are hidden navigation links that only become visible when keyboard users interact with the page. They are very easy to implement with
153153
internal page anchors and some styling:
154154

155-
- [WebAIM - Skip Navigation Links](http://webaim.org/techniques/skipnav/)
155+
- [WebAIM - Skip Navigation Links](https://webaim.org/techniques/skipnav/)
156156

157157
Also use landmark elements and roles, such as `<main>` and `<aside>`, to demarcate page regions as assistive technology allow the user to quickly navigate to these sections.
158158

159159
Read more about the use of these elements to enhance accessibility here:
160160

161-
- [Accessible Landmarks](http://www.scottohara.me/blog/2018/03/03/landmarks.html)
161+
- [Accessible Landmarks](https://www.scottohara.me/blog/2018/03/03/landmarks.html)
162162

163163
### Programmatically managing focus {#programmatically-managing-focus}
164164

@@ -387,7 +387,7 @@ These are toolboxes filled with HTML attributes that are fully supported in JSX
387387
Each type of widget has a specific design pattern and is expected to function in a certain way by users and user agents alike:
388388

389389
- [WAI-ARIA Authoring Practices - Design Patterns and Widgets](https://www.w3.org/TR/wai-aria-practices/#aria_ex)
390-
- [Heydon Pickering - ARIA Examples](http://heydonworks.com/practical_aria_examples/)
390+
- [Heydon Pickering - ARIA Examples](https://heydonworks.com/practical_aria_examples/)
391391
- [Inclusive Components](https://inclusive-components.design/)
392392

393393
## Other Points for Consideration {#other-points-for-consideration}
@@ -396,7 +396,7 @@ Each type of widget has a specific design pattern and is expected to function in
396396

397397
Indicate the human language of page texts as screen reader software uses this to select the correct voice settings:
398398

399-
- [WebAIM - Document Language](http://webaim.org/techniques/screenreader/#language)
399+
- [WebAIM - Document Language](https://webaim.org/techniques/screenreader/#language)
400400

401401
### Setting the document title {#setting-the-document-title}
402402

@@ -412,15 +412,15 @@ Ensure that all readable text on your website has sufficient color contrast to r
412412

413413
- [WCAG - Understanding the Color Contrast Requirement](https://www.w3.org/TR/UNDERSTANDING-WCAG20/visual-audio-contrast-contrast.html)
414414
- [Everything About Color Contrast And Why You Should Rethink It](https://www.smashingmagazine.com/2014/10/color-contrast-tips-and-tools-for-accessibility/)
415-
- [A11yProject - What is Color Contrast](http://a11yproject.com/posts/what-is-color-contrast/)
415+
- [A11yProject - What is Color Contrast](https://a11yproject.com/posts/what-is-color-contrast/)
416416

417-
It can be tedious to manually calculate the proper color combinations for all cases in your website so instead, you can [calculate an entire accessible color palette with Colorable](http://jxnblk.com/colorable/).
417+
It can be tedious to manually calculate the proper color combinations for all cases in your website so instead, you can [calculate an entire accessible color palette with Colorable](https://jxnblk.com/colorable/).
418418

419419
Both the aXe and WAVE tools mentioned below also include color contrast tests and will report on contrast errors.
420420

421421
If you want to extend your contrast testing abilities you can use these tools:
422422

423-
- [WebAIM - Color Contrast Checker](http://webaim.org/resources/contrastchecker/)
423+
- [WebAIM - Color Contrast Checker](https://webaim.org/resources/contrastchecker/)
424424
- [The Paciello Group - Color Contrast Analyzer](https://www.paciellogroup.com/resources/contrastanalyser/)
425425

426426
## Development and Testing Tools {#development-and-testing-tools}
@@ -471,7 +471,7 @@ You can also use the [react-axe](https://github.com/dylanb/react-axe) module to
471471

472472
#### WebAIM WAVE {#webaim-wave}
473473

474-
The [Web Accessibility Evaluation Tool](http://wave.webaim.org/extension/) is another accessibility browser extension.
474+
The [Web Accessibility Evaluation Tool](https://wave.webaim.org/extension/) is another accessibility browser extension.
475475

476476
#### Accessibility inspectors and the Accessibility Tree {#accessibility-inspectors-and-the-accessibility-tree}
477477

@@ -498,7 +498,7 @@ Please note that browser / screen reader combinations matter. It is recommended
498498

499499
Refer to the following guides on how to best use NVDA:
500500

501-
- [WebAIM - Using NVDA to Evaluate Web Accessibility](http://webaim.org/articles/nvda/)
501+
- [WebAIM - Using NVDA to Evaluate Web Accessibility](https://webaim.org/articles/nvda/)
502502
- [Deque - NVDA Keyboard Shortcuts](https://dequeuniversity.com/screenreaders/nvda-keyboard-shortcuts)
503503

504504
#### VoiceOver in Safari {#voiceover-in-safari}
@@ -507,26 +507,26 @@ VoiceOver is an integrated screen reader on Apple devices.
507507

508508
Refer to the following guides on how activate and use VoiceOver:
509509

510-
- [WebAIM - Using VoiceOver to Evaluate Web Accessibility](http://webaim.org/articles/voiceover/)
510+
- [WebAIM - Using VoiceOver to Evaluate Web Accessibility](https://webaim.org/articles/voiceover/)
511511
- [Deque - VoiceOver for OS X Keyboard Shortcuts](https://dequeuniversity.com/screenreaders/voiceover-keyboard-shortcuts)
512512
- [Deque - VoiceOver for iOS Shortcuts](https://dequeuniversity.com/screenreaders/voiceover-ios-shortcuts)
513513

514514
#### JAWS in Internet Explorer {#jaws-in-internet-explorer}
515515

516-
[Job Access With Speech](http://www.freedomscientific.com/Products/Blindness/JAWS) or JAWS, is a prolifically used screen reader on Windows.
516+
[Job Access With Speech](https://www.freedomscientific.com/Products/software/JAWS/) or JAWS, is a prolifically used screen reader on Windows.
517517

518518
Refer to the following guides on how to best use JAWS:
519519

520-
- [WebAIM - Using JAWS to Evaluate Web Accessibility](http://webaim.org/articles/jaws/)
520+
- [WebAIM - Using JAWS to Evaluate Web Accessibility](https://webaim.org/articles/jaws/)
521521
- [Deque - JAWS Keyboard Shortcuts](https://dequeuniversity.com/screenreaders/jaws-keyboard-shortcuts)
522522

523523
### Other Screen Readers {#other-screen-readers}
524524

525525
#### ChromeVox in Google Chrome {#chromevox-in-google-chrome}
526526

527-
[ChromeVox](http://www.chromevox.com/) is an integrated screen reader on Chromebooks and is available [as an extension](https://chrome.google.com/webstore/detail/chromevox/kgejglhpjiefppelpmljglcjbhoiplfn?hl=en) for Google Chrome.
527+
[ChromeVox](https://www.chromevox.com/) is an integrated screen reader on Chromebooks and is available [as an extension](https://chrome.google.com/webstore/detail/chromevox/kgejglhpjiefppelpmljglcjbhoiplfn?hl=en) for Google Chrome.
528528

529529
Refer to the following guides on how best to use ChromeVox:
530530

531531
- [Google Chromebook Help - Use the Built-in Screen Reader](https://support.google.com/chromebook/answer/7031755?hl=en)
532-
- [ChromeVox Classic Keyboard Shortcuts Reference](http://www.chromevox.com/keyboard_shortcuts.html)
532+
- [ChromeVox Classic Keyboard Shortcuts Reference](https://www.chromevox.com/keyboard_shortcuts.html)

content/docs/add-react-to-a-website.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -149,7 +149,7 @@ return (
149149

150150
Estos dos fragmentos de código son equivalentes. Mientras **JSX es [completamente opcional](/docs/react-without-jsx.html)**, muchas personas lo encuentran útil para escribir código relacionado con la interfaz de usuario -- ya sea usando React o con otras bibliotecas.
151151

152-
Puedes experimentar con JSX usando [este conversor en línea](http://babeljs.io/repl#?babili=false&browsers=&build=&builtIns=false&spec=false&loose=false&code_lz=Q&debug=false&forceAllTransforms=false&shippedProposals=false&circleciRepo=&evaluate=false&fileSize=false&sourceType=module&lineWrap=true&presets=es2015%2Creact%2Cstage-2%2Cstage-3&prettier=true&targets=Node-6.12&version=6.26.0&envVersion=).
152+
Puedes experimentar con JSX usando [este conversor en línea](https://babeljs.io/repl#?babili=false&browsers=&build=&builtIns=false&spec=false&loose=false&code_lz=Q&debug=false&forceAllTransforms=false&shippedProposals=false&circleciRepo=&evaluate=false&fileSize=false&sourceType=module&lineWrap=true&presets=es2015%2Creact%2Cstage-2%2Cstage-3&prettier=true&targets=Node-6.12&version=6.26.0&envVersion=).
153153

154154
### Prueba JSX de forma rápida {#quickly-try-jsx}
155155

@@ -197,6 +197,6 @@ No esperes hasta que termine -- este comando inicia un observador automático pa
197197

198198
Si ahora creas un archivo llamado `src/like_button.js` con este **[código inicial de JSX](https://cdn.rawgit.com/gaearon/c8e112dc74ac44aac4f673f2c39d19d1/raw/09b951c86c1bf1116af741fa4664511f2f179f0a/like_button.js)**, el observador va a crear un `like_button.js` preprocesado con el código JavaScript original que es apto para el navegador. Cuando edites el código del archivo que tiene JSX, el transformador va a volver a ejecutarse de forma automática.
199199

200-
Como un bonus, esto también te permite utilizar características nuevas de la sintaxis de JavaScript, como las clases, sin que te preocupes de que no funcionen en navegadores antiguos. La herramienta que hemos usado se llama Babel, y puedes leer más sobre ella en [su documentación](http://babeljs.io/docs/en/babel-cli/).
200+
Como un bonus, esto también te permite utilizar características nuevas de la sintaxis de JavaScript, como las clases, sin que te preocupes de que no funcionen en navegadores antiguos. La herramienta que hemos usado se llama Babel, y puedes leer más sobre ella en [su documentación](https://babeljs.io/docs/en/babel-cli/).
201201

202202
Si notas que se te está haciendo más cómodo manejar las herramientas de configuración y quieres sacarle mayor provecho, [en la próxima sección](/docs/create-a-new-react-app.html) se describen unas de las cadenas de herramientas más populares y accesibles. Dado el caso que no te sientas así -- esas etiquetas de script serán suficiente.

content/docs/addons-perf.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -27,8 +27,8 @@ In addition to giving you an overview of your app's overall performance, `Perf`
2727
See these articles for an introduction to React performance tooling:
2828

2929
- ["How to Benchmark React Components"](https://medium.com/code-life/how-to-benchmark-react-components-the-quick-and-dirty-guide-f595baf1014c)
30-
- ["Performance Engineering with React"](http://benchling.engineering/performance-engineering-with-react/)
31-
- ["A Deep Dive into React Perf Debugging"](http://benchling.engineering/deep-dive-react-perf-debugging/)
30+
- ["Performance Engineering with React"](https://benchling.engineering/performance-engineering-with-react/)
31+
- ["A Deep Dive into React Perf Debugging"](https://benchling.engineering/deep-dive-react-perf-debugging/)
3232

3333
### Development vs. Production Builds {#development-vs-production-builds}
3434

content/docs/addons-shallow-renderer.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -51,7 +51,7 @@ Las pruebas superficiales tienen algunas limitaciones, es decir, no soportan ref
5151

5252
> Nota:
5353
>
54-
> También recomendamos revisar la [API de Renderizado Superficial](http://airbnb.io/enzyme/docs/api/shallow.html) de Enzyme. Provee una API de alto nivel mucho mejor de la misma funcionalidad.
54+
> También recomendamos revisar la [API de Renderizado Superficial](https://airbnb.io/enzyme/docs/api/shallow.html) de Enzyme. Provee una API de alto nivel mucho mejor de la misma funcionalidad.
5555
5656
## Referencia {#referencia}
5757

content/docs/addons-test-utils.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -15,13 +15,13 @@ var ReactTestUtils = require('react-dom/test-utils'); // ES5 con npm
1515

1616
## Introducción {#overview}
1717

18-
`ReactTestUtils` facilita probar los componentes de React en cualquiera de los frameworks de pruebas que elijas. En Facebook usamos [Jest](https://facebook.github.io/jest/) para realizar las pruebas de JavaScript sin problemas. Aprende como iniciar con Jest en el [tutorial para React](http://facebook.github.io/jest/docs/en/tutorial-react.html#content) que se encuentra en el sitio web de Jest.
18+
`ReactTestUtils` facilita probar los componentes de React en cualquiera de los frameworks de pruebas que elijas. En Facebook usamos [Jest](https://facebook.github.io/jest/) para realizar las pruebas de JavaScript sin problemas. Aprende como iniciar con Jest en el [tutorial para React](https://jestjs.io/docs/tutorial-react) que se encuentra en el sitio web de Jest.
1919

2020
> Nota:
2121
>
2222
> Recomendamos utilizar [`react-testing-library`](https://git.io/react-testing-library) que está diseñada para permitir e incentivar la escritura de las pruebas para que usen los componentes de la misma forma en que lo harían los usuarios finales.
2323
>
24-
> Como otra opción, Airbnb ha liberado una utilidad de pruebas llamada [Enzyme](http://airbnb.io/enzyme/), que hace fácil asegurar, manipular y navegar por los resultados de tus Componentes de React.
24+
> Como otra opción, Airbnb ha liberado una utilidad de pruebas llamada [Enzyme](https://airbnb.io/enzyme/), que hace fácil asegurar, manipular y navegar por los resultados de tus Componentes de React.
2525
2626
- [`act()`](#act)
2727
- [`mockComponent()`](#mockcomponent)

content/docs/addons-update.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -21,7 +21,7 @@ var update = require('react-addons-update'); // ES5 with npm
2121

2222
React lets you use whatever style of data management you want, including mutation. However, if you can use immutable data in performance-critical parts of your application it's easy to implement a fast [`shouldComponentUpdate()`](/docs/react-component.html#shouldcomponentupdate) method to significantly speed up your app.
2323

24-
Dealing with immutable data in JavaScript is more difficult than in languages designed for it, like [Clojure](http://clojure.org/). However, we've provided a simple immutability helper, `update()`, that makes dealing with this type of data much easier, *without* fundamentally changing how your data is represented. You can also take a look at Facebook's [Immutable-js](https://facebook.github.io/immutable-js/docs/) and the [Advanced Performance](/docs/advanced-performance.html) section for more detail on Immutable-js.
24+
Dealing with immutable data in JavaScript is more difficult than in languages designed for it, like [Clojure](https://clojure.org/). However, we've provided a simple immutability helper, `update()`, that makes dealing with this type of data much easier, *without* fundamentally changing how your data is represented. You can also take a look at Facebook's [Immutable-js](https://facebook.github.io/immutable-js/docs/) and the [Advanced Performance](/docs/advanced-performance.html) section for more detail on Immutable-js.
2525

2626
### The Main Idea {#the-main-idea}
2727

@@ -67,7 +67,7 @@ const newData = update(myData, {
6767
});
6868
```
6969

70-
While the syntax takes a little getting used to (though it's inspired by [MongoDB's query language](http://docs.mongodb.org/manual/core/crud-introduction/#query)) there's no redundancy, it's statically analyzable and it's not much more typing than the mutative version.
70+
While the syntax takes a little getting used to (though it's inspired by [MongoDB's query language](https://docs.mongodb.com/manual/crud/#query)) there's no redundancy, it's statically analyzable and it's not much more typing than the mutative version.
7171

7272
The `$`-prefixed keys are called *commands*. The data structure they are "mutating" is called the *target*.
7373

content/docs/code-splitting.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -94,7 +94,7 @@ configurado para ti y puedes comenzar a [usarlo](https://github.com/facebookincu
9494

9595
Si configuras Webpack por ti mismo, probablemente vas a querer leer la [guía sobre división de código](https://webpack.js.org/guides/code-splitting/) de Webpack. Tu configuración de Webpack debería verse vagamente [como esta](https://gist.github.com/gaearon/ca6e803f5c604d37468b0091d9959269).
9696

97-
Cuando uses [Babel](http://babeljs.io/), tienes que asegurarte de que Babel reconozca la sintaxis de `import()` dinámico pero no la transforme. Para ello vas a necesitar el [babel-plugin-syntax-dynamic-import](https://yarnpkg.com/en/package/babel-plugin-syntax-dynamic-import).
97+
Cuando uses [Babel](https://babeljs.io/), tienes que asegurarte de que Babel reconozca la sintaxis de `import()` dinámico pero no la transforme. Para ello vas a necesitar el [babel-plugin-syntax-dynamic-import](https://yarnpkg.com/es-ES/package/babel-plugin-syntax-dynamic-import).
9898

9999
## `React.lazy` {#reactlazy}
100100

content/docs/codebase-overview.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -155,7 +155,7 @@ There are multiple injection points in the codebase. In the future, we intend to
155155

156156
### Multiple Packages {#multiple-packages}
157157

158-
React is a [monorepo](http://danluu.com/monorepo/). Its repository contains multiple separate packages so that their changes can be coordinated together, and issues live in one place.
158+
React is a [monorepo](https://danluu.com/monorepo/). Its repository contains multiple separate packages so that their changes can be coordinated together, and issues live in one place.
159159

160160
### React Core {#react-core}
161161

@@ -171,7 +171,7 @@ The code for React core is located in [`packages/react`](https://github.com/face
171171

172172
### Renderers {#renderers}
173173

174-
React was originally created for the DOM but it was later adapted to also support native platforms with [React Native](http://facebook.github.io/react-native/). This introduced the concept of "renderers" to React internals.
174+
React was originally created for the DOM but it was later adapted to also support native platforms with [React Native](https://facebook.github.io/react-native/). This introduced the concept of "renderers" to React internals.
175175

176176
**Renderers manage how a React tree turns into the underlying platform calls.**
177177

0 commit comments

Comments
 (0)