From 485213a22bab3f5f8014181c8174a7bed8554e7b Mon Sep 17 00:00:00 2001 From: Mark Story Date: Wed, 13 Apr 2011 22:15:32 -0400 Subject: [PATCH] Updating documentation for whitespace trim tags. --- doc/templates.rst | 20 +++++++++++++++----- 1 files changed, 15 insertions(+), 5 deletions(-) diff --git a/doc/templates.rst b/doc/templates.rst index da8de89..e0b3a2d 100644 --- a/doc/templates.rst +++ b/doc/templates.rst @@ -162,19 +162,29 @@ Use the ``spaceless`` tag to remove whitespace between HTML tags: In addition to the spaceless tag you can also control whitespace on a per tag level. By using the whitespace control modifier on your tags you can trim -leading and or trailing horizontal whitespace from any tag type: +leading and or trailing whitespace from any tag type: .. code-block:: jinja + {% set value = 'no spaces' %} {#- No leading/trailing whitespace -#} - {%- if condition -%} + {%- if true -%} {{- value -}} {%- endif -%} + {# output 'spaces' #} + The above sample shows the default whitespace control modifier, and how you can -use it to remove whitespace around tags. Only horizontal space will be removed -any vertical space (newlines) will need to be removed with the -``spaceless`` tag. +use it to remove whitespace around tags. Trimming space will consume all whitespace +for that side of the tag. It is possible to use whitespace trimming on one side +of a tag: + +.. code-block:: jinja + + {% set value = 'no spaces' %} +
  • {{- value }}
    • + + {# outputs '
  • value
    • ' #} ..versionadded:: 1.1 -- 1.7.2.5