模板繼承

Django模版引擎中最強大也是最復(fù)雜的部分就是模版繼承了棘捣。模版繼承可以讓您創(chuàng)建一個基本的“骨架”模版,它包含您站點中的全部元素冰啃,并且可以定義能夠被子模版覆蓋的 blocks 橄镜。
通過從下面這個例子開始括饶,可以容易的理解模版繼承:

<!DOCTYPE html>
<html lang="en">
<head>
    <link rel="stylesheet" href="style.css" />
    <title>{% block title %}My amazing site{%/span> endblock %}</title>
</head>

<body>
    <div id="sidebar">
        {% block sidebar %}
        <ul>
            <li><a href="/">Home</a></li>
            <li><a href="/blog/">Blog</a></li>
        </ul>
        {% endblock %}
    </div>

    <div id="content">
        {% block content %}{% endblock %}
    </div>
</body>
</html>

這個模版,我們把它叫作 base.html恕洲, 它定義了一個可以用于兩列排版頁面的簡單HTML骨架塔橡。“子模版”的工作是用它們的內(nèi)容填充空的blocks霜第。
在這個例子中葛家, block 標(biāo)簽定義了三個可以被子模版內(nèi)容填充的block。 block 告訴模版引擎: 子模版可能會覆蓋掉模版中的這些位置泌类。
子模版可能看起來是這樣的:

{% extends "base.html" %}
 
{% block title %}My amazing blog{% endblock %}
 
{% block content %}
{% for entry in blog_entries %}
    <h2>{{ entry.title }}</h2>
    <p>{{ entry.body }}</p>
{% endfor %}
{% endblock %}

extends 標(biāo)簽是這里的關(guān)鍵癞谒。它告訴模版引擎,這個模版“繼承”了另一個模版。當(dāng)模版系統(tǒng)處理這個模版時弹砚,首先双仍,它將定位父模版——在此例中,就是“base.html”桌吃。

那時殊校,模版引擎將注意到 base.html 中的三個 block 標(biāo)簽,并用子模版中的內(nèi)容來替換這些block读存。根據(jù) blog_entries 的值为流,輸出可能看起來是這樣的:

<!DOCTYPE html>
<html lang="en">
<head>
    <link rel="stylesheet" href="style.css" />
    <title>My amazing blog</title>
</head>
 
<body>
    <div id="sidebar">
        <ul>
            <li><a href="/">Home</a></li>
            <li><a href="/blog/">Blog</a></li>
        </ul>
    </div>
 
    <div id="content">
        <h2>Entry one</h2>
        <p>This is my first entry.</p>
 
        <h2>Entry two</h2>
        <p>This is my second entry.</p>
    </div>
</body>
</html>

請注意,子模版并沒有定義 sidebar block让簿,所以系統(tǒng)使用了父模版中的值敬察。父模版的 {% block %} 標(biāo)簽中的內(nèi)容總是被用作備選內(nèi)容(fallback)。
這種方式使代碼得到最大程度的復(fù)用尔当,并且使得添加內(nèi)容到共享的內(nèi)容區(qū)域更加簡單莲祸,例如,部分范圍內(nèi)的導(dǎo)航椭迎。
這里是使用繼承的一些提示:

  • 如果你在模版中使用 {% extends %} 標(biāo)簽锐帜,它必須是模版中的第一個標(biāo)簽。其他的任何情況下畜号,模版繼承都將無法工作缴阎。
  • 在base模版中設(shè)置越多的 {% block %} 標(biāo)簽越好。請記住简软,子模版不必定義全部父模版中的blocks蛮拔,所以,你可以在大多數(shù)blocks中填充合理的默認(rèn)內(nèi)容痹升,然后建炫,只定義你需要的那一個。多一點鉤子總比少一點好疼蛾。
  • 如果你發(fā)現(xiàn)你自己在大量的模版中復(fù)制內(nèi)容肛跌,那可能意味著你應(yīng)該把內(nèi)容移動到父模版中的一個 {% block %} 中。
  • 如果需要獲取父模板中的block 的內(nèi)容察郁,可以使用{{ block.super }}變量衍慎。如果你想要在父block 中新增內(nèi)容而不是完全覆蓋它,它將非常有用绳锅。使用{{block.super }}插入的數(shù)據(jù)不會被自動轉(zhuǎn)義西饵,因為父模板中的內(nèi)容已經(jīng)被轉(zhuǎn)義。
  • 為了更好的可讀性鳞芙,你也可以給你的 {% endblock %} 標(biāo)簽一個 名字 眷柔。
    例如:{% block content %}...{% endblock content %}
    在大型模版中期虾,這個方法幫你清楚的看到哪一個  {% block %} 標(biāo)簽被關(guān)閉了。

最后驯嘱,請注意您并不能在一個模版中定義多個相同名字的 block 標(biāo)簽镶苞。這個限制的存在是因為block標(biāo)簽的作用是“雙向”的。這個意思是鞠评,block標(biāo)簽不僅提供了一個坑去填茂蚓,它還在 父模版中定義了填坑的內(nèi)容。如果在一個模版中有兩個名字一樣的 block 標(biāo)簽剃幌,模版的父模版將不知道使用哪個block的內(nèi)容聋涨。

