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 d7e3bff commit b76fff7
Showing 1 changed file with 83 additions and 36 deletions.
119 changes: 83 additions & 36 deletions docs/ru/docs/field.md
Original file line number Diff line number Diff line change
Expand Up @@ -931,70 +931,117 @@ Group::make([
```


## Кнопка/Ссылка
## Кнопка

В определенных случаях необходимо добавить кнопку для вызова модального окна, простую ссылку или добавить кнопку
отправки формы в конце экрана.
Для таких случаев существует поле `Button`. Поле `Button` не может иметь какого либо
значения и не передается при сохранении. Оно может быть использовано для вызова модального окна определенного на экране
и для добавления простой ссылки в форме.
Кнопки (`Button`) применяются для отправки формы, заполненной пользователем, на сервер.

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

```php
ModalToggle::make('Add Payment')
->modal('addNewPayment')
->icon('wallet');
Button::make('Submit')
->method('handler');
```

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

```php
Link::make('Google It!')
->href('http://google.com');
Button::make('Submit')
->method('handler', [
'user' => 1,
]);
```


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

Link::make('Idea')
->route('platform.idea');
Чтобы избежать случайных действий, добавьте метод `confirm()`. Он покажет окно подтверждения перед выполнением, что полезно для операций, которые нельзя отменить, например, удаления данных.

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

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

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

```php
Button::make('Google It!')
->method('goToGoogle');
Button::make('Submit')
->action('https://orchid.software');
```

Доступные модификаторы:
### Скачивание файла

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

```php
Button::make('Download Report')
->method('export')
->download();
```

* `right()` - позиционирование элемента по правому краю экрана.
* `block()` - позиционирование элемента по всей ширине экрана.
* `class('class-names')` - переписывает стандартные классы для кнопки.
* `method('methodName')` - при клике форма будет отправлена на заданный метод в рамках текущего экрана.
* `icon('icon-wallet)` - задает иконку для кнопки.


## Ссылка

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

Вы можете легко создать кнопку действия DropDown, объединяющую все остальные действия.
Например, создать типичный раскрывающийся список из трех точек:
Чтобы создать ссылку, ведущую на определенный URL, используйте `Link::make()` с указанием текста ссылки и метода `href()`.

```php
Link::make('Visit Orchid')
->href('https://orchid.software');
```

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

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

```php
Link::make('Documentation')
->href('https://orchid.software/docs')
->target('_blank');
```

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

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

```php
Link::make('Download Report')
->href('/path/to/report.pdf')
->download();
```

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

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

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

Все что требуется, это перечислить все действия в методе `list`:

```php
DropDown::make()
->icon('options-vertical')
->icon('bs.options-vertical')
->list([
Link::make(__('Edit'))
Link::make('Edit')
->route('platform.systems.users.edit', $user->id)
->icon('pencil'),
Button::make(__('Delete'))

Button::make('Delete')
->method('remove')
->icon('trash')
->confirm(__('Are you sure you want to delete the user?'))
->parameters([
'id' => $user->id,
]),
->confirm('Are you sure you want to delete the user?')
]);
```


## NumberRange

Вы можете создавать диапазоны чисел. Особенно полезно для фильтров.
Expand Down

0 comments on commit b76fff7

Please sign in to comment.