Update field.md

docs/en/docs/field.md

@@ -1075,77 +1075,112 @@ Group::make([
 
 
 
-## Button/Link
+## Button
 
-In certain cases, you need to add a button to call a modal window, a simple link, or add a button
-submit the form at the end of the screen.
-For such cases, there is a `Button` field. The `Button` field cannot have any
-values and is not transmitted when saving. It can be used to call a modal window defined on the screen.
-And to add a simple link in the form.
+Buttons are used to submit a form filled out by the user to the server.
 
-An example of using the modal window `addNewPayment` added earlier to the screen:
+To create a button that calls the `handler` method defined in the current screen, use `Button::make()`:
 
 ```php
-use Orchid\Screen\Actions\ModalToggle;
+Button::make('Submit')
+    ->method('handler');
+```
+
+> The method must be available in the screen where the button is located.
 
-ModalToggle::make('Add Payment')
-    ->modal('addNewPayment')
-    ->icon('wallet');
+If you need to pass specific data to the method, specify it as the second argument:
+
+```php
+Button::make('Submit')
+    ->method('handler', [
+        'user' => 1,
+    ]);
 ```
 
-Linking example:
+### Action Confirmation
+
+To prevent accidental actions, add the `confirm()` method. This will display a confirmation dialog before executing the action. It is particularly useful for irreversible actions, such as data deletion.
 
 ```php
-use Orchid\Screen\Actions\Link;
+Button::make('Delete')
+    ->method('deleteItem')
+    ->confirm('You will lose access to this item.');
+```
 
-Link::make('Google It!')
-    ->href('http://google.com');
+> **Tip:** Use clear and concise messaging in `confirm()` so the user understands the consequences.
 
-Link::make('Idea')
-    ->route('platform.idea');
+### Sending Data to an External URL
+
+To send data to an external URL, use the `action()` method. This is useful if you need to submit a form to a destination outside the current screen.
+
+```php
+Button::make('Submit')
+    ->action('https://orchid.software');
 ```
 
-Example use with method:
+### File Download
+
+To initiate a file download when clicking a button, use the `download()` method. This signals the system that the result of the method execution will be a downloadable file rather than simply displaying it in the browser.
 
 ```php
-use Orchid\Screen\Actions\Button;
+Button::make('Download Report')
+    ->method('export')
+    ->download();
+```
+
+## Link
 
-Button::make('Google It!')
-    ->method('goToGoogle');
+Links (`Link`) are used to direct the user to another page or to perform an action, such as downloading a file.
+
+To create a link to a specific URL, use `Link::make()` with the link text and the `href()` method:
+
+```php
+Link::make('Visit Orchid')
+    ->href('https://orchid.software');
 ```
 
-Available modifiers:
+### Opening Link in a New Tab
 
-* `right()` - Positioning the element on the right edge of the screen
-* `block()` - Positioning the element across the entire width of the screen
-* `class('class-names')` - rewrites the standard button classes
-* `method('methodName')` - when clicked, the form will be sent to the specified method within the current screen
-* `icon('icon-wallet')` - sets an icon for the button
+To open a link in a new tab, add the `target('_blank')` method. This is useful for external sites or resources you want to open alongside the current page.
 
-## Dropdown
+```php
+Link::make('Documentation')
+    ->href('https://orchid.software/docs')
+    ->target('_blank');
+```
+
+### File Download
 
-You can easily create a DropDown action button combining all other actions. 
-For example, you can create the typical three dots dropdown:
+If the link should initiate a file download, use the `download()` method. This informs the browser that the link points to a downloadable file.
 
 ```php
-use Orchid\Screen\Actions\DropDown;
+Link::make('Download Report')
+    ->href('/path/to/report.pdf')
+    ->download();
+```
 
+> **Note:** Ensure the file is accessible at the specified path to avoid download errors.
+
+## Dropdown Menu
+
+The `Dropdown` component allows you to create a button with a dropdown list of actions, which is convenient for grouping related actions, such as a three-dot menu for managing an item.
+
+To create a dropdown menu, list all actions in the `list()` method:
+
+```php
 DropDown::make()
-    ->icon('options-vertical')
+    ->icon('bs.options-vertical')
     ->list([
         Link::make('Edit')
-            ->route('platform.users.edit', $user->id)
-            ->icon('pencil'),
+            ->route('platform.systems.users.edit', $user->id),
 
         Button::make('Delete')
-            ->icon('trash')
-            ->confirm('Are you sure you want to delete the user?')
-            ->method('remove', [
-                'id' => $user->id,
-            ]),
+            ->method('remove')
+            ->icon('trash'),
     ]);
 ```
 
+
 
 ## NumberRange