Skip to content

Commit 06deed4

Browse files
ari-os310ari-os310
committed
Spanish README completed
1 parent 7730d0d commit 06deed4

File tree

1 file changed

+174
-11
lines changed

1 file changed

+174
-11
lines changed

‎translations/README.mx.md

+174-11
Original file line numberDiff line numberDiff line change
@@ -98,16 +98,40 @@ Añade `plugin:jsx-a11y/recommended` o `plugin:jsx-a11y/strict` dentro "`extends
9898

9999
## Reglas Soportadas
100100

101-
- [accessible-emoji](docs/rules/accessible-emoji.md): Enforce emojis are wrapped in `<span>` and provide screenreader access.
102-
- [alt-text](docs/rules/alt-text.md): Enforce all elements that require alternative text have meaningful information to relay back to end user.
103-
- [anchor-has-content](docs/rules/anchor-has-content.md): Enforce all anchors to contain accessible content.
104-
- [anchor-is-valid](docs/rules/anchor-is-valid.md): Enforce all anchors are valid, navigable elements.
105-
- [aria-activedescendant-has-tabindex](docs/rules/aria-activedescendant-has-tabindex.md): Enforce elements with aria-activedescendant are tabbable.
106-
- [aria-props](docs/rules/aria-props.md): Enforce all `aria-*` props are valid.
107-
- [aria-proptypes](docs/rules/aria-proptypes.md): Enforce ARIA state and property values are valid.
108-
- [aria-role](docs/rules/aria-role.md): Enforce that elements with ARIA roles must use a valid, non-abstract ARIA role.
109-
- [aria-unsupported-elements](docs/rules/aria-unsupported-elements.md): Enforce that elements that do not support ARIA roles, states, and properties do not have those attributes.
110-
- [autocomplete-valid](docs/rules/autocomplete-valid.md): Enforce that autocomplete attributes are used correctly.
101+
- [accessible-emoji](docs/rules/accessible-emoji.md): Enforce emojis están envueltos en `<span>` y brindan acceso al lector de pantalla.
102+
- [alt-text](docs/rules/alt-text.md): Enforce todos los elementos que requieren texto alternativo tenga información significativa para transmitir al usuario.
103+
- [anchor-has-content](docs/rules/anchor-has-content.md): Enforce todos los anclajes contengan contenido accesible.
104+
- [anchor-is-valid](docs/rules/anchor-is-valid.md): Enforce todas las anclas son elementos navegables válidos.
105+
- [aria-activedescendant-has-tabindex](docs/rules/aria-activedescendant-has-tabindex.md): Enforce elementos con aria-activedescendant son accesibles por tab.
106+
- [aria-props](docs/rules/aria-props.md): Enforce todos los accesorios `aria- *` son válidos.
107+
- [aria-proptypes](docs/rules/aria-proptypes.md): Enforce el estado ARIA y los valores de propiedad son válidos
108+
- [aria-role](docs/rules/aria-role.md): Enforce que los elementos con roles ARIA deben usar un rol ARIA válido y no abstracto.
109+
- [aria-unsupported-elements](docs/rules/aria-unsupported-elements.md): Enforce que los elementos que no admitan roles, estados y propiedades de ARIA no tengan esos atributos.
110+
- [autocomplete-valid](docs/rules/autocomplete-valid.md): Enforce los atributos de autocompletar se utilicen correctamente.
111+
- [click-events-have-key-events](docs/rules/click-events-have-key-events.md): Enforce un elemento no interactivo de clic tiene al menos un detector de eventos de teclado.
112+
- [heading-has-content](docs/rules/heading-has-content.md): Enforce los elementos de encabezada (`h1`,` h2`, etc.) contienen contenido accesible.
113+
- [html-has-lang](docs/rules/html-has-lang.md): Enforce el elemento `<html>` tiene la propiedad `lang`.
114+
- [iframe-has-title](docs/rules/iframe-has-title.md): Enforce los elementos de iframe tiene un atributo de título.
115+
- [img-redundant-alt](docs/rules/img-redundant-alt.md): Enforce `<img>` alt prop no contiene la palabra "imagen", "imagen" o "foto".
116+
- [interactive-supports-focus](docs/rules/interactive-supports-focus.md): Enforce los elementos con controladores interactivos como "onClick" deben poder enfocarse.
117+
- [label-has-associated-control](docs/rules/label-has-associated-control.md): Enforce una etiqueta `label` tenga una etiqueta de texto y un control asociado.
118+
- [lang](docs/rules/lang.md): Enforce el atributo lang tiene un valor válido.
119+
- [media-has-caption](docs/rules/media-has-caption.md): Enforce los elementos `<audio>` y `<video>` tiene un `<track>` para los subtítulos.
120+
- [mouse-events-have-key-events](docs/rules/mouse-events-have-key-events.md): Enforce que `onMouseOver`/`onMouseOut` son acompañados por `onFocus`/`onBlur` para usuarios de solo teclado.
121+
- [no-access-key](docs/rules/no-access-key.md): Enforce la propiedad `accessKey` no se use en ningún elemento para evitar complicaciones con comandos del teclado usados por un lector de pantalla
122+
- [no-autofocus](docs/rules/no-autofocus.md): Enforce que no se utilice propiedad autoFocus.
123+
- [no-distracting-elements](docs/rules/no-distracting-elements.md): Enforce elementos que distraen no se utilizen.
124+
- [no-interactive-element-to-noninteractive-role](docs/rules/no-interactive-element-to-noninteractive-role.md): Elementos interactivos no se les deben asignar roles no interactivos.
125+
- [no-noninteractive-element-interactions](docs/rules/no-noninteractive-element-interactions.md): Elementos no interactivos no se les debe asignar detectores de eventos de mouse o teclado.
126+
- [no-noninteractive-element-to-interactive-role](docs/rules/no-noninteractive-element-to-interactive-role.md): Elementos no interactivos no se les deben asignar roles interactivos.
127+
- [no-noninteractive-tabindex](docs/rules/no-noninteractive-tabindex.md): Declare `tabIndex` solo en elementos interactivos.
128+
- [no-onchange](docs/rules/no-onchange.md): Enforce `onBlur` sobre ` onChange` en menús selectos para accesibilidad.
129+
- [no-redundant-roles](docs/rules/no-redundant-roles.md): Enforce propiedad de función explícita no es lo mismo que la propiedad de función implícita / predeterminada en el elemento.
130+
- [no-static-element-interactions](docs/rules/no-static-element-interactions.md): Enforce elementos visibles no interactivos (como `<div>`) que tienen controladores de clic usan el atributo de rol.
131+
- [role-has-required-aria-props](docs/rules/role-has-required-aria-props.md): Enforce elementos con roles ARIA tengan todos los atributos requeridos para ese rol.
132+
- [role-supports-aria-props](docs/rules/role-supports-aria-props.md): Enforce elementos con roles explícitos o implícitos definidos contengan solo propiedades `aria- *` admitidas por ese `rol`.
133+
- [scope](docs/rules/scope.md): Enforce `scope` prop solo se usa en elementos` <th> `.
134+
- [tabindex-no-positive](docs/rules/tabindex-no-positive.md): Enforce el valor de `tabIndex` no es mas de cero.
111135

