Bản mẫu:Fmbox

Các siêu bản mẫu; hộp thông báo (Mbox)
{{Ambox}}	bài viết
{{Cmbox}}	thể loại
{{Imbox}}	hình
{{Fmbox}}	thảo luận
{{Ombox}}	chân / đầu trang
{{Mbox}}	(auto-detect)
{{Asbox}}	bài sơ khai
{{Dmbox}}	trang định hướng

Tài liệu bản mẫu[xem] [sửa] [lịch sử] [làm mới]

Bản mẫu này được sử dụng trong thông báo hệ thống.
Thay đổi đến nó có thể dẫn đến thay đổi ngay lập tức giao diện người dùng Wikipedia.
Để tránh gây lỗi trên quy mô lớn, tất cả thay đổi cần được thử nghiệm ở trang con /sandbox, /testcases của bản mẫu, hoặc ở không gian người dùng của bạn. Các thay đổi đã được thử nghiệm có thể thêm vào bản mẫu bằng một sửa đổi duy nhất. Xin hãy thảo luận các thay đổi tại trang thảo luận trước khi áp dụng sửa đổi.

Bản mẫu này sử dụng Lua:

Module:Message box (chỗ thử)

Đây là bản mẫu {{Fmbox}} ([F]ooter and header [m]essage [box]).

Nó có thể được sử dụng để xây dựng các hộp thông báo cho các thông báo hệ thống như MediaWiki:Sp-contributions-footer-anon. Nó cũng có thể được sử dụng cho hộp chân trang và hộp tiêu đề trên trang người dùng và cho editnotices.

Bản mẫu này hoạt động tương tự như {{Ambox}} và chủ yếu sử dụng các tham số tương tự. Sự khác biệt chính là hộp này rộng 100% và có các kiểu màu khác nhau.

Sử dụng

Ví dự đơn giản

{{Fmbox |text=Văn bản nào đó.}}

tạo ra:

Văn bản nào đó.

Ví dự phức tạp

{{Fmbox
 | type = editnotice
 | image = [[File:Emblem-question-yellow.svg|40px]]
 | style = border:1px solid #f4c430;
 | textstyle = font-style:italic; font-weight:bold; color:red;
 | text = The message's text.
}}

tạo ra:

The message's text.

Các loại hộp thông báo chân trang và tiêu đề

Các ví dụ sau sử dụng các tham số type khác nhau nhưng không có tham số hình ảnh, tức là họ sử dụng hình ảnh mặc định cho từng loại.

type = warning
Đối với các thông báo cảnh báo hệ thống như MediaWiki:Revision-info và MediaWiki:Protectedpagewarning.

type = editnotice
Cung cấp một nền màu trong suốt cho editnotices.

type = system
Mặc định nền hệ thống tin nhắn màu xám nhạt.

Hình ảnh không mặc định

Các hình ảnh mặc định hiển thị ở trên hầu hết là để thử nghiệm và minh họa. Trong hầu hết các trường hợp, sẽ phù hợp hơn khi sử dụng một hình ảnh cụ thể hơn hoặc không có hình ảnh nào cả. Các ví dụ sau sử dụng tham số image để chỉ định dùng một hình ảnh khác với mặc định.

image = [[File:User-info.svg|40px]]
Ảnh MediaWiki:Sp-contributions-footer.

image = [[File:Commons-logo.svg|40x40px]]
Ảnh MediaWiki:Sharedupload-desc-here. Tham số "40x40px" trong liên kết File:đặt chiều cao cũng như chiều rộng của hình ảnh.

Ví dụ khác

Ảnh mặc định của Fmbox (khi tham số image không xác định).

Đặt image = none có nghĩa là text sử dụng toàn bộ hộp thông báo.

image = [[File:User-info.svg|40px]]
imageright = [[File:Nuvola apps bookcase.svg|40px]]

Tham số

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

{{fmbox
| name = name of the template
| type  = system / editnotice / warning
| image = none / [[Image:Some image.svg|40px]]
| imageright = [[Image:Some image.svg|40px]]
| id = CSS id
| class = CSS class names
| style = CSS values
| textstyle = CSS values
| plainlinks  = no
| text  = The message body text.
}}

