Потребителска директива на AngularJS: Шаблони, Обхват и Включване

⚡ Умно обобщение

Персонализираните директиви в AngularJS разширяват HTML с поведение за многократна употреба, което вие дефинирате сами. Фабриката на директиви връща обект за дефиниране и AngularJS прикачва това поведение, където и да се появи съответстващият елемент, атрибут, клас или коментар в маркировката.

  • 🏗️ Регистрация: Методът module.directive приема нормализирано име плюс фабрична функция, която връща обекта за дефиниране на директивата.
  • 🔤 наименуване: Имената са camelCase вътре JavaСкрипт и kebab-case вътре в HTML, така че ngGuru е написано като ng-guru на страницата.
  • 🎯 Съчетаване: Свойството restrict решава дали AngularJS съвпада с елемент, атрибут, клас или коментар и по подразбиране е EA.
  • 🧬 Достъп до обхвата: Директивата споделя родителския обхват по подразбиране, докато опцията за обхват изгражда изолиран обхват с обвързвания @, =, & или <.
  • 🔗 Функция на връзката: Функцията link получава scope, element и attrs и е правилното място за DOM слушатели и почистване.
  • 🧱 Състав: Директивите се влагат една в друга, обгръщат произволно маркиране чрез трансклузия и предоставят API на братя и сестри чрез контролер.
  • ⚠️ Състояние на поддръжката: AngularJS достигна края на жизнения си цикъл на 31 декември 2021 г. и не получава допълнителни корекции или поправки за сигурност.

Персонализирани директиви в AngularJS

Какво е персонализирана директива в AngularJS?

A Персонализирана директива В AngularJS е потребителски дефинирана директива, която разширява HTML с поведение, което сами пишете. Тя е регистрирана на модул използвайки функцията „директива“, а AngularJS я прикачва навсякъде, където съответстващият елемент или атрибут се появява на страницата. Въпреки че AngularJS има много мощни вградени директиви извън кутията, като например ng-повтаряне, понякога са необходими персонализирани директиви.

⚠️ Корекция: В оригинала се казваше, че персонализираната директива „заменя елемента, за който се използва“. По подразбиране тя не: template се вмъква вътре съответстващият елемент. Нужди за подмяна replace: true, остаряло от AngularJS 1.3.

⚠️ Известие за поддръжка: Достигнахме AngularJS край на жизнения цикъл на 31 декември 2021 г. и не получава допълнителни корекции или корекции за сигурност. Всичко по-долу остава вярно за поддържане на съществуващия код на AngularJS 1.x; в съвременния Angular еквивалентите са компоненти и директиви за атрибути.

Причината да се използва персонализирана директива е повторението. Когато една и съща маркировка или DOM окабеляване се появява на няколко екрана, директивата го превръща в един именуван таг.

Как да създадете персонализирана директива?

Нека да разгледаме пример за това как можем да създадем персонализирана директива на AngularJS.

В нашия случай, персонализираната директива просто ще инжектира div таг, който съдържа текста „Angular JS Tutorial“ в нашата страница, когато директивата бъде извикана.

Анотираната екранна снимка по-долу номерира четирите части от списъка, обяснени след нея.

Създайте персонализирана директива

<!DOCTYPE html>
<html>
<head>
    <meta chrset="UTF 8">
    <title>Event Registration</title>
</head>
<body>

<script src="https://code.angularjs.org/1.6.9/angular-route.js"></script>
<script src="https://code.angularjs.org/1.6.9/angular.js"></script>
<script src="https://code.angularjs.org/1.6.9/angular.min.js"></script>
<script src="https://code.jquery.com/jquery-3.3.1.min.js"></script>

<h1> Guru99 Global Event</h1>

<div ng-app="DemoApp">
    <div ng-guru=""></div>

</div>

<script type="text/javascript">
    var app = angular.module('DemoApp',[]);
    app.directive('ngGuru',function(){

    return {
        template: '<div>Angular JS Tutorial</div>'
    }
    });

</script>

</body>
</html>

