Version 0.16.0 (#2106)

* snapshot

* words

* word update

Author: willmcgugan

CHANGELOG.md

@@ -5,7 +5,7 @@ All notable changes to this project will be documented in this file.
 The format is based on [Keep a Changelog](http://keepachangelog.com/)
 and this project adheres to [Semantic Versioning](http://semver.org/).
 
-## Unreleased
+## [0.16.0] - 2023-03-22
 
 ### Added
 - Added `parser_factory` argument to `Markdown` and `MarkdownViewer` constructors https://github.com/Textualize/textual/pull/2075
@@ -629,6 +629,7 @@ https://textual.textualize.io/blog/2022/11/08/version-040/#version-040
 - New handler system for messages that doesn't require inheritance
 - Improved traceback handling
 
+[0.16.0]: https://github.com/Textualize/textual/compare/v0.15.1...v0.16.0
 [0.15.1]: https://github.com/Textualize/textual/compare/v0.15.0...v0.15.1
 [0.15.0]: https://github.com/Textualize/textual/compare/v0.14.0...v0.15.0
 [0.14.0]: https://github.com/Textualize/textual/compare/v0.13.0...v0.14.0

docs/blog/images/border-title.svg

@@ -0,0 +1,66 @@
+---
+draft: false
+date: 2023-03-22
+categories:
+  - Release
+title: "Textual 0.16.0 adds TabbedContent and border titles"
+authors:
+  - willmcgugan
+---
+
+# Textual 0.16.0 adds TabbedContent and border titles
+
+Textual 0.16.0 lands 9 days after the previous release. We have some new features to show you.
+
+<!-- more -->
+
+There are two highlights in this release. In no particular order, the first is [TabbedContent](../../widgets/tabbed_content.md) which uses a row of *tabs* to navigate content. You will have likely encountered this UI in the desktop and web. I think in Windows they are known as "Tabbed Dialogs".
+
+This widget combines existing [Tabs](../../widgets/tabs.md) and [ContentSwitcher](../../api/content_switcher.md) widgets and adds an expressive interface for composing. Here's a trivial example to use content tabs to navigate a set of three markdown documents:
+
+```python
+def compose(self) -> ComposeResult:
+    with TabbedContent("Leto", "Jessica", "Paul"):
+        yield Markdown(LETO)
+        yield Markdown(JESSICA)
+        yield Markdown(PAUL)
+```
+
+Here's an example of the UI you can create with this widget (note the nesting)!
+
+```{.textual path="docs/examples/widgets/tabbed_content.py" press="j"}
+```
+
+
+## Border titles
+
+The second highlight is a frequently requests feature (FRF?). Widgets now have the two new string properties, `border_title` and `border_subtitle`, which will be displayed within the widget's border.
+
+You can set the alignment of these titles via [`border-title-align`](../../styles/border_title_align.md) and [`border-subtitle-align`](../../styles/border_subtitle_align.md). Titles may contain [Console Markup](https://rich.readthedocs.io/en/latest/markup.html), so you can add additional color and style to the labels.
+
+Here's an example of a widget with a title:
+
+<div>
+--8<-- "docs/blog/images/border-title.svg"
+</div>
+
+BTW the above is a command you can run to see the various border styles you can apply to widgets.
+
+```
+textual borders
+```
+
+## Container changes
+
+!!! warning "Breaking change"
+
+    If you have an app that uses any container classes, you should read this section.
+
+We've made a change to containers in this release. Previously all containers had *auto* scrollbars, which means that any container would scroll if its children didn't fit. With nested layouts, it could be tricky to understand exactly which containers were scrolling. In 0.16.0 we split containers in to scrolling and non-scrolling versions. So `Horizontal` will now *not* scroll by default, but `HorizontalScroll` will have automatic scrollbars.
+
+
+## What else?
+
+As always, see the [release notes](https://github.com/Textualize/textual/releases/tag/v0.16.0) for the full details on this update.
+
+If you want to talk about this update or anything else Textual related, join us on our [Discord server](https://discord.gg/Enf6Z3qhVr).

docs/blog/posts/release0-16-0.md

@@ -1,6 +1,6 @@
 # Border-subtitle-align
 
-The `border-subtitle-align` sets the horizontal alignment for the border subtitle.
+The `border-subtitle-align` rule sets the horizontal alignment for the border subtitle.
 
 ## Syntax
 

docs/styles/border_subtitle_align.md

@@ -1,6 +1,6 @@
 # Border-title-align
 
-The `border-title-align` sets the horizontal alignment for the border title.
+The `border-title-align` rule sets the horizontal alignment for the border title.
 
 ## Syntax
 

docs/styles/border_title_align.md

@@ -1,6 +1,6 @@
 [tool.poetry]
 name = "textual"
-version = "0.15.1"
+version = "0.16.0"
 homepage = "https://github.com/Textualize/textual"
 description = "Modern Text User Interface framework"
 authors = ["Will McGugan <[email protected]>"]

pyproject.toml

@@ -46,16 +46,19 @@ class BorderApp(App):
         height: auto;
         background: $panel;
         color: $text;
+        border-title-align: center;
     }
     """
 
     def compose(self):
         yield BorderButtons()
         self.text = Label(TEXT, id="text")
         self.text.shrink = True
+        self.text.border_title = "solid"
         yield self.text
 
     def on_button_pressed(self, event: Button.Pressed) -> None:
+        self.text.border_title = event.button.id
         self.text.styles.border = (
             event.button.id,
             self.stylesheet._variables["secondary"],