Documentation suggestion: clearly state how scope works in Svelte HTML files

[sveltejs]

Documentation suggestion: clearly state how scope works in Svelte HTML files

[Rich-Harris]

This is all excellent feedback, thanks. Will work more on the docs when I can, but briefly:

• Properties of data and computed can be used in mustache tags and as arguments to event handlers. The same goes for helpers, which is really just an extension of data (but I've found a lot of people get weirded out by having functions in an object called 'data')
• methods are added to the component's prototype – i.e. if you have a foo method than you will be able to do component.foo(...) in your app. You can also call methods (built-in or custom) inside event handlers in your template – in an on:somevent='foo(bar)' directive, foo(...) must be a method, bar must be a property of data or computed
• Inside a method, this is always the component
• In the event handler itself, this is the node – so <input on:input='log(this.value)'> means 'call the log method with the value of the the <input>'. Demo: https://svelte.technology/repl/?gist=b709873e61bbf7fed5d84ab0ca14ea86
• Name collisions will cause a compile time error – the compiler is strict, it won't let you make that sort of mistake

Hope this sheds some light!

[Conduitry]

Scope is a bit simpler in v3, and I think adequately covered in the documentation. Closing.