name

(Tùy chọn) Tên của bản mẫu. Điều này thêm một lớp CSS có tên box-name đến phần tử HTML, để sử dụng bởi bot hoặc tập lệnh.

type

Nếu không có tham số type được đưa ra thì mặc định bản mẫu dùng tham số type system. Điều đó có nghĩa là bản mẫu có một nền màu xám nhạt.

image

Không có tham số = Nếu không có tham số image được đưa ra thì mặc định bản mẫu dùng ảnh mặc định. Hình ảnh mặc định nào bản mẫu sử dụng phụ thuộc vào tham số type.

Dùng ảnh = Nên là một hình ảnh với ký hiệu wiki thông thường. Chiều rộng 40px - 50px thường ở bên phải tùy thuộc vào tỷ lệ chiều cao/chiều rộng của hình ảnh. (Nhưng hộp thông báo có thể xử lý hình ảnh ở mọi kích thước.) Ví dụ:

image = [[Tập tin:User-info.svg|40px]]

none = Có nghĩa là không có hình ảnh được sử dụng.

imageright

Không có tham số = Nếu không có tham số imagerightđược đưa ra thì mặc định bản mẫu không hiện bất kỳ ảnh nào ở bên phải.

Dùng ảnh = Nên là một hình ảnh với ký hiệu wiki thông thường. Chiều rộng 40px - 50px thường ở bên phải tùy thuộc vào tỷ lệ chiều cao / chiều rộng của hình ảnh. (Nhưng hộp thông báo có thể xử lý hình ảnh ở mọi kích thước.) Ví dụ:

imageright = [[Tập tin:Nuvola apps bookcase.png|40px]]

Anything = Bất kỳ đối tượng khác mà bạn muốn hiển thị ở phía bên phải.

id

Optional CSS id used by the entire message box table. Without quotation marks " ". Mostly meant to be used to tag a message box with its name, to make it easy to detect the presence of the message from javascript. For instance MediaWiki:Sp-contributions-footer would use:

id = sp-contributions-footer

class

Tùy chọn tên class CSS được sử dụng bởi toàn bộ bảng hộp thông báo. Không có dấu ngoặc kép " ". Chủ yếu được sử dụng để gắn thẻ một hộp thông báo với tên của bản mẫu để bản mẫu có thể được đặt riêng lẻ. Ví dụ MediaWiki:Sp-contributions-footer sẽ sử dụng:

class = sp-contributions-footer

style

Tùy chọn các giá trị CSS được sử dụng bởi toàn bộ bảng hộp thông báo. Không có dấu ngoặc kép " " nhưng với dấu chấm phẩy kết thúc ;. Ví dụ:

style = margin-top: 1em;

textstyle

Tùy chọn các giá trị CSS được sử dụng bởi ô văn bản. Ví dụ:

textstyle = font-size: 90%; text-align: center;

plainlinks

Thông thường trên Wikipedia, các liên kết bên ngoài có biểu tượng mũi tên bên cạnh, như thế này: Example.com. Tuy nhiên, trong các hộp thông báo, biểu tượng mũi tên bị chặn theo mặc định, như thế này: Example.com. Để có được kiểu thông thường của liên kết ngoài với biểu tượng mũi tên, hãy sử dụng |plainlinks=no.

text

Văn bản thông báo hiện ra.

Thông tin kĩ thuật

Bản mẫu này hiện đang sử dụng kiểu mã hóa cứng và tên lớp. Sau đó, nó sẽ chỉ sử dụng các lớp CSS làm cho nó dễ dàng hơn. (Trong khi đó, nó có thể được skin bằng cách sử dụng từ khóa"!important".)

Nếu bạn cần làm một hộp rộng hơn 100%, thì không hộp này; thay vào đó, sử dụng {{Ombox}}. Vì hộp này không có mã "ô hình ảnh trống 1px" để làm cho nó để các mbox khác có được luồng hộp thích hợp trong tất cả các trình duyệt khi rộng hơn 100%.