⚠️ Внимание — в тази обява са запазени дефекти: Кодът е възпроизведен точно както е публикуван. Три недостатъка се появяват във всеки списък тук: chrset="UTF 8" трябва да бъде charset="UTF-8"; angular.js намлява angular.min.js и двете се зареждат, така че AngularJS се зарежда два пъти; и angular-route.js зарежда се преди файла, от който зависи.

Code Обяснение

  1. Първо създаваме a модул за нашето AngularJS приложение. Това е необходимо за създаване на персонализирана директива, защото тя ще бъде създадена с помощта на този модул.
  2. Сега създаваме персонализирана директива, наречена „ngGuru„и дефиниране на фабрична функция, която ще съдържа персонализирания код за нашата директива.“
  3. Използваме параметъра template, който е параметър, дефиниран от AngularJS за персонализирани директиви. В този случай дефинираме, че когато се използва тази директива, просто се използва стойността на шаблона и се инжектира в извикващия код.
  4. Тук сега използваме нашата персонализирана директива „ng-guru“. Когато правим това, стойността, която сме дефинирали за нашия шаблон, <div>Angular JS Tutorial</div>, сега ще бъде инжектиран тук.

Именуване и нормализиране на директиви

Несъответствието в имената между JavaСкриптът и HTML объркват повечето начинаещи. AngularJS нормализира всеки елемент и име на атрибут, преди да го съпостави: това премахва всички x- or data- префикс, след което преобразува име, разделено от -, : or _ в camelCase. Ето защо ngGuru кибрит ng-guru, и защо data-ng-guru работи също. Формата camelCase е истинското име; kebab-case е просто начинът, по който е написано в HTML.

⚠️ Корекция: В оригиналния текст се казваше, че името на персонализираната директива „трябва да започва с буквите „ng““. официална документация на AngularJS съветва обратното: никога не поставяйте пред собствените си директиви пред ngили може да се сблъскат с бъдещ вграден елемент. Използвайте свой собствен префикс, например g99Guru написано като g99-guru.

Ако кодът се изпълни успешно, се появява този изход.

Изход:

Създайте персонализирана директива

Резултатът ясно показва, че нашата персонализирана директива ng-guru, в която е дефиниран шаблон за показване на персонализиран текст, се показва в браузъра. Следващата стъпка е да поставим нещо, което си струва да се използва повторно, в този шаблон.

Как да създаваме директиви за многократна употреба

Вече видяхме силата на персонализираните директиви, но можем да изведем това на следващото ниво, като изградим наши собствени повторно използваеми директиви.

Да кажем например, че искаме да инжектираме код, който винаги да показва посочените по-долу HTML тагове на множество екрани, което е просто въвеждане на „Име“ и „Възраст“ на потребителя.

Създавайте директиви за многократна употреба

За да използваме повторно този фрагмент на множество екрани, без да го кодираме всеки път, създаваме главен контрол или директива в AngularJS, която да съдържа тези два контрола.

Така че сега, вместо да повтаряме тази маркировка на всеки екран, я вграждаме в директива и вместо това извикваме директивата. Снимката на екрана по-долу маркира единствения ред, който се променя.

Създавайте директиви за многократна употреба

<!DOCTYPE html>
<html>
<head>
    <meta chrset="UTF 8">
    <title>Event Registration</title>
</head>
<body>

<script src="https://code.angularjs.org/1.6.9/angular-route.js"></script>
<script src="https://code.angularjs.org/1.6.9/angular.js"></script>
<script src="https://code.angularjs.org/1.6.9/angular.min.js"></script>
<script src="https://code.jquery.com/jquery-3.3.1.min.js"></script>

<h1> Guru99 Global Event</h1>

<div ng-app="DemoApp">
    <div ng-guru=""></div>

</div>

<script type="text/javascript">

    var app = angular.module('DemoApp',[]);

    app.directive('ngGuru',function(){
        return {

            template: '&nbsp;&nbsp;Name <input type="text"><br><br>&nbsp;&nbsp;&nbsp;Age<input type="text">'
        };
    });

</script>

</body>
</html>