112136
### Diferencia entre modos 'recomendedo' y 'estricto'
113137

@@ -147,5 +171,144 @@ Añade `plugin:jsx-a11y/recommended` o `plugin:jsx-a11y/strict` dentro "`extends
147171
| [scope](https://github.com/evcohen/eslint-plugin-jsx-a11y/blob/master/docs/rules/scope.md) | error, con opciones | error |
148172
| [tabindex-no-positive](https://github.com/evcohen/eslint-plugin-jsx-a11y/blob/master/docs/rules/tabindex-no-positive.md) | error | error |
149173

174+
Las siguiente reglas tienen otras opciones disponibles cuando en modo *recomendado*:
150175

151-
Las siguiente reglas tienen otras opciones disponibles cuando en modo *recomendado*:
176+
#### no-interactive-element-to-noninteractive-role
177+
178+
```js
179+
'jsx-a11y/no-interactive-element-to-noninteractive-role': [
180+
'error',
181+
{
182+
tr: ['none', 'presentation'],
183+
},
184+
]
185+
```
186+
187+
#### no-noninteractive-element-interactions
188+
189+
```js
190+
'jsx-a11y/no-noninteractive-element-interactions': [
191+
'error',
192+
{
193+
handlers: [
194+
'onClick',
195+
'onMouseDown',
196+
'onMouseUp',
197+
'onKeyPress',
198+
'onKeyDown',
199+
'onKeyUp',
200+
],
201+
},
202+
]
203+
```
204+
205+
#### no-noninteractive-element-to-interactive-role
206+
207+
```js
208+
'jsx-a11y/no-noninteractive-element-to-interactive-role': [
209+
'error',
210+
{
211+
ul: [
212+
'listbox',
213+
'menu',
214+
'menubar',
215+
'radiogroup',
216+
'tablist',
217+
'tree',
218+
'treegrid',
219+
],
220+
ol: [
221+
'listbox',
222+
'menu',
223+
'menubar',
224+
'radiogroup',
225+
'tablist',
226+
'tree',
227+
'treegrid',
228+
],
229+
li: ['menuitem', 'option', 'row', 'tab', 'treeitem'],
230+
table: ['grid'],
231+
td: ['gridcell'],
232+
},
233+
]
234+
```
235+
236+
#### no-noninteractive-tabindex
237+
238+
```js
239+
'jsx-a11y/no-noninteractive-tabindex': [
240+
'error',
241+
{
242+
tags: [],
243+
roles: ['tabpanel'],
244+
},
245+
]
246+
```
247+
248+
#### no-static-element-interactions
249+
250+
```js
251+
'jsx-a11y/no-noninteractive-element-interactions': [
252+
'error',
253+
{
254+
handlers: [
255+
'onClick',
256+
'onMouseDown',
257+
'onMouseUp',
258+
'onKeyPress',
259+
'onKeyDown',
260+
'onKeyUp',
261+
],
262+
},
263+
]
264+
```
265+
266+
## Creando una nueva regla
267+
268+
Si está desarrollando nuevas reglas para este proyecto, puede usar el `create-rule` script para aplicar scaffolding a los nuevos archivos.
269+
270+
```
271+
$ ./scripts/create-rule.js my-new-rule
272+
```
273+
274+
## Contexto sobre WAI-ARIA, el árbol AX y los navegadores
275+
276+
### API de accesibilidad
277+
278+
El sistema operativo proporcionará un API de accesibilidad que mapea el estado y el contenido de la aplicación en controladores de entrada / salida, como ejemplo un lector de pantalla, dispositivo braille, teclado, etc.
279+
280+
Estas APIs se desarrollaron cuando las interfaces de computadora se cambiaron de búferes (que son basados en texto e intrínsecamente bastante accesibles) a interfaces gráficas de usuario (GUI). Los primeros intentos de hacer GUIs accesibles involucraron el análisis sintáctico de imágenes ráster para reconocer caracteres, palabras, etc. Esta información se almacenó en un búfer paralelo y se hizo accesible a los dispositivos de tecnología de asistencia (AT).
281+
282+
Las GUIs se volvieron más complejas, y el análisis sintáctico ráster se volvió insostenible. Las APIs de accesibilidad fueron desarrolladasolladas para reemplazarlas. Consulte [NSAccessibility (AXAPI)](https://developer.apple.com/library/mac/documentation/Cocoa/Reference/ApplicationKit/Protocols/NSAccessibility_Protocol/index.html) por ejemplos. Consulte [Core Accessibility API Mappings 1.1](https://www.w3.org/TR/core-aam-1.1/) para más detalles.
283+
284+
### Navegadores
285+
286+
Los navegadores apoyan ciertad API de accesibilidad dependiendo en el sistema operativo. Por ejemplo, Firefox implementa la API de accesibilidad MSAA en Windows, pero no implementa AXAPI en OSX.
287+
288+
### El árbol de accesibilidad (AX) y DOM
289+
290+
De parte de [W3 Core Accessibility API Mappings 1.1](https://www.w3.org/TR/core-aam-1.1/#intro_treetypes)
291+
292+
> El árbol de accesibilidad y el árbol DOM son estructuras paralelas. En términos generales, el árbol de accesibilidad es un subconjunto del árbol DOM. Incluye los objetos de la interfaz de usuario y los objetos del documento. Los objetos accesibles se crean en el árbol de accesibilidad por cada elemento DOM que debe ser expuesto a la tecnología de asistencia, ya sea porque puede desencadenar un evento de accesibilidad o porque tiene una propiedad, relación o característica que debe exponerse. Generalmente, si algo puede ser omitido, sera, por razones de rendimiento y simplicidad. Por ejemplo, un `<span>` con solo un cambio de estilo y sin semántica puede que no obtenga su propio objeto accesible, pero el cambio de estilo será expuesto por otros medios.
293+
294+
Los proveedores de navegadores están comenzando a exponer el árbol AX a través de herramientas de inspección. Chrome tiene un experimento disponible para permitir su herramienta de inspección.
295+
296+
También puede ver una versión basada en texto del árbol AX en Chrome en la versión estable.
297+
298+
#### Ver el árbol de AX en Chrome
299+
300+
1. Navegar a `chrome://accessibility/` en Chrome.
301+
1. Cambie el `accessibility off` enlace por cualquier tab que quiere inspeccionar.
302+
1. Un enlace mostrando `show accessibility tree` aparecerá; seleccione el enlace.
303+
1. Vacile ansiosamente a la pantalla de texto, pero luego recupere su convicción.
304+
1. Utilice el comando de búsqueda para localizar cadenas y valores en el texto.
305+
306+
### Juntándolo todo
307+
308+
El navegador construye un árbol AX como un subconjunto del DOM. ARIA informa en gran medida las propiedades del árbol AX. Este árbol AX está expuesto a la API de accesibilidad a nivel del sistema, que actúa como intermediario en los agentes de tecnología de asistencia.
309+
310+
Modelamos ARIA en el proyecto [aria-query](https://github.com/a11yance/aria-query). Modelamos AXObjects (que componen el árbol AX) en el proyecto [axobject-query](https://github.com/A11yance/axobject-query). El objetivo de la especificación WAI-ARIA es ser una interfaz declarativa completa para el modelo AXObject. La [versión 1.2 en borrador](https://github.com/w3c/aria/issues?q=is%3Aissue+is%3Aopen+label%3A%22ARIA+1.2%22) avanza hacia este objetivo. Pero hasta entonces, debemos considerar las construcciones semánticas que ofrece ARIA, así como las que ofrece el modelo AXObject (AXAPI) para determinar cómo se puede usar HTML para expresar las ofrendas de la interfaz de usuario para los usuarios de tecnología de asistencia.
311+
312+
## Licencia
313+
314+
eslint-plugin-jsx-a11y es licenciada bajo el [MIT License](LICENSE.md).

0 commit comments

Comments
 (0)