Commit Graph

1124 Commits

Author SHA1 Message Date
Dave Pearson
ac35c1d1d5 Document TreeNode via Tree itself
There's a couple of other types in the public interface of Tree that should
be teased out, and it feels odd to have one type in one file and a bunch of
others in another. So this sets us up for having them all the same place.
This should make it easier for the reader to find related information.
2023-03-01 13:21:45 +00:00
Dave Pearson
a837cd1d85 Ensure PlaceholderVariant gets included in the docs 2023-03-01 13:08:40 +00:00
Dave Pearson
87f216980d Add the Welcome widget to the documentation
While it's arguably not the most useful widget, it's in the code, exported,
and can be seen by people; I feel it should be in the documentation. I've
ensured that it also links to Placeholder given it sort of is a Placeholder
and so people might arrive at it first and it makes sense to redirect them
to something more comprehensive.
2023-03-01 10:39:30 +00:00
Dave Pearson
7101010fb0 Merge pull request #1906 from davep/question02-doc-tweak
Highlight that the label acquires an id in the example code
2023-03-01 09:43:05 +00:00
Dave Pearson
99d482491b A warning from the future
Add a warning to my first blog post, letting the attentive reader know that
`emit_no_wait` doesn't exist any more, and linking them to what they should
be using if they want to do their own custom messages.
2023-03-01 09:14:27 +00:00
Dave Pearson
f9e7c80256 Highlight that the label acquires an id in the example code
While the code here isn't exactly written as a play-along tutorial, it's
reasonable to expect that some one can and will. This commit has been
written because exactly that situation happened.

The problem here is without the ID on the label the layout will end up
looking very different from that shown in the docs; which will halt the
reader's flow as they try and figure out what they did wrong.

Counterpoint: this is a guide, not a tutorial, so it seemed reasonable to
only highlight the important thing that's changing. Personally I think I'd
argue in favour of highlighting all the changes from question01 to
question02.

Addresses #1905.
2023-03-01 09:05:07 +00:00
Dave Pearson
ce5b02522e Document AwaitRemove 2023-02-28 12:50:41 +00:00
Dave Pearson
8d2336a02e Increase the coverage of API documentation
See #1364 -- rather than pull in specific classes, this pulls in every
publicly-documented item (function, class, type, "constant", etc) that can
be found in each of the modules.

