You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: README.md
+10-5Lines changed: 10 additions & 5 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -108,13 +108,17 @@ This will result in a document along the lines of:
108
108
```
109
109
110
110
111
-
### Fastboot Only
111
+
##FastBoot-Only Use
112
112
113
-
The primary need for this library is to support various bots and web crawlers. To that end the head content is only truly needed in a serverrendered (i.e. FastBoot) environment. However, by default the library will keep the head content in sync with any transitions/data changes that occur in your Ember App while running in the browser. This can be useful for development and/or debugging.
113
+
The primary need for this addon is to support various bots and web crawlers. To that end, the head content is only truly needed in a server-rendered environment like FastBoot.
114
114
115
-
If you do not wish to have the head content "live" while running in browser you can restrict this library to only work in FastBoot by adding the following to your `config/environment.js`:
115
+
By default, the addon will keep the head content in sync with any route transitions and data changes that occur when your Ember app runs in the browser. This can be useful for development and debugging.
116
+
117
+
If you don't wish the head content to be "live" when the app runs in browser, you can restrict this addon to run only in FastBoot:
If you use `suppressBrowserRender`, the content of `<head>` will be the static FastBoot-rendered content throughout your app's lifecycle.
134
+
135
+
129
136
### Upgrade to 0.4.x
130
137
131
138
As mentioned above you need to add the `<HeadLayout />` component once and only once in an application wide template. This template is usually `app/templates/application.hbs`, but could be different in your case. Previously, in ember-cli-head 0.3.x and below the component was appended to the document inside an instance initializer. This prevented the need for the `<HeadLayout />` component as it was automatically injected and used inside that initializer. Unfortunately, this approach needed to change so that we could render the component with the rest of the application rendering.
@@ -134,8 +141,6 @@ If you care to read more about the details of render please see the PR that intr
134
141
135
142
But for now, if you are upgrading to 0.4.x, you simply need to add `<HeadLayout />` component to your application wide template.
136
143
137
-
If you make use of this mode the content of `<head>` will be the static FastBoot rendered content through the life of your App.
138
-
139
144
## Contributing
140
145
141
146
See the [Contributing](CONTRIBUTING.md) guide for details.
0 commit comments