# 접근성: 사용자 지정 웹 애플리케이션에 ARIA 속성 추가하기

Source: https://support.wix.com/ko/article/%EC%A0%91%EA%B7%BC%EC%84%B1-%EC%82%AC%EC%9A%A9%EC%9E%90-%EC%A7%80%EC%A0%95-%EC%9B%B9-%EC%95%A0%ED%94%8C%EB%A6%AC%EC%BC%80%EC%9D%B4%EC%85%98%EC%97%90-aria-%EC%86%8D%EC%84%B1-%EC%B6%94%EA%B0%80%ED%95%98%EA%B8%B0 (updated 2025-08-13)
Related: Wix developer documentation, https://dev.wix.com/docs/llms.txt; Help Center index, https://support.wix.com/en/llms.txt

ARIA 속성은 스크린 리더와 같은 보조 기술 요소의 의미 체계에 대한 추가 정보를 제공합니다. ARIA 속성을 사이트의 모든 사용자 지정 요소 또는 애플리케이션에 추가할 수 있습니다.

ARIA 속성은 요소의 기본 HTML로 액세스할 수 없는 경우 사용자 지정 요소 및 애플리케이션에 액세스할 수 있는 방법을 정의하므로 중요합니다.

> **중요!** 이 기능은 ARIA 속성이 필요한 사용자 지정 애플리케이션/요소를 보유한 사용자를 대상으로 합니다. 사이트에 ARIA 속성이 없다면 ARIA 속성을 편집할 필요가 없습니다.

---

## ARIA 속성 추가하기

Wix는 사이트 대부분의 요소에 대해 이미 ARIA 속성을 하드코딩했습니다. 하지만 사용자 지정 애플리케이션을 추가한 경우 접근성을 위해 고유한 ARIA 속성을 추가할 수 있습니다.

**Studio 에디터:**

