Skip to content

Commit

Permalink
Update field.md
Browse files Browse the repository at this point in the history
  • Loading branch information
tabuna authored Nov 4, 2024
1 parent b76fff7 commit 3888193
Showing 1 changed file with 28 additions and 33 deletions.
61 changes: 28 additions & 33 deletions docs/ru/docs/field.md
Original file line number Diff line number Diff line change
Expand Up @@ -933,111 +933,106 @@ Group::make([

## Кнопка

Кнопки (`Button`) применяются для отправки формы, заполненной пользователем, на сервер.
Кнопки (`Button`) используются для отправки заполненной пользователем формы на сервер.

Чтобы создать кнопку, которая вызывает метод `handler`, объявленный в текущем экране, используйте `Button::make()`:
Чтобы создать кнопку, вызывающую метод `handler`, определённый в текущем экране, используйте `Button::make()`:

```php
Button::make('Submit')
Button::make('Отправить')
->method('handler');
```

> Метод должен быть доступен на экране, где находится кнопка.
> Метод должен быть доступен в текущем экране, где размещена кнопка.
Когда вы захотите передать какое либо значение явно, а не ожидать пользовательский ввод, укажите второй аргумент параметры:
Если вам необходимо передать определённые данные в метод, укажите их вторым аргументом:

```php
Button::make('Submit')
Button::make('Отправить')
->method('handler', [
'user' => 1,
]);
```


### Подтверждение действия

Чтобы избежать случайных действий, добавьте метод `confirm()`. Он покажет окно подтверждения перед выполнением, что полезно для операций, которые нельзя отменить, например, удаления данных.
Для предотвращения случайных действий добавьте метод `confirm()`, который отобразит окно подтверждения перед выполнением операции. Это особенно полезно для необратимых действий, таких как удаление данных.

```php
Button::make('Delete')
Button::make('Удалить')
->method('deleteItem')
->confirm('Вы потеряете доступ к этому элементу.');
```

> **Совет:** Указывайте в `confirm()` краткое и ясное сообщение, чтобы пользователь понимал последствия.
> **Совет:** Указывайте в `confirm()` чёткое сообщение, чтобы пользователь понимал последствия.
### Отправка данных на внешний URL

Для отправки данных на сторонний URL используйте метод `action()`. Это подойдет, если требуется отправить форму за пределы текущего экрана.
Чтобы отправить данные на сторонний URL, используйте метод `action()`. Этот метод полезен, если необходимо отправить форму вне текущего экрана.

```php
Button::make('Submit')
Button::make('Отправить')
->action('https://orchid.software');
```

### Скачивание файла

Если при нажатии на кнопку нужно начать скачивание файла, используйте метод `download()`.
Это указывает системе, что результатом выполнения метода будет файл, который нужно скачать, а не просто открыть в браузере.
Для начала скачивания файла по нажатию кнопки примените метод `download()`. Он указывает системе, что результатом выполнения будет файл, который нужно загрузить, а не просто открыть в браузере.

```php
Button::make('Download Report')
Button::make('Скачать отчёт')
->method('export')
->download();
```


## Ссылка

Ссылки (`Link`) используются для перехода пользователя на другую страницу или выполнения определенного действия, такого как скачивание файла.
Ссылки (`Link`) используются для перенаправления пользователя на другую страницу или выполнения действия, такого как скачивание файла.

Чтобы создать ссылку, ведущую на определенный URL, используйте `Link::make()` с указанием текста ссылки и метода `href()`.
Чтобы создать ссылку на определённый URL, используйте `Link::make()` с текстом ссылки и методом `href()`:

```php
Link::make('Visit Orchid')
Link::make('Посетить Orchid')
->href('https://orchid.software');
```

### Открытие ссылки в новом окне
### Открытие ссылки в новой вкладке

Чтобы открыть ссылку в новой вкладке или окне, добавьте метод `target('_blank')`. Это удобно для внешних сайтов или ресурсов, которые вы хотите открыть параллельно текущей странице.
Для открытия ссылки в новой вкладке добавьте метод `target('_blank')`. Это удобно для внешних ресурсов, которые нужно открыть параллельно с текущей страницей.

```php
Link::make('Documentation')
Link::make('Документация')
->href('https://orchid.software/docs')
->target('_blank');
```

### Скачивание файла

Если при переходе по ссылке нужно начать скачивание файла, используйте метод `download()`. Это указывает браузеру, что ссылка ведет к файлу для загрузки, а не для просмотра.
Если переход по ссылке должен инициировать скачивание файла, используйте метод `download()`. Это указывает браузеру, что ссылка ведёт к файлу для загрузки.

```php
Link::make('Download Report')
Link::make('Скачать отчёт')
->href('/path/to/report.pdf')
->download();
```

> **Примечание:** Убедитесь, что файл доступен по указанному пути, чтобы избежать ошибок при скачивании.
## Выпадающее меню (Dropdown)

## Выпадающее Меню (Dropdown)

`Dropdown` позволяет создавать элементы с раскрывающимся списком действий, что удобно для группировки связанных действий под одной кнопкой, например, меню с тремя точками для управления элементом.
`Dropdown` позволяет создать элемент с выпадающим списком действий, что удобно для группировки связанных действий под одной кнопкой, например, в меню управления элементом.

Все что требуется, это перечислить все действия в методе `list`:
Чтобы создать меню, перечислите все действия в методе `list()`:

```php
DropDown::make()
->icon('bs.options-vertical')
->list([
Link::make('Edit')
->route('platform.systems.users.edit', $user->id)
Link::make('Редактировать')
->route('platform.systems.users.edit', $user->id),

Button::make('Delete')
Button::make('Удалить')
->method('remove')
->icon('trash')
->confirm('Are you sure you want to delete the user?')
->icon('trash'),
]);
```

Expand Down

0 comments on commit 3888193

Please sign in to comment.