Code Обяснение

  • В нашия фрагмент от код за персонализирана директива, това, което се променя, е само стойността, която се дава на параметъра на шаблона. Вместо обикновен таг или ред текст, въвеждаме целия фрагмент от два контрола за въвеждане за „Име“ и „Възраст“, ​​който трябва да се покаже на нашата страница.

💡 Съвет: Шаблон с такава дължина трябва да бъде в отделен файл. Размяна template за templateUrl: 'name-age.html'.

Ако кодът се изпълни успешно, се появява този изход.

Изход:

Създавайте директиви за многократна употреба

От горния резултат виждаме, че фрагментът от кода от шаблона на персонализираната директива се добавя към страницата. Шаблонът все още е статичен, така че следващата стъпка е да му подадем данни.

Директиви и области на действие на AngularJS

- обхват се дефинира като лепилото, което свързва контролера с изгледа, като управлява данните между изгледа и контролера.

Когато създавате персонализирани AngularJS директиви, те по подразбиране ще имат достъп до обекта scope в родителския контролер. Това е същият обект scope, а не негово копие.

По този начин става лесно за персонализираната директива да използва данните, които се предават на главния контролер.

Нека разгледаме пример за това как можем да използваме обхвата на родителски контролер в нашата персонализирана директива. Снимката на екрана по-долу изброява четирите стъпки.

Директиви и области на действие на AngularJS

<!DOCTYPE html>
<html>
<head>
    <meta chrset="UTF 8">
    <title>Event Registration</title>
</head>
<body>

<script src="https://code.angularjs.org/1.6.9/angular-route.js"></script>
<script src="https://code.angularjs.org/1.6.9/angular.js"></script>
<script src="https://code.angularjs.org/1.6.9/angular.min.js"></script>
<script src="https://code.jquery.com/jquery-3.3.1.min.js"></script>

<h1> Guru99 Global Event</h1>

<div ng-app="DemoApp" ng-controller="DemoController">
    <div ng-guru=""></div>

</div>

<script type="text/javascript">

    var app = angular.module('DemoApp',[]);

    app.controller('DemoController',function($scope) {
        $scope.tutorialName = "Angular JS";

    });

        app.directive('ngGuru',function(){
        return {
         template: '<div>{{tutorialName}}</div>'
     }
    });

</script>

</body>
</html>

Code Обяснение

  1. Първо създаваме контролер, наречен „DemoController“. В него дефинираме променлива, наречена tutorialName, и я прикачваме към обекта scope с едно изречение: $scope.tutorialName = "Angular JS".
  2. В нашата персонализирана директива можем да извикаме променливата „tutorialName“ с помощта на израз. Тази променлива ще бъде достъпна, защото е дефинирана в контролера „DemoController“, който ще стане родител за тази директива.
  3. Ние препращаме към контролера в div таг, който ще действа като родителски div таг. Имайте предвид, че това трябва да се направи първо, за да може нашата персонализирана директива да има достъп до променливата tutorialName.
  4. Накрая просто прикачваме нашата персонализирана директива „ng-guru“ към нашия div таг.

Ако кодът се изпълни успешно, се появява този изход.

Изход:

Директиви и области на действие на AngularJS

Горният резултат ясно показва, че нашата персонализирана директива „ng-guru“ използва променливата за обхват tutorialName в родителския контролер. Споделянето на родителския обхват е удобно, но не винаги е това, което искате.

Използване на контролери с директиви

AngularJS дава възможност за достъп до членската променлива на контролера директно от персонализирани директиви без необходимост от обекта на обхвата.

Това понякога става необходимо, защото едно приложение може да има множество обекти на обхват, принадлежащи на множество контролери, така че има голяма вероятност по погрешка да се осъществи достъп до обекта на обхват на грешен контролер.

В такъв сценарий има начин да се каже конкретно „Искам да осъществя достъп до този контролер“ от моята директива.

Нека да разгледаме пример как можем да постигнем това. Екранната снимка номерира четирите стъпки.

Използване на контролери с директиви

<!DOCTYPE html>
<html>
<head>
    <meta chrset="UTF 8">
    <title>Event Registration</title>
