Skip to content

No results for

↑ ↓ navigate ↵ open Esc close 
php artisan aura:add mail-attachment

Copies the component source into resources/views/components/aura/. Run php artisan aura:init first if you haven't already. See the CLI guide for all options.

composer require bluestarsystem/aura-ui
php artisan aura:install

Full installation instructions in the Installation guide.

Pro Component — This component requires an Aura UI Pro license.

Overview

<x-aura::mail-attachment> is the small paperclip chip under a message. A link when the file can be opened, plain text when it cannot — never a link that goes nowhere, which is announced as a link and then disappoints.

Basic Usage

invoice-2026-0042.pdf terms.docx 
<div class="flex flex-wrap gap-2">
    <x-aura::mail-attachment name="invoice-2026-0042.pdf" href="#" />
    <x-aura::mail-attachment name="terms.docx" />
</div>

Props

Prop Type Default Description
name string required The file name. Truncated visually, never in the accessible name.
href string|null null Renders a link opening in a new tab. Without it the chip is plain text.

Accessibility

  • The paperclip is decoration and is hidden from assistive technology: the file name is the content.
  • Links open in a new tab with rel="noopener", and the file name is the link text — not "download", which tells a screen-reader user nothing about which of five files they are on.