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

Bách khoa toàn thư mở Wikipedia
Bước tới: menu, tìm kiếm
Hình tượng tài liệu Tài liệu bản mẫu[xem] [sửa] [lịch sử] [làm tươi]

Đâ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[sửa | sửa mã nguồn]

Ví dụ đơn giản:

{{Hộp thông báo hình | chữ = 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.
}}

Các loại hộp thông báo[sửa | sửa mã nguồn]

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.

Các hình khác[sửa | sửa mã nguồn]

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.

Đặc biệt[sửa | sửa mã nguồn]

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

Các tham số[sửa | sửa mã nguồn]

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 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.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ì 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[sửa | sửa mã nguồn]

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>
}}

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[sửa | sửa mã nguồn]

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.