</head>
<body>

<script src="https://code.angularjs.org/1.6.9/angular-route.js"></script>
<script src="https://code.angularjs.org/1.6.9/angular.js"></script>
<script src="https://code.angularjs.org/1.6.9/angular.min.js"></script>
<script src="https://code.jquery.com/jquery-3.3.1.min.js"></script>

<h1> Guru99 Global Event</h1>

<div ng-app="DemoApp" ng-controller="DemoController">
    <div ng-guru99=""></div>

</div>

<script type="text/javascript">

    var app = angular.module('DemoApp',[]);

    app.controller('DemoController',function() {
        this.tutorialName = "Angular";

    });

     app.directive('ngGuru99',function(){
        return {
         controller: 'DemoController',

          controllerAs: 'ctrl',

          template: '{{ctrl.tutorialName}}'
     };
    });

</script>

</body>
</html>

Code Обяснение

  1. Първо създаваме контролер, наречен „DemoController“. В него ще дефинираме променлива, наречена „tutorialName“, и този път, вместо да я прикачваме към обекта scope, ще я прикачим директно към контролера.
  2. В нашата персонализирана директива ние специално споменаваме, че искаме да използваме контролера „DemoController“, като използваме ключовата дума за параметър на контролера.
  3. Създаваме препратка към контролера, използвайки параметъра „controllerAs“. Това е дефинирано от AngularJS и е начинът за препращане към контролера чрез псевдоним.
  4. Накрая, в нашия шаблон използваме препратката, създадена в стъпка 3, и използваме променливата член, която беше прикачена директно към контролера в стъпка 1.

Забележка: Възможно е да се осъществи достъп до множество контролери в една директива чрез задаване на съответните блокове на контролера, controllerAs и шаблонните оператори. За да се достигне до родител контролера на директивата, използвайте вместо това require.

Ако кодът се изпълни успешно, се появява този изход.

Изход:

Използване на контролери с директиви

Резултатът ясно показва, че персонализираната директива осъществява достъп до DemoController и прикачената към него променлива член tutorialName, и показва текста „Angular“. И двата подхода все още четат от споделена област, което изолираната област предотвратява.

Как се различават обвързванията @, =, & и < в изолиран обхват

Директива, която споделя родителския си обхват, може да се използва само веднъж на контролер, защото две копия биха се борили за едни и същи променливи. scope обект създава изолиране на обхватаДирективата не вижда нищо отвън освен изброените от вас свойства. Всеки запис използва префикс, деклариращ как се предава стойността му.

символ Посока Получена стойност Използвайте го за
@ Еднопосочен вход Атрибутът като интерполиран низ Етикети, заглавия, всякакъв обикновен текст
= Двупосочен Самият жив обект или стойност Модели, към които директивата записва обратно
& Външно обаждане Функция, оценяваща израз във външната област на видимост Обратни извиквания, като например при затваряне или при запазване
< Еднопосочен вход Оценената стойност, никога не записвана нагоре Данни само за четене, добавени в AngularJS 1.5

💡 Съвет: Посягам към < преди =Еднопосочното обвързване е по-евтино за наблюдение и спира компонента да променя тихо данните на извикващия го компонент. В следващия раздел се използва @.

Директиви и компоненти на AngularJS: ng-transclude

Както споменахме по-рано, AngularJS е предназначен да разшири функционалността на HTML. И вече видяхме как можем да имаме инжектиране на код чрез използване на персонализирани повторно използваеми директиви.

Но в съвременното разработване на уеб приложения съществува и концепцията за разработванеping уеб компоненти, което основно означава създаване на собствени HTML тагове, които могат да се използват като компоненти в нашия код.

Следователно AngularJS предоставя друго ниво на мощност за разширяване на HTML тагове, като дава възможност за обгръщане на всяка маркировка, която извикващата функция поставя вътре в тага.

Това се прави от „ng-включване„директива“, която казва на AngularJS да заснеме всичко, което е поставено в персонализирания таг в маркировката, и да го пусне в шаблона на това място.

Нека вземем пример как можем да постигнем това. Снимката на екрана изброява следващите пет точки.

AngularJS директиви и компоненти

<!DOCTYPE html>
<html>
<head>
    <meta chrset="UTF 8">
    <title>Event Registration</title>
</head>
<body>

<script src="https://code.angularjs.org/1.6.9/angular-route.js"></script>
<script src="https://code.angularjs.org/1.6.9/angular.js"></script>
<script src="https://code.angularjs.org/1.6.9/angular.min.js"></script>
<script src="https://code.jquery.com/jquery-3.3.1.min.js"></script>

<h1> Guru99 Global Event</h1>

<div ng-app="DemoApp">
    <pane title="{{title}}">Angular JS</pane>

</div>

<script type="text/javascript">

    var app = angular.module('DemoApp',[]);

    app.directive('pane',function(){
        return {

            transclude:true,
            scope :{title:'@'},
            template: '<div style="border: 1px solid black;"> '+
                        '<ng-transclude></ng-transclude>'+
                            '</div>'
        };
    });

</script>

</body>
</html>

Code Обяснение

  1. Използваме директивата, за да дефинираме персонализиран HTML таг, наречен „pane“, с фабрична функция, предоставяща неговия код. В резултата тагът pane показва текста „Angular JS“ в правоъгълник с плътна черна рамка.
  2. Свойството „transclude“ трябва да бъде зададено на true, което е това, което казва на AngularJS да запази оригиналната вътрешна маркировка и да я направи достъпна за ng-transclude.
  3. В обекта scope декларираме обвързване на заглавие. Атрибутите обикновено се записват като двойки име/стойност, например name="value"В нашия случай атрибутът на тага на панела е „title“ (заглавие), а символът „@“ изисква от AngularJS да копира този атрибут като интерполиран низ.
  4. Шаблонът рисува плътна черна рамка за нашия контрол и маркира мястото, където е вмъкната транскрибираната маркировка.
  5. Накрая извикваме нашия персонализиран HTML таг заедно с дефинирания атрибут title.

⚠️ Корекция: Оригиналният текст описваше „@“ като „изискването от Angular“. Това не е формалност: @ е един от четирите символа за свързване в isolate-scope в таблицата по-горе и винаги дава низ. Този шаблон също никога не се рендира {{title}}и никой контролер не дефинира title, така че се вижда само транскрибираният текст.

Ако кодът се изпълни успешно, се появява този изход.

Изход:

AngularJS директиви и компоненти

  • Резултатът показва персонализирания панел, рендиран като оградено поле, съдържащо включения текст „Angular JS“.

Директивата може да съдържа и други директиви, които определят как се сглобяват по-големи компоненти.

Вложени директиви

Директивите в AngularJS могат да бъдат вложени. Подобно на вътрешните модули или функции във всеки програмен език, може да се наложи да вградите директиви една в друга.

Можете да разберете по-добре това, като видите примера по-долу.

В този пример създаваме 2 директиви, наречени „външен“ и „вътрешен“.

  • Вътрешната директива показва текст, наречен „Inner“.
  • Докато външната директива всъщност прави повикване към вътрешната директива, за да покаже текста, наречен „Inner“.

Снимката на екрана по-долу маркира и двете дефиниции на директиви и точката, където едната извиква другата.

Вложени директиви

</head>
<body>

<script src="https://code.angularjs.org/1.6.9/angular-route.js"></script>
<script src="https://code.angularjs.org/1.6.9/angular.js"></script>
<script src="https://code.angularjs.org/1.6.9/angular.min.js"></script>
<script src="https://code.jquery.com/jquery-3.3.1.min.js"></script>

<h1> Guru99 Global Event</h1>

<div ng-app="DemoApp">
    <outer></outer>
</div>

<script type="text/javascript">

    var app = angular.module('DemoApp',[]);

    app.directive('outer',function(){
        return {

            restrict:'E',
            template: '<div><h1>Outer</h1><inner></inner></div>',
        }});

    app.directive('inner',function(){
        return {

            restrict:'E',
            template: '<div><h1>Inner</h1></div>',
        }
    });