最后編輯于
?著作權(quán)歸作者所有,轉(zhuǎn)載或內(nèi)容合作請聯(lián)系作者
  • 序言:七十年代末,一起剝皮案震驚了整個濱河市负乡,隨后出現(xiàn)的幾起案子牍白,更是在濱河造成了極大的恐慌,老刑警劉巖抖棘,帶你破解...
    沈念sama閱讀 212,383評論 6 493
  • 序言:濱河連續(xù)發(fā)生了三起死亡事件茂腥,死亡現(xiàn)場離奇詭異,居然都是意外死亡切省,警方通過查閱死者的電腦和手機最岗,發(fā)現(xiàn)死者居然都...
    沈念sama閱讀 90,522評論 3 385
  • 文/潘曉璐 我一進店門,熙熙樓的掌柜王于貴愁眉苦臉地迎上來朝捆,“玉大人般渡,你說我怎么就攤上這事∮冶模” “怎么了诊杆?”我有些...
    開封第一講書人閱讀 157,852評論 0 348
  • 文/不壞的土叔 我叫張陵,是天一觀的道長何陆。 經(jīng)常有香客問我,道長豹储,這世上最難降的妖魔是什么贷盲? 我笑而不...
    開封第一講書人閱讀 56,621評論 1 284
  • 正文 為了忘掉前任,我火速辦了婚禮剥扣,結(jié)果婚禮上巩剖,老公的妹妹穿的比我還像新娘。我一直安慰自己钠怯,他們只是感情好佳魔,可當(dāng)我...
    茶點故事閱讀 65,741評論 6 386
  • 文/花漫 我一把揭開白布。 她就那樣靜靜地躺著晦炊,像睡著了一般鞠鲜。 火紅的嫁衣襯著肌膚如雪宁脊。 梳的紋絲不亂的頭發(fā)上,一...
    開封第一講書人閱讀 49,929評論 1 290
  • 那天贤姆,我揣著相機與錄音榆苞,去河邊找鬼。 笑死霞捡,一個胖子當(dāng)著我的面吹牛坐漏,可吹牛的內(nèi)容都是我干的。 我是一名探鬼主播碧信,決...
    沈念sama閱讀 39,076評論 3 410
  • 文/蒼蘭香墨 我猛地睜開眼赊琳,長吁一口氣:“原來是場噩夢啊……” “哼!你這毒婦竟也來了砰碴?” 一聲冷哼從身側(cè)響起慨畸,我...
    開封第一講書人閱讀 37,803評論 0 268
  • 序言:老撾萬榮一對情侶失蹤,失蹤者是張志新(化名)和其女友劉穎衣式,沒想到半個月后寸士,有當(dāng)?shù)厝嗽跇淞掷锇l(fā)現(xiàn)了一具尸體,經(jīng)...
    沈念sama閱讀 44,265評論 1 303
  • 正文 獨居荒郊野嶺守林人離奇死亡碴卧,尸身上長有42處帶血的膿包…… 初始之章·張勛 以下內(nèi)容為張勛視角 年9月15日...
    茶點故事閱讀 36,582評論 2 327
  • 正文 我和宋清朗相戀三年弱卡,在試婚紗的時候發(fā)現(xiàn)自己被綠了。 大學(xué)時的朋友給我發(fā)了我未婚夫和他白月光在一起吃飯的照片住册。...
    茶點故事閱讀 38,716評論 1 341
  • 序言:一個原本活蹦亂跳的男人離奇死亡婶博,死狀恐怖,靈堂內(nèi)的尸體忽然破棺而出荧飞,到底是詐尸還是另有隱情凡人,我是刑警寧澤,帶...
    沈念sama閱讀 34,395評論 4 333
  • 正文 年R本政府宣布叹阔,位于F島的核電站挠轴,受9級特大地震影響,放射性物質(zhì)發(fā)生泄漏耳幢。R本人自食惡果不足惜岸晦,卻給世界環(huán)境...
    茶點故事閱讀 40,039評論 3 316
  • 文/蒙蒙 一、第九天 我趴在偏房一處隱蔽的房頂上張望睛藻。 院中可真熱鬧启上,春花似錦、人聲如沸店印。這莊子的主人今日做“春日...
    開封第一講書人閱讀 30,798評論 0 21
  • 文/蒼蘭香墨 我抬頭看了看天上的太陽按摘。三九已至包券,卻和暖如春纫谅,著一層夾襖步出監(jiān)牢的瞬間,已是汗流浹背兴使。 一陣腳步聲響...
    開封第一講書人閱讀 32,027評論 1 266
  • 我被黑心中介騙來泰國打工系宜, 沒想到剛下飛機就差點兒被人妖公主榨干…… 1. 我叫王不留,地道東北人发魄。 一個月前我還...
    沈念sama閱讀 46,488評論 2 361
  • 正文 我出身青樓盹牧,卻偏偏與公主長得像,于是被迫代替她去往敵國和親励幼。 傳聞我的和親對象是個殘疾皇子汰寓,可洞房花燭夜當(dāng)晚...
    茶點故事閱讀 43,612評論 2 350

推薦閱讀更多精彩內(nèi)容