python-openxml
diff --git a/‎features/par-access-inner-content.feature
Lines changed: 5 additions & 0 deletions b/‎features/par-access-inner-content.feature
Lines changed: 5 additions & 0 deletions
diff --git a/‎features/steps/paragraph.py
Lines changed: 9 additions & 0 deletions b/‎features/steps/paragraph.py
Lines changed: 9 additions & 0 deletions
diff --git a/‎src/docx/oxml/text/paragraph.py
Lines changed: 9 additions & 0 deletions b/‎src/docx/oxml/text/paragraph.py
Lines changed: 9 additions & 0 deletions
diff --git a/‎src/docx/text/paragraph.py
Lines changed: 3 additions & 5 deletions b/‎src/docx/text/paragraph.py
Lines changed: 3 additions & 5 deletions
diff --git a/‎tests/text/test_paragraph.py
Lines changed: 6 additions & 0 deletions b/‎tests/text/test_paragraph.py
Lines changed: 6 additions & 0 deletions
@@ -42,3 +42,8 @@ Feature: Access paragraph inner-content including hyperlinks
       | no           |   0   |
       | one          |   1   |
       | two          |   2   |
+
+
+  Scenario: Paragraph.text contains both run-text and hyperlink-text
+    Given a paragraph having three hyperlinks
+     Then paragraph.text contains the text of both the runs and the hyperlinks
@@ -190,6 +190,15 @@ def then_paragraph_style_is_value(context: Context, value_key: str):
     assert paragraph.style == expected_value
 
 
+@then("paragraph.text contains the text of both the runs and the hyperlinks")
+def then_paragraph_text_contains_the_text_of_both_the_runs_and_the_hyperlinks(
+    context: Context,
+):
+    actual = context.paragraph.text
+    expected = "Three hyperlinks: the first one here, the second one, and the third."
+    assert actual == expected, f"expected:\n'{expected}'\n\ngot:\n'{actual}'"
+
+
 @then("the document contains four paragraphs")
 def then_the_document_contains_four_paragraphs(context: Context):
     assert len(context.document.paragraphs) == 4
 
@@ -88,6 +88,15 @@ def style(self, style):
         pPr = self.get_or_add_pPr()
         pPr.style = style
 
+    @property  # pyright: ignore[reportIncompatibleVariableOverride]
+    def text(self):
+        """The textual content of this paragraph.
+
+        Inner-content child elements like `w:r` and `w:hyperlink` are translated to
+        their text equivalent.
+        """
+        return "".join(e.text for e in self.xpath("w:r | w:hyperlink"))
+
     def _insert_pPr(self, pPr: CT_PPr) -> CT_PPr:
         self.insert(0, pPr)
         return pPr
@@ -150,8 +150,9 @@ def style(self, style_or_name: str | ParagraphStyle | None):
 
     @property
     def text(self) -> str:
-        """String formed by concatenating the text of each run in the paragraph.
+        """The textual content of this paragraph.
 
+        The text includes the visible-text portion of any hyperlinks in the paragraph.
         Tabs and line breaks in the XML are mapped to ``\\t`` and ``\\n`` characters
         respectively.
 
@@ -161,10 +162,7 @@ def text(self) -> str:
         character is mapped to a line break. Paragraph-level formatting, such as style,
         is preserved. All run-level formatting, such as bold or italic, is removed.
         """
-        text = ""
-        for run in self.runs:
-            text += run.text
-        return text
+        return self._p.text
 
     @text.setter
     def text(self, text: str | None):
 
@@ -143,9 +143,15 @@ def it_provides_access_to_the_rendered_page_breaks_it_contains(
             ('w:p/w:r/(w:t"foo", w:tab, w:t"bar")', "foo\tbar"),
             ('w:p/w:r/(w:t"foo", w:br,  w:t"bar")', "foo\nbar"),
             ('w:p/w:r/(w:t"foo", w:cr,  w:t"bar")', "foo\nbar"),
+            (
+                'w:p/(w:r/w:t"click ",w:hyperlink{r:id=rId6}/w:r/w:t"here",'
+                'w:r/w:t" for more")',
+                "click here for more",
+            ),
         ],
     )
     def it_knows_the_text_it_contains(self, p_cxml: str, expected_value: str):
+        """Including the text of embedded hyperlinks."""
         paragraph = Paragraph(element(p_cxml), None)
         assert paragraph.text == expected_value