Bản mẫu:Hộp thông báo hình/tài liệu

Đây là siêu bản mẫu {{Hộp thông báo hình}} hay image message box (imbox).

Nó được dùng để tạo nên những bản mẫu hộp thông báo dành cho các trang hình, như {{cleanup-image}}. Nó có vài màu khác nhau, sử dụng hình mặc định nếu không chỉ định tham số hình và có một số tính năng khác.

Bản mẫu này hoạt động gần như y hệt {{Hộp thông báo}} và sử dụng cùng tham số.

Cách dùng

Ví dụ đơn giản:

{{Hộp thông báo hình | chữ = Chữ gì đó.}}

Chữ gì đó.

Ví dụ phức tạp:

{{Hộp thông báo hình
| loại      = văn phong
| hình      = [[Hình:Emblem-question-yellow.svg|40px]]
| kiểu      = width: 400px; 
| kiểu chữ  = color: red; font-weight: bold; font-style: italic;
| chữ       = Nội dung bên trong thông điệp.
}}

Nội dung bên trong thông điệp.

Các loại hộp thông báo

Các ví dụ dưới đây sử dụng các tham số loại khác nhau nhưng không dùng tham số hình ảnh do đó chúng đang dùng hình mặc định cho mỗi loại.

loại=xóa nhanh – Các bản mẫu xóa nhanh như {{isd}}.

loại=xóa – Bản mẫu xóa như {{ifd}}.

loại=nội dung – Các cảnh báo và vấn đề lớn, như {{non-free reduce}}.

loại=văn phong – Các cảnh báo và vấn đề nhỏ, như {{cleanup-image}}.

loại=chú ý – Chú ý và thông báo các loại, cả vĩnh viễn và tạm thời.

loại=di chuyển – thông báo di chuyển và đổi tên và các đề nghị, như {{rename media}}.

loại=khóa – bản mẫu khóa như {{pp-protected}} khi hiển thị ở trang hình ảnh.

loại=chọn lọc – bản mẫu hình chọn lọc như {{Hình chọn lọc}}.

Các hình khác

Những hình mặc định ở trên là để cho thuận tiện. Trong nhiều trường hợp sẽ thích hợp hơn nếu dùng các hình cụ thể hơn. Những ví dụ dưới đây sử dụng tham số hình để xác định hình khác ngoài hình mặc định.

loại = văn phong
hình = [[Hình:Gnome-dev-camera.svg|42px]]
Hình này được dùng trong {{cleanup-image}}.

loại = di chuyển
hình = [[Hình:To Commons.svg|52px]]
Hình này được dùng trong {{copy to Wikimedia Commons}}.

Đặc biệt

Vài kết hợp tham số đặc biệt khác.

Không có loại và không có hình (mặc định)

Không có loại và hình=không – Không sử dụng hình và chữ sử dụng toàn bộ khoảng trống trong hộp.

Các tham số

Danh sách tất cả các tham số:

{{Hộp thông báo hình
| loại  = xóa nhanh / xóa  / nội dung / văn phong / chú ý / 
          di chuyển / khóa / giấy phép / chọn lọc
| hình = không / [[Hình:Some hình.svg|40px]]
| hình phải = [[Hình:Some hình.svg|40px]]
| kiểu = giá trị CSS
| kiểu chữ = giá trị CSS
| chữ   = Nội dung bên trong thông báo.
| dưới = Thêm nội dung hoặc hộp thông báo khác.
}}

loại

Nếu không đưa ra tham số loại bản mẫu sẽ mặc định là loại chú ý. Có nghĩa là nó có viền màu xanh.

hình

Không tham số = Nếu không có tham số hình trong bản mẫu, nó sẽ dùng hình mặc định. Hình mặc định nào là tùy vào tham số loại.

Một hình = Nên là hình dùng mã wiki thông thường. Bề rộng 40px - 50px là vừa tùy vào tỷ lệ chiều cao và chiều rộng. (Nhưng hộp thông báo có thể xử lý hình với bất kỳ kích thước nào.) Ví dụ:

