مرجع فیلترها (Filter Reference)

فیلترهای قالب جنگو (Django Template Filters) توابع کوچک هستند. این توابع متن را قبلِ نمایش تغییر می دهند. مثل مدرسه، برگه را تمیزنویس می کنند. در این مرجع، نام فیلترها و توضیح کوتاه آن ها را می بینی.

فهرست فیلترها

• add: افزودن یک مقدار مشخص.
• addslashes: افزودن اسلش برای فراردهی نقل قول ها.
• capfirst: بزرگ کردن حرف اول.
• center: قرار دادن متن در وسطِ عرض.
• cut: حذف کاراکتر یا عبارت مشخص.
• date: فرمت دهی تاریخ.
• default: جایگزین زمانی که مقدار False است.
• default_if_none: جایگزین زمانی که مقدار None است.
• dictsort: مرتب سازی دیکشنری بر اساس مقدار.
• dictsortreversed: مرتب سازی معکوس دیکشنری.
• divisibleby: بررسی بخش پذیری بر عددی مشخص.
• escape: فراردهی HTML از رشته.
• escapejs: فراردهی JavaScript از رشته.
• filesizeformat: نمایش عدد به فرمت حجم فایل.
• first: اولین آیتمِ آبجکت یا کاراکتر متن.
• floatformat: گردکردن اعشاری تا رقم دلخواه.
• force_escape: فراردهی اجباری HTML.
• get_digit: برگرداندن رقم خاص از عدد.
• iriencode: تبدیل IRI به رشته سازگار با URL.
• join: اتصال لیست به رشته.
• json_script: خروجی JSON داخل تگ <script>.
• last: آخرین آیتمِ آبجکت یا کاراکتر متن.
• length: تعداد آیتم ها یا کاراکترها.
• length_is: مقایسه طول با عدد مشخص.
• linebreaks: تبدیل \n به <br> و پاراگراف.
• linebreaksbr: تبدیل \n به <br>.
• linenumbers: شماره گذاری خطوط متن.
• ljust: چپ چین با عرض مشخص.
• lower: حروف کوچک.
• make_list: تبدیل مقدار به لیست.
• phone2numeric: تبدیل حروف تلفن به عدد.
• pluralize: افزودن s بر اساس عدد.
• pprint: نمایش مرتب برای اشیاء.
• random: انتخاب آیتم تصادفی.
• rjust: راست چین با عرض مشخص.
• safe: علامت گذاری متنِ امن؛ بدون فراردهی.
• safeseq: امن کردن تک تک آیتم های دنباله.
• slice: برگرداندن برش از متن یا آبجکت.
• slugify: تبدیل متن به اسلاگِ کوچک و مجاز.
• stringformat: قالب دهی رشته ای به مقدار.
• striptags: حذف تگ های HTML.
• time: فرمت دهی زمان.
• timesince: اختلاف زمانی انسانی.
• timeuntil: اختلاف تا زمان آینده.
• title: حروف اول کلمات بزرگ.
• truncatechars: کوتاه کردن بر اساس کاراکتر.
• truncatechars_html: کوتاه کردن بدون شمردن تگ ها.
• truncatewords: کوتاه کردن بر اساس واژه.
• truncatewords_html: کوتاه کردن واژه با نادیده گرفتن تگ ها.
• unordered_list: نمایش آیتم ها به صورت لیستِ بدون ترتیب.
• upper: حروف بزرگ.
• urlencode: کدگذاری URL.
• urlize: تبدیل URLها به لینک.
• urlizetrunc: لینک کردن و کوتاه سازی URL.
• wordcount: شمارش واژه ها.
• wordwrap: شکست خط بر تعداد کاراکتر.
• yesno: نگاشت بولین به متن های دلخواه.
• i18n, l10n, tz: فیلترهای مرتبط با بین المللی سازی و زمان.

نکته: برای منطقِ نمایش، از تگ های قالب کنار فیلترهای قالب جنگو استفاده کن تا قالب ها تمیز و کوتاه بمانند.

جمع بندی سریع

• فیلترها خروجی متن را سریع اصلاح می کنند.
• برای تاریخ و زمان از date و time استفاده کن.
• safe را فقط برای متنِ مطمئن بگذار.
• ترکیب filterها با تگ ها، کد را کوتاه می کند.