Gói này giúp bạn tạo HTML bằng API rõ ràng, đơn giản và dễ đọc. Tất cả các yếu tố có thể được tạo động và kết hợp với nhau. Trình tạo HTML giúp bạn tạo các phần tử biểu mẫu được gán động dựa trên mô hình, phiên hoặc giá trị mặc định đã chọn của bạn
hỗ trợ chúng tôi
Chúng tôi đầu tư rất nhiều tài nguyên vào việc tạo ra các gói nguồn mở tốt nhất trong lớp. Bạn có thể hỗ trợ chúng tôi bằng cách mua một trong những sản phẩm trả phí của chúng tôi
Chúng tôi đánh giá cao việc bạn gửi cho chúng tôi một tấm bưu thiếp từ quê hương của bạn, đề cập đến [những] gói bạn đang sử dụng của chúng tôi. Bạn sẽ tìm thấy địa chỉ của chúng tôi trên trang liên hệ của chúng tôi. Chúng tôi xuất bản tất cả các bưu thiếp nhận được trên bức tường bưu thiếp ảo của chúng tôi
Bưu thiếp
Bạn có thể tự do sử dụng gói này [được MIT cấp phép], nhưng nếu nó được đưa vào môi trường sản xuất của bạn, chúng tôi đánh giá cao việc bạn gửi cho chúng tôi một tấm bưu thiếp từ quê hương của bạn, đề cập đến [những] gói của chúng tôi mà bạn đang sử dụng
Địa chỉ của chúng tôi là. Spatie, Kruikstraat 22, 2018 Antwerp, Bỉ
Tất cả các bưu thiếp được xuất bản trên trang web của chúng tôi
Cài đặt
Bạn có thể cài đặt gói qua nhà soạn nhạc
composer require spatie/laravel-html
Và tùy chọn đăng ký bí danh cho mặt tiền
// config/app.php 'aliases' => [ ... 'Html' => Spatie\Html\Facades\Html::class, ];
Cách sử dụng
Các khái niệm
Các phần tử—các lớp trong không gian tên Spatie\Html\Elements
—thường được tạo thông qua một phiên bản trình tạo Spatie\Html\Html
html[]->span[]->text['Hello world!'];
Các thuộc tính và nội dung của phần tử được sửa đổi thông qua các phương thức trôi chảy trả về một thể hiện mới. Điều này có nghĩa là các trường hợp phần tử là bất biến
$icon = html[]->span[]->class['fa']; $icon->class['fa-eye']; // '' $icon->class['fa-eye-slash']; // ''
Các lớp phần tử không có bất kỳ kiến thức nào về thế giới bên ngoài. Bất kỳ khớp nối nào với các khái niệm khác, như yêu cầu và phiên, sẽ xảy ra trong lớp trình tạo, không phải trên lớp phần tử
Theo quy ước, chúng tôi giả định rằng các phương thức của trình tạo sẽ sửa đổi các giá trị thành lợi thế của chúng tôi [như lấy các giá trị cũ từ phiên theo yêu cầu biểu mẫu không thành công] và các phương thức phần tử sẽ mang tính quyết định
// This will try to resolve an initial value, and fall back to 'hello@example.com' $email = html[]->email['email', 'hello@example.com']; // This will always have 'hello@example.com' as it's value $email = html[]->email['email']->value['hello@example.com'];
nâng cấp
Từ v1 đến v2
Phiên bản 2 đã được tạo vì các bản đánh máy trong phiên bản 1 đã giữ lại gói trong một số trường hợp [như nhiều lựa chọn yêu cầu một mảng giá trị thay vì một chuỗi được giả định]
May mắn thay, chạm vào số phiên bản trong
// config/app.php 'aliases' => [ ... 'Html' => Spatie\Html\Facades\Html::class, ];0 và chạy
// config/app.php 'aliases' => [ ... 'Html' => Spatie\Html\Facades\Html::class, ];1 sẽ không bị hỏng. Dưới đây là một số lưu ý cần chú ý
- Theo mặc định, gói này đi kèm với hàm
// config/app.php 'aliases' => [ ... 'Html' => Spatie\Html\Facades\Html::class, ];
0, hàm này trả về một thể hiện của lớp trình tạo// config/app.php 'aliases' => [ ... 'Html' => Spatie\Html\Facades\Html::class, ];
1. Nếu bạn đã xác định phương thức của riêng mình, bạn sẽ cần xóa nó - Nhiều gợi ý loại khác nhau đã bị xóa trong toàn bộ gói, nếu bạn đã mở rộng một lớp để ghi đè các phương thức của nó, bạn sẽ cần cập nhật chúng cho phù hợp [mọi thứ vẫn hoạt động như cũ. ]
Nhật ký thay đổi
Vui lòng xem CHANGELOG để biết thêm thông tin về những thay đổi gần đây
thử nghiệm
$ composer test
Đóng góp
Vui lòng xem ĐÓNG GÓP để biết chi tiết
Bảo vệ
Nếu bạn tìm thấy một lỗi liên quan đến bảo mật, vui lòng gửi mail security@spatie. thay vì sử dụng trình theo dõi vấn đề
Tín dụng
- Sebastián De Deyne
- Freek Van der Herten
- Tất cả những người đóng góp
Giới thiệu về Spatie
Spatie là một công ty thiết kế web có trụ sở tại Antwerp, Bỉ. Bạn sẽ tìm thấy tổng quan về tất cả các dự án nguồn mở của chúng tôi trên trang web của chúng tôi