Commit graph

1021 commits

Author SHA1 Message Date
Will McGugan
6531901442 Added tip to post 2023-02-15 11:22:43 +00:00
Will McGugan
cee21cf87c version bump, post, added --screenshot options to console run 2023-02-15 11:05:45 +00:00
Dave Pearson
6ab9a424a2
Merge branch 'main' into promote-disabled 2023-02-15 10:14:21 +00:00
Will McGugan
0dac83668b
Merge pull request #1791 from Textualize/textual-markdown
Textual markdown
2023-02-15 09:23:19 +00:00
Dave Pearson
ba9b2e03d9
Merge branch 'main' into promote-disabled 2023-02-15 08:47:20 +00:00
Will McGugan
08c3a7214e No, I repeat, no abbreviations 2023-02-14 17:28:24 +00:00
Will McGugan
df1edb087c
Merge pull request #1788 from Textualize/datatable-select-headers
DataTable - Message emitted when header selected
2023-02-14 16:42:01 +00:00
Darren Burns
36a9214d7f
Update reactive names in DataTable reference docs 2023-02-14 15:29:05 +00:00
Will McGugan
71d0017ef9 docs and refactor 2023-02-14 15:22:15 +00:00
Darren Burns
49b78daa04
Update docs to include DataTable.HeaderSelected 2023-02-14 15:18:32 +00:00
Dave Pearson
bff4334c5a
Merge branch 'main' into promote-disabled 2023-02-14 10:31:36 +00:00
darrenburns
27503b15bf
Merge branch 'main' into datatable-cell-keys 2023-02-14 10:27:24 +00:00
Will McGugan
6f1abe849f fix reference 2023-02-13 17:30:53 +00:00
darrenburns
bd73b1b007
Merge branch 'main' into datatable-cell-keys 2023-02-13 16:02:37 +00:00
Dave Pearson
257fe7b30a
Add enabled and disabled pseudo-classes
Note that this doesn't touch the application of stylesheets yet, in terms of
things like specificity; this just makes sure that the classes exist and can
be seen.
2023-02-13 12:56:52 +00:00
Will McGugan
555cf8e6ee comma 2023-02-13 09:29:04 +00:00
Will McGugan
933138b3a6 fix link 2023-02-11 20:15:23 +00:00
Will McGugan
a28c970506 Wrong link 2023-02-11 17:41:48 +00:00
Will McGugan
48a4c7cb68 reverse words 2023-02-11 17:25:22 +00:00
Will McGugan
e880f27329 no comma 2023-02-11 17:21:47 +00:00
Will McGugan
93746b75a1 edit 2023-02-11 17:20:08 +00:00
Will McGugan
6004d7c731 typo 2023-02-11 17:16:01 +00:00
Will McGugan
1540f120cc words, non draft 2023-02-11 17:15:35 +00:00
Will McGugan
05042725cd words 2023-02-11 17:11:38 +00:00
Will McGugan
f5723f933e new blogpost 2023-02-11 17:08:21 +00:00
Will McGugan
a37e7fcb2b fix modal example 2023-02-11 15:37:24 +00:00
Dave Pearson
0b9107abfc
Merge branch 'main' into switch-redux 2023-02-09 16:09:56 +00:00
Darren Burns
f4cd51e5e8
Merge branch 'main' of github.com:Textualize/textual into datatable-cell-keys 2023-02-09 15:55:45 +00:00
Dave Pearson
584df4530c
Merge branch 'main' into package-docs 2023-02-09 15:49:56 +00:00
Dave Pearson
1956f7f9d7
Rename the switch--switch component class to switch--slider
Following on from #1751: originally Switch was called Checkbox and the
moving part was, for the component class, called a checkbox--switch; after
renaming the widget to Switch that component class ended up being
switch--switch; which wasn't ideal.

We decided to go with it as-is, but I just realised that internally the code
calls it a slider. So this leans into that and I'm renaming the component
class switch--slider. This removes the doubling-up of the name and also
makes the code more consistent.
2023-02-09 15:36:04 +00:00
Dave Pearson
decc1e2f3c
Rename Checkbox to Switch
A new form of Checkbox will be arriving in Textual soon, working in
conjunction with a RadioButton. What was called Checkbox is perhaps a wee
bit heavyweight in terms of visual design, but is a style of widget that
should remain.

With this in mind we're renaming the current Checkbox to Switch. In all
other respects its workings remains the same, only the name has changed.

