Bản mẫu:Hộp thông báo hình
Sử dụng Lua: |
Đâ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ửaVí 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
sửaCá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=giấy phép – bản mẫu giấy phép như {{GFDL}}. |
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
sửaNhữ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}}. |
loại = giấy phép hình = [[Hình:Heckert GNU white.svg|48px]] Hình này được dùng trong các tieu bản giấy phép GFDL như {{GFDL}}. |
Đặc biệt
sửaVà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. |
| loại = giấy phép hình = [[Hình:PD-icon.svg|40px]] <br> [[Hình:Ambox warning yellow.svg|40px]] hình phải = [[Hình:Shuttle.svg|30px]] |
| Tập tin 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ỳ. |
loại = giấy phép hình = [[Hình:PD-icon.svg|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!''' }} | |||
|
Các tham số
sửaDanh 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ửaNế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
sửaCó 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.