canonicalwebteam.image template
1.0.0
وحدة لإنشاء علامة صورة HTML أداء للصور. سوف العلامات:
width height لتجنب تأثير القفز على الصفحةsrcset محددة مسبقًا (2x) لشاشات HideF url (سلسلة إلزامية): عنوان URL لصورة (على سبيل المثال https://assets.ubuntu.com/v1/9f6916dd-k8s-prometheus-light.png )alt (سلسلة إلزامية): نص ALT لوصف الصورةhi_def (منطقي إلزامي): هل تم تحميل صورة 2x وعرض وارتفاع الحجم المطلوبwidth (عدد صحيح إلزامي): يجب أن يكون عدد وحدات البكسل على نطاق واسعheight (عدد صحيح اختياري): يجب أن يكون عدد البكسلات عالية الصورةfill (منطقي اختياري): اضبط وضع المحاصيل على "ملء"loading (سلسلة اختيارية ، افتراضي: "Lazy"): تعيين على "Auto" أو "Cean" لتعطيل Lazyloadingattrs ( class الاختياري): يمكن id سمات extra <img> للتنمية المحلية ، من الأفضل اختبار هذه الوحدة مع أحد مشاريع موقع الويب لدينا مثل ubuntu.com. لمزيد من المعلومات ، اتبع هذا الدليل (داخلي فقط).
يمكن استخدام وظيفة image_template مباشرة لإنشاء علامة تصوير الصورة.
from canonicalwebteam import image_template
image_markup = image_template (
url = "https://assets.ubuntu.com/v1/450d7c2f-openstack-hero.svg" ,
alt = "" ,
width = "534" ,
height = "319" ,
hi_def = True ,
loading = "auto" ,
fill = True ,
attrs = { "class" : "hero" , "id" : "openstack-hero" },
) ومع ذلك ، فإن الاستخدام الأكثر شيوعًا هو إضافته إلى سياقات قالب Django أو Flask ، كدالة image .
أضفها كعلامة قالب:
# myapp/templatetags.py
from canonicalwebteam import image_template
from django import template
from django . utils . safestring import mark_safe
register = template . Library ()
@ register . simple_tag
def image ( * args , ** kwargs ):
return mark_safe ( image_template ( * args , ** kwargs ))
# settings.py
TEMPLATES [ 0 ][ "OPTIONS" ][ "builtins" ]. append ( "myapp.templatetags" )استخدمه في القوالب:
# templates/mytemplate.html
{% image url="https://assets.ubuntu.com/v1/9f6916dd-k8s-prometheus-light.png" alt="Operational dashboard" width="1040" height="585" hi_def=True fill=True %}أضفها كعلامة قالب:
# app.py
from canonicalwebteam import image_template
from flask import Flask
app = Flask ( __name__ )
@ app . context_processor
def utility_processor ():
return { "image" : image_template }استخدمه في القوالب ، على سبيل المثال ::
# templates/mytemplate.html
{{
image(
url="https://assets.ubuntu.com/v1/450d7c2f-openstack-hero.svg",
alt="",
width="534",
height="319",
hi_def=True,
fill=True,
loading="auto",
attrs={"class": "hero", "id": "openstack-hero"},
) | safe
}}سيكون ترميز صورة الإخراج على سبيل المثال:
< img
src =" https://res.cloudinary.com/canonical/image/fetch/f_auto,q_auto,fl_sanitize,w_534,h_319,c_fill/https://assets.ubuntu.com/v1/450d7c2f-openstack-hero.svg "
srcset =" https://res.cloudinary.com/canonical/image/fetch/f_auto,q_auto,fl_sanitize,w_1068,h_638,c_fill/https://assets.ubuntu.com/v1/450d7c2f-openstack-hero.svg 2x "
alt =""
width =" 534 "
height =" 319 "
loading =" auto "
class =" hero "
id =" openstack hero "
/> لإضافة العلامات المطلوبة لهذا القالب كقصاص مستخدم ، أضف ما يلي كقصاص HTML (مقتطفات المستخدم ضمن ملف> تفضيلات ، أو رمز> تفضيلات على MacOS):
"Image module": {
"prefix": "image-module",
"body": [
"{{",
" image_template(",
" url="$1",",
" alt="$2",",
" height="$3",",
" width="$4",",
" hi_def=$5True,",
" loading="auto|lazy$6",",
" attrs={"class": "$7"}",
" ) | safe",
"}}"
],
"description": "Image module include"
}"