From ca56bb2934a83628232eb738901abbaec2532130 Mon Sep 17 00:00:00 2001 From: Eka Date: Tue, 9 Jul 2019 21:18:00 +0700 Subject: [PATCH] Recommit Accessibility translation with original yarn.lock --- content/docs/accessibility.md | 353 ++++++++++++++++------------------ 1 file changed, 168 insertions(+), 185 deletions(-) diff --git a/content/docs/accessibility.md b/content/docs/accessibility.md index 663251a03..6f4fd07ee 100644 --- a/content/docs/accessibility.md +++ b/content/docs/accessibility.md @@ -1,32 +1,32 @@ --- id: accessibility -title: Accessibility +title: Aksesibilitas permalink: docs/accessibility.html --- -## Why Accessibility? {#why-accessibility} +## Mengapa aksesibilitas? {#why-accessibility} -Web accessibility (also referred to as [**a11y**](https://en.wiktionary.org/wiki/a11y)) is the design and creation of websites that can be used by everyone. Accessibility support is necessary to allow assistive technology to interpret web pages. +Aksesibilitas web (juga dikenal dengan istilah [**a11y**](https://en.wiktionary.org/wiki/a11y)) adalah perancangan dan pembuatan situs web yang dapat digunakan oleh semua orang. Dukungan aksesibilitas diperlukan agar teknologi asistif—misalnya alat pembaca layar untuk pengguna tuna netra—dapat memahami dan menyampaikan isi halaman web. -React fully supports building accessible websites, often by using standard HTML techniques. +React sepenuhnya mendukung pembuatan situs web yang aksesibel, pada umumnya melalui penggunaan teknik-teknik HTML standar. -## Standards and Guidelines {#standards-and-guidelines} +## Standar dan Pedoman {#standards-and-guidelines} ### WCAG {#wcag} -The [Web Content Accessibility Guidelines](https://www.w3.org/WAI/intro/wcag) provides guidelines for creating accessible web sites. +[Web Content Accessibility Guidelines](https://www.w3.org/WAI/intro/wcag) (Panduan Aksesibilitas Konten Web) menyediakan panduan untuk membuat situs web yang aksesibel. -The following WCAG checklists provide an overview: +Daftar cek dari WCAG di bawah ini dapat memberikan gambaran umum: -- [WCAG checklist from Wuhcag](https://www.wuhcag.com/wcag-checklist/) -- [WCAG checklist from WebAIM](http://webaim.org/standards/wcag/checklist) -- [Checklist from The A11Y Project](http://a11yproject.com/checklist.html) +- [Daftar cek WCAG dari Wuhcag](https://www.wuhcag.com/wcag-checklist/) +- [Daftar cek WCAG dari WebAIM](http://webaim.org/standards/wcag/checklist) +- [Daftar cek dari The A11Y Project](http://a11yproject.com/checklist.html) ### WAI-ARIA {#wai-aria} -The [Web Accessibility Initiative - Accessible Rich Internet Applications](https://www.w3.org/WAI/intro/aria) document contains techniques for building fully accessible JavaScript widgets. +Dokumen [Web Accessibility Initiative - Accessible Rich Internet Applications](https://www.w3.org/WAI/intro/aria) (Inisiatif Aksesibilitas Web - Aplikasi Internet Kaya yang Aksesibel) berisi teknik-teknik untuk membuat _widget_ JavaScript yang sepenuhnya aksesibel. -Note that all `aria-*` HTML attributes are fully supported in JSX. Whereas most DOM properties and attributes in React are camelCased, these attributes should be hyphen-cased (also known as kebab-case, lisp-case, etc) as they are in plain HTML: +JSX sepenuhnya mendukung semua atribut HTML `aria-*`. Berbeda dengan sebagian besar properti DOM dan atribut lain di React yang ditulis dengan _camelCase_ (inisial kata selain kata pertama menggunakan huruf kapital), atribut `aria-*` menggunakan _hyphen-case_ (seluruh kata ditulis dengan huruf kecil dan dipisahkan tanda “-“) karena atribut-atribut tersebut ditulis dalam HTML biasa: ```javascript{3,4} ``` -## Semantic HTML {#semantic-html} -Semantic HTML is the foundation of accessibility in a web application. Using the various HTML elements to reinforce the meaning of information -in our websites will often give us accessibility for free. +## HTML Semantik {#semantic-html} -- [MDN HTML elements reference](https://developer.mozilla.org/en-US/docs/Web/HTML/Element) +HTML yang semantik merupakan landasan aksesibilitas dalam suatu aplikasi web. Dengan menggunakan berbagai elemen HTML untuk memperkuat makna informasi di situs web kita, sering kali kita dapat memperoleh manfaat aksesibilitas secara cuma-cuma. -Sometimes we break HTML semantics when we add `
` elements to our JSX to make our React code work, especially when working with lists (`
    `, `
      ` and `
      `) and the HTML ``. -In these cases we should rather use [React Fragments](/docs/fragments.html) to group together multiple elements. +- [Referensi elemen HTML di MDN](https://developer.mozilla.org/id/docs/Web/HTML/Element) -For example, +Kadang kita melanggar kaidah semantik HTML dengan menambahkan elemen `
      ` ke dalam JSX agar kode React berjalan dengan baik, khususnya saat berurusan dengan elemen-elemen daftar (`
        `, `
          `, dan `
          `) serta `
      ` HTML. Dalam kasus demikian, alih-alih `
      `, gunakan [_Fragment_ React](/docs/fragments.html) untuk mengelompokkan beberapa elemen. + +Contohnya, ```javascript{1,5,8} import React, { Fragment } from 'react'; @@ -73,14 +72,14 @@ function Glossary(props) { } ``` -You can map a collection of items to an array of fragments as you would any other type of element as well: +Anda juga dapat memetakan sekumpulan _item_ pada senarai (_array_) berisi fragmen, sama seperti elemen-elemen lainnya: ```javascript{6,9} function Glossary(props) { return (
      {props.items.map(item => ( - // Fragments should also have a `key` prop when mapping collections + // Fragment juga harus memiliki prop `key` untuk memetakan koleksi
      {item.term}
      {item.description}
      @@ -91,7 +90,7 @@ function Glossary(props) { } ``` -When you don't need any props on the Fragment tag you can use the [short syntax](/docs/fragments.html#short-syntax), if your tooling supports it: +Jika _tag_ _Fragment_ Anda tidak membutuhkan _props_ dan jika peralatan Anda mendukung, Anda dapat menggunakan [sintaks singkat](/docs/fragments.html#short-syntax): ```javascript{3,6} function ListItem({ item }) { @@ -104,83 +103,83 @@ function ListItem({ item }) { } ``` -For more info, see [the Fragments documentation](/docs/fragments.html). +Untuk info selengkapnya, lihat [dokumentasi _Fragment_](/docs/fragments.html). + +## Formulir yang Aksesibel {#accessible-forms} -## Accessible Forms {#accessible-forms} +### Pelabelan {#labeling} -### Labeling {#labeling} -Every HTML form control, such as `` and `