feat: Make it possible to specify that a token should ALWAYS be in front (#152)

* Add a new attribute called 'front' to ensure that the token is ALWAYS appended at the start

* PR feedback: Remove unused route, add description column to README

Author: erkie

README.md

@@ -32,11 +32,12 @@ This file is added automatically if you use `ember install`. This is for all the
 
 ### API
 
-| attribute | type    | default |
-|-----------|:--------|:--------|
-| separator | string  | `" \| "`|
-| prepend   | boolean | true    |
-| replace   | boolean | false   |
+| attribute | type    | default | description                                                               |
+|-----------|:--------|:--------|:--------------------------------------------------------------------------|
+| separator | string  | `" \| "`| Which separator should be displayed _after_ this instance of `{{title }}` |
+| prepend   | boolean | true    | If the token should be prepended or appended to the list of tokens        |
+| replace   | boolean | false   | Replace all previous elements with the active                             |
+| front     | boolean | false   | If the token should always be in the beginning of the resulting title.    |
 
 These defaults are configurable in `config/environment.js`:
 

addon/services/page-title-list.js

@@ -147,8 +147,11 @@ export default Service.extend({
       let appending = true;
       let group = [];
       let groups = A([group]);
+      let frontGroups = [];
       visible.forEach((token) => {
-        if (token.prepend) {
+        if (token.front) {
+          frontGroups.unshift(token);
+        } else if (token.prepend) {
           if (appending) {
             appending = false;
             group = [];
@@ -170,7 +173,9 @@ export default Service.extend({
         }
       });
 
-      return groups.reduce((E, group) => E.concat(group), []);
+      return frontGroups.concat(
+        groups.reduce((E, group) => E.concat(group), [])
+      );
     }
   }),
 

tests/acceptance/posts-test.js

@@ -85,4 +85,11 @@ module('Acceptance: title', function(hooks) {
     });
     assert.equal(title(), 'Tomster (@tomster)');
   });
+
+  test('front tokens work', async function (assert) {
+    assert.expect(1);
+    await visit('/reader');
+
+    assert.equal(title(), '(10) Reader | My App');
+  });
 });

tests/dummy/app/router.js

@@ -17,6 +17,7 @@ Router.map(function() {
   this.route('author', { path: '/authors/:author_id' });
   this.route('hollywood', { path: '/hollywood' });
   this.route('feed', { path: '/feeds/:name' });
+  this.route('reader', { path: '/reader' });
 });
 
 export default Router;

tests/dummy/app/templates/reader.hbs

@@ -0,0 +1,3 @@
+{{title "Reader"}}
+
+{{title "(10)" front=true separator=" "}}