Merge pull request #219 from raveren/main

Add autocomplete attribute helper to input, select and textarea

docs/general-usage/element-classes.md

@@ -66,6 +66,7 @@ echo Element::withTag('p')->text('This is the content!');
 
 ## `Input`
 
+- `function autocomplete(?$autocomplete)`
 - `function autofocus(?$autofocus)`
 - `function checked($checked = true)`
 - `function disabled($disabled = true)`
@@ -103,6 +104,7 @@ echo Element::withTag('p')->text('This is the content!');
 
 ## `Select`
 
+- `function autocomplete(?$autocomplete)`
 - `function autofocus(?$autofocus)`
 - `function disabled(?$disabled)`
 - `function isReadonly(?$readonly)`
@@ -118,6 +120,7 @@ echo Element::withTag('p')->text('This is the content!');
 
 ## `Textarea`
 
+- `function autocomplete(?$autocomplete)`
 - `function autofocus()`
 - `function cols(int $cols)`
 - `function disabled(?$disabled)`

src/Elements/Attributes/Autocomplete.php

@@ -0,0 +1,24 @@
+<?php
+
+namespace Spatie\Html\Elements\Attributes;
+
+trait Autocomplete
+{
+    /**
+     * @param bool|string $autocomplete
+     *
+     * @return static
+     */
+    public function autocomplete($autocomplete = true)
+    {
+        $value = 'on';
+        if ($autocomplete === false) {
+            $value = 'off';
+        }
+        if (is_string($autocomplete)) {
+            $value = $autocomplete;
+        }
+
+        return $this->attribute('autocomplete', $value);
+    }
+}

src/Elements/Input.php

@@ -3,6 +3,7 @@
 namespace Spatie\Html\Elements;
 
 use Spatie\Html\BaseElement;
+use Spatie\Html\Elements\Attributes\Autocomplete;
 use Spatie\Html\Elements\Attributes\Autofocus;
 use Spatie\Html\Elements\Attributes\Disabled;
 use Spatie\Html\Elements\Attributes\MinMaxLength;
@@ -16,6 +17,7 @@
 class Input extends BaseElement
 {
     use Autofocus;
+    use Autocomplete;
     use Disabled;
     use MinMaxLength;
     use Name;

src/Elements/Select.php

@@ -5,6 +5,7 @@
 use Illuminate\Support\Collection;
 use Illuminate\Support\Str;
 use Spatie\Html\BaseElement;
+use Spatie\Html\Elements\Attributes\Autocomplete;
 use Spatie\Html\Elements\Attributes\Autofocus;
 use Spatie\Html\Elements\Attributes\Disabled;
 use Spatie\Html\Elements\Attributes\Name;
@@ -15,6 +16,7 @@
 class Select extends BaseElement
 {
     use Autofocus;
+    use Autocomplete;
     use Disabled;
     use Name;
     use Required;

src/Elements/Textarea.php

@@ -3,6 +3,7 @@
 namespace Spatie\Html\Elements;
 
 use Spatie\Html\BaseElement;
+use Spatie\Html\Elements\Attributes\Autocomplete;
 use Spatie\Html\Elements\Attributes\Autofocus;
 use Spatie\Html\Elements\Attributes\Disabled;
 use Spatie\Html\Elements\Attributes\MinMaxLength;
@@ -14,6 +15,7 @@
 class Textarea extends BaseElement
 {
     use Autofocus;
+    use Autocomplete;
     use Placeholder;
     use Name;
     use Required;

tests/Elements/InputTest.php

@@ -50,6 +50,12 @@
         Input::create()->required(false)
     );
 
+it('can create a non-autocompleted input')
+    ->assertHtmlStringEqualsHtmlString(
+        '<input autocomplete="off">',
+        Input::create()->autocomplete(false)
+    );
+
 it('can create an input that has autofocus')
     ->assertHtmlStringEqualsHtmlString(
         '<input autofocus>',

tests/Elements/SelectTest.php

@@ -173,6 +173,14 @@
         Select::create()->autofocus()->options(['value1' => 'text1'])->render()
     );
 
+it('can create a non-autocompleted select')
+    ->assertHtmlStringEqualsHtmlString(
+        '<select autocomplete="off">
+                <option value="value1">text1</option>
+            </select>',
+        Select::create()->autocomplete('off')->options(['value1' => 'text1'])->render()
+    );
+
 it('can create a select that has autofocus when passing true')
     ->assertHtmlStringEqualsHtmlString(
         '<select autofocus>

tests/Elements/TextareaTest.php

@@ -14,6 +14,26 @@
         Textarea::create()->autofocus()
     );
 
+it('can create a non-autocompleted textarea')
+    ->assertHtmlStringEqualsHtmlString(
+        '<textarea autocomplete="off"></textarea>',
+        Textarea::create()->autocomplete('off')
+    )
+    ->assertHtmlStringEqualsHtmlString(
+        '<textarea autocomplete="off"></textarea>',
+        Textarea::create()->autocomplete(false)
+    );
+
+it('can create a custom-autocompleted textarea')
+    ->assertHtmlStringEqualsHtmlString(
+        '<textarea autocomplete="on"></textarea>',
+        Textarea::create()->autocomplete()
+    )
+    ->assertHtmlStringEqualsHtmlString(
+        '<textarea autocomplete="other-field"></textarea>',
+        Textarea::create()->autocomplete('other-field')
+    );
+
 it('can create a textarea with a placeholder')
     ->assertHtmlStringEqualsHtmlString(
         '<textarea placeholder="Lorem ipsum"></textarea>',