init source

node_modules/eslint-plugin-jsx-a11y/docs/rules/accessible-emoji.md

@@ -0,0 +1,23 @@
+# accessible-emoji
+
+Emoji have become a common way of communicating content to the end user. To a person using a screenreader, however, he/she may not be aware that this content is there at all. By wrapping the emoji in a `<span>`, giving it the `role="img"`, and providing a useful description in `aria-label`, the screenreader will treat the emoji as an image in the accessibility tree with an accessible name for the end user.
+
+#### Resources
+1. [Léonie Watson](http://tink.uk/accessible-emoji/)
+
+## Rule details
+
+This rule takes no arguments.
+
+### Succeed
+```jsx
+<span role="img" aria-label="Snowman">&#9731;</span>
+<span role="img" aria-label="Panda">🐼</span>
+<span role="img" aria-labelledby="panda1">🐼</span>
+```
+
+### Fail
+```jsx
+<span>🐼</span>
+<i role="img" aria-label="Panda">🐼</i>
+```