Bản mẫu:Hộp thông báo/doc

Đây là siêu tiêu bản ambox hay hộp thông báo bài viết.

Nó được sử dụng để tạo ra các tiêu bản hộp thông báo bài viết, như {{wikify}} v.v. Nó cho phép một vài lựa chọn màu, sử dụng các hình ảnh mặc định nếu không có tham biến về hình ảnh được đưa vào và có một vài đặc trưng khác.

Siêu tiêu bản này chỉ là lớp bao bọc mỏng cho các lớp ambox CSS trong MediaWiki:Common.css. Các lớp cũng có thể sử dụng trực tiếp trong wikitable, đặc biệt khi cần dùng cụ thể chức năng này. Xem hướng dẫn cho điều này.

Lưu ý:

Nếu hai hộp trông không giống nhau, bạn cần làm mới bộ nhớ đệm trong trình duyệt web của bạn:

Hộp mã chuẩn.

Đây là vấn đề cache tạm thời và sẽ mất đi sau một khoảng thời gian nào đó.

Sử dụng

Ví dụ sử dụng đơn giản:

{{hộp thông báo | chữ = Văn bản gì đó.}}

Ví dụ sử dụng phức tạp:

{{hộp thông báo
| loại  = văn phong
| hình = [[Hình:Icon apps query.png|38px]]
| chữ  = Nội dung văn bản thông điệp.
}}

Ví dụ thông báo ngắn:

{{hộp thông báo
| loại = chú ý
| nhỏ  = trái
| hình = [[Hình:Wiki letter w.png|20px]]
| chữ  = Thông báo ngắn ở phía bên trái
}}

Hình ảnh mặc định

Các ví dụ sau sử dụng các tham biến loại nhưng không sử dụng tham biến hình ảnh vì thế chúng sử dụng các hình ảnh mặc định cho mỗi kiểu.

Hình ảnh khác

Các hình ảnh mặc định chỉ ra trên đây là thuận tiện nhất. Tuy nhiên, trong nhiều trường hợp thì việc sử dụng các hình ảnh cụ thể hơn sẽ là thích hợp hơn. Các ví dụ này sử dụng tham biến hình để chỉ rõ hình ảnh được dùng thay vì hình ảnh mặc định.

Đặc biệt

Một vài tổ hợp tham biến khác.

Các tham biến

Danh sách các tham biến:

{{hộp thông báo
| loại  = nghiêm trọng / nội dung / văn phong / hợp nhất / chú ý
| hình = không / trống / [[Hình:Some image.png|40px]]
| hình phải = [[Hình:Some image.png|40px]]
| chữ  = Nội dung văn bản thông điệp. 
}}

loại

Nếu không đưa vào tham biến loại thì tiêu bản mặc định lấy theo loại chú ý, được sử dụng cho "thông báo về bài viết". Điều đó có nghĩa là nó có thanh dọc mé trái màu xanh lam tương tự như trong ví dụ sử dụng đơn giản trên đây.

hình

Không tham số = Nếu không có tham biến hình thì tiêu bản sử dụng hình ảnh mặc định. Hình ảnh mặc định nào được dùng phụ thuộc vào tham biến loại trên đây.

Một tấm hình = Phải có hình với ký hiệu wiki thông thường. Độ rộng 40px-50px là đẹp nhất, phụ thuộc vào tỷ lệ chiều cao so với chiều rộng của hình. Ví dụ:

[[Hình:Unbalanced scales.png|40px]]

không = Nghĩa là không dùng hình.

trống = Nghĩa là không dùng hình nhưng một khoảng trống cùng kích thước với hình mặc định được sử dụng, điều này làm cho văn bản của hộp thông điệp được căn lề tương xứng với các hộp thông điệp khác về bài viết. (Xem các ví dụ "Đặc biệt" trên đây.)

hình phải

Không tham số = Nếu không đưa ra tham biến hình phải thì ở mé phải của hộp thông điệp sẽ không có hình nào cả.

Một tấm hình = Phải là hình ảnh với ký hiệu wiki thông thường. Độ rộng 40px-50px là đẹp nhất, phụ thuộc vào tỷ lệ chiều cao so với chiều rộng của hình. Ví dụ:

[[Hình:Nuvola apps bookcase.png|40px]]

Bất kỳ thứ gì = Bất kỳ thứ gì mà bạn muốn thể hiện ở mé phải hộp thông điệp.

nhỏ

Không tham số = Nếu không đưa ra tham biến nhỏ thì mặc định là kiểu bình thường như hộp thông báo.

trái = Bảng thông báo nhỏ ở phía bên trái văn bản. Khi đó, chiều cao khuyên dùng cho hình và hình phải là 20x20px.

chữ

Nội dung văn bản thông điệp.

Các chi tiết kỹ thuật

Nếu bạn cần thiết phải dùng các ký tự đặc biệt trong tham biến chữ thì bạn phải dùng ký tự đánh dấu thoát như sau:

{{hộp thông báo
| chữ  = <div>
Dấu bằng = và dấu ngoặc móc đóng và mở { } hoạt động bình thường.
Nhưng ở đây dấu suyệt đứng {{!}} và dấu móc kép <nowiki>}}</nowiki>. 
Và giờ là dấu suyệt đứng và các dấu móc đóng <nowiki>|}}</nowiki>.
</div>
}}

Xem thêm

• VLOS:Lớp CSS cho hộp thông báo – Miêu tả việc sử dụng các lớp ambox CSS trực tiếp trong các wikitable và bảng HTML.
• VLOS:Hộp thông điệp về bài viết - Chỉ dẫn kiểu cách (đề xuất) cho việc tạo ra các hộp thông điệp về bài viết.
• en:VLOS talk:Article message boxes - Thảo luận về vấn đề này.

Liên kết đến đây

• Bản mẫu:Hộp thông báo