Using Angular’s ng-content in conjunction with ngProjectAs attribute
Introduction
I recently ran into some troubles when trying to project content across several component scopes. It took me quite a bit of searching until I found a way to make my solution work. Turns out content projection in Angular is a pretty complex and not-that-well documented topic. I came across and highly recommend reading Eudes Petonnet’s ng-content: the hidden docs — it provides a great and concise explanation on how Angular’s ng-content works in different scenarios.
All in all, documentation on the topic of content projection in Angular seems a bit lacking, so I thought I’d try my hand at providing a comprehensive example on how to use it and what pitfalls you might encounter.
Setup
So here’s the basic example I’ve been tweaking: I want to create a simple questionnaire component that can render both single and multiple choice questions. The component is data bound to a feed of questions. The questions, depending on their type, are then rendered either as a single or multi select component. You can find the working example here.
I’ve also created a q-validator component, used to display an error message in a question (both q-single and q-multi ). The validator is rendered inside of the question component’s host and will display an error if the question is not valid (in the example — if the value is null ).
Using
Inside of the questionnaire template, I’ve defined 3 sections (list back-to-front for dramatic effect):
- Footer — Contains the survey submit button
- Body — Contains all of the questions rendered in resp. components ( q-single or q-multi )
- Header — Contains any content that is passed inside of the q-questionnaire tags
The header part of the survey is an example of the most basic use of ng-content — projecting everything that is inside of the element’s selector into the element’s host.
In the demo, I’m just passing some text inside of a h6 tag in the container, but for a more complex ‘greeting’, you can pass anything you like — standard tags, other components, template outlets.
Using
If you need to further structure the content that is passed, you can use ng-content `’s select attribute. This selects all elements passed in the content that match the criteria of the select argument.
In the example, I’ll change the structure of the q-questionnaire header to render content as follows: everything passed with a qHeader attribute will be rendered inside of a h6 tag at the top of the .questionnaire__header section. Everything else will be rendered below it.
With these changes, the questionnaire template looks like this:
The always ‘gets’ content first. When all projections with `select` have passed, the rest is dumped in the catch all tag (if any). So now, if some header text is passed, it will always render on top of the questionnaire header in a h6 tag. Even if passed like this:
Interlude — content projection woes
Disclaimer: This is a pretty messy way to pass content down through several components. For instance, having a reference to the questionnaire in the QValidator component is way easier (and won’t interfere, as the validator is really a questionnaire only control).
My survey view is working properly — the question data is rendered correctly and the validator error messages show up when the questions are not valid. But since my error message is not tied to my questions data, I might want to make it customizable (for example, if the questions were all in German, currently my error messages will still be in English).
I add an input to my questionnaire component, accepting an object with error messages for each type of question (conveniently, only 2). I then pass the input down to the question components:
and project it inside of the question components’ templates using ng-content select=»[qError]» :
Inside of the validator, I want to handle the projected content with another content projection:
The content projection is handled with a select argument, in case we want to pass multiple content blocks down to the validator (which we will!).
In my survey view, I pass down custom error messages to my q-questionnaire via the errorMsg input:
When I run the app, no errors are thrown, but my validators do not show any error messages. The error icons are still visible, so the q-validator component is properly rendered for invalid questions.
If I debug my app, I can see that the error messages are properly passed to the q-questionnaire component (the instance of q-questionnaire.errorMsgs return the proper messages, in German). The question components are also getting a reference to the questionnaire ( q-single.questionnaire is not null ) and they are properly getting the errorMsgs (as they are public ). If I change my q-multi.component.html to the following, I can even see the error message on my last question:
So whatever’s going wrong must be happening in the last step of the projection, when the message is being passed to the q-validator component.
Using
The ng-content tag inside of the q-validator component does not seem to be properly rendering the error message.
If I change the template of the q-validator component to use a catch-all ng-content tag, the error message is displayed properly:
But what if I want to pass multiple content blocks and render them in pre-specified positions? I’d really like it if I could keep the select attribute on that ng-content tag.
I search around for any additional documentation regarding content projection in order to find something that can help me with my case. Eudes Petonnet’s post does a great job of explaining how ng-content works and has examples for different use cases.
In my example, the fault is in the projection, inside q-single / q-multi.component.html :
Since the q-validator component is awaiting for a text passed with , it doesn’t recognize the block passed from q-single/q-multi (as the projection has not yet been replaced and the element itself does not match the criteria of `select=”[qError]”`). This can be solved by using the ngProjectAs attribute — this attribute can be placed on any element and allows it to ‘mask’ itself as the criteria passed, for the sake of content projection.
After adding the ngProjectAs=»[qError]» to the ng-content tag , the error messages appear correclty and are in German. Now the survey has customizable error messages that can be passed from the q-questionnaire component. It would be great if we could customize the error icon as well.
Using
Okay, I want to pass an icon down to the validator component. I’ll create an @Input() property in the q-questionnaire that accepts a TemplateRef of the icon.
The icon is defined in the survey.component.html and the template ref is passed to the q-questionnaire via the input:
I pass a reference to the questionnaire inside of the q-single / q-multi class and pass the questionnaire error icon down to the q-validator (using ngTemplateOutlet )
And, depending on whether the control has a custom icon passed or not, it renders the custom or default icon (resp.) in the validator:
Disclaimer : Again, this is a far-from-ideal approach, but I think it is a good way to illustrate how content can be passed.
The QValidatorComponent.errorIcon gets a ContentChild by checking for an instance of QErrorIconDirective (using a ViewChild would always get a reference, due to the default icon). However, the ContentChild query never seems to return anything. I tried debugging and could see that the template was in fact passed to the questionnaire component (so QQuestionnaire.errorIcon was not undefined ), thus was properly passed inside of the q-single / q-multi components and reached all the way down to the q-validator component (if the decorator on QValidatorComponent.errorIcon is changed to @ContentChild(TemplateRef, < read: TemplateRef >) , the component properly gets a reference to the template and the custom icon is rendered).
Conclusion
I hope that this article and the examples will prove helpful to someone trying to better understand the use .
And here is the GitHub repo, if you want to download and play with the demo:
https://github.com/ViktorSlavov/DemoSurveyApp
Feel free to share your thoughts on anything that comes to mind in the comments below.
Источник
Render the following text in english фундамент сетевого взаимодействия
Ex. 2.4. Read and render the following text in English:
Каналы распределения: уровни и типы организации
Большинство современных производителей для продвижения своей продукции на рынки прибегают к услугам тех или иных посредников, которые, передавая товар друг другу, образуют сравнительно устойчивые цепочки. Цепочки эти принято называть каналами распределения (англ. distribution channels), маркетинговыми каналами (англ. marketing channels), каналами сбыта. Выбор термина главным образом зависит от привычек и профессиональной принадлежности специалиста, им пользующегося.
В общем случае канал распределения – это совокупность физических и юридических лиц, которые принимают на себя или помогают передать кому-то другому право собственности на конкретные товары или услуги при их движении от производителя к потребителю. Иногда под каналом распределения имеют в виду путь, по которому товары движутся от производителей к потребителям. В процессе движения по каналам распределения происходит трансформация ассортимента продукции, выпущенной ее производителем, в ассортимент товаров, востребованных конечным потребителем. Канаты распределения играют главенствующую роль в установлении соответствия между спросом и предложением на рынке.
В каналах распределения могут реализовываться следующие функции:
1. Информационно-исследовательская функция, включающая сбор маркетинговой информации, проведение маркетинговых исследований и распространение информации, необходимой для планирования и облегчения сбыта товаров.
2. Функция стимулирования сбыта.
3. Функция по установлению контактов, включающая поиск потенциальных покупателей, налаживание и поддержание связи с ними.
4. Функция приспособления товара к запросам покупателей, включая упаковку, сортировку, монтаж и т.п.
5. Функция проведения переговоров для согласования цен и прочих условий, необходимых для последующего осуществления акта передачи товара в собственность или владение.
6. Функция организации товародвижения, включающая транспортировку и складирование товара.
7. Функция финансирования, направленная на изыскание и использование средств для покрытия издержек по работе канала.
8. Функция принятия риска, связанного с ответственностью за работу канала.
Все перечисленные функции можно разделить на две группы. Одна из них касается заключения сделок, а вторая группа связана с выполнением уже заключенных сделок. Эти функции также можно классифицировать по направлениям деятельности и выделить из них относящиеся к логистике, маркетингу, продажам, сервису.
Структура канала распределения, прежде всего, связана с тем, сколько его участников, на каких условиях и с какой эффективностью выполняют свою работу. В общем случае канал распределения представляет собой последовательность групп посредников, где каждая из них выполняет конкретную задачу по приближению товара и права собственности на него к конечному покупателю в процессе распределения товара. Эти группы образуют уровень канала распределения (англ. channel level). Поскольку определенную работу выполняют и сам производитель, и конечный потребитель, они тоже входят в состав любого канала. Обычно выделяют следующие уровни каната распределения: оптовая торговля, мелкооптовая торговля, розничная торговля.
Каналы распределения можно классифицировать по числу уровней, из которых он состоит, например канал нулевого уровня, одноуровневый канал, двухуровневый канал и т.д. В целом канал распределения часто характеризуют длиной и шириной.
Длина канала, иногда используют термин «протяженность канала», – это максимальное число самостоятельных независимых посредников, участвующих в доведении товара от производителя до потребителя.
Ширина канала – это количество независимых участников на данном уровне канала распределения.
Канал нулевого уровня, иногда называемый также каналом прямого маркетинга, состоит из производителя, продающего товар непосредственно потребителям. Наиболее известны три способа прямой продажи: торговля вразнос, посылочная торговля и торговля через принадлежащие производителю магазины. Типичный пример такого канала в России – магазины при заводах и фабриках, непосредственно продающих свою продукцию населению. Сегодня развиваются такие формы продажи без привлечения торгового персонала, как телемаркетинг, заказ по каталогам, телемагазин (англ. TV-shop). Широкое распространение каналы нулевого уровня получили в Интернете. Это связано с тем, что результаты деятельности производителей интернет-продукта, например программное обеспечение, вполне можно распространять непосредственно через сеть. Характерными особенностями прямых каналов распределения являются: сравнительно небольшой объем сбыта, тесный контакт изготовителя с потребителем, гибкая ценовая политика, широкие возможности технического обслуживания продаваемых товаров, оперативная обратная связь с потребителями. До недавнего времени этот вариант наиболее часто использовался при реализации продукции производственно-технического назначения и реже – товаров широкого потребления. С появлением современных форм сбыта, особенно Интернета, такое положение начинает меняться.
Одноуровневый канал включает в себя одного посредника. На потребительских рынках этим посредником обычно бывает розничный торговец, а на рынках товаров промышленного назначения им нередко оказывается брокер или торговый агент. Одноуровневый канал считается выгодным, если у производителя нет средств для организации самостоятельной работы по сбыту, ассортимент продукции широкий, количество сегментов рынка невелико, объем предпродажного и послепродажного сервиса незначителен, а особенности товаров определяют небольшую кратность разовых покупок.
Двухуровневый канал включает в себя двух посредников. На потребительских рынках такими посредниками обычно становятся оптовые и розничные торговцы, на рынках товаров промышленного назначения это могут быть промышленный дистрибьютор и дилеры. При этом оптовик и дистрибьютор являются посредниками первого уровня, а розничные торговцы и дилеры – посредниками второго уровня. Двухуровневый канал считается выгодным, если рынок расположен на большой территории, можно значительно сэкономить, поставляя большие партии небольшому количеству покупателей.
Трехуровневый канал включает трех посредников. Например, между оптовым и розничным торговцами располагается мелкий оптовик. Мелкие оптовики покупают товары у крупных оптовых торговцев и перепродают их небольшим предприятиям розничной торговли, которые крупные оптовики могут не обслуживать из-за сравнительно низкой рентабельности.
Существуют каналы и с большим количеством уровней, но они встречаются реже. Очевидно, чем больше уровней имеет канал распределения, тем меньше возможность у производителя его контролировать, но ритм работы производителя при этом стабильнее. Длинные каналы относительно затратны, однако зачастую иного выбора у производителя, желающего выйти на массовый рынок, нет, особенно если целью является завоевание массового рынка не только в своем регионе, но и по всей стране.
Источник