Bản mẫu:Hộp thông tin
 | Bản mẫu này được sử dụng ở khoảng 1.100.000 trang, chiếm ≈ 6% tổng số trang. Để tránh gây lỗi trên quy mô lớn và tải máy chủ không cần thiết, 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: |
| {{{above}}} | |
|---|---|
| {{{subheader}}} | |
| {{{subheader2}}} ...... | |
| {{{image}}} {{{caption}}} | |
| {{{image2}}} {{{caption2}}} ...... | |
{{{header1}}} ( or ) | |
| {{{label1}}} | {{{data1}}} |
| ( or ) | |
{{{data1}}} | |
| {{{header2}}} ( or ) | |
| {{{label2}}} | {{{data2}}} |
| ( or ) | |
{{{data2}}} | |
( etc ) | |
| {{{below}}} | |
Sử dụng
Bản mẫu này là một bản mẫu meta, được sử dụng để xây dựng các bản mẫu khác. Nó không nên được sử dụng trực tiếp trong một bài viết. Xem en:Help:Infobox để biết thông tin về cách tạo các hộp thông tin nói chung. Tham khảo Wikipedia:Cẩm nang biên soạn và và các bản mẫu đã viết để biết thêm.
Cách sử dụng tương tự như {{navbox}}, nhưng với một sự phân biệt bổ sung. Mỗi hàng trên bảng có thể là một "đầu đề" (header) hoặc nó có thể có một cặp nhãn/dữ liệu (label/data) hoặc nó chỉ có thể là một ô dữ liệu. Đây là các trạng thái loại trừ lẫn nhau, vì vậy nếu bạn xác định một hàng vừa là đầu đề vừa là cặp nhãn/dữ liệu (label/data), cặp nhãn/dữ liệu (label/data) sẽ bị ghi đè.
Lưu ý rằng nếu bạn muốn chèn một hình ảnh ở nơi khác ngoài đầu hộp thông tin hoặc chèn các dữ liệu "dạng tự do" khác, sử dụng một hàng chỉ với trường "dữ liệu" (data) sẽ cho phép điều đó.
Tham số
Để đảm bảo hộp thông tin hiện được thông tin, cần có ít nhất một hoặc nhiều tham số sau:
- name
- Tên trang bản mẫu mà liên kết "x/t/s" bên dưới nên trỏ đến. Bạn có thể dùng {{subst:PAGENAME}}.
- title
- Một tiêu đề để đặt vào thanh tiêu đề ở trên cùng.
Nếu không có tên hoặc tiêu đề được đưa ra, pagename (tên trang) được sử dụng.
- image
- Một hình ảnh để hiển thị ở trên cùng của bản mẫu. Sử dụng cú pháp hình ảnh đầy đủ, ví dụ [[Image:example.png|200px]]. Hình ảnh được căn giữa theo mặc định.
- caption
- Văn bản đặt bên dưới hình ảnh.
- header(n)
- Văn bản để sử dụng làm đầu đề trong hàng n.
- label(n)
- Văn bản để sử dụng làm một nhãn trong hàng n.
- data(n)
- Văn bản để hiển thị dưới dạng dữ liệu trong hàng n.
- below
- Văn bản để đặt trong ô dưới cùng. Các ô dưới cùng được dành cho chú thích, xem thêm và các thông tin khác như vậy.
Kiểu CSS tùy chọn:
- bodystyle
- Áp dụng cho toàn bộ bảng thông tin
- titlestyle
- Chỉ áp dụng cho ô tiêu đề (title)
- imagestyle
- Áp dụng cho ô mà hình ảnh nằm trong (bao gồm cả chú thích (caption))
- captionstyle
- Áp dụng cho văn bản của chú thích (caption)
- headerstyle
- Áp dụng cho tất cả các ô đầu đề (header)
- labelstyle
- Áp dụng cho tất cả các ô nhãn (label)
- datastyle
- Áp dụng cho tất cả các ô dữ liệu (data)
- belowstyle
- Chỉ áp dụng cho các ô bên dưới (below)
Làm cho các tham số tùy chọn
Một hàng có nhãn nhưng không có dữ liệu không được hiển thị. Điều này cho phép tùy chỉnh nội dung hộp thông tin. Để làm cho một tham số tùy chọn, sử dụng một tham số mặc định thành một chuỗi trống, như thế này:
|data5={{{population|}}}
Đối với các trường phức tạp hơn với nội dung được định dạng sẵn vẫn sẽ xuất hiện nếu một tham số không được đặt, bạn có thể gói tất cả trong một câu lệnh "nếu" (If) đơn giản để làm cho toàn bộ nội dung biến mất khi không được sử dụng. Thí dụ:
|data5= {{#if: {{{mass|}}} | {{{mass}}} kg}}
Ví dụ
 Caption for example.png | |
| Header defined alone | |
|---|---|
| Data defined alone | |
| All three defined (header, label, data, all with same number) | |
| Label and data defined (label) | Label and data defined (data) |
| Below text | |
{{Hộp thông tin
|name = Hộp thông tin/doc
|bodystyle =
|title = Test Hộp thông tin
|titlestyle =
|image = [[File:example.png|200px|alt=Example alt text]]
|imagestyle =
|caption = Caption for example.png
|captionstyle =
|headerstyle = background:#ccf;
|labelstyle = background:#ddf;
|datastyle =
|header1 = Header defined alone
|label1 =
|data1 =
|header2 =
|label2 = Label defined alone does not display (needs data, or is suppressed)
|data2 =
|header3 =
|label3 =
|data3 = Data defined alone
|header4 = All three defined (header, label, data, all with same number)
|label4 = does not display (same number as a header)
|data4 = does not display (same number as a header)
|header5 =
|label5 = Label and data defined (label)
|data5 = Label and data defined (data)
|belowstyle = background:#ddf;
|below = Below text
}}
Lưu ý cách khi nhãn (label) được xác định mà không có ô dữ liệu (data) đi kèm, hàng không xuất hiện trong hộp thông tin sẽ được hiển thị và khi tiêu đề được xác định trên cùng một hàng với tất cả các ô dữ liệu sẽ được hiển thị.
Ví dụ này, bodystyle = width:20em; and labelstyle = width:33%;
| Label 1 | Data 1 |
|---|---|
| Label 2 | Data 2 |
| Label 3 | Data 3 |
| Header 4 | |
| Label 5 | Data 5: Lorem ipsum dolor sit amet, consectetur adipisicing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua. |
| Below text | |
{{Hộp thông tin
|bodystyle = width:20em;
|name = Hộp thông tin/doc
|title = Test Hộp thông tin
|titlestyle =
|headerstyle =
|labelstyle = width:33%
|datastyle =
|header1 =
|label1 = Label 1
|data1 = Data 1
|header2 =
|label2 = Label 2
|data2 = Data 2
|header3 =
|label3 = Label 3
|data3 = Data 3
|header4 = Header 4
|label4 =
|data4 =
|header5 =
|label5 = Label 5
|data5 = Data 5: Lorem ipsum dolor sit amet, consectetur adipisicing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua.
|belowstyle =
|below = Below text
}}
Nhúng
Một bản mẫu hộp thông tin có thể được nhúng vào một bản mẫu khác bằng cách sử dụng tham số |child=. Tính năng này có thể được sử dụng để tạo hộp thông tin mô-đun hoặc để tạo các phần logic được xác định rõ hơn.
| First subsection | |
| Label 1.1 | Data 1.1 |
|---|---|
| Second subsection | |
| Label 2.1 | Data 2.1 |
| Below text | |
{{Hộp thông tin
| title = Top level title
| data1 = {{Hộp thông tin
| child = yes
| title = First subsection
| label1= Label 1.1
| data1 = Data 1.1
}}
| data2 = {{Hộp thông tin
| child = yes
| title = Second subsection
| label1= Label 2.1
| data1 = Data 2.1
}}
|belowstyle =
|below = Below text
}}
Lưu ý, trong các ví dụ trên, hộp thông tin con được đặt trong tham số data, không phải tham số header. Tiêu đề sẽ được đính kèm trong tag đậm <b>...</b>, có thể tạo ra "hiệu ứng gấp đôi" trong một số trình duyệt nếu hộp thông tin con được đặt trong tham số header. Để đặt hộp thông tin con vào trường tiêu đề và tránh hiệu ứng gấp đôi, hãy sử dụng
| First subsection | |
|---|---|
| Label 1.1 | Data 1.1 |
| Second subsection | |
| Label 2.1 | Data 2.1 |
| Below text | |
{{Hộp thông tin
| title = Top level title
| header1 = First subsection
{{Hộp thông tin
| child = yes
| label1= Label 1.1
| data1 = Data 1.1
}}
| header2 = Second subsection
{{Hộp thông tin
| child = yes
| label1= Label 2.1
| data1 = Data 2.1
}}
|belowstyle =
|below = Below text
}}
Tham số đầy đủ
(Lưu ý: bản mẫu hiện xử lý và hiển thị không giới hạn số hàng; chỉ có 20 được đưa ra dưới đây vì hộp thông tin lớn hơn sẽ tương đối hiếm. Chỉ cần mở rộng đánh số khi cần thiết. Các tham số "class" microformat cũng bị bỏ qua vì chúng không được sử dụng phổ biến.)
{{Hộp thông tin
|name = {{subst:PAGENAME}}
|bodystyle =
|title =
|titlestyle =
|above =
|abovestyle =
|imagestyle =
|captionstyle =
|image =
|caption =
|image2 =
|caption2 =
|headerstyle =
|labelstyle =
|datastyle =
|header1 =
|label1 =
|data1 =
|header2 =
|label2 =
|data2 =
|header3 =
|label3 =
|data3 =
|header4 =
|label4 =
|data4 =
|header5 =
|label5 =
|data5 =
|header6 =
|label6 =
|data6 =
|header7 =
|label7 =
|data7 =
|header8 =
|label8 =
|data8 =
|header9 =
|label9 =
|data9 =
|header10 =
|label10 =
|data10 =
|header11 =
|label11 =
|data11 =
|header12 =
|label12 =
|data12 =
|header13 =
|label13 =
|data13 =
|header14 =
|label14 =
|data14 =
|header15 =
|label15 =
|data15 =
|header16 =
|label16 =
|data16 =
|header17 =
|label17 =
|data17 =
|header18 =
|label18 =
|data18 =
|header19 =
|label19 =
|data19 =
|header20 =
|label20 =
|data20 =
|belowstyle =
|below =
}}
Xem thêm
- {{infobox3cols}}