can/view/scope/doc/attr.md

MIT-licensed, client-side, JavaScript framework that makes building rich web applications easy.

@function can.view.Scope.attr attr
@parent can.view.Scope.prototype

@param {can.mustache.key} key A dot seperated path.  Use `"\."` if you have a
property name that includes a dot.

@return {*} The found value or undefined if no value is found.

@body

## Use

`scope.attr(key)` looks up a value in the current scope's
context, if a value is not found, parent scope's context
will be explored.

    var list = [{name: "Justin"},{name: "Brian"}],
        justin = list[0];

    var curScope = new can.view.Scope(list).add(justin);

    curScope.attr("name"); //-> "Justin"
    curScope.attr("length"); //-> 2

Prefixing a key with `"./"` prevents any parent scope look ups.
Prefixing a key with one or more `"../"` shifts the lookup path
that many levels up.

    var list = [{name: "Justin"},{name: "Brian"}];
    list.name = "Programmers";
    list.surname = "CanJS";

    var justin = list[0];
    var brian = list[1];
    var curScope = new can.view.Scope(list).add(justin).add(brian);

    curScope.attr("name"); //-> "Brian"
    curScope.attr("surname"); //-> "CanJS"
    curScope.attr("./surname"); //-> undefined
    curScope.attr("../name"); //-> "Justin"
    curScope.attr("../surname"); //-> "CanJS"
    curScope.attr(".././surname"); //-> "undefined"
    curScope.attr("../../name"); //-> "Programmers"