Things for people to watch out for:

- Imports will need to be updated.
- Queries will need to be updated; special attention will need to be paid to
  any queries that are string-based.
- CSS will need to be changed if any Checkbox styling is happening, or if
  any Checkbox component styles are being used.

See #1725 as the initial motivation and #1746 as the issue for this
particular change.
2023-02-09 11:10:30 +00:00
Darren Burns
c9398d87cf Merge branch 'main' of github.com:willmcgugan/textual into datatable-cell-keys 2023-02-08 14:22:43 +00:00
Dave Pearson
8d905b753d
Revert retrofitting of example code in an old blog post
Makes sense to update all the docs to reflect the work done in #1738 but I
feel it doesn't quite make sense to retrofit this into an old blog post --
especially if the code it is referring to was like that at the time and
likely still will be for a wee while after this gets republished.
2023-02-08 13:39:24 +00:00
Darren Burns
20b8782a5d Unit tests for DataTable reverse sort 2023-02-08 12:54:15 +00:00
Dave Pearson
ddb2579168
Merge branch 'main' into package-docs 2023-02-08 11:40:15 +00:00
Will McGugan
1b050ea8b7
Merge pull request #1738 from Textualize/emit-start-with-self
Change emit to post to self.
2023-02-08 11:37:43 +00:00
Rodrigo Girão Serrão
c39b23f78d Final fixes. 2023-02-08 11:26:27 +00:00
Rodrigo Girão Serrão
e5e7c08afe Update docs accordingly. 2023-02-08 10:53:51 +00:00
Dave Pearson
86e1997b30
Merge branch 'main' into package-docs 2023-02-08 10:40:20 +00:00
Darren Burns
0721d7fc87 Snapshot test for sorting 2023-02-08 10:39:04 +00:00
Will McGugan
29875a66fc into [skip ci] 2023-02-08 10:31:35 +00:00
Will McGugan
aabc1cc898 fix typo [skip ci] 2023-02-08 10:20:47 +00:00
Will McGugan
0a4d1c919d updated widgets docs 2023-02-07 18:10:01 +00:00
Darren Burns
802ea63ddb
Default cell formatter fixes 2023-02-07 15:09:21 +00:00
Dave Pearson
aece00e1dc
Remove the keystrokes from the dictionary example in events guide
As well as not being necessary for the example, it also had the problem of
not actually having the input in focus (there was no press of 'tab' to kick
things off) and so the other keys didn't go into the `Input` as they were
supposed to.
2023-02-06 16:06:50 +00:00
Dave Pearson
4e4353b2ce
Remove the dictionary example from the front page of the docs
Sometimes, when building the docs, this would end up being a bit of an
"empty" example in that the time taken to get the result back from the API
would be so long that the output would be of the request just in progress.

