Template:Infobox nutritional value
This is the {{nutritional value}} infobox template.
Brief usage
[change source]{{nutritional value
| name =
| kJ =
| carbs =
| fat =
| protein =
| note =
}}
Parameters
[change source]- Required fields: |name=, |kJ=, |carbs=, |fat=, |protein=. You must state the units that are being used, except for kJ which is in kilojoules (1 Calorie = 1 kcal = 4.2 kJ). E.g. |fat= 3 g, the units are usually expressed in grams (g).
- Note: To specify energy in kcal rather than kJ, use |kcal= instead.
- Optional fields: |image=, |caption=, |serving_size=, |sugars=, |lactose=, |satfat=, |transfat=, |monofat=, |polyfat=, |omega3fat=, |omega6fat=, |fiber=, |starch=, |water=, |alcohol= and |caffeine=. Again, you must state the units that are being used.
- Contributor defined fields: Additional fields can be added using the |opt1n= and |opt1v= fields, where n is for name and v is for value. Up to four optional fields are supported, |opt1n= & |opt1v= up to |opt4n= & |opt4v=.
- The following optional variables are converted into percentages of RDA (taken as averages for males and females aged 25–50 years from the USDA 2000 recommendation)
- Minerals (in mg) - |calcium_mg=, |iron_mg=, |phosphorus_mg=, |magnesium_mg=, |manganese_mg=, |sodium_mg=, |potassium_mg=, |zinc_mg=
- Vitamins (in mg, μg, or international units) - |vitA_ug=, |vitA_iu= (in IU), |betacarotene_ug= (subcategory of vitamin A!), |thiamin_mg= (Vit. B1), |riboflavin_mg= (Vit. B2), |niacin_mg= (Vit. B3), |pantothenic_mg= (pantothenic acid), |vitB6_mg=, |folate_ug=, |vitB12_ug=, |vitC_mg=, |vitD_ug=, |vitD_iu= (in IU), |vitE_mg=, |vitK_ug=.
- Other optional variables and flags
- Footnote - |note= a convenient way to indicate serving sizes or edible parts, e.g. 1 banana is 100 to 150 g or other information.
- Data source - |source= sets the source of the information used in the template.
- USDA - |source_usda= a "yes" in this field will automatically set the source as the USDA database.
- Suppression of RDA explanation - |noRDA = a value of "yes" will suppress the USDA recommenced daily value that is automatically assigned as part of several fields.
- Location - |right = - a value of "yes" will cause the table to appear on the right side of the article.
- Additional notes
- According to convention, there should be a space between the number and the unit: "14 g" and not "14g".
- Don't specify numbers in too many decimals. Food is often very variable; the USDA tables provide a standard deviation as an indication for how accurate the number is. If it says "1.2345 g" with a standard deviation of 0.08 g, then 1.2 g is the highest accuracy worth mentioning.
- Splitting up components that are present in trace amounts is not very meaningful (e.g. 1.5 g fats of which 0.5 g unsaturated).
- The author of the template recommendeds to include only vitamins and minerals for which this product is considered to be a major source, in order to prevent clogging up the article with a huge table. As a guideline:
- staple foods: an amount that provides 10,000 kJ should provide well over 100% of the RDI.
- meats and such: same, but for 4,000 kJ.
- vegetables, other low-calorie solid food, fruits: same, but for 400 g.
- other products: use an amount that one could reasonably eat on a daily basis.
Nutritional values can be found e.g. in the USDA National Nutrient Database. Note that fibers are counted as carbohydrates.
Full syntax
[change source]{{nutritional value
| name =
| image =
| caption =
| serving_size =
| kJ =
| carbs =
| fat =
| protein =
| sugars =
| lactose =
| satfat =
| transfat =
| monofat =
| polyfat =
| omega3fat =
| omega6fat =
| fiber =
| starch =
| water =
| alcohol =
| caffeine =
| opt1n =
| opt1v =
| opt4n =
| opt4v =
| calcium_mg =
| iron_mg =
| phosphorus_mg =
| magnesium_mg =
| manganese_mg =
| sodium_mg =
| potassium_mg =
| zinc_mg =
| vitA_ug =
| vitA_iu =
| betacarotene_ug =
| lutein_ug =
| thiamin_mg =
| riboflavin_mg =
| niacin_mg =
| pantothenic_mg =
| vitB6_mg =
| folate_ug =
| vitB12_ug =
| vitC_mg =
| vitD_ug =
| vitD_iu =
| vitE_mg =
| vitK_ug =
| note =
| source =
| source_usda =
| noRDA =
| right =
}}
Examples
[change source]| Nutritional value per 100 g (3.5 oz) | |
|---|---|
| Energy | 2,450 kJ (590 kcal) |
| Carbohydrates | 22 g |
| - Starch | 8 g |
| - Sugars | 5 g |
| - Lactose | 1 g |
| - Dietary fibre | 9 g |
| Fat | 50 g |
| - saturated | 7 g |
| - trans | 3 g |
| - monounsaturated | 25 g |
| - polyunsaturated | 16 g |
| - omega-3 fat | 1 g |
| - omega-6 fat | 2 g |
| Protein | 24 g |
| Water | 5 g |
| Alcohol | 1 g |
| Caffeine | 20 mg |
| Vitamin A equiv. | 12 μg (1%) |
| - beta-carotene | 120 μg (1%) |
| Thiamine (Vit. B1) | 1 mg (77%) |
| Riboflavin (Vit. B2) | 2 mg (133%) |
| Niacin (Vit. B3) | 0.5 mg (3%) |
| Pantothenic acid (B5) | 0.1 mg (2%) |
| Vitamin B6 | 1 mg (77%) |
| Folate (Vit. B9) | 1.5 μg (0%) |
| Vitamin B12 | 0.5 μg (21%) |
| Vitamin C | 20 mg (33%) |
| Vitamin D | 10 μg (100%) |
| Vitamin E | 5 mg (33%) |
| Vitamin K | 10 μg (10%) |
| Calcium | 200 mg (20%) |
| Iron | 5 mg (40%) |
| Magnesium | 1.2 mg (0%) |
| Manganese | 1.2 mg (60%) |
| Phosphorus | 50 mg (7%) |
| Potassium | 80 mg (2%) |
| Sodium | 40 mg (2%) |
| Zinc | 0.4 mg (4%) |
| Footnote text here Percentages are relative to US recommendations for adults. Source: USDA Nutrient database | |
{{nutritional value
| name = Foonuts
| kJ = 2450
| protein = 24 g
| fat = 50 g
| satfat = 7 g
| transfat = 3 g
| monofat = 25 g
| polyfat = 16 g
| omega3fat = 1 g
| omega6fat = 2 g
| carbs = 22 g
| starch = 8 g
| sugars = 5 g
| lactose = 1 g
| fiber = 9 g
| sodium_mg = 40
| potassium_mg = 80
| vitA_ug = 12
| betacarotene_ug = 120
| vitC_mg = 20
| thiamin_mg = 1
| riboflavin_mg = 2
| niacin_mg = 0.5
| pantothenic_mg = 0.1
| folate_ug = 1.5
| vitD_ug = 10
| vitE_mg = 5
| vitK_ug = 10
| iron_mg = 5
| magnesium_mg = 10
| manganese_mg = 1.2
| phosphorus_mg = 50
| zinc_mg = 0.4
| calcium_mg = 200
| vitB6_mg = 1
| vitB12_ug = 0.5
| water = 5 g
| alcohol = 1 g
| caffeine = 20 mg
| tryptophan = 0.010 g
| source_usda = 1
| note = Footnote text here
| right = yes
}}
will generate →
Template editing
[change source]This is a complex template that is used by over 150 articles as of October 2008. Breaking this template will cause problems in all those articles, so please use {{nutritionalvalue/sandbox}} for experimenting with the layout.
In the HTML version: don't put line breaks into the template around the {{#if:...}} parser functions, because they will end up as line breaks above the table.
Translations
[change source]If you translate this template for use in other language wikipedias, you could consider keeping the English variable names, so that you can simply copy/paste existing tables from English to your language (and back). Or you could make two versions, one using native-language variable names, and the other using the English names.