mirrors/TiddlyWiki5
1
0
Fork 0
mirror of https://github.com/Jermolene/TiddlyWiki5 synced 2024-11-23 18:17:20 +00:00
Code Issues Releases Wiki Activity

Docs: Minor formatting tweaks

Browse Source 
I was cloning this docs tiddler to experiment with docs for a new widget and noticed some punctuation inconsistencies
This commit is contained in:
jeremy@jermolene.com 2021-02-07 12:48:06 +00:00
parent 2b41661721
commit 40d21f607a
2 changed files with 21 additions and 19 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

4
editions/tw5.com/tiddlers/styleguide/Tiddler Structure.tid
View File

@ -1,5 +1,5 @@
created: 20150110183300000 created: 20150110183300000
modified: 20150117152556000 modified: 20210207124737959
title: Tiddler Structure title: Tiddler Structure
tags: [[Improving TiddlyWiki Documentation]] tags: [[Improving TiddlyWiki Documentation]]
@ -13,4 +13,6 @@ Use numbered lists for step-by-step instructions, and bullet points for lists wh
Use a table when information naturally falls into three or more columns, and also for lists of parameters, attributes, etc in [[reference tiddlers|Reference Tiddlers]]. Use a table when information naturally falls into three or more columns, and also for lists of parameters, attributes, etc in [[reference tiddlers|Reference Tiddlers]].
Avoid periods at the end of list items, headings and table cell text.
The documentation describes the current reality of ~TiddlyWiki. Avoid discussing future aspirations. The documentation describes the current reality of ~TiddlyWiki. Avoid discussing future aspirations.

12
editions/tw5.com/tiddlers/widgets/EventCatcherWidget.tid
View File

@ -14,9 +14,9 @@ The event catcher widget traps DOM-initiated Javascript events dispatched within
In order for the events to be trapped they must: In order for the events to be trapped they must:
* be of one of the events specified in the event catcher widget's `events` attribute. * be of one of the events specified in the event catcher widget's `events` attribute
* arise within a DOM node specified by the widget's `selector` attribute. * arise within a DOM node specified by the widget's `selector` attribute
* support event bubbling. * support event bubbling
Use of the event catcher widget is beneficial when using large numbers of other trigger widgets such as the ButtonWidget is causing performance problems. The workflow it enables is akin to what is referred to as "event delegation" in JavaScript parlance. Use of the event catcher widget is beneficial when using large numbers of other trigger widgets such as the ButtonWidget is causing performance problems. The workflow it enables is akin to what is referred to as "event delegation" in JavaScript parlance.
@ -25,11 +25,11 @@ Use of the event catcher widget is beneficial when using large numbers of other
The content of the `<$eventcatcher>` widget is displayed normally. The content of the `<$eventcatcher>` widget is displayed normally.
|!Attribute |!Description | |!Attribute |!Description |
|events |Space separated list of JavaScript events to be trapped, for example "click" or "click dblclick". | |events |Space separated list of JavaScript events to be trapped, for example "click" or "click dblclick" |
|selector |A CSS selector. Only events originating inside a DOM node with this selector will be trapped. | |selector |A CSS selector. Only events originating inside a DOM node with this selector will be trapped |
|actions-* |Action strings to be invoked when a matching event is trapped. Each event is mapped to an action attribute name of the form <code>actions-<em>event</em></code> where <code><em>event</em></code> represents the type of the event. For example: `actions-click` or `actions-dblclick` | |actions-* |Action strings to be invoked when a matching event is trapped. Each event is mapped to an action attribute name of the form <code>actions-<em>event</em></code> where <code><em>event</em></code> represents the type of the event. For example: `actions-click` or `actions-dblclick` |
|tag |Optional. The HTML element the widget creates to capture the events, defaults to:<br>» `span` when parsed in inline-mode<br>» `div` when parsed in block-mode | |tag |Optional. The HTML element the widget creates to capture the events, defaults to:<br>» `span` when parsed in inline-mode<br>» `div` when parsed in block-mode |
|class |Optional. A CSS class name (or names) to be assigned to the widget HTML element. | |class |Optional. A CSS class name (or names) to be assigned to the widget HTML element |
! Variables ! Variables