So we've decided to drop this from the front page.
2023-02-06 16:04:52 +00:00
Will McGugan
fb7fd14262
Merge pull request #1710 from Textualize/line-api-docs
Documented the Line API
2023-02-06 11:42:57 +00:00
Will McGugan
f8577f79d7 review fixes 2023-02-06 11:34:37 +00:00
Will McGugan
b12c5e1cdf typo 2023-02-05 12:12:27 +01:00
Will McGugan
738837fd66 review update 2023-02-05 12:06:48 +01:00
Will McGugan
f56823a733 better diagram 2023-02-04 17:47:49 +01:00
Will McGugan
e81ac17c6c revised copy 2023-02-04 17:35:09 +01:00
Will McGugan
a05398378f diagram tweak 2023-02-04 16:24:40 +01:00
Will McGugan
dc1fce3da7 svg update 2023-02-04 16:13:42 +01:00
Will McGugan
fb7c1642bc Checker example 4, docs and diagram 2023-02-04 15:40:36 +01:00
Will McGugan
25b498896d checker 4 and diagram 2023-02-04 11:28:07 +01:00
Will McGugan
a5808db8b8 more docs and diagrams 2023-02-03 19:10:03 +01:00
Will McGugan
2ff278874b docs examples and diagrams 2023-02-03 11:23:14 +01:00
Will McGugan
8ce76f4f89 fix title update 2023-02-01 18:01:34 +01:00
Will McGugan
087654a246
Update docs/guide/app.md
Co-authored-by: Rodrigo Girão Serrão <5621605+rodrigogiraoserrao@users.noreply.github.com>
2023-02-01 17:49:33 +01:00
Will McGugan
340f7c53bc
Update docs/guide/app.md
Co-authored-by: Rodrigo Girão Serrão <5621605+rodrigogiraoserrao@users.noreply.github.com>
2023-02-01 17:49:05 +01:00
Will McGugan
259c1cc14e tip to info 2023-02-01 17:43:29 +01:00
Will McGugan
c04e387dfe title copy 2023-02-01 17:38:19 +01:00
Will McGugan
806c80b8fe simplify 2023-02-01 17:14:53 +01:00
Will McGugan
0a5838d964 checker example 2023-02-01 16:26:55 +01:00
Rodrigo Girão Serrão
faa2ee68d7
Merge pull request #1706 from Textualize/document-sub-title
Document setting (sub) title in the app guide
2023-02-01 15:08:43 +00:00
Rodrigo Girão Serrão
2140aa52d2
Update docs/guide/app.md 2023-02-01 14:53:20 +00:00
Rodrigo Girão Serrão
476eca7a6e Shuffle sections around. 2023-02-01 11:30:56 +00:00
David Brochart
d1790caff7 Fix typo 2023-02-01 12:25:00 +01:00
Rodrigo Girão Serrão
521e90488c Add context about (sub)title. 2023-02-01 11:08:13 +00:00
Rodrigo Girão Serrão
828d8d2cf1 Replace Static with Label. 2023-01-31 17:31:36 +00:00
Rodrigo Girão Serrão
c14f635244 Document setting app (sub)title. 2023-01-31 17:31:06 +00:00
Rodrigo Girão Serrão
bc729033c8 Merge branch 'main' into doc-improvements 2023-01-26 13:55:34 +00:00
Rodrigo Girão Serrão
b37517c400 Add all messages to widget references. 2023-01-26 11:53:51 +00:00
Will McGugan
211280e0be Fixed wording of tree node docs 2023-01-26 12:37:57 +01:00
Will McGugan
d01c8a7e07 more superfluous words 2023-01-26 12:34:10 +01:00
Will McGugan
56ef37637b superfluous words 2023-01-26 12:31:45 +01:00
Will McGugan
15f116d160 moved link 2023-01-26 12:25:43 +01:00
Will McGugan
dc5041f1e1 update to intro page, fix for API docs 2023-01-26 12:21:49 +01:00
Rodrigo Girão Serrão
210e39488f Add template for widget reference. 2023-01-26 10:56:32 +00:00
Rodrigo Girão Serrão
ef779d71dd Add bindings and component classes to reference pages. 2023-01-25 15:19:16 +00:00
Rodrigo Girão Serrão
fcba6ecaad Omit default values for attributes.
We copy the mkdocstrings template for attributes so that we can exclude the (default) value for attributes (and class variables) from the documentation as that is generally useless.
2023-01-25 11:41:05 +00:00
Dave Pearson
faac89fd8d
Remove mention of ChildrenUpdated from the ListView docs
As pointed out in #1649, a `ChildrenUpdated` message is documented but it
doesn't exist in the code. It looks like it got added during development,
then removed after it was realised it wasn't needed, but presumably it got
left in the docs:

  https://github.com/Textualize/textual/pull/1143#discussion_r1030409026
2023-01-24 07:47:18 +00:00
Will McGugan
c214ca3697
Merge pull request #1598 from davep/pcent-text-update
Seek to improve the explanation of what a percentage does
2023-01-18 02:14:58 -08:00
Dave Pearson
05b3ab6c78
Refine the explanation of percentage
Co-authored-by: Will McGugan <willmcgugan@gmail.com>
2023-01-18 10:05:40 +00:00
Will McGugan
5fad4ad36c
Merge branch 'main' into datatable-events 2023-01-18 01:46:21 -08:00
Will McGugan
c87711ca0d
Merge pull request #1551 from Textualize/fix-1420
Raise clearer exception when `none` is in a space-separated list of text styles.
2023-01-17 10:05:27 -08:00
Dave Pearson
330950e6b0
Seek to improve the explanation of what a percentage does
I've seen a couple or so folk get confused about what a percentage value for
a dimension means, often seeming to think it means that percentage of
the *remaining* space within a container as opposed to a percentage of the
space in the container (note total space, not remaining space).

I'm not sure the wording here is the final form we want (there's more
mention of "dimension" here than your average Star Trek or Doctor Who
episode!), but I think it's narrowing in on it.

