[TW5] New plugin: tobibeer/appear

[Tobias Beer]

Hi again,

I've decided to finally release tobibeer/appear with version 0.5.7:

http://tobibeer.github.io/tw5-plugins/#appear

As the title suggests, it makes things appear,

e.g. as popups, sliders or accordion style menus, even just inline text.

I designed and created it so as:

1. to have its inner content be the stuff that appears
2. to much simplify the popup mechanism for the end user
   
3. to also cater for sliders all the way to accordion-style-menus
   
4. to, under the hood, use basic core widgets (button and reveal) that yield the desired functionality
• however, without a need for you to fiddle with all the glue that makes them work as either popups or sliders
  
5. to fix the problem that arises with the current ways of the core of always expecting the popup reveal to immediately follow the button that triggers it
• which results in popups being cut off, e.g. at the edge of a table cell in tables, or the edge in a column in column layouts
• now you can avoid this by using the handler mechanism which takes the reveal out of the flow and puts it into a global placeholder
6. to allow you to specify states in the simplest way possible
• no more $:/state/foo/bar/baz, possibly constructed via intermediary helper macros
• unless you really want that, in which case you can have it

Best wishes,

Tobias.

[Matabele]

Hi Tobias

Looking good :-) 

regards

On Tuesday, 29 December 2015 12:24:29 UTC+2, Tobias Beer wrote:

Hi again,

I've decided to finally release tobibeer/appear with version 0.5.5:

[Felix Küppers]

Looks very nice @Tobias. Many thanks!

-Felix

On 12/29/2015 11:24 AM, Tobias Beer wrote:

Hi again,

I've decided to finally release tobibeer/appear with version 0.5.5:

http://tobibeer.github.io/tw5-plugins/#appear

As the title suggests, it makes things appear,

e.g. as popups, sliders or accordion style menu, even just inline text.

I designed and created it so as:

1. to much simplify the popup mechanism for the end user
   
2. to also cater for sliders all the way to accordion-style-menus
   
3. to, under the hood, use basic core widgets (button and reveal) that yield the desired functionality
• however, without a need for you to fiddle with all the glue that makes them work as either popups or sliders
  
4. to fix the problem that arises with the current ways of the core of always expecting the popup reveal to immediately follow the button that triggers it

• which results in popups being cut off within things like tables at the edges of a table cell

• now you can avoid this by using the handler mechanism which takes the reveal out of the flow and puts it into a global placeholder

1. to allow you to specify states in the simplest way possible
• no more $:/state/foo/bar/baz, possibly constructed via intermediary helper macros
• unless you really want that, in which case you can have it

Best wishes,

Tobias.

--
You received this message because you are subscribed to the Google Groups "TiddlyWiki" group.
To unsubscribe from this group and stop receiving emails from it, send an email to tiddlywiki+...@googlegroups.com.
To post to this group, send email to tiddl...@googlegroups.com.
Visit this group at https://groups.google.com/group/tiddlywiki.
To view this discussion on the web visit https://groups.google.com/d/msgid/tiddlywiki/7b9856dc-1b6e-49f3-98ca-b8c9be055890%40googlegroups.com.
For more options, visit https://groups.google.com/d/optout.

[Mat]

That Tobi-dude is like a frickin' machine gun! Incredible! I'm totally lagging in testing all those wonderful creations!

<:-)

On Tuesday, December 29, 2015 at 11:24:29 AM UTC+1, Tobias Beer wrote:

Hi again,

I've decided to finally release tobibeer/appear with version 0.5.6:

http://tobibeer.github.io/tw5-plugins/#appear

As the title suggests, it makes things appear,

e.g. as popups, sliders or accordion style menu, even just inline text.

I designed and created it so as:

1. to have its inner content be the stuff that appears
2. to much simplify the popup mechanism for the end user
   
3. to also cater for sliders all the way to accordion-style-menus
   
4. to, under the hood, use basic core widgets (button and reveal) that yield the desired functionality
• however, without a need for you to fiddle with all the glue that makes them work as either popups or sliders
  
5. to fix the problem that arises with the current ways of the core of always expecting the popup reveal to immediately follow the button that triggers it

• which results in popups being cut off within things like tables at the edges of a table cell

• now you can avoid this by using the handler mechanism which takes the reveal out of the flow and puts it into a global placeholder

1. to allow you to specify states in the simplest way possible
• no more $:/state/foo/bar/baz, possibly constructed via intermediary helper macros
• unless you really want that, in which case you can have it

Best wishes,

Tobias.

[Tobias Beer]

Hi Matabele, Felix, Mat,

Many thanks for the positive feedback. Hope you find it useful.

One minor issue with having rudimentary docs stuffed into plugins is that

we (technically) need to publish a new release for fixing any typos or wrong markup in there.

That's why we're now at version 0.5.7 and no longer version 0.5.5 (as originally posted, but then edited over ;-).

Best wishes,

Tobias.

[Matabele]

Hi Tobias

Not all of the docs and examples need to be packed with the widget plugin -- only the reference doc. The remainder can be published on the widget wiki (as you  already do), where they may be referred to whilst users acquaint themselves with the widget. This will go some way to reducing the number of times you need to repack and re-publish the plugin itself.

regards

[Tobias Beer]

By the way,

should you come up with or implement some fancy use-cases

that are not already listed in the examples at:

http://tobibeer.github.io/tw5-plugins/#appear-Examples

...please post them here.

Best wishes,

Tobias.

[Felix Küppers]

Hi @Tobias
> One minor issue with having docs stuffed into plugins is that

> we (technically) need to publish a new release for fixing any typos or
> wrong markup in there.

I usually do not increase versions for typos as they do not make a
functional difference and are not a critical non-functional modification.

[Tobias Beer]

Hi Felix,

 

I usually do not increase versions for typos as they do not make a
functional difference and are not a critical non-functional modification.

I usually would do the same, but then some people may wish to compare hashes to find sources trustworthy.

So, this would create different hashes for what appears to be the same plugin version.

Best wishes,

Tobias. 

[Dave]

How would you make a regular slider type non-sticky like you can do with the pop-ups?

I tried this:

before <$appear keep="no"> slider content here </$appear>

... but that didn't work like this does

before <$appear type="popup" keep="no"> slider content here </$appear>

the functionality I'm looking for is like with the accordion example (except with the ability ot collapse when clicked outside the text block), but I don't want to have to separate the content into tiddlers - I just need to reveal single sentences or paragraphs in a column of two or three on a presentation, kind of like this:

*point one <$appear keep="no"> slider content here, bla bla bla bla
bla bla bla </$appear>
*point two <$appear keep="no"> slider content here, bla bla bla bla
bla bla bla bla bla bla bla bla bla bla </$appear>
*and thirdly <$appear keep="no"> slider content here, bla bla bla bla
bla bla blabla bla bla bla bla bla bla bla bla bla bla bla bla bla </$appear>

Thanks for making this!!  I like having the ability to do this without the big buttons that appear with the regular slider widget

[SteveSchneider DesignWriteX]

Hi Tobias,

Great plugin! I am using it to teach transclusion in my class about hypertext & tiddlywiki at bit.do/designwrite.

However, I'm finding that <<appear>> interferes with my sidebar: installing appear seems to cause tiddlers to behave incorrectly relative to sidebar. Any suggestions?

http://appear-sidebar-interaction.tiddlyspot.com/

Thanks!

//steve.

[Hegart Dmishiv]

Hi Tobias,

I've raised a GitHub issue in your repo about this, as well.

Hegart.