Nếu bạn cần sử dụng các ký tự đặc biệt trong tham số text, sau đó bạn cần "thoát" chúng như thế này:

{{Fmbox
| text = <div>
Dấu bằng = và dấu ngoặc móc đóng và mở { } hoạt động bình thường.
Nhưng ở đây dấu suyệt đứng {{!}} và dấu móc kép }}. 
Và giờ là dấu suyệt đứng và các dấu móc đóng |}}.
}}

Tạo ra:

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

Để tránh những khó khăn tiềm ẩn với ví dụ: parser functions hoặc kí tư đặc biệt, siêu dữ liệu này sử dụng HTML chứ không phải wiki markup để sản xuất bảng mang đầu ra của nó.

Vì một số trình duyệt cũ gặp khó khăn trong việc hiển thị độ trong suốt của SVG, hình ảnh mặc định cho siêu dữ liệu này ở định dạng PNG thay vì định dạng SVG và được tối ưu hóa bằng tay để đảm bảo chúng hoạt động trên phạm vi rộng và phiên bản của trình duyệt. (Các biểu tượng SVG chỉ trông hơi tệ trong các trình duyệt cũ hơn, do đó tối ưu hóa như vậy chỉ đáng giá cho các biểu tượng được sử dụng rất rộng rãi.)

Bảo quản viên:Phân tích cú pháp và chuyển đổi đánh dấu HTML của MediaWiki cho các thông báo hệ thống không giống như các trang thông thường: <br> chẳng hạn, không được tự động chuyển đổi thành <br /> và thiếu </td> và </tr> tags không được thêm tự động. Do đó, bất kỳ mã HTML nào được sử dụng trong các thông báo hệ thống đều phải hợp lệ (bao gồm tất cả các thẻ đóng bổ sung, v.v.).

Để biết thêm chi tiết, xem trang thảo luận. Vì bản mẫu này hoạt động gần giống như {{Ambox}}, {{Tmbox}}, {{Imbox}}, {{Cmbox}} và {{Ombox}}, thông tin thêm được tìm thấy trên các trang thảo luận của các bản mẫu đó cũng có thể có liên quan.

Xem thêm

{{Fmbox warning ruler}}, một thước kẻ ngang, được sử dụng trong một số thông báo cảnh báo hệ thống, sử dụng cùng màu đỏ với bản mẫu này loại tham số type warning.

Có 7 siêu bản mẫu trong gia đình hộp thông báo (Mbox):

{{Hộp thông báo}} (Ambox) – dùng cho không gian tên Chính (bài viết)
{{Hộp thông báo thể loại}} (Cmbox) – dùng cho không gian tên Thể loại
{{Hộp thông báo thảo luận}} (Tmbox) – dùng cho không gian tên Thảo luận
{{Hộp thông báo hình}} (Imbox) – dùng cho không gian tên Tập tin
{{Fmbox}} – các hộp thông báo dạng footer và header
{{Ombox}} – dùng cho các không gian tên khác (Thành viên, Wikipedia,…)
{{Mbox}} – tự độ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 không gian tên và do đó cần thay đổi kiểu tùy vào nơi chúng được dùng.

Siêu bản mẫu có liên quan gần:

{{Hộp sơ khai}} (Asbox) – siêu bản mẫu dành cho hệ thống bản mẫu sơ khai.
{{Dmbox}}, cho các hộp thông báo trên các trang định hướng hoặc trang chỉ mục.
{{Ivmbox}}, một hộp đơn giản có chiều rộng đầy đủ với nền ngà mặc định dành cho các thông điệp hoặc thông báo quan trọng.=

Tài liệu bên trên được truyền tải từ Bản mẫu:Fmbox/doc.
Biên tập viên sửa đổi có thể thử nghiệm trong các trang chỗ thử và trường hợp kiểm thử của bản mẫu này.
Xin hãy bổ sung các thể loại vào trang con /doc. Các trang con của bản mẫu này.