Bỏ qua để đến nội dung
PHP Ecosystem
Explore

Usage examples

Nội dung này hiện chưa có sẵn bằng ngôn ngữ của bạn.

This document provides practical examples for metadata resolution, nested fields, and error handling.

<?php
declare(strict_types=1);
namespace App\FormModel;
use UIAwesome\FormModel\Attribute\{Hint, Label, Placeholder};
use UIAwesome\FormModel\BaseFormModel;
final class ContactForm extends BaseFormModel
{
#[Label('Full name')]
#[Placeholder('Ada Lovelace')]
public string $name = '';
#[Hint('Use a valid email address.')]
#[Label('Email address')]
#[Placeholder('ada@example.com')]
public string $email = '';
public function getHints(): array
{
return [
'name' => 'Enter your full name.',
];
}
public function getLabels(): array
{
return [
'email' => 'Email (map fallback)',
];
}
public function getPlaceholders(): array
{
return [
'email' => 'fallback@example.com',
];
}
}
$form = new ContactForm();
echo $form->getLabel('name');
// "Full name"
echo $form->getHint('email');
// "Use a valid email address."
<?php
echo $form->getLabel('email');
// "Email address" from #[Label(...)]
echo $form->getHint('name');
// "Enter your full name." from getHints() fallback
<?php
declare(strict_types=1);
namespace App\FormModel;
use UIAwesome\FormModel\BaseFormModel;
final class PostForm extends BaseFormModel
{
public string $seoTitle = '';
}
$form = new PostForm();
echo $form->getLabel('seoTitle');
// "Seo Title"
<?php
$form = new ContactForm();
$form->addError('email', 'Email is required.');
$form->addError('email', 'Email format is invalid.');
print_r($form->getError('email'));
/*
[
'Email is required.',
'Email format is invalid.',
]
*/
<?php
$form->setErrors(
[
'email' => ['Email is required.', 'Email format is invalid.'],
'password' => ['Password is required.'],
],
);
print_r($form->getFirstErrors());
/*
[
'email' => 'Email is required.',
'password' => 'Password is required.',
]
*/
print_r($form->getErrorSummary());
/*
[
'Email is required.',
'Email format is invalid.',
'Password is required.',
]
*/
<?php
declare(strict_types=1);
namespace App\FormModel;
use UIAwesome\FormModel\BaseFormModel;
final class AddressForm extends BaseFormModel
{
public string $city = '';
public function getLabels(): array
{
return ['city' => 'City'];
}
}
final class ProfileForm extends BaseFormModel
{
public AddressForm $address;
public function __construct()
{
$this->address = new AddressForm();
}
}
$form = new ProfileForm();
echo $form->getLabel('address.city');
// "City"
<?php
declare(strict_types=1);
namespace App\FormModel;
use UIAwesome\FormModel\BaseFormModel;
final class LoginForm extends BaseFormModel
{
public string $email = '';
public function getFieldConfigs(): array
{
return [
'email' => [
'class' => ['w-full rounded-md border border-slate-300 px-3 py-2'],
],
];
}
}
$form = new LoginForm();
print_r($form->getFieldConfig('email'));