Макеты экрана
Suggest EditОтображение внешнего вида элементов пользовательского интерфейса в приложении играет большое значение, делает приложение проще в использовании и помогает пользователям интуитивно отображать элементы экрана для выполнения своих задач.
Разделение логики и презентации является один из принципов разработки с ORCHID. Одним из элементов презентации являются “Layouts”, это макеты которые могут отображаться как:
- Таблицы
- Колонки
- Строки
- Графики
- Модальные окна
Таблица
Макет таблицы используется для вывода минимальной информации для просмотра и выборки.
php artisan make:table PatientListLayout
Пример:
namespace App\Layouts\Clinic\Patient;
use App\Http\Filters\LastNamePatient;
use Orchid\Platform\Http\Filters\CreatedFilter;
use Orchid\Platform\Http\Filters\SearchFilter;
use Orchid\Platform\Http\Filters\StatusFilter;
use Orchid\Platform\Layouts\Table;
class PatientListLayout extends Table
{
/**
* @var string
*/
public $data = 'patients';
/**
* HTTP data filters
*
* @return array
*/
public function filters() : array
{
return [
LastNamePatient::class,
SearchFilter::class,
];
}
/**
* @return array
*/
public function fields() : array
{
return [
TD::name('last_name')
->title('Last name')
->setRender(function ($patient) {
return '<a href="' . route('dashboard.clinic.patient.edit',
$patient->id) . '">' . $patient->last_name . '</a>';
}),
TD::name('first_name')
->title('First Name'),
TD::name('phone')
->title('Phone'),
TD::name('first_name')
->title('First Name'),
TD::name('email')
->title('Email'),
TD::name('created_at')
->title('Date of publication'),
];
}
}
Строки
Макет строк служит минимальным набором, который чаще всего используется. Его цель объединять все необходимые поля.
Для создания исполните команду:
php artisan make:rows PatientFirstRows
Пример:
namespace App\Layouts\Clinic\Patient;
use App\Http\Widgets\AppointmentTypes;
use Orchid\Platform\Fields\Field;
use Orchid\Platform\Layouts\Rows;
class Appointment extends Rows
{
/**
* @return array
*
* @throws \Orchid\Platform\Exceptions\TypeException
*/
public function fields(): array
{
return [
Field::tag('datetime')
->name('appointment_time')
->required()
->title('Time'),
Field::tag('relationship')
->name('appointment_type')
->required()
->title('Appointment type')
->handler(AppointmentTypes::class),
Field::tag('textarea')
->name('doctor_notes')
->rows(10)
->required()
->title('Doctor notes')
->help('What did the patient complain about?'),
];
}
}
Графики
Макет графиков удобный способ графически отображать динамику значений, но он требует некоторой
обработки данных, пример данных из query
/**
* Query data
*
* @param Patient $patient
*
* @return array
*/
public function query($patient = null) : array
{
$charts = [
[
'title' => "Some Data",
'values' => [25, 40, 30, 35, 8, 52, 17, -4],
],
[
'title' => "Another Set",
'values' => [25, 50, -10, 15, 18, 32, 27, 14],
],
[
'title' => "Yet Another",
'values' => [15, 20, -3, -15, 58, 12, -17, 37],
],
];
return [
'charts' => $charts,
];
}
Пример макета:
namespace App\Layouts\Clinic\Patient;
use Orchid\Platform\Layouts\Chart;
class ChartsLayout extends Chart
{
/**
* @var string
*/
public $title = 'DemoCharts';
/**
* @var int
*/
public $height = 150;
/**
* Available options:
* 'bar', 'line', 'scatter',
* 'pie', 'percentage'
*
* @var string
*/
public $type = 'scatter';
/**
* @var array
*/
public $labels = [
"12am-3am",
"3am-6am",
"6am-9am",
"9am-12pm",
"12pm-3pm",
"3pm-6pm",
"6pm-9pm",
"9pm-12am",
];
/**
* @var string
*/
public $data = 'charts';
}