Տեմային շրջաններ ավելացնելը

Տեմայում շրջաններ ավելացնելու համար անհրաժեշտ է.

• Շրջանների մետատվյալներ ավելացնել THEMENAME.info.yml ֆայլում։
• Խմբագրել page.html.twig ֆայլը և տպել նոր շրջանները։

Նշում. Եթե ձեր թեմայում հայտարարեք որևէ շրջան, նույնիսկ միայն մեկ, բոլոր նախնական շրջանները այլևս կիրառելի չեն, և դուք պետք է պատասխանատվություն ստանձնեք այն բոլոր շրջանների հայտարարության համար, որոնք ցանկանում եք օգտագործել։

Այն բլոկները, որոնք նախկինում գտնվում էին շրջաններում, որոնք այլևս գոյություն չունեն (քանի որ դուք դրանք չեք սահմանել), հիմա անջատված կլինեն։ Հատկապես, եթե խմբագրեք THEMENAME.info.yml և կատարեք cache-ը վերականգնում drush cr-ով, կտեսնեք նման հաղորդագրություն յուրաքանչյուրի համար՝

themename_breadcrumbs բլոկը նշանակվել է սխալ breadcrumb շրջանին և անջատվել է։

Եթե մտնեք /admin/structure/block, բոլոր անջատված բլոկները ցուցադրվում են վերին հատվածում «անջատված» նշումով։ Կարող եք դրանք քաշել կամ օգտագործել «Շրջան» բացվող ցանկը՝ դրանք նորից նշանակելու կամ ջնջելու այն բլոկները, որոնք ձեզ այլևս պետք չեն։

Հաստատեք, որ պահպանել եք page_top և page_bottom շրջանները։ Դրանք «թաքնված» տարածքներ են, որոնք օգտագործվում են էջի վերին և ստորին մասերում, օրինակ՝ վերլուծության կամ ադմինիստրատորի գործիքագոտու համար։ Դրանց կարիք չկա նշել THEMENAME.info.yml ֆայլում, պարզապես մի՛ ջնջեք դրանք html.html.twig շաբլոնից։ Մոդուլները կարող են հույս ունենալ դրանց առկայության վրա։

Շրջաններ ավելացնելը ձեր ինֆորմացիոն ֆայլում

Սկսեք հայտարարելով ձեր նոր շրջանները THEMENAME.info.yml ֆայլում։ Շրջանները հայտարարվում են regions բանալիի տակ հետևյալ կերպ՝

regions:
  header: 'Վերնագիր'
  content: 'Բովանդակություն'
  footer: 'Ներքև' 

Շրջանի բանալին պետք է լինի ա-ռ տառերով և թվերով, կարող է պարունակել ստորակետ (_): Բանալին պետք է սկսվի տառով։ Բանալին համակարգչային անունն է (օգտագործվում է կոդում), իսկ արժեքը՝ ընթերցողին հասկանալի անվանումը, որը ցուցադրվում է ադմինիստրատորի միջավայրում։

Շրջաններ ավելացնելը ձեր շաբլոններում

Որպեսզի շրջանները ցուցադրեն նրանց մեջ տեղադրված բովանդակությունը, դուք պետք է համոզվեք, որ ձեր նոր շրջանները նույնպես ավելացվել են ձեր page.html.twig ֆայլում։ Շրջանները ներկայացվում են Twig փոփոխականների տեսքով, որոնց անունները համընկնում են THEMENAME.info.yml ֆայլում օգտագործվող բանալիի հետ՝ «page.» նախածանցով։

Օրինակ՝

header: 'Վերնագիր'

դառնալու է՝

{{ page.header }}

Նրանք գործում են ինչպես ցանկացած այլ Twig փոփոխական և կարող են շրջապատվել ցանկացած մարկապով, որը համապատասխան է ձեր օգտագործման դեպքին։

(Թաքնված շրջանների հիմնական սինթաքսը տարբեր է, տես ստորև)

Նախնական շրջաններ

Տես page.html.twig API-ն նախնական շրջանների ցանկը։

• page.header
• page.primary_menu
• page.secondary_menu
• page.highlighted
• page.help (դինամիկ օգնության տեքստ, հիմնականում ադմինիստրատորի էջերի համար)
• page.content (այժմյան էջի հիմնական բովանդակությունը)
• page.sidebar_first
• page.sidebar_second
• page.footer
• page.breadcrumb

Եթե ձեր թեման չի հայտարարում շրջաններ, Drupal-ը կօգտագործի այս նախնական սետը։

Այս շրջանները համընկնում են core/modules/system/templates/page.html.twig ֆայլի ստանդարտ տեղադրման հետ, ինչպես նաև երկու թաքնված շրջանների՝ page_top և page_bottom հետ։ Այս վերջին երկուսը հայտարարելու կարիք չկա, եթե դուք վերագրվում եք ստանդարտ արժեքները, սակայն Twig փոփոխականները {{ page_top }} և {{ page_bottom }} պետք է պահպանվեն html.html.twig շաբլոնում։