Studio 에디터에서 개발자 모드(Velo by Wix)를 활성화해 요소에 속성을 추가하세요. Velo를 사용하면 [코딩 추가, 데이터베이스 구축 등](https://dev.wix.com/docs/develop-websites/articles/getting-started/about-velo-by-wix)의 작업을 수행할 수 있습니다.

1. 에디터 왼쪽에서 **코드**![](https://d2x3xhvgiqkx42.cloudfront.net/12345678-1234-1234-1234-1234567890ab/8696077d-830a-4b1e-bd86-9df98f89994a/2023/07/31/0de74f7a-9d8a-4c0c-8279-219bd3eefe97/d55e629b-e8dc-4acc-8af2-7a7779fb8bbc.png) 아이콘을 클릭합니다.
2. 해당 앱 또는 요소를 선택한 후 **추가 작업**![](https://lh7-us.googleusercontent.com/docsz/AD_4nXdFGzMGNDzgiZQ0F979Jv1-o5331SfuPnrxO8m55pHp_EiDKy7_zvShglz_oxBkkonbL4dOmmectOTVLG8_Lwhsvbvn33GQEVRVFTt0SaKfQnbZ33f2OyrtaR5ki1Fo_2ovT0Vy4H_uPEi3jljAkW-gqs8?key=dRllTO6NEoYu0-D1JuBE8A) 아이콘을 클릭합니다.
3. **접근성**을 선택합니다.
4. **속성 추가**를 선택합니다.
5. 드롭다운 메뉴에서 속성을 선택합니다.
6. 라벨을 입력합니다. / 레벨 또는 값을 선택합니다.
7. **추가**를 선택합니다.

![Studio 에디터에서 요소의 접근성 패널입니다. 커서가 속성 추가 버튼을 클릭하고 있습니다.](https://d2x3xhvgiqkx42.cloudfront.net/12345678-1234-1234-1234-1234567890ab/651c25b0-2d60-43c8-addf-1df2fd575568/2024/06/06/28953d00-e0af-4830-9a6e-befc645463b7/d306108c-c260-44f0-8301-e5713d96a4c6.jpg)

**Wix 에디터:**

[접근성 마법사](https://support.wix.com/koarticle/accessibility-about-the-accessibility-wizard-7284021)에서 개발자 도구를 활성화해 사용자 지정 요소에 ARIA 속성을 추가할 수 있습니다. 요소 또는 애플리케이션을 마우스 오른쪽 버튼으로 클릭해 속성을 추가할 수 있습니다.

1. 에디터 상단 바에서 **설정**을 선택합니다.
2. **접근성 마법사**를 선택합니다.
3. 마법사 상단 바에서 **추가 작업**![](https://lh7-us.googleusercontent.com/docsz/AD_4nXdFGzMGNDzgiZQ0F979Jv1-o5331SfuPnrxO8m55pHp_EiDKy7_zvShglz_oxBkkonbL4dOmmectOTVLG8_Lwhsvbvn33GQEVRVFTt0SaKfQnbZ33f2OyrtaR5ki1Fo_2ovT0Vy4H_uPEi3jljAkW-gqs8?key=dRllTO6NEoYu0-D1JuBE8A) 아이콘을 선택합니다.
4. **고급 접근성 설정**을 선택합니다.
5. **접근성 개발자 도구**  버튼을 클릭해 활성화합니다.
6. 속성을 추가할 애플리케이션 또는 요소를 마우스 오른쪽 버튼으로 클릭합니다.
7. **접근성**을 선택합니다.
8. **속성 추가**를 선택합니다.
9. 드롭다운 메뉴에서 속성을 선택합니다.
10. 라벨을 입력합니다. / 레벨 또는 값을 선택합니다.
11. **추가**를 선택합니다.

![접근성 패널과 마법사가 열려 있습니다. 커서로 속성 추가를 클릭하고 있으며, 버튼이 활성화되어 있습니다.](https://d2x3xhvgiqkx42.cloudfront.net/12345678-1234-1234-1234-1234567890ab/651c25b0-2d60-43c8-addf-1df2fd575568/2024/06/06/08f56fa8-dbc6-4484-b600-2447401cd390/51281520-4c34-49dc-a5f1-8159f3ce06e7.jpg)

> **중요!** 고급 접근성 설정은 언제든지 비활성화할 수 있으며 ARIA 속성은 삭제되지 않습니다.

### ARIA 속성을 다음 요소에 추가할 수 있습니다.

| 요소 | 속성 |
| --- | --- |
| 라이트박스 | label |
| 텍스트 | label, role [heading, status, alert\], live, relevant, atomic, hidden, current, level](https://www.wix.com/contact/ko) |
| 컨테이너 상자 | label, tabindex, role \[region, group, none, status, alert\], live, relevant, atomic, current, controls, hidden |
| 스트립 | label, tabindex, role \[heading, status, alert\], live, atomic, hidden, current |
| 반복 레이아웃 | label, role \[heading, status, alert\] |
| 텍스트 버튼 | tabindex, pressed, expanded, haspopup |

> Wix에서는 더 많은 요소에 ARIA 속성을 추가할 수 있는 기능을 지속적으로 개발하고 있습니다. ARIA 속성에 대한 특정 요청 사항이 있다면 \[고객지원 팀에 알려주세요.

---

## ARIA 속성 편집하기

사용자 지정 애플리케이션에 속성을 추가한 후 접근성 ![](https://lh6.googleusercontent.com/tzGAKNeD3huzfUCBGbiHOAmMhpoOMn2d7mXWbB8x3rd5_wDvr4uEfNczYUD_5EqzSdzFPLv5nc9zp7VkwFDWloqQmUBf71J5_kTbI5nE3o9Wb2s_CS8xcsfkw0eHNAxCpa4dBBIq=s0) 아이콘을 사용해 언제든지 속성을 편집 및 업데이트할 수 있습니다. 이 아이콘은 속성을 연결한 요소에 자동으로 추가됩니다.

### 속성을 편집하려면:

1. 에디터에서 요소 또는 응용 프로그램을 선택합니다.
2. **접근성** ![](https://d2x3xhvgiqkx42.cloudfront.net/12345678-1234-1234-1234-1234567890ab/651c25b0-2d60-43c8-addf-1df2fd575568/2021/05/05/123b3ec4-f910-485b-ba95-c80ee1f6723b/29accdaa-a7f8-4070-a4e9-be08ffc45e99.png) 아이콘을 선택합니다.
3. 해당 속성에 마우스오버한 후 **추가 작업**![](https://lh7-us.googleusercontent.com/docsz/AD_4nXcC5vRw8B_ITz9qd1n_rF0jP0XZvFe8Ly4NcbviMUHdlLJZIK7ATwxhjb-fPDytIlmc7hmtqMlqZt_sh3CtRvQOGzQRe_skqNqCTCHoFti1Yc1JZwr5M1G5d7vxKBGJAMf6oCDrRmiI9mYujNW1sBSBKREb?key=dRllTO6NEoYu0-D1JuBE8A) 아이콘을 클릭합니다.
4. **편집**을 선택합니다.
5. 원하는 대로 변경하고 **저장**을 선택합니다.

---

## ARIA 속성 유형

| 속성 이름 | 카테고리 | 토큰 |
| --- | --- | --- |
| tabindex |  | 0, -1 |
| 역할 |  | token: 원시 내 정의에 따름 |
| aria-level |  | int |
| aria-live | 라이브 | token: polite, assertive |
| aria-multiline | 설명 | true, false |
| aria-multiselectable | 설명 | true, false |
| aria-pressed | 시/도/주/지역 | true, false |
| aria-relevant | 라이브 | token: all, additions, removals, text |
| aria-activedescendant | 관계 | ID\_REF |
| aria-atomic | 라이브 | true, false |
| aria-autocomplete | 설명 | true, false |
| aria-controls | 관계 | ID\_REF |
| aria-current | 시/도/주/지역 | step, page, true, false |
| aria-descriptions | 관계 | ID\_REF (공백으로 구분된 아이템) |
| aria-expanded |  | true, false |
| aria-haspopup | 관계 | dialog, menu, true, false |
| aria-hidden |  | true, false |
| aria-invalid | 시/도/주/지역 | true, false |
| aria-label |  | string |
| aria-labelledby | 관계 | ID\_REF (공백으로 구분된 아이템) |
