An open API service indexing awesome lists of open source software.

https://github.com/orange-opensource/accessibility-statement-lib-ios

Provides a view that indicates the WCAG compliance status to be integrated into your iOS mobile application, based on Vallydette report
https://github.com/orange-opensource/accessibility-statement-lib-ios

a11y ios swift swiftui wcag

Last synced: 5 months ago
JSON representation

Provides a view that indicates the WCAG compliance status to be integrated into your iOS mobile application, based on Vallydette report

Awesome Lists containing this project

README

          

Accessibility Statement Lib iOS


Accessibility Statement Lib iOS contains a view showing the WCAG compliance status for a given iOS application.


Report bug
·
Request feature


Gitleaks status
 
SwiftLint status
 
SwiftPolyglot status
 
Tests status

## ⚙️ Status

[![Apache 2.0 license](https://img.shields.io/github/license/Orange-OpenSource/accessibility-statement-lib-ios?style=for-the-badge)](https://github.com/Orange-OpenSource/accessibility-statement-lib-ios/blob/master/LICENSE)

[![Versions](https://img.shields.io/github/v/release/Orange-OpenSource/accessibility-statement-lib-ios?label=Last%20version&style=for-the-badge)](https://github.com/Orange-OpenSource/accessibility-statement-lib-ios/releases)
[![Still maintained](https://img.shields.io/maintenance/yes/2026?style=for-the-badge)](https://github.com/Orange-OpenSource/accessibility-statement-lib-ios/issues?q=is%3Aissue+is%3Aclosed)

[![Code size](https://img.shields.io/github/languages/code-size/Orange-OpenSource/accessibility-statement-lib-ios?style=for-the-badge)](https://github.com/Orange-OpenSource/accessibility-statement-lib-ios)
[![Opened issues](https://img.shields.io/github/issues-raw/Orange-OpenSource/accessibility-statement-lib-ios?style=for-the-badge)](https://github.com/Orange-OpenSource/accessibility-statement-lib-ios/issues)

[![](https://img.shields.io/endpoint?url=https%3A%2F%2Fswiftpackageindex.com%2Fapi%2Fpackages%2FOrange-OpenSource%2Faccessibility-statement-lib-ios%2Fbadge%3Ftype%3Dswift-versions)](https://swiftpackageindex.com/Orange-OpenSource/accessibility-statement-lib-ios)

[![Open Hub](https://img.shields.io/badge/open%20hub-5A2A82?style=for-the-badge)](https://openhub.net/p/accessibility-statement-lib-ios)

> [!CAUTION]
> To use it, you need the XML accessibility result file from the [Orange Va11ydette](https://la-va11ydette.orange.com/)


Preview with Orange theme from OUDS library (french)
 
Preview with Sosh theme from OUDS library (french)
 
Preview with Wireframe theme from OUDS library (french)

## 🚀 Import Accessibility Statement lib in your project

1. To integrate the `DeclarationAccessibility` module into your Xcode project using _Swift Package Manager_, declare a new dependency:

```swift
.package(url: "https://github.com/Orange-OpenSource/accessibility-statement-lib-ios.git", .exact("2.0.0"))
```

2. Then add the dependency product in the target you want:

```swift
.target(
name: "YourTargetName",
dependencies: [
.product(name: "DeclarationAccessibility", package: "accessibility-statement-lib-ios")
],
)
```

> [!TIP]
> You can of course refer to it in your Xcode project settings.

## 🚀 Usage

Import the module from the Swift Package:

```swift
import DeclarationAccessibility
```

Then, given an XML file generated by [La Va11ydette](https://la-va11ydette.orange.com/) named `accessibility_result` in your app bundle:

- Display the statement with additional details in local HTML file
```swift
StatementView(xmlFile: "accessibility_result", theme: .orange, localUrl: absoluteStringUrlToLocalFile)
```

- Or use a detailed page available outside the app, e.g. in web site, to display in webview or not (by default not)
```swift
StatementView(xmlFile: "accessibility_result", theme: .orange, remoteUrl: "https://a11y-guidelines.orange.com/fr/", useWebView: true)
```

## 🪲 Bugs, feature requests and discussions

Have a bug or a feature request? Please first search for existing and closed issues. If your problem or idea is not addressed yet, [please open a new issue](https://github.com/Orange-OpenSource/accessibility-statement-lib-ios/issues/new/choose).

If you want to share ideas or discuss about API, features, components or other topics, you should first open a new discussion.
[Q&A](https://github.com/Orange-OpenSource/accessibility-statement-lib-ios/discussions/categories/q-a) is more dedicated for help, otherwise feel free to open or update a topic in [Ideas](https://github.com/Orange-OpenSource/accessibility-statement-lib-ios/discussions/categories/ideas).
Keep in mind internal or sensitive discussions must be in internal tools, not public ones.

## 🤝 Contributing

Please read through our [contributing guidelines](https://github.com/Orange-OpenSource/accessibility-statement-lib-ios/blob/master/.github/CONTRIBUTING.md). Included are directions for opening issues, coding standards, and notes on development. More technical details are available also in the [DEVELOP](https://github.com/Orange-OpenSource/accessibility-statement-lib-ios/blob/master/.github/DEVELOP.md) file.

## 🔒 Data and privacy

The Accessibility Statement Lib is a Software Development Kit (SDK) that allows developpers display accessibility statement.
As such:
- this SDK does not handle any personnal data
- this SDK does not require any device permission to work

## ⚖️ Copyright and license

Code released under the [Apache 2.0 License](https://github.com/Orange-OpenSource/accessibility-statement-lib-ios/blob/master/LICENSE).