Angular 2
Директивы
Поиск…
Синтаксис
<input [value]="value">
- Персональное значение атрибут член классаname
.<div [attr.data-note]="note">
- Персональный атрибутdata-note
к переменнойnote
.<p green></p>
- Пользовательская директива
замечания
Основным источником информации о директивах Angular 2 является официальная документация https://angular.io/docs/ts/latest/guide/attribute-directives.html
Директива атрибута
<div [class.active]="isActive"></div>
<span [style.color]="'red'"></span>
<p [attr.data-note]="'This is value for data-note attribute'">A lot of text here</p>
Компонент - это директива с шаблоном
import { Component } from '@angular/core';
@Component({
selector: 'my-app',
template: `
<h1>Angular 2 App</h1>
<p>Component is directive with template</p>
`
})
export class AppComponent {
}
Структурные директивы
<div *ngFor="let item of items">{{ item.description }}</div>
<span *ngIf="isVisible"></span>
Пользовательская директива
import {Directive, ElementRef, Renderer} from '@angular/core';
@Directive({
selector: '[green]',
})
class GreenDirective {
constructor(private _elementRef: ElementRef,
private _renderer: Renderer) {
_renderer.setElementStyle(_elementRef.nativeElement, 'color', 'green');
}
}
Использование:
<p green>A lot of green text here</p>
* ngFor
form1.component.ts:
import { Component } from '@angular/core';
// Defines example component and associated template
@Component({
selector: 'example',
template: `
<div *ngFor="let f of fruit"> {{f}} </div>
<select required>
<option *ngFor="let f of fruit" [value]="f"> {{f}} </option>
</select>
`
})
// Create a class for all functions, objects, and variables
export class ExampleComponent {
// Array of fruit to be iterated by *ngFor
fruit = ['Apples', 'Oranges', 'Bananas', 'Limes', 'Lemons'];
}
Выход:
<div>Apples</div>
<div>Oranges</div>
<div>Bananas</div>
<div>Limes</div>
<div>Lemons</div>
<select required>
<option value="Apples">Apples</option>
<option value="Oranges">Oranges</option>
<option value="Bananas">Bananas</option>
<option value="Limes">Limes</option>
<option value="Lemons">Lemons</option>
</select>
В самой простой форме *ngFor
имеет две части: let variableName of object/array
В случае fruit = ['Apples', 'Oranges', 'Bananas', 'Limes', 'Lemons'];
,
Яблоки, апельсины и так далее являются значением внутри массива fruit
.
[value]="f"
будет равно каждый текущим fruit
( f
) , что *ngFor
имеет итерацию.
В отличие от AngularJS, Angular2 не продолжался с использованием ng-options
для <select>
и ng-repeat
для всех других общих повторений.
*ngFor
очень похож на ng-repeat
со слегка измененным синтаксисом.
Рекомендации:
Angular2 | Отображение данных
Angular2 | ngFor
Angular2 | формы
Скопировать в буфер обмена
В этом примере мы собираемся создать директиву для копирования текста в буфер обмена, нажав на элемент
Тетради text.directive.ts
import { Directive, Input, HostListener } from "@angular/core"; @Directive({ selector: '[text-copy]' }) export class TextCopyDirective { // Parse attribute value into a 'text' variable @Input('text-copy') text:string; constructor() { } // The HostListener will listen to click events and run the below function, the HostListener supports other standard events such as mouseenter, mouseleave etc. @HostListener('click') copyText() { // We need to create a dummy textarea with the text to be copied in the DOM var textArea = document.createElement("textarea"); // Hide the textarea from actually showing textArea.style.position = 'fixed'; textArea.style.top = '-999px'; textArea.style.left = '-999px'; textArea.style.width = '2em'; textArea.style.height = '2em'; textArea.style.padding = '0'; textArea.style.border = 'none'; textArea.style.outline = 'none'; textArea.style.boxShadow = 'none'; textArea.style.background = 'transparent'; // Set the texarea's content to our value defined in our [text-copy] attribute textArea.value = this.text; document.body.appendChild(textArea); // This will select the textarea textArea.select(); try { // Most modern browsers support execCommand('copy'|'cut'|'paste'), if it doesn't it should throw an error var successful = document.execCommand('copy'); var msg = successful ? 'successful' : 'unsuccessful'; // Let the user know the text has been copied, e.g toast, alert etc. console.log(msg); } catch (err) { // Tell the user copying is not supported and give alternative, e.g alert window with the text to copy console.log('unable to copy'); } // Finally we remove the textarea from the DOM document.body.removeChild(textArea); } } export const TEXT_COPY_DIRECTIVES = [TextCopyDirective];
некоторые-page.component.html
Не забудьте ввести TEXT_COPY_DIRECTIVES в массив директив вашего компонента
... <!-- Insert variable as the attribute's value, let textToBeCopied = 'http://facebook.com/' --> <button [text-copy]="textToBeCopied">Copy URL</button> <button [text-copy]="'https://www.google.com/'">Copy URL</button> ...
Тестирование пользовательской директивы
Учитывая директиву, которая выделяет текст на событиях мыши
import { Directive, ElementRef, HostListener, Input } from '@angular/core';
@Directive({ selector: '[appHighlight]' })
export class HighlightDirective {
@Input('appHighlight') // tslint:disable-line no-input-rename
highlightColor: string;
constructor(private el: ElementRef) { }
@HostListener('mouseenter')
onMouseEnter() {
this.highlight(this.highlightColor || 'red');
}
@HostListener('mouseleave')
onMouseLeave() {
this.highlight(null);
}
private highlight(color: string) {
this.el.nativeElement.style.backgroundColor = color;
}
}
Его можно протестировать следующим образом
import { ComponentFixture, ComponentFixtureAutoDetect, TestBed } from '@angular/core/testing';
import { Component } from '@angular/core';
import { HighlightDirective } from './highlight.directive';
@Component({
selector: 'app-test-container',
template: `
<div>
<span id="red" appHighlight>red text</span>
<span id="green" [appHighlight]="'green'">green text</span>
<span id="no">no color</span>
</div>
`
})
class ContainerComponent { }
const mouseEvents = {
get enter() {
const mouseenter = document.createEvent('MouseEvent');
mouseenter.initEvent('mouseenter', true, true);
return mouseenter;
},
get leave() {
const mouseleave = document.createEvent('MouseEvent');
mouseleave.initEvent('mouseleave', true, true);
return mouseleave;
},
};
describe('HighlightDirective', () => {
let fixture: ComponentFixture<ContainerComponent>;
let container: ContainerComponent;
let element: HTMLElement;
beforeEach(() => {
TestBed.configureTestingModule({
declarations: [ContainerComponent, HighlightDirective],
providers: [
{ provide: ComponentFixtureAutoDetect, useValue: true },
],
});
fixture = TestBed.createComponent(ContainerComponent);
// fixture.detectChanges(); // without the provider
container = fixture.componentInstance;
element = fixture.nativeElement;
});
it('should set background-color to empty when mouse leaves with directive without arguments', () => {
const targetElement = <HTMLSpanElement>element.querySelector('#red');
targetElement.dispatchEvent(mouseEvents.leave);
expect(targetElement.style.backgroundColor).toEqual('');
});
it('should set background-color to empty when mouse leaves with directive with arguments', () => {
const targetElement = <HTMLSpanElement>element.querySelector('#green');
targetElement.dispatchEvent(mouseEvents.leave);
expect(targetElement.style.backgroundColor).toEqual('');
});
it('should set background-color red with no args passed', () => {
const targetElement = <HTMLSpanElement>element.querySelector('#red');
targetElement.dispatchEvent(mouseEvents.enter);
expect(targetElement.style.backgroundColor).toEqual('red');
});
it('should set background-color green when passing green parameter', () => {
const targetElement = <HTMLSpanElement>element.querySelector('#green');
targetElement.dispatchEvent(mouseEvents.enter);
expect(targetElement.style.backgroundColor).toEqual('green');
});
});