Skip to content

Commit 9c78b48

Browse files
committed
Add setters to settings titles.
1 parent c181c3d commit 9c78b48

File tree

1 file changed

+7
-7
lines changed

1 file changed

+7
-7
lines changed

CHANGELOG.md

+7-7
Original file line numberDiff line numberDiff line change
@@ -12,7 +12,7 @@ If your application is uses pre-built Shady CSS styles and your browser supports
1212

1313
This update to Polymer includes some new [global settings](https://polymer-library.polymer-project.org/3.0/docs/devguide/settings):
1414

15-
- `legacyUndefined`
15+
- `legacyUndefined` / `setLegacyUndefined`
1616

1717
**What does it do?** This setting reverts how computed properties handle `undefined` values to the Polymer 1 behavior: when enabled, computed properties will only be recomputed if none of their dependencies are `undefined`.
1818

@@ -31,7 +31,7 @@ This update to Polymer includes some new [global settings](https://polymer-libra
3131

3232
**Should I use it?** This setting should only be used for migrating legacy codebases that depend on this behavior and is otherwise **not recommended**.
3333

34-
- `legacyWarnings`
34+
- `legacyWarnings` / `setLegacyWarnings`
3535

3636
**What does it do?** This setting causes Polymer to warn if a component's template contains bindings to properties that are not listed in that element's [`properties` block](https://polymer-library.polymer-project.org/3.0/docs/devguide/properties). For example:
3737

@@ -55,7 +55,7 @@ This update to Polymer includes some new [global settings](https://polymer-libra
5555

5656
**Should I use it?** Consider using this feature during development but don't enable it in production.
5757

58-
- `orderedComputed`
58+
- `orderedComputed` / `setOrderedComputed`
5959

6060
**What does it do?** This setting causes Polymer to topologically sort each component's computed properties graph when the class is initialized and uses that order whenever computed properties are run.
6161

@@ -99,7 +99,7 @@ This update to Polymer includes some new [global settings](https://polymer-libra
9999

100100
**Should I use it?** The value of this setting depends on how your computed property functions are implemented. If they are pure and relatively inexpensive, you shouldn't need to enable this feature. If they have side effects that would make the order in which they are run important or are expensive enough that it would be a problem to run them multiple times for a property update, consider enabling it.
101101

102-
- `fastDomIf`
102+
- `fastDomIf` / `setFastDomIf`
103103

104104
**What does it do?** This setting enables a different implementation of `<dom-if>` that uses its host element's template stamping facilities (provided as part of `PolymerElement`) rather than including its own. This setting can help with performance but comes with a few caveats:
105105

@@ -109,13 +109,13 @@ This update to Polymer includes some new [global settings](https://polymer-libra
109109

110110
**Should I use it?** This setting is recommended as long as your app doesn't use `<dom-if>` as described in the section above.
111111

112-
- `removeNestedTemplates`
112+
- `removeNestedTemplates` / `setRemoveNestedTemplates`
113113

114114
**What does it do?** This setting causes Polymer to remove the child `<template>` elements used by `<dom-if>` and `<dom-repeat>` from the their containing templates. This can improve the performance of cloning your component's template when new instances are created.
115115

116116
**Should I use it?** This setting is generally recommended.
117117

118-
- `suppressTemplateNotifications`
118+
- `suppressTemplateNotifications` / `setSuppressTemplateNotifications`
119119

120120
**What does it do?** This setting causes `<dom-if>` and `<dom-repeat>` not to dispatch `dom-change` events when their rendered content is updated. If you're using lots of `<dom-if>` and `<dom-repeat>` but not listening for these events, this setting lets you disable them and their associated propagation work.
121121

@@ -157,7 +157,7 @@ This update to Polymer includes some new [global settings](https://polymer-libra
157157

158158
**Should I use it?** This setting is generally recommended.
159159

160-
- `legacyNoObservedAttributes`
160+
- `legacyNoObservedAttributes` / `setLegacyNoObservedAttributes`
161161

162162
**What does it do?** This setting causes `LegacyElementMixin` not to use the browser's built-in mechanism for informing elements of attribute changes (i.e. `observedAttributes` and `attributeChangedCallback`), which lets Polymer skip computing the list of attributes it tells the browser to observe. Instead, `LegacyElementMixin` simulates this behavior by overriding attribute APIs on the element and calling `attributeChangedCallback` itself.
163163

0 commit comments

Comments
 (0)