Merge pull request #226 from bskl/add-aria-method

Add aria helper method

docs/general-usage/element-methods.md

@@ -14,6 +14,7 @@ All `Spatie\Html\Elements` have some methods that make working with elements eas
 - [`class()`](#class)
 - [`id()`](#id)
 - [`data()`](#data)
+- [`aria()`](#aria)
 - [`child()` and `children()`](#child-and-children)
 - [`prependChild()` and `prependChildren()`](#prependchild-and-prependchildren)
 - [`text()`](#text)
@@ -103,6 +104,14 @@ echo Div::data('btn', 123);
 // "<div data-btn="123"></div>"
 ```
 
+## `aria()`
+
+Add a aria- attribute:
+```php
+echo Div::aria('describedby', 'bar');
+// "<div aria-describedby="bar"></div>"
+```
+
 ## `child()` and `children()`
 
 Adds one or more child elements to the element:

src/BaseElement.php

@@ -169,6 +169,17 @@ public function data($name, $value = null)
         return $this->attribute("data-{$name}", $value);
     }
 
+    /**
+     * @param string $attribute
+     * @param string|null $value
+     *
+     * @return static
+     */
+    public function aria($attribute, $value = null)
+    {
+        return $this->attribute("aria-{$attribute}", $value);
+    }
+
     /**
      * @param \Spatie\Html\HtmlElement|string|iterable|int|float|null $children
      * @param callable|null $mapper

tests/BaseElementTest.php

@@ -303,3 +303,9 @@ class Div extends BaseElement
         '<div data-foo="bar"></div>',
         Div::create()->data('foo', 'bar')->render()
     );
+
+it('can set a aria attribute')
+    ->assertHtmlStringEqualsHtmlString(
+        '<div aria-describedby="bar"></div>',
+        Div::create()->aria('describedby', 'bar')->render()
+    );