Merge pull request #33 from jeffreyvanhees/main

Add ->paperSize()-method

docs/basic-usage/formatting-pdfs.md

@@ -86,6 +86,18 @@ A5: 5.83in  x  8.27in
 A6: 4.13in  x  5.83in
 ```
 
+### Paper size
+
+If you don't want to use standardized formats, you can also use the `paperSize` method instead.
+
+```php
+use Spatie\LaravelPdf\Facades\Pdf;
+
+Pdf::view('pdf.receipt', ['order' => $order])
+    ->paperSize(57, 500, 'mm')
+    ->save('/some/directory/receipt-12345.pdf');
+```
+
 ### Page margins
 
 Margins can be set using the `margins` method. The unit of the margins is millimeters by default.

src/PdfBuilder.php

@@ -203,6 +203,15 @@ public function format(string|Format $format): self
         return $this;
     }
 
+    public function paperSize(float $width, float $height, string $unit = 'mm'): self
+    {
+        $this->withBrowsershot(function (Browsershot $browsershot) use ($width, $height, $unit) {
+            $browsershot->paperSize($width, $height, $unit);
+        });
+
+        return $this;
+    }
+
     public function withBrowsershot(callable $callback): self
     {
         $this->customizeBrowsershot = $callback;

tests/PdfTest.php

@@ -106,6 +106,16 @@
         ->toContainText('This is a test');
 });
 
+it('can accept the page size', function () {
+    Pdf::view('test')
+        ->paperSize(200, 400, 'mm')
+        ->save($this->targetPath);
+
+    expect($this->targetPath)
+        ->toHaveDimensions(567, 1134)
+        ->toContainText('This is a test');
+});
+
 it('can accept the orientation', function () {
     Pdf::view('test')
         ->orientation(Orientation::Landscape)