Procházet zdrojové kódy

Describe successive select-all behavior in the feature docs,

as suggested at https://github.com/ckeditor/ckeditor5/pull/6816#pullrequestreview-418243766.
Tomek Wytrębowicz před 5 roky
rodič
revize
a2a44eb5b0

+ 19 - 6
packages/ckeditor5-select-all/docs/_snippets/features/select-all.html

@@ -1,13 +1,26 @@
 <div id="editor">
 	<h2>The three greatest things you learn from traveling</h2>
 
-	<figure class="image image-style-side"><img src="%BASE_PATH%/assets/img/volcano.jpg" alt="A lone wanderer looking at Mount Bromo volcano in Indonesia.">
-		<figcaption>Leaving your comfort zone might lead you to such beautiful sceneries like this one.</figcaption>
-	</figure>
-
 	<p>Like all the great things on earth traveling teaches us by example. Here are some of the most precious lessons I’ve learned over the years of traveling.</p>
 
-	<h3>Appreciation of diversity</h3>
+	<figure class="table">
+		<table>
+			<tbody>
+				<tr>
+					<td>
+						<h3>Appreciation of diversity</h3>
 
-	<p>Getting used to an entirely different culture can be challenging. While it’s also nice to learn about cultures online or from books, nothing comes close to experiencing cultural diversity in person. You learn to appreciate each and every single one of the differences while you become more culturally fluid.</p>
+						<p>Getting used to an entirely different culture can be challenging. While it’s also nice to learn about cultures online or from books, nothing comes close to experiencing cultural diversity in person. You learn to appreciate each and every single one of the differences while you become more culturally fluid.</p>
+					</td>
+					<td>
+						<p>Leaving your comfort zone might lead you to such beautiful sceneries like this one.</p>
+						<figure class="image">
+							<img src="%BASE_PATH%/assets/img/volcano.jpg" alt="A lone wanderer looking at Mount Bromo volcano in Indonesia.">
+							<figcaption>Mount Bromo, Indonesia.</figcaption>
+						</figure>
+					</td>
+				</tr>
+			</tbody>
+		</table>
+	</figure>
 </div>

+ 11 - 1
packages/ckeditor5-select-all/docs/features/select-all.md

@@ -9,10 +9,20 @@ The {@link module:select-all/selectall~SelectAll} feature allows selecting the e
 
 ## Demo
 
-Press <kbd>Ctrl/⌘</kbd>+<kbd>A</kbd> or use the toolbar button to select the entire content of the editor. Note that when editing an {@link features/image#image-captions image caption}, the selection will only expand to the boundaries of the caption.
+Press <kbd>Ctrl/⌘</kbd>+<kbd>A</kbd> or use the toolbar button to select the entire content of the editor.
 
 {@snippet features/select-all}
 
+### Boundaries
+
+Note that when editing an {@link features/image#image-captions image caption}, the selection will only expand to the boundaries of the caption. Successive use will expand the selection beyond these boundaries to encompass more and more content up to the entire editable root of the editor. This is to allow the user to do more focused editing and select only related content.
+
+<info-box>
+	The Select All boundaries are created by any {@link framework/guides/deep-dive/schema#limit-elements limit element} which can contain a text or paragraph.
+</info-box>
+
+
+
 ## Installation
 
 <info-box info>