This should help improve the linkage of types within the documentation.
2023-02-28 12:27:22 +00:00
Dave Pearson
b5c028c36d Fix a docstring typo
Co-authored-by: Rodrigo Girão Serrão <5621605+rodrigogiraoserrao@users.noreply.github.com>
2023-02-27 13:35:33 +00:00
Dave Pearson
6d0fc0489f Rework the layout of the checkbox example
Time to start to show off the new compose method.
2023-02-27 09:11:18 +00:00
Dave Pearson
23c0587efb Rework the layout of the radio button example
Time to start to show off the new compose method.
2023-02-27 09:10:10 +00:00
Dave Pearson
f436489efa Rework the layout of the radio set example
Time to start to show off the new compose method.
2023-02-27 09:08:40 +00:00
Dave Pearson
e6e46d0825 Merge branch 'main' into toggle-boxen 2023-02-27 08:53:30 +00:00
Will McGugan
5b1cba1d85 update to copy 2023-02-26 12:31:50 +00:00
Will McGugan
bc620fd46f remove highlighted line 2023-02-26 12:24:39 +00:00
Will McGugan
da1a820565 highlight lines 2023-02-26 12:08:18 +00:00
Will McGugan
b23fbd9be8 words 2023-02-26 10:36:17 +00:00
Will McGugan
9c1f6f7fad Added docs for the new compose method 2023-02-26 10:34:30 +00:00
Will McGugan
461abc7fbe missing bracket 2023-02-24 17:19:55 +00:00
Will McGugan
01a4ed97e1 update blog 2023-02-24 17:12:29 +00:00
Will McGugan
e3976155fd Update docs/blog/posts/release0-12-0.md
Co-authored-by: Dave Pearson <davep@davep.org>
2023-02-24 17:12:14 +00:00
Will McGugan
8a5e5f29e0 Update docs/blog/posts/release0-12-0.md
Co-authored-by: Dave Pearson <davep@davep.org>
2023-02-24 17:12:04 +00:00
Will McGugan
661990f6e4 new blog post 2023-02-24 17:01:02 +00:00
Will McGugan
5f1ca95f8a Merge pull request #1866 from Textualize/prevent-event
Add a "prevent" context manager
2023-02-24 12:36:46 +00:00
Will McGugan
63438f170d Update docs/examples/events/prevent.py
Co-authored-by: Rodrigo Girão Serrão <5621605+rodrigogiraoserrao@users.noreply.github.com>
2023-02-24 12:02:56 +00:00
Will McGugan
217956bbdf Update docs/examples/events/prevent.py
Co-authored-by: Rodrigo Girão Serrão <5621605+rodrigogiraoserrao@users.noreply.github.com>
2023-02-24 12:02:46 +00:00
Will McGugan
0999114811 Update docs/guide/events.md
Co-authored-by: Rodrigo Girão Serrão <5621605+rodrigogiraoserrao@users.noreply.github.com>
2023-02-24 12:02:20 +00:00
Dave Pearson
f0a6771533 Update the ChangeLog and the roadmap 2023-02-23 22:14:41 +00:00
Will McGugan
b2ab5b6886 docs 2023-02-23 21:36:33 +00:00
Dave Pearson
307b1789a1 Give radio button its own example code now
Still within a RadioSet, but this time only the code that uses RadioSet; not
the code that just uses strings.
2023-02-23 16:00:14 +00:00
Dave Pearson
316faf9e45 Add width reference documentation for radio set 2023-02-23 15:31:32 +00:00
Dave Pearson
a821b2f8f6 Add width reference documentation for radio buttons
A large part of the code to go with this is to show off a radio set; I feel
it makes sense to use the same code for both bits of documentation given
that a radio button only really makes sense inside a radio set.
2023-02-23 15:14:25 +00:00
Dave Pearson
a3d50d90f6 Revert example code to composing the old way
We've not documented it yet so, until we do...
2023-02-23 15:09:45 +00:00
Dave Pearson
87bd610eec Swap the checkbox example to the newer compose approach 2023-02-23 14:45:24 +00:00
Will McGugan
da9e28d4d6 Add example 2023-02-23 14:41:44 +00:00
Will McGugan
dc4421e76a Merge pull request #1867 from davep/fix-switch-wording
Correct the wording of the description of `Switch.value`
2023-02-23 14:41:08 +00:00
Dave Pearson
01215a1fe8 Tweak the style of the box in the example for checkbox 2023-02-23 14:40:58 +00:00
Will McGugan
2ee61f95db Docs 2023-02-23 14:37:47 +00:00
Dave Pearson
4f75a395d8 Fix copy/paste-o in the checkbox reference 2023-02-23 14:35:24 +00:00
Dave Pearson
6738c5686c Correct the wording of the description of Switch.value
It's not just the default value, it's the ongoing value too and can be used
to change the switch.
2023-02-23 14:28:25 +00:00
Dave Pearson
3fd3d272ce Add the widget reference for Checkbox 2023-02-23 14:26:11 +00:00
Dave Pearson
f52aac4952 Initial work on adding toggle buttons to the documentation
This just gets the API docs into place, and tidies up some of the docstirngs.
2023-02-23 13:27:27 +00:00
Dave Pearson
a18685c9c8 Fix a copy/paste-o in the TextLog reference entry 2023-02-22 16:28:23 +00:00
Will McGugan
068d7513b8 Merge pull request #1823 from Textualize/optimize-scroll
Optimize scroll with a Spatial Map
2023-02-21 10:41:04 +00:00
Will McGugan
453070032e Merge pull request #1785 from davep/promote-disabled
Promote disabled to `Widget` level
2023-02-21 09:56:01 +00:00
Will McGugan
32a1b576a0 merged changelog 2023-02-17 12:37:53 +00:00
Will McGugan
11d10db1ab fast path for scrolling 2023-02-17 10:42:42 +00:00
Dave Pearson
c4b24babc8 Mark the Markdown viewer as done on the roadmap
Also add a couple of sub-items that are tended to be added.
2023-02-17 10:13:17 +00:00
Dave Pearson
ca1eede533 Merge branch 'main' into promote-disabled 2023-02-15 13:59:32 +00:00
Will McGugan
56b0214c6b fix blog 2023-02-15 11:55:41 +00:00