hình = [[Hình:Gnome-dev-camera.svg|40px]]

không = Có nghĩa là không sử dụng hình.

hình phải

Không tham số = Nếu không có tham số hình phải, thì bản mẫu không hiển thị hình bên phải.

Một hình = Nên là hình dùng mã wiki thông thường. Bề rộng 40px - 50px là vừa tùy vào tỷ lệ chiều cao và chiều rộng. (Nhưng hộp thông báo có thể xử lý hình với bất kỳ kích thước nào.) Ví dụ:

hình phải = [[Hình:Nuvola apps bookcase.png|40px]]

Bất kỳ thứ khác = Bất kỳ thứ nào khác mà bạn muốn hiển thị ở phía phải.

kiểu

Một giá trị CSS tùy chọn để dùng cho toàn bộ bảng hộp thông báo. Không có dấu mở ngoặc " ". Ví dụ:

kiểu = margin-bottom: 0.5em;

kiểu chữ

Một giá trị CSS tùy chọn để dùng cho ô chứa chữ. Ví dụ:

kiểu chữ = text-align: center;

chữ

Nội dung thông điệp.

dưới

Một khoảng không gian với chiều dài đầy đủ nằm phía dưới hình và chữ. Có thể có một nội dung mới hoặc bất kỳ đối tượng nào khác, ví dụ một imbox khác:

dưới = {{Hộp thông báo hình | loại = nội dung | chữ = Thẻ quyền này đã lỗi thời. }}

Chi tiết kỹ thuật

Nếu bạn cần sử dụng các ký tự đặc biệt trong tham số chữ bạn cần phải để dấu thoát như sau:

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

Dấu bằng = và dấu mở đóng ngoặc kép { } hoạt động bình thường. Nhưng ở đây là dấu sổ đứng | và hai dấu đóng ngoặc }}. Và giờ là dấu sổ đứng và các dấu đóng ngoặc |}}.

Bản mẫu này sử dụng các lớp CSS Hộp thông báo hình trong MediaWiki:Common.css để hiển thị hình dáng, do đó nó có thể thay đổi được hình dáng.

Bên trong siêu bản mẫu này sử dụng mã HTML thay vì mã wiki làm mã vẽ bảng. Đây là cách thông thường để tạo siêu bản mẫu vì mã wiki có một số điểm bất lợi. Ví dụ nó khiến khó sử dụng hàm cú pháp và các ký tự đặc biệt trong tham số hơn.

Các hình mặc định dành cho siêu bản mẫu này có định dạng png thay vì svg. Lý do chính là vì một số trình duyệt web cũ có vấn đề với phông nền trong suốt mà MediaWiki phân giải đối với hình svg. Hình png có màu nền trong suốt được tối ưu do đó chúng trông đẹp đối với tất cả các trình duyệt. Chú ý rằng biểu tượng svg chỉ nhìn xấu ở vài trình duyệt mà thôi, do đó việc tối ưu hóa như vậy chỉ nên dành cho những biểu tượng được dùng rất rộng rãi.

Để biết thêm chi tiết kỹ thuật mời xem trang thảo luận tiếng Anh. Vì bản mẫu này gần như y hệt với {{Hộp thông báo}} và {{cmbox}} các trang thảo luận và trang liên quan của chúng cũng có các thông tin khác.

Xem thêm

Có vài siêu bản mẫu trong gia đình mbox:

• {{Hộp thông báo}} (ambox) – Dành cho hộp thông báo bài viết.
• {{tmbox}} – Dùng cho hộp thông báo trang thảo luận.
• {{Hộp thông báo hình}} – Dùng cho hộp thông báo trang hình.
• {{cmbox}} – Dùng cho hộp thông báo thể loại.
• {{ombox}} – Dùng cho các hộp thông báo khác.
• {{mbox}} – Có khả năng kiểm tra không gian tên, dành cho hộp thông báo được sử dụng tại nhiều loại trang và do đó cần phải thay đổi kiểu tùy vào trang chúng được dùng.