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

Văn thư lưu trữ mở Wikisource
Bước tới điều hướng Bước tới tìm kiếm
Tài liệu bản mẫu[xem] [sửa] [lịch sử] [làm mới]

Đâ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[sửa]

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]

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]

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]

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

Các tham số[sửa]

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[sửa]

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

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[sửa]

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.