Bản mẫu:Tham số/doc
 | Đây là một trang con tài liệu dành cho Bản mẫu:Tham số. Nó gồm có các thông tin hướng dẫn sử dụng, thể loại và các nội dung khác không thuộc về phần trang bản mẫu gốc. |
Cách sử dụng
[sửa]Bản mẫu này được dùng để hiển thị các ví dụ về mã nguồn của tham số bản mẫu (hữu ích khi viết tài liệu hướng dẫn bản mẫu và thảo luận về mã bản mẫu tại các trang thảo luận).
Bản thân bản mẫu này yêu cầu ít nhất một hoặc hai tham số. Tham số đầu tiên là tên của tham số ví dụ muốn hiển thị (tham số này có thể để trống, nhưng bắt buộc phải khai báo). Tham số thứ hai (tùy chọn) là giá trị cho tham số ví dụ đầu tiên; hoặc, nếu tham số đầu tiên bị bỏ trống, tham số thứ hai sẽ minh họa cho một tham số không tên (trong một số trường hợp, nó đóng vai trò là tham số định trước không đi kèm với cú pháp |=giá trị phía sau, ví dụ: |phần trong {{Refimprove|phần}}).
Ví dụ
[sửa]| Mã | Kết quả | Ghi chú |
|---|---|---|
| {{para|tên}} | |tên= |
|
| {{para|tựa đề|Từ điển Tiếng Việt}} | |tựa đề=Từ điển Tiếng Việt |
|
| {{para| |phần}} | |phần |
Dành cho các tham số không tên; lưu ý tham số đầu tiên để trống trong mã nguồn |
{{para|tham số|giá trị}} |
|tham số=giá trị |
Các tham số
[sửa]|1=hoặc tham số không tên thứ nhất – tên tham số. Hãy để trống tham số này một cách rõ ràng và chỉ điền tham số 2 khi bạn muốn hiển thị một tham số không tên (tùy thuộc vào ngữ cảnh, nó có thể đóng vai trò là một tên tham số không có giá trị); ví dụ: {{[[Bản mẫu:|]]|para|phần}} →|phần|2=hoặc tham số không tên thứ hai – tên giá trị. Khi tham số đầu tiên được khai báo nhưng để trống, tham số thứ hai sẽ đại diện cho giá trị của tham số không tên (hoặc một tên tham số không có giá trị), như minh họa ở trên.|plain=y(hoặc bất kỳ giá trị nào khác ngoài y) – loại bỏ đường viền mờ và nền xám nhạt, tùy chọn này có thể hữu ích trong nhiều trường hợp. Màu của đường viền và văn bản được thiết lập là "inherit", để sử dụng màu sắc của văn bản xung quanh. Tham số này phối hợp với hai tham số bên dưới: nếu sử dụng bất kỳ tham số nào dưới đây, văn bản sẽ được tô màu trong khi đường viền và nền vẫn bị loại bỏ.|style=– dùng để áp dụng kiểu CSS tùy ý cho một số mục đích ngữ cảnh chuyên biệt. Ví dụ:|style=background-color: yellow;. Bất kỳ thuộc tính color (màu chữ), background-color (màu nền), hoặc border (viền) nào được quy định tại đây sẽ ghi đè các thuộc tính được cung cấp bởi các tham số kể trên, bất kể thứ tự khai báo tham số trong bản mẫu. Vì bản mẫu này sử dụng thẻ span, nên chỉ có CSS áp dụng cho phần tử nội dòng (inline elements) mới hoạt động (không áp dụng cho phần tử khối/block elements). Giống như các tham số trên, nó áp dụng cho toàn bộ kết quả đầu ra.- Nếu bạn chỉ muốn tạo kiểu cho riêng tên tham số và/hoặc giá trị, hãy thực hiện trực tiếp trong mã;
ví dụ: {{para|trang|số trang '''đơn'''}}, {{para|các trang|khoảng trang, hoặc '''nhiều''' trang riêng lẻ, hoặc cả hai}}
kết quả: |trang=số trang đơn, |các trang=khoảng trang, hoặc nhiều trang riêng lẻ, hoặc cả hai
Dữ liệu bản mẫu
[sửa]Đưa ra các ví dụ về mã nguồn tham số bản mẫu
| Tham số | Miêu tả | Kiểu | Trạng thái | |
|---|---|---|---|---|
| Tên tham số | 1 | Tên của tham số. Hãy để trống tham số này một cách rõ ràng và chỉ điền tham số 2 khi bạn muốn hiển thị một tham số không tên. | Chuỗi dài | khuyên dùng |
| Tên giá trị | 2 | Tên giá trị của tham số. Khi tham số đầu tiên được khai báo nhưng để trống, tham số thứ hai sẽ đại diện cho giá trị của một tham số không tên (hoặc một tên tham số không có giá trị). | Chuỗi dài | khuyên dùng |
| plain | plain | Loại bỏ đường viền mờ và nền màu xám nhạt. | Luận lý | tùy chọn |
| style | style | Áp dụng kiểu CSS tùy ý, phục vụ cho các mục đích ngữ cảnh chuyên biệt.
| Nội dung | tùy chọn |