Polymer/old-docs-site

Properties outside the properties object

Open

#2,463 创建于 2018年2月6日

在 GitHub 查看
 (3 评论) (0 反应) (0 负责人)HTML (1,013 star) (2,482 fork)batch import
P3docsgood first issuequestion

描述

From @hadriann on February 5, 2018 17:31

Description

The usage of properties outside of the properties object is not documented. From the docs:

In most cases, a property that's part of your element's public API should be declared in the properties object.

It is implied that there are use cases when you need not declare a property in the properties object.

One such use case might be a component's private property (like a config), that is set by the component itself (not received via attributes), and passed down to one of its children.

There are a few questions regarding this:

  1. Is the above scenario (or any scenario) a valid use case for outside-the-properties properties?
  2. Will basic data binding work for such properties?
  3. Will computed data binding work?
  4. Will such a property be bound at the first render (ready) of the markup?
  5. What is the best practice (Polymer-way) to declare or use such private properties?

Copied from original issue: Polymer/polymer#5093

贡献者指南

技术栈
javascriptweb components
领域
documentation
议题类型
documentation
难度面向新贡献者的预计实现难度，1 表示很小改动，5 表示专家级工作。
3
预计时间有经验贡献者完成调查、实现、测试并准备 pull request 的粗略时间范围。
1-3 hours
活动状态议题当前的可参与程度：新鲜、活跃、陈旧、阻塞或等待维护者输入。
stale
清晰度议题是否清楚说明期望改动、验收标准和下一步。
clear
前置要求
Polymerweb components
新手友好度1-100 的估计分数，表示该议题对首次贡献者的友好程度。
50
研究方向
Investigate the Polymer documentation and source code to answer the five questions about properties declared outside the properties object. Since the repository 'old docs site' is deprecated and replaced by polymer project.org and polymer library docs, consider whether the issue should be migrated or closed. Provide a clear explanation with best practices for private properties in Polymer elements.