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

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

Nó được dùng để tạo nên những tiêu bản 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.

Tiêu bản 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.png|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.
}}

40px	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.

40x40px

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

loại=xóa – Tiêu bản xóa như {{ifd}}.

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

40x40px

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.

40x40px

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

40x40px

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

40x40px

loại=giấy phép – tiêu bản giấy phép như {{GFDL}}.

40x40px

loại=chọn lọc – tiêu bản 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.

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

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

loại = giấy phép hình = [[Hình:Heckert GNU white.png|48px]] Hình này được dùng trong các tieu bản giấy phép GFDL như {{GFDL}}.

Đặ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.

40px 40px

loại = giấy phép hình = [[Hình:Imbox license.png|40px]] <br> [[Hình:Ambox warning yellow.png|40px]] hình phải = [[Hình:Shuttle.png|30px]]

30px

40px 40px

Hình này nằm trong phạm vi công cộng vì nó được NASA tạo ra. Chú ý rằng việc sử dụng biểu trưng, con dấu và biểu tượng của NASA bị giới hạn theo luật Hoa Kỳ.

30px

40px	loại = giấy phép hình = [[Hình:Imbox license.png|40px]] 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!''' }}
Thẻ quyền này đã lỗi thời!

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.png|40px]]
| hình phải = [[Hình:Some hình.png|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 tiêu bản 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 tiêu bản, 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.png|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ì tiêu bản 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 |}}.

Tiêu bản 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 tiêu bản 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 tiêu bản 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 tiêu bản 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ì tiêu bản 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 tiêu bản 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.

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

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