Making this change to place-hold the need to improve this and perhaps gather
some input to find the best final wording.
2023-01-17 16:33:30 +00:00
Darren Burns
be45db4573
Use autodoc for DataTable Messages reference 2023-01-17 13:00:01 +00:00
Darren Burns
23eb13d12d
Some DataTable doc updates, rename Coord -> Coordinate and extract to module 2023-01-17 11:06:21 +00:00
Darren Burns
f327f1d2af
Small datatable docs rewording 2023-01-17 10:11:19 +00:00
Darren Burns
9bc93cd683
Small datatable docs rewording 2023-01-17 10:06:39 +00:00
Darren Burns
65223be8be
Merge branch 'main' of github.com:Textualize/textual into datatable-events 2023-01-16 11:00:10 +00:00
Darren Burns
2814e1f93c
Documentation updates 2023-01-16 10:50:41 +00:00
Will McGugan
027635b978 merge 2023-01-12 17:45:36 +00:00
Rodrigo Girão Serrão
036c3e8651 Update documentation. 2023-01-12 14:42:04 +00:00
Will McGugan
1c4fe0c4fb added text re navigation 2023-01-10 18:18:59 +00:00
Will McGugan
e4cef274b1 tweak 2023-01-10 18:18:59 +00:00
Will McGugan
809e7c9d08
Merge pull request #1537 from Textualize/fix-docs-api
Minor doc fixes.
2023-01-10 08:15:44 -08:00
Will McGugan
43915b9415 update to introduction 2023-01-10 16:07:33 +00:00
Rodrigo Girão Serrão
e1d36e5be8 Minor doc fixes. 2023-01-10 14:45:37 +00:00
Rodrigo Girão Serrão
0f3aff6fb1
Merge pull request #1408 from Textualize/review-styles-reference
Review styles reference
2023-01-10 14:20:11 +00:00
Ofek Lev
9b779c130d
Fix typo 2023-01-10 01:42:16 -05:00
Rodrigo Girão Serrão
d41471034a Fix failing tests. 2023-01-09 16:39:12 +00:00
Rodrigo Girão Serrão
130d8b8d05 Increase negative y offset. 2023-01-09 16:34:24 +00:00
Rodrigo Girão Serrão
15691b4451 Remove debugging style. 2023-01-09 16:34:06 +00:00
Rodrigo Girão Serrão
5cad93220e Merge branch 'main' into review-styles-reference 2023-01-09 16:19:24 +00:00
Rodrigo Girão Serrão
a3a452b674 Highlight rule usage in references.
[skip ci]
2023-01-09 16:14:11 +00:00
Rodrigo Girão Serrão
a1b9d4b2c5 Fix examples. 2023-01-09 16:11:45 +00:00
Rodrigo Girão Serrão
2827edcd49 Add example with all padding types. 2023-01-09 15:43:34 +00:00
Rodrigo Girão Serrão
e81779f97c Add 'See also' sections to references. 2023-01-09 15:25:47 +00:00
Rodrigo Girão Serrão
8bf211b898 Fix typo. 2023-01-09 14:14:14 +00:00
Rodrigo Girão Serrão
1300807b3a Put example outputs in first tab. 2023-01-09 13:57:04 +00:00
Rodrigo Girão Serrão
e7afcbc0b5 Add reference to 'textual borders' command. 2023-01-09 13:52:02 +00:00
Rodrigo Girão Serrão
dd6e73aa39 Add subsections for references with 2+ examples. 2023-01-09 13:50:45 +00:00
Rodrigo Girão Serrão
71b859b6e2 Add thorough example for all outlines. 2023-01-09 13:49:32 +00:00
Rodrigo Girão Serrão
da9a481f1c Remove inclusion of old css types snippets.
Supposedly, this had been done in an earlier commit for all styles. Apparently, I forgot to open styles references that were one level deeper in the directory, so the pages about grid, links, and scrollbar colors still included the css types values directly in their reference pages.
2023-01-09 11:28:47 +00:00
Rodrigo Girão Serrão
196d430582 Style all Textual CSS as 'sass'
Textual CSS is better highlighted in SASS code blocks because the SASS parser seems to be more lenient.
2023-01-09 11:20:04 +00:00
Rodrigo Girão Serrão
40cbbc31b8 Add note about viewport size.
[skip ci]
2023-01-09 10:54:04 +00:00
Rodrigo Girão Serrão
1ef20eb4ec Improve CSS type color reference.
[skip ci]
2023-01-09 10:29:47 +00:00
Dave Pearson
0a190193d7
Link to GitHub and Discord early on
For the benefit of those who aren't there yet.
2023-01-09 10:16:52 +00:00
Dave Pearson
bd9d88fa4f
Fix a typo 2023-01-09 10:10:29 +00:00
Rodrigo Girão Serrão
81ddae7933 Use specific rules in CSS type examples.
[skip ci]
2023-01-09 09:32:27 +00:00
Dave Pearson
a1b4d53fb9
Update date
This hasn't been accepted/published yet so let's update the date.
2023-01-09 08:51:00 +00:00
Dave Pearson
01ad0df17f
Final tweaks to the "asking for help" blog post
It's not finished, it never will be, but it's good to go.
2023-01-08 21:10:50 +00:00
Dave Pearson
e12d1f8bbb
Fleshing out the post a wee bit more
Needs whittling and rounding and stuff, perhaps, but I think I'm mostly
there. A post-dinner top-to-bottom read is in now in order before I finally
decide if I like it or not.
2023-01-08 17:51:32 +00:00
Dave Pearson
a3601cf0be
Fix blog typo
The second of many, I'm sure.
2023-01-07 22:52:16 +00:00
Dave Pearson
a242d4b6c5
Fix blog typo
The first of many, I'm sure.
2023-01-07 22:50:35 +00:00
Dave Pearson
90d38cd0da
WIP: devlog blog post about looking for help with Textual
Work in progress. First rough draft of ideas, committing and pushing to
remote as backup for the night.
2023-01-07 22:45:38 +00:00
Rodrigo Girão Serrão
c0d7f7cebf Add note about Textual limitation. 2023-01-07 09:47:56 +00:00
Rodrigo Girão Serrão
aad41b8de0 Fix height example.
[skip ci]
2023-01-07 09:44:39 +00:00
Rodrigo Girão Serrão
08baaf11f3 Refactor width reference. 2023-01-07 09:40:32 +00:00
Rodrigo Girão Serrão
8de6d8fd69 Add new width comparison example. 2023-01-07 09:40:03 +00:00
Dave Pearson
779b10a0e8
Merge pull request #1314 from davep/refresh-community
Refresh community
2023-01-07 09:37:11 +00:00
Darren Burns
ad6a716d09 Fix mouse01 example background transparency 2023-01-07 09:35:00 +00:00
Rodrigo Girão Serrão
2867b09923 Update visibility reference. 2023-01-06 16:38:49 +00:00
Rodrigo Girão Serrão
2217a8f5fa Add new visibility example.
This new example shows how we can have an invisible container with visible children.
2023-01-06 16:38:31 +00:00
Rodrigo Girão Serrão
d69168a922 Update visibility example to use labels. 2023-01-06 16:37:41 +00:00
Rodrigo Girão Serrão
498f452b88 Update tint reference. 2023-01-06 14:53:18 +00:00
Rodrigo Girão Serrão
ee4b2cfe9e Update tint example to use labels. 2023-01-06 14:53:07 +00:00
Rodrigo Girão Serrão
69a143442c Inline css type values in their reference.
[skip ci]
2023-01-06 14:50:31 +00:00
Rodrigo Girão Serrão
42baa0e074 Remove redundant values subsections.
[skip ci]
2023-01-06 14:41:13 +00:00
Darren Burns
387a045cff
Fix mouse01 example background transparency 2023-01-06 14:32:23 +00:00
Rodrigo Girão Serrão
583b1273ac Update text style reference.
[skip ci]
2023-01-06 14:18:50 +00:00
Rodrigo Girão Serrão
72d3171a79 Add example with all text styles. 2023-01-06 14:18:21 +00:00
Rodrigo Girão Serrão
1276629431 Update example. 2023-01-06 14:18:07 +00:00
Rodrigo Girão Serrão
c7c352a38a Replace statics with labels.
[skip ci]
2023-01-06 10:56:55 +00:00
Rodrigo Girão Serrão
a25ba1bea4 Update *opacity references. 2023-01-06 10:47:31 +00:00
Rodrigo Girão Serrão
042bc3b3fe Improve text-align example.
Replace statics with labels; change to a 2 x 2 grid layout to make it easier to see the difference between 'center' and 'justify'; increase readability by setting 'color: auto' in the labels.
2023-01-06 10:41:46 +00:00
Rodrigo Girão Serrão
7743feadff Add GIF to show all scrollbar colors. 2023-01-06 10:28:54 +00:00