</script>

</body>
</html>

⚠️ Внимание — дефектът е запазен в тази обява: Публикуваният списък започва от </head>, пропускайки откриването му <!DOCTYPE html>, <html> намлява <head> редове. Добавете ги преди да го стартирате.

Code Обяснение

  1. Създаваме директива, наречена „външна“, която ще се държи като нашата родителска директива. След това тази директива ще извика „вътрешната“ директива.
  2. - restrict:'E' опцията казва на AngularJS да съпостави всяка директива с елемент име, поради което могат да бъдат записани като тагове <outer> намлява <inner>Буквата „Е“ е кратката форма на думата „Елемент“.
  3. Тук създаваме вътрешната директива, която показва текста „Inner“ в div таг.
  4. В шаблона за външната директива извикваме вътрешната директива. Така че тук инжектираме шаблона от вътрешната директива във външната директива.
  5. И накрая, ние директно извикваме външната директива.

⚠️ Корекция: Оригиналният текст, за който се твърди restrict:'E' е необходимо „да се гарантира, че данните от вътрешната директива са достъпни за външната директива“. Не прави нищо подобно; само контролира как може да се напише директива. Влагането работи, защото компилаторът продължава да влиза в шаблона, който току-що е вмъкнал. За споделяне на данни използвайте require намлява controller.

Ако кодът се изпълни успешно, се появява този изход.

Изход:

Вложени директиви

От изхода,

  • Вижда се, че и външната, и вътрешната директиви са извикани и текстът и в двата div тага е показан.

Рендирането на маркирането е само половината от това, което прави една директива; другата половина е реагиране на потребителя.

Обработка на събития в директива

Събития като кликвания с мишката или кликвания с бутони, могат да се обработват от самите директиви. Това се прави с помощта на функцията link. Функцията link позволява на директивата да се прикрепи към DOM елементите в HTML страница.

Синтаксис:

Синтаксисът на функцията за свързване е показан по-долу.

link: function ($scope, element, attrs)

Функцията за свързване обикновено приема 3 параметъра: обхвата, елемента, с който е свързана директивата, и атрибутите на целевия елемент. Други два, задължителен контролер и функция за трансклюдиране, се получават при прилагането им.

Фаза на компилиране срещу фаза на свързване

AngularJS обработва директива на два прохода и познаването на коя е коя ви показва къде принадлежи вашият код.

  • Компилирам изпълнява се веднъж върху елемента на шаблона, преди да съществува каквато и да е област на видимост. Подходящ е за структурни редакции, споделени от всеки клонинг.
  • връзка изпълнява се веднъж на екземпляр, след като шаблонът е клониран и е прикачена област на видимост. DOM слушателите и четенията на област на видимост принадлежат тук.

Тъй като компилирането няма обхват, всичко, което се нуждае от данни, принадлежи към link, поради което примерът по-долу дефинира link сам.

Нека разгледаме пример как можем да постигнем това. Екранната снимка номерира четирите точки по-долу.

Обработка на събития в директива

<!DOCTYPE html>
<html>
<head>
    <meta chrset="UTF 8">
    <title>Event Registration</title>
</head>
<body>

<script src="https://code.angularjs.org/1.6.9/angular-route.js"></script>
<script src="https://code.angularjs.org/1.6.9/angular.js"></script>
<script src="https://code.angularjs.org/1.6.9/angular.min.js"></script>
<script src="https://code.jquery.com/jquery-3.3.1.min.js"></script>

<h1> Guru99 Global Event</h1>

<div ng-app="DemoApp">
    <div ng-guru="">Click Me</div>
</div>

<script type="text/javascript">

    var app = angular.module('DemoApp',[]);

    app.directive('ngGuru',function(){
        return {

            link:function($scope,element,attrs) {
                element.bind('click',function () {
                    element.html('You clicked me');
                });}
        }});
</script>

</body>
</html>

Code Обяснение

  1. Използваме функцията link, както е дефинирана в AngularJS, за да дадем на директивата възможност за достъп до събития в HTML DOM.
  2. Използваме ключовата дума „element“, защото искаме да реагираме на събитие за HTML DOM елемент, който в нашия случай е елементът „div“. След това използваме функцията „bind“, за да добавим персонализирана функционалност към събитието click на елемента. Думата „click“ е ключовата дума, използвана за обозначаване на събитието click на всеки HTML контрол.
  3. Тук казваме, че искаме да заместим вътрешния HTML код на елемента, в нашия случай елемента div, с текста „Кликнахте върху мен“.
  4. Тук дефинираме нашия таг div да използва персонализираната директива ng-guru.

💡 Съвет: Директивата трябва да се „почисти“ след себе си. Премахнете всеки слушател, който надживява елемента вътре. element.on('$destroy', ...)или страницата губи памет.

Ако кодът се изпълни успешно, се появява този изход.

Изход:

Обработка на събития в директива

  • Първоначално на потребителя се показва текстът „Click Me“, защото това е дефинирано в тага div. Когато щракнете върху тага div, вместо това се показва резултатът по-долу.

Обработка на събития в директива

Всеки пример по-горе използва едно или две свойства на един и същ обект на дефиниция. Струва си да се запази пълният набор.ping под ръка.

Справка за свойствата на обекта, определени от директива

Обектът, върнат от фабрика на директиви, е Директива Определение ОбектВсяко свойство отговаря на един въпрос за това как се държи директивата.

Имот По подразбиране Какво го прави
ограничи „ЕА“ Кои форми съответстват: E елемент, A атрибут, C клас, M коментар
шаблон нито един Вградена маркировка, вмъкната в съответстващия елемент
URL адрес на шаблона нито един Път към файла на шаблона, извлечен веднъж и кеширан
обхват фалшив false споделя родителския обхват, true създава дете, а обектът се изолира.
регулатор нито един Конструктор, който предоставя API, може да изисква други директиви
контролерAs нито един Псевдоним за контролера в шаблона
изисква нито един Контролерът на друга директива за инжектиране; ^ търси родители, ^^ пропуска себе си, ? по избор
връзка нито един Функция за всеки екземпляр: обхват, елемент, атрибути, контролер, transcludeFn
компилирам нито един Изпълнява се веднъж върху шаблона, преди да съществува какъвто и да е обхват
включва фалшив Запазва оригиналната вътрешна маркировка за ng-transclude
приоритет 0 Ред на компилиране на споделен елемент; по-високият елемент се изпълнява първи
терминал фалшив Спира директиви с по-нисък приоритет върху този елемент
замени фалшив Заменя елемента с шаблона. Остаряло от версия 1.3.

💡 Съвет: Започнете с restrict, template намлява link, Добави scope за повторна употреба, controller намлява require за повиквания от директива към директива и оставете priority намлява terminal сам.

Въпроси и Отговори

Компонентът, добавен в AngularJS 1.5, е директива с определени настройки по подразбиране: съвпадение само на елементи, изолиран обхват и контролер. Използвайте компонент за самостоятелен изглед и директива, когато имате нужда от DOM достъп на ниво връзка.

Обикновено името не е било нормализирано правилно или restrict изключва формата, която сте използвали. Директива, регистрирана като myBox съвпада с my-box, а не с mybox, а тагът на елемента трябва да бъде ограничен, за да включва E.

Да. AI Асистентите картографират изолиран обхват върху входни и изходни декоратори и шаблон върху шаблон на компонент. RevПрегледайте DOM кода за трансклузия и линк-функция на ръка, тъй като те рядко се превеждат чисто.

Асистентите с изкуствен интелект генерират единица тест скелети, които компилират директивата, прикачват обхват и правят твърдения (assertions) върху рендирания изход. Те са добри в изброяването на крайни случаи, така че третирайте генерираните твърдения като начална чернова.

Използвайте templateUrl, след като маркировката надхвърли един или два реда. Файлът може да се редактира с нормални HTML инструменти и се извлича само веднъж, след което се предоставя от кеша на шаблона за всеки следващ случай.

Обобщете тази публикация с: