Ng1StateDeclaration | @uirouter/angularjs
Options
Menu

Interface Ng1StateDeclaration

The StateDeclaration object is used to define a state or nested state. It should be registered with the StateRegistry.

Example:

// StateDeclaration object
var foldersState = {
  name: 'folders',
  url: '/folders',
  resolve: {
    allfolders: function(FolderService) {
      return FolderService.list();
    }
  },
  template: "<ul><li ng-repeat='folder in allfolders'></li></ul>",
  controller: function(allfolders, $scope) {
    $scope.allfolders = allfolders;
  }
}

Since this interface extends Ng1ViewDeclaration, any view declaration properties can be set directly on the state declaration and they will be applied to the view with the name $default. For example:

var state = {
  name: 'foo',
  url: '/foo',
  template: '<h1>foo</h1>',
  controller: 'FooController'
}

is simply syntactic sugar for:

var state = {
  name: 'foo',
  url: '/foo',
  views: {
    $default: {
      template: '<h1>foo</h1>',
      controller: 'FooController'
    }
  }
}

If a state definition contains a views: object, any view properties set directly on the state are ignored. Thus, this is an invalid state defintion:

var state = {
  name: 'foo',
  url: '/foo',
  controller: 'FooController', // invalid because views: exists
  views: {
    header: {
      template: '<h1>header</h1>'
    }
  }
}

Hierarchy

Index

Properties

$$state: function

Gets the internal State object API

Gets the internal State object API

Gets the internal API for a registered state.

Note: the internal StateObject API is subject to change without notice

Type declaration

    • (): StateObject
    • Returns StateObject

$context: ViewContext

The context that this view is declared within.

The context that this view is declared within.

$name: string

The raw name for the view declaration, i.e., the StateDeclaration.views property name.

The raw name for the view declaration, i.e., the StateDeclaration.views property name.

$type: string

A type identifier for the View

A type identifier for the View

This is used when loading prerequisites for the view, before it enters the DOM. Different types of views may load differently (e.g., templateProvider+controllerProvider vs component class)

$uiViewContextAnchor: string

The normalized context anchor (state name) for the uiViewName

The normalized context anchor (state name) for the uiViewName

When targeting a ui-view, the uiViewName address is anchored to a context name (state name).

$uiViewName: string

The normalized address for the ui-view which this ViewConfig targets.

The normalized address for the ui-view which this ViewConfig targets.

A ViewConfig targets a ui-view in the DOM (relative to the uiViewContextAnchor) which has a specific name.

example

header or $default

The uiViewName can also target a nested view by providing a dot-notation address

example

foo.bar or foo.$default.bar

abstract: boolean

Abstract state indicator

Abstract state indicator

An abstract state can never be directly activated. Use an abstract state to provide inherited properties (url, resolve, data, etc) to children states.

bindings: object

An object which maps resolves to component bindings.

An object which maps resolves to component bindings.

A property of Ng1StateDeclaration or Ng1ViewDeclaration:

When using a component declaration (component: 'myComponent'), each input binding for the component is supplied data from a resolve of the same name, by default. You may supply data from a different resolve name by mapping it here.

Each key in this object is the name of one of the component's input bindings. Each value is the name of the resolve that should be provided to that binding.

Any component bindings that are omitted from this map get the default behavior of mapping to a resolve of the same name.

Example:

$stateProvider.state('foo', {
  resolve: {
    foo: function(FooService) { return FooService.get(); },
    bar: function(BarService) { return BarService.get(); }
  },
  component: 'Baz',
  // The component's `baz` binding gets data from the `bar` resolve
  // The component's `foo` binding gets data from the `foo` resolve (default behavior)
  bindings: {
    baz: 'bar'
  }
});

app.component('Baz', {
  templateUrl: 'baz.html',
  controller: 'BazController',
  bindings: {
    foo: '<', // foo binding
    baz: '<'  // baz binding
  }
});

Type declaration

  • [key: string]: string
component: string

The name of the component to use for this view.

The name of the component to use for this view.

A property of Ng1StateDeclaration or Ng1ViewDeclaration:

The name of an angular 1.5+ .component() (or directive with bindToController and/or scope declaration) which will be used for this view.

Resolve data can be provided to the component via the component's bindings object (for 1.3+ directives, the bindToController is used; for other directives, the scope declaration is used). For each binding declared on the component, any resolve with the same name is set on the component's controller instance. The binding is provided to the component as a one-time-binding. In general, components should likewise declare their input bindings as one-way ("<").

Note: inside a "views:" block, a bare string "foo" is shorthand for { component: "foo" }

Note: Mapping from resolve names to component inputs may be specified using bindings.

Example:

.state('profile', {
  // Use the <my-profile></my-profile> component for the Unnamed view
  component: 'MyProfile',
}

.state('messages', {
  // use the <nav-bar></nav-bar> component for the view named 'header'
  // use the <message-list></message-list> component for the view named 'content'
  views: {
    header: { component: 'NavBar' },
    content: { component: 'MessageList' }
  }
}

.state('contacts', {
  // Inside a "views:" block, a bare string "NavBar" is shorthand for { component: "NavBar" }
  // use the <nav-bar></nav-bar> component for the view named 'header'
  // use the <contact-list></contact-list> component for the view named 'content'
  views: {
    header: 'NavBar',
    content: 'ContactList'
  }
}

Note: When using component to define a view, you may not use any of: template, templateUrl, templateProvider, controller, controllerProvider, controllerAs.

See also: Todd Motto's angular 1.3 and 1.4 backport of .component()

componentProvider: IInjectable

Dynamic component provider function.

Dynamic component provider function.

A property of Ng1StateDeclaration or Ng1ViewDeclaration:

This is an injectable provider function which returns the name of the component to use. The provider will invoked during a Transition in which the view's state is entered. The provider is called after the resolve data is fetched.

Example:

componentProvider: function(MyResolveData, $transition$) {
  if (MyResolveData.foo) {
    return "fooComponent"
  } else if ($transition$.to().name === 'bar') {
    return "barComponent";
  }
}
controller: IInjectable | string

The view's controller function or name

The view's controller function or name

A property of Ng1StateDeclaration or Ng1ViewDeclaration:

The controller function, or the name of a registered controller. The controller function will be used to control the contents of the directives.uiView directive.

If specified as a string, controllerAs can be declared here, i.e., "FooController as foo" instead of in a separate controllerAs property.

See: Ng1Controller for information about component-level router hooks.

controllerAs: string

A controller alias name.

A controller alias name.

A property of Ng1StateDeclaration or Ng1ViewDeclaration:

If present, the controller will be published to scope under the controllerAs name. See: https://docs.angularjs.org/api/ng/directive/ngController

controllerProvider: IInjectable

Dynamic controller provider function.

Dynamic controller provider function.

A property of Ng1StateDeclaration or Ng1ViewDeclaration:

This is an injectable provider function which returns the actual controller function, or the name of a registered controller. The provider will invoked during a Transition in which the view's state is entered. The provider is called after the resolve data is fetched.

Example:

controllerProvider: function(MyResolveData, $transition$) {
  if (MyResolveData.foo) {
    return "FooCtrl"
  } else if ($transition$.to().name === 'bar') {
    return "BarCtrl";
  } else {
    return function($scope) {
      $scope.baz = "Qux";
    }
  }
}
data: any

An inherited property to store state data

An inherited property to store state data

This is a spot for you to store inherited state metadata. Child states' data object will prototypally inherit from their parent state.

This is a good spot to put metadata such as requiresAuth.

Note: because prototypal inheritance is used, changes to parent data objects reflect in the child data objects. Care should be taken if you are using hasOwnProperty on the data object. Properties from parent objects will return false for hasOwnProperty.

dynamic: boolean

Marks all the state's parameters as dynamic.

Marks all the state's parameters as dynamic.

All parameters on the state will use this value for dynamic as a default. Individual parameters may override this default using ParamDeclaration.dynamic in the params block.

Note: this value overrides the dynamic value on a custom parameter type (ParamTypeDefinition.dynamic).

lazyLoad: function

A function used to lazy load code

A function used to lazy load code

The lazyLoad function is invoked before the state is activated. The transition waits while the code is loading.

The function should load the code that is required to activate the state. For example, it may load a component class, or some service code. The function must return a promise which resolves when loading is complete.

For example, this code lazy loads a service before the abc state is activated:

.state('abc', {
  lazyLoad: (transition, state) => System.import('./abcService')
}

The abcService file is imported and loaded (it is assumed that the abcService file knows how to register itself as a service).

Lifecycle

  • The lazyLoad function is invoked if a transition is going to enter the state.

  • The function is invoked before the transition starts (using an onBefore transition hook).

  • The function is only invoked once; while the lazyLoad function is loading code, it will not be invoked again. For example, if the user double clicks a ui-sref, lazyLoad is only invoked once even though there were two transition attempts. Instead, the existing lazy load promise is re-used.

  • When the promise resolves successfully, the lazyLoad property is deleted from the state declaration.

  • If the promise resolves to a LazyLoadResult which has an array of states, those states are registered.

  • The original transition is retried (this time without the lazyLoad property present).

  • If the lazyLoad function fails, then the transition also fails. The failed transition (and the lazyLoad function) could potentially be retried by the user.

Lazy loading state definitions (Future States)

State definitions can also be lazy loaded. This might be desirable when building large, multi-module applications.

To lazy load state definitions, a Future State should be registered as a placeholder. When the state definitions are lazy loaded, the Future State is deregistered.

A future state can act as a placeholder for a single state, or for an entire module of states and substates. A future state should have:

  • A name which ends in .**. A future state's name property acts as a wildcard Glob. It matches any state name that starts with the name (including child states that are not yet loaded).
  • A url prefix. A future state's url property acts as a wildcard. UI-Router matches all paths that begin with the url. It effectively appends .* to the internal regular expression. When the prefix matches, the future state will begin loading.
  • A lazyLoad function. This function should should return a Promise to lazy load the code for one or more StateDeclaration objects. It should return a LazyLoadResult. Generally, one of the lazy loaded states should have the same name as the future state. The new state will then replace the future state placeholder in the registry.

Additional resources

For in depth information on lazy loading and Future States, see the Lazy Loading Guide.

Example: states.js


// This child state is a lazy loaded future state
// The `lazyLoad` function loads the final state definition
{
  name: 'parent.**',
  url: '/parent',
  lazyLoad: () => System.import('./lazy.states.js')
}

Example: lazy.states.js

This file is lazy loaded. It exports an array of states.

import {ChildComponent} from "./child.component.js";
import {ParentComponent} from "./parent.component.js";

// This fully defined state replaces the future state
let parentState = {
  // the name should match the future state
  name: 'parent',
  url: '/parent/:parentId',
  component: ParentComponent,
  resolve: {
    parentData: ($transition$, ParentService) =>
        ParentService.get($transition$.params().parentId)
  }
}

let childState = {
  name: 'parent.child',
  url: '/child/:childId',
  params: {
    childId: "default"
  },
  resolve: {
    childData: ($transition$, ChildService) =>
        ChildService.get($transition$.params().childId)
  }
};

// This array of states will be registered by the lazyLoad hook
let lazyLoadResults = {
  states: [ parentState, childState ]
};

export default lazyLoadResults;
param

the Transition that is activating the future state

param

the StateDeclaration that the lazyLoad function is declared on

returns

a Promise to load the states. Optionally, if the promise resolves to a LazyLoadResult, the states will be registered with the StateRegistry.

Type declaration

    • (transition: Transition, state: StateDeclaration): Promise<LazyLoadResult>
    • Parameters

      • transition Transition
      • state StateDeclaration

      Returns Promise<LazyLoadResult>

name: string

The state name (required)

The state name (required)

A unique state name, e.g. "home", "about", "contacts". To create a parent/child state use a dot, e.g. "about.sales", "home.newest".

Note: [State] objects require unique names. The name is used like an id.

onEnter: Ng1StateTransitionHook | IInjectable

A state hook invoked when a state is being entered.

A state hook invoked when a state is being entered.

The hook can inject global services. It can also inject $transition$ or $state$ (from the current transition).

Example:

$stateProvider.state({
  name: 'mystate',
  onEnter: (MyService, $transition$, $state$) => {
    return MyService.doSomething($state$.name, $transition$.params());
  }
});

Example:`

$stateProvider.state({
  name: 'mystate',
  onEnter: [ 'MyService', '$transition$', '$state$', function (MyService, $transition$, $state$) {
    return MyService.doSomething($state$.name, $transition$.params());
  } ]
});
onExit: Ng1StateTransitionHook | IInjectable

A state hook invoked when a state is being exited.

A state hook invoked when a state is being exited.

The hook can inject global services. It can also inject $transition$ or $state$ (from the current transition).

Example:

$stateProvider.state({
  name: 'mystate',
  onExit: (MyService, $transition$, $state$) => {
    return MyService.doSomething($state$.name, $transition$.params());
  }
});

Example:`

$stateProvider.state({
  name: 'mystate',
  onExit: [ 'MyService', '$transition$', '$state$', function (MyService, $transition$, $state$) {
    return MyService.doSomething($state$.name, $transition$.params());
  } ]
});
onRetain: Ng1StateTransitionHook | IInjectable

A state hook invoked when a state is being retained.

A state hook invoked when a state is being retained.

The hook can inject global services. It can also inject $transition$ or $state$ (from the current transition).

Example:

$stateProvider.state({
  name: 'mystate',
  onRetain: (MyService, $transition$, $state$) => {
    return MyService.doSomething($state$.name, $transition$.params());
  }
});

Example:`

$stateProvider.state({
  name: 'mystate',
  onRetain: [ 'MyService', '$transition$', '$state$', function (MyService, $transition$, $state$) {
    return MyService.doSomething($state$.name, $transition$.params());
  } ]
});
params: object

Params configuration

Params configuration

An object which optionally configures parameters declared in the url, or defines additional non-url parameters. For each parameter being configured, add a ParamDeclaration keyed to the name of the parameter.

Example:

params: {
  param1: {
   type: "int",
   array: true,
   value: []
  },
  param2: {
    value: "index"
  }
}

Type declaration

  • [key: string]: ParamDeclaration | any
parent: string | StateDeclaration

The parent state

The parent state

Normally, a state's parent is implied from the state's name, e.g., "parentstate.childstate".

Alternatively, you can explicitly set the parent state using this property. This allows shorter state names, e.g., <a ui-sref="childstate">Child</a> instead of `Child

When using this property, the state's name should not have any dots in it.

Example:

var parentstate = {
  name: 'parentstate'
}
var childstate = {
  name: 'childstate',
  parent: 'parentstate'
  // or use a JS var which is the parent StateDeclaration, i.e.:
  // parent: parentstate
}
redirectTo: RedirectToResult | function | function

Synchronously or asynchronously redirects Transitions to a different state/params

Synchronously or asynchronously redirects Transitions to a different state/params

If this property is defined, a Transition directly to this state will be redirected based on the property's value.

  • If the value is a string, the Transition is redirected to the state named by the string.

  • If the property is an object with a state and/or params property, the Transition is redirected to the named state and/or params.

  • If the value is a TargetState the Transition is redirected to the TargetState

  • If the property is a function:

    • The function is called with the current Transition
    • The return value is processed using the previously mentioned rules.
    • If the return value is a promise, the promise is waited for, then the resolved async value is processed using the same rules.

Note: redirectTo is processed as an onStart hook, before LAZY resolves. If your redirect function relies on resolve data, get the Transition.injector and get a promise for the resolve data using UIInjector.getAsync.

Example:

// a string
.state('A', {
  redirectTo: 'A.B'
})

// a {state, params} object
.state('C', {
  redirectTo: { state: 'C.D', params: { foo: 'index' } }
})

// a fn
.state('E', {
  redirectTo: () => "A"
})

// a fn conditionally returning a {state, params}
.state('F', {
  redirectTo: (trans) => {
    if (trans.params().foo < 10)
      return { state: 'F', params: { foo: 10 } };
  }
})

// a fn returning a promise for a redirect
.state('G', {
  redirectTo: (trans) => {
    let svc = trans.injector().get('SomeAsyncService')
    let promise = svc.getAsyncRedirectTo(trans.params.foo);
    return promise;
  }
})

// a fn that fetches resolve data
.state('G', {
  redirectTo: (trans) => {
    // getAsync tells the resolve to load
    let resolvePromise = trans.injector().getAsync('SomeResolve')
    return resolvePromise.then(resolveData => resolveData === 'login' ? 'login' : null);
  }
})
reloadOnSearch: boolean

Makes all search/query parameters dynamic

Makes all search/query parameters dynamic

Deprecation warning: use ParamDeclaration.dynamic instead

deprecated
resolve: ResolveTypes[] | object

Resolve - a mechanism to asynchronously fetch data, participating in the Transition lifecycle

Resolve - a mechanism to asynchronously fetch data, participating in the Transition lifecycle

The resolve: property defines data (or other dependencies) to be fetched asynchronously when the state is being entered. After the data is fetched, it may be used in views, transition hooks or other resolves that belong to this state. The data may also be used in any views or resolves that belong to nested states.

As an array

Each array element should be a ResolvableLiteral object.

Example:

The user resolve injects the current Transition and the UserService (using its token, which is a string). The [[ResolvableLiteral.resolvePolicy]] sets how the resolve is processed. The user data, fetched asynchronously, can then be used in a view.

var state = {
  name: 'user',
  url: '/user/:userId
  resolve: [
    {
      token: 'user',
      policy: { when: 'EAGER' },
      deps: ['UserService', Transition],
      resolveFn: (userSvc, trans) => userSvc.fetchUser(trans.params().userId) },
    }
  ]
}

Note: an Angular 2 style useFactory provider literal may also be used. See ProviderLike.

Example:

resolve: [
  { provide: 'token', useFactory: (http) => http.get('/'), deps: [ Http ] },
]

As an object

The resolve property may be an object where:

  • Each key (string) is the name of the dependency.
  • Each value (function) is an injectable function which returns the dependency, or a promise for the dependency.

This style is based on AngularJS injectable functions, but can be used with any UI-Router implementation. If your code will be minified, the function should be "annotated" in the AngularJS manner.

AngularJS Example:

resolve: {
  // If you inject `myStateDependency` into a controller, you'll get "abc"
  myStateDependency: function() {
    return "abc";
  },
  // Dependencies are annotated in "Inline Array Annotation"
  myAsyncData: ['$http', '$transition$' function($http, $transition$) {
    // Return a promise (async) for the data
    return $http.get("/foos/" + $transition$.params().foo);
  }]
}

Note: You cannot specify a policy for each Resolvable, nor can you use non-string tokens when using the object style resolve: block.

Lifecycle

Since a resolve function can return a promise, the router will delay entering the state until the promises are ready. If any of the promises are rejected, the Transition is aborted with an Error.

By default, resolves for a state are fetched just before that state is entered. Note that only states which are being entered during the Transition have their resolves fetched. States that are "retained" do not have their resolves re-fetched.

If you are currently in a parent state parent and are transitioning to a child state parent.child, the previously resolved data for state parent can be injected into parent.child without delay.

Any resolved data for parent.child is retained until parent.child is exited, e.g., by transitioning back to the parent state.

Because of this scoping and lifecycle, resolves are a great place to fetch your application's primary data.

Injecting resolves into other things

During a transition, Resolve data can be injected into:

  • Views (the components which fill a ui-view tag)
  • Transition Hooks
  • Other resolves (a resolve may depend on asynchronous data from a different resolve)

Injecting other things into resolves

Resolve functions usually have dependencies on some other API(s). The dependencies are usually declared and injected into the resolve function. A common pattern is to inject a custom service such as UserService. The resolve then delegates to a service method, such as UserService.list();

Special injectable tokens

  • UIRouter: The UIRouter instance which has references to all the UI-Router services.
  • Transition: The current Transition object; information and API about the current transition, such as "to" and "from" State Parameters and transition options.
  • '$transition$': A string alias for the Transition injectable
  • '$state$': For onEnter/onExit/onRetain, the state being entered/exited/retained.
  • Other resolve tokens: A resolve can depend on another resolve, either from the same state, or from any parent state.

Example:

// Injecting a resolve into another resolve
resolve: [
  // Define a resolve 'allusers' which delegates to the UserService.list()
  // which returns a promise (async) for all the users
  { provide: 'allusers', useFactory: (UserService) => UserService.list(), deps: [UserService] },

  // Define a resolve 'user' which depends on the allusers resolve.
  // This resolve function is not called until 'allusers' is ready.
  { provide: 'user', (allusers, trans) => _.find(allusers, trans.params().userId, deps: ['allusers', Transition] }
}
resolveAs: string

The scope variable name to use for resolve data.

The scope variable name to use for resolve data.

A property of Ng1StateDeclaration or Ng1ViewDeclaration:

When a view is activated, the resolved data for the state which the view belongs to is put on the scope. This property sets the name of the scope variable to use for the resolved data.

Defaults to $resolve.

resolvePolicy: ResolvePolicy

Sets the resolve policy defaults for all resolves on this state

Sets the resolve policy defaults for all resolves on this state

This should be an ResolvePolicy object.

It can contain the following optional keys/values:

  • when: (optional) defines when the resolve is fetched. Accepted values: "LAZY" or "EAGER"
  • async: (optional) if the transition waits for the resolve. Accepted values: "WAIT", "NOWAIT", CustomAsyncPolicy

See ResolvePolicy for more details.

template: Function | string

The HTML template for the view.

The HTML template for the view.

A property of Ng1StateDeclaration or Ng1ViewDeclaration:

HTML template as a string, or a function which returns an html template as a string. This template will be used to render the corresponding directives.uiView directive.

This property takes precedence over templateUrl.

If template is a function, it will be called with the Transition parameters as the first argument.

Example:

template: "<h1>inline template definition</h1><div ui-view></div>"

Example:

template: function(params) {
  return "<h1>generated template</h1>";
}
templateProvider: IInjectable

Injected function which returns the HTML template.

Injected function which returns the HTML template.

A property of Ng1StateDeclaration or Ng1ViewDeclaration:

Injected function which returns the HTML template. The template will be used to render the corresponding directives.uiView directive.

Example:

templateProvider: function(MyTemplateService, $transition$) {
  return MyTemplateService.getTemplate($transition$.params().pageId);
}
templateUrl: string | Function

The URL for the HTML template for the view.

The URL for the HTML template for the view.

A property of Ng1StateDeclaration or Ng1ViewDeclaration:

A path or a function that returns a path to an html template. The template will be fetched and used to render the corresponding directives.uiView directive.

If templateUrl is a function, it will be called with the Transition parameters as the first argument.

Example:

templateUrl: "/templates/home.html"

Example:

templateUrl: function(params) {
  return myTemplates[params.pageId];
}
url: string

The url fragment for the state

The url fragment for the state

A URL fragment (with optional parameters) which is used to match the browser location with this state.

This fragment will be appended to the parent state's URL in order to build up the overall URL for this state. See UrlMatcher for details on acceptable patterns.

examples

url: "/home"
// Define a parameter named 'userid'
url: "/users/:userid"
// param 'bookid' has a custom regexp
url: "/books/{bookid:[a-zA-Z_-]}"
// param 'categoryid' is of type 'int'
url: "/books/{categoryid:int}"
// two parameters for this state
url: "/books/{publishername:string}/{categoryid:int}"
// Query parameters
url: "/messages?before&after"
// Query parameters of type 'date'
url: "/messages?{before:date}&{after:date}"
// Path and query parameters
url: "/messages/:mailboxid?{before:date}&{after:date}"
views: object

An optional object which defines multiple named views.

An optional object which defines multiple named views.

Each key is the name of a view, and each value is a Ng1ViewDeclaration. Unnamed views are internally renamed to $default.

A view's name is used to match an active <ui-view> directive in the DOM. When the state is entered, the state's views are activated and matched with active <ui-view> directives:

  • The view's name is processed into a ui-view target:

    • ui-view address: an address to a ui-view
    • state anchor: the state to anchor the address to

    Examples:

    Targets three named ui-views in the parent state's template

Example:

views: {
  header: {
    controller: "headerCtrl",
    templateUrl: "header.html"
  },
  body: {
    controller: "bodyCtrl",
    templateUrl: "body.html"
  },
  footer: "footerComponent"
}

Example:

// Targets named ui-view="header" in the template of the ancestor state 'top'
// and the named `ui-view="body" from the parent state's template.
views: {
  'header@top': {
    controller: "msgHeaderCtrl",
    templateUrl: "msgHeader.html"
  },
  'body': {
    controller: "messagesCtrl",
    templateUrl: "messages.html"
  }
}

View targeting details

There are a few styles of view addressing/targeting. The most common is a simple ui-view name

Simple ui-view name

Addresses without an @ are anchored to the parent state.

Example:

// target the `<div ui-view='foo'></div>` created in the parent state's view
views: {
  foo: {...}
}

View name anchored to a state

You can anchor the ui-view name to a specific state by including an @

Example:

targets the <div ui-view='foo'></div> which was created in a view owned by the state bar.baz

views: {
  'foo@bar.baz': {...}
}

Absolute addressing

You can address a ui-view absolutely, using dotted notation, by prefixing the address with a !. Dotted addresses traverse the hierarchy of ui-views active in the DOM:

Example:

absolutely targets the <div ui-view='nested'></div> ... which was created in the unnamed/$default root <ui-view></ui-view>

views: {
  '!$default.nested': {...}
}

Relative addressing

Absolute addressing is actually relative addressing, anchored to the unnamed root state (""). You can also use relative addressing anchored to any state, in order to target a target deeply nested ui-views: The ui-view is targeted relative to the anchored state by traversing the nested ui-view names.

Example:

targets the <div ui-view='bar'></div> ... which was created inside the <div ui-view='foo'></div> ... which was created inside the parent state's template.

views: {
  'foo.bar': {...}
}

Example:

targets the <div ui-view='bar'></div> ... which was created in <div ui-view='foo'></div> ... which was created in a template from the state baz.qux

views: {
  'foo.bar@baz.qux': {...}
}

Example:

a view can relatively target a named ui-view defined on an ancestor using ^ (meaning "parent")

views: {
  'foo@^': {...}, // foo@(parent state) (same as simply 'foo')
  'bar@^.^': {...}, // bar@(grandparent state)
  'baz@^.^.^': {...}, // baz@(great-grandparent state)
}

For additional in-depth details about how ui-view addressing works, see the internal api [[ViewService.match]].


State template+controller and views: incompatiblity

If a state has a views object, any state-level view properties (Ng1ViewDeclaration) are ignored. Therefore, if any view for a state is declared in the views object, then all of the state's views must be defined in the views object. The state declaration must not have any of the following fields:

  • component
  • bindings
  • resolveAs
  • template
  • templateUrl
  • templateProvider
  • controller
  • controllerAs
  • controllerProvider

Type declaration

Generated using TypeDoc