Skip to content

TINYDOC-3570: Resizable sidebars documentation (TINYMCE-14486) - #4307

Open
kemister85 wants to merge 5 commits into
feature/8.9/TINYDOC-3570from
feature/8.9/TINYDOC-3570_TINYMCE-14528
Open

TINYDOC-3570: Resizable sidebars documentation (TINYMCE-14486)#4307
kemister85 wants to merge 5 commits into
feature/8.9/TINYDOC-3570from
feature/8.9/TINYDOC-3570_TINYMCE-14528

Conversation

@kemister85

@kemister85 kemister85 commented Aug 11, 2026

Copy link
Copy Markdown
Contributor

Ticket: TINYDOC-3570 — documentation for epic TINYMCE-14486 (Resizable sidebars)

Site: Staging

Covers TINYMCE-14527, TINYMCE-14528, TINYMCE-14529, TINYMCE-14530, TINYMCE-14678, and TINYMCE-14683.

Changes:

Release notesmodules/ROOT/pages/8.9.0-release-notes.adoc

Configuration optionsmodules/ROOT/partials/configuration/

  • Added sidebar_width.adoc, sidebar_min_width.adoc, and sidebar_max_width.adoc, included in customsidebar.adoc in alphabetical order alongside sidebar_show.

Sidebar documentationmodules/ROOT/pages/customsidebar.adoc

  • Added the resizable property to the addSidebar specification object.
  • Added a Resizable sidebars section covering resize behaviour, the content styling contract for opting in (before and after examples), and persisting the sidebar width across editor loads.

Eventsmodules/ROOT/pages/events.adoc

  • Added SidebarResizeStart and SidebarResized rows to Editor core events.

Pre-checks:

  • Branch is correctly prefixed (release-note branch)
  • Files have been included where required (if applicable).
  • Files added for New product features include a release note entry.
  • Build passes without console errors, warnings, or issues.

Review:

  • Documentation Team Lead has reviewed.

@kemister85 kemister85 added this to the TinyMCE 8.9.0 milestone Aug 11, 2026
@kemister85 kemister85 added the upcoming release Documentation for features currently under development/QA label Aug 11, 2026
@kemister85
kemister85 marked this pull request as ready for review August 12, 2026 00:15
@kemister85
kemister85 requested review from a team and soritaheng as code owners August 12, 2026 00:15
@kemister85
kemister85 requested review from MitchC1999, ShiridiGandham and tiny-ben-tran and removed request for a team August 12, 2026 00:15
@kemister85
kemister85 marked this pull request as draft August 12, 2026 01:21
@kemister85 kemister85 changed the title TINYDOC-3570: New options for configuring the width of resizable sidebars TINYDOC-3570: Resizable sidebars documentation (TINYMCE-14486) Aug 12, 2026
…availability

Adds the 8.9 requires-version admonition partial and links api.element() to
the sidebar API object reference.
@kemister85
kemister85 marked this pull request as ready for review August 12, 2026 05:09

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

TinyMCEAI plugin had a default sidebar width set to 440px, and after release of resizable sidebars 440px is the new default, so the sidebar is initially the same width.

TinyComments plugin had a default sidebar width set to 300px, and after release of resizable sidebars it's also 440px, so there's a change and TinyComments sidebar is not wider by default.

Should we mention that in the release notes for comments plugin?

include::partial$configuration/sidebar_width.adoc[leveloffset=+1]

[[example-inside-the-tinymceinit]]
== Example inside the tinymce.init

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Shall we update the examples below to include resizable: true?

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

upcoming release Documentation for features currently under development/QA

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants