{"templateId":"markdown","sharedDataIds":{},"props":{"metadata":{"markdoc":{"tagList":[]},"type":"markdown"},"seo":{"title":"LinkTextDirectory Component","siteUrl":"https://xrpl.org","llmstxt":{"hide":false,"title":"XRPL Developer Portal & Documentation","description":"Explore XRP Ledger documentation, blogs, and other blockchain developer resources needed to start building and integrating with the ledger.","details":{"content":"XRP Ledger concepts, use cases, tutorials, references, and other blockchain developer resources. Also, stay up to date with release announcements and more through the XRPL Blog."},"sections":[{"title":"Introduction","description":"A high-level introduction to the XRP Ledger.","includeFiles":["docs/introduction/**/*.*","about/faq.md"],"excludeFiles":["docs/introduction/index.md"]},{"title":"Use Cases","description":"Real-world applications and business scenarios for the XRP Ledger.","includeFiles":["docs/use-cases/**/*.*"],"excludeFiles":["docs/use-cases/index.md","docs/use-cases/defi/index.md"]},{"title":"Agentic Transactions","description":"XRPL AI Starter Kit to help autonomous agents discover, set up, and execute agentic transactions on the XRP Ledger.","includeFiles":["docs/agents/**/*.*"]},{"title":"Concepts","description":"Core concepts including accounts, tokens, transactions, consensus, and more.","includeFiles":["docs/concepts/**/*.*"],"excludeFiles":["docs/concepts/index.md","docs/concepts/decentralized-storage/index.md","docs/concepts/payment-types/index.md"]},{"title":"Tutorials","description":"Step-by-step guides for building on the XRP Ledger in JavaScript, Python, Go, and more.","includeFiles":["docs/tutorials/**/*.*"]},{"title":"References","description":"Protocol specification, transaction types, ledger entries, and API methods.","includeFiles":["docs/references/**/*.*"],"excludeFiles":["docs/references/xrp-api.md","docs/references/data-api.md","docs/references/protocol/index.md","docs/references/protocol/ledger-data/ledger-entry-types/index.md","docs/references/protocol/transactions/index.md","docs/references/protocol/transactions/types/index.md","docs/references/http-websocket-apis/api-conventions/index.md","docs/references/http-websocket-apis/public-api-methods/*/index.md","docs/references/http-websocket-apis/admin-api-methods/*/index.md"]},{"title":"Infrastructure","description":"Install, configure, and troubleshoot xrpld and Clio servers.","includeFiles":["docs/infrastructure/**/*.*"],"excludeFiles":["docs/infrastructure/index.md","docs/infrastructure/*/index.md","docs/infrastructure/installation/build-run-xrpld-in-reporting-mode.md","docs/infrastructure/configuration/data-retention/index.md","docs/infrastructure/configuration/server-modes/index.md"]},{"title":"Blog (2023+)","description":"Recent XRPL Blog posts (showing 2023 and newer).","includeFiles":["blog/2023/**/*.*","blog/2024/**/*.*","blog/2025/**/*.*","blog/2026/**/*.*"]},{"title":"Resources","description":"Developer resources and contribution guidelines.","includeFiles":["resources/**/*.*"]}]}},"dynamicMarkdocComponents":[],"compilationErrors":[],"ast":{"$$mdtype":"Tag","name":"article","attributes":{},"children":[{"$$mdtype":"Tag","name":"Heading","attributes":{"level":1,"id":"linktextdirectory-component","__idx":0},"children":["LinkTextDirectory Component"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["A section pattern that displays a numbered list of LinkTextCard components with a heading and optional description."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"overview","__idx":1},"children":["Overview"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["LinkTextDirectory is a section-level pattern that combines a header (heading + description) with a vertically stacked list of LinkTextCard components. Each card is automatically numbered sequentially (01, 02, 03...), making it perfect for feature lists, step-by-step guides, or numbered content sections."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"features","__idx":2},"children":["Features"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Automatic Numbering"]},": Cards are numbered sequentially starting from 01"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Responsive Layout"]},": Adaptive spacing and alignment across breakpoints"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Desktop Right-Alignment"]},": Cards are right-aligned on desktop for visual interest"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Minimal HTML Structure"]},": Flat, efficient DOM hierarchy"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Light/Dark Mode"]},": Full theming support"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Flexible Content"]},": Supports any number of cards"]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"layout-behavior","__idx":3},"children":["Layout Behavior"]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"className":"md"},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Breakpoint"},"children":["Breakpoint"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Card Alignment"},"children":["Card Alignment"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Gap Between Cards"},"children":["Gap Between Cards"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Header Gap"},"children":["Header Gap"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Base (< 576px)"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Left"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["24px"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["8px"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["MD (576px - 991px)"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Left"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["32px"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["8px"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["LG (≥ 992px)"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Right"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["40px"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["16px"]}]}]}]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Desktop Behavior"]},": Cards are right-aligned using ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["align-items: flex-end"]},", creating a visually distinct layout compared to mobile/tablet."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"usage","__idx":4},"children":["Usage"]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"basic-usage","__idx":5},"children":["Basic Usage"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"tsx","header":{"controls":{"copy":{}}},"source":"<LinkTextDirectory\n  heading=\"Explore XRPL Developer Tools\"\n  description=\"XRP Ledger is a compliance-focused blockchain where financial applications come to life\"\n  cards={[\n    {\n      heading: \"Fast Settlement and Low Fees\",\n      description: \"Settle transactions in 3-5 seconds for a fraction of a cent, ideal for large-scale, high-volume RWA tokenization\",\n      buttons: [\n        { label: \"Get Started\", href: \"/start\" },\n        { label: \"Learn More\", href: \"/docs\" }\n      ]\n    },\n    {\n      heading: \"Secure and Reliable\",\n      description: \"Built on proven blockchain technology with enterprise-grade security\",\n      buttons: [\n        { label: \"Read Documentation\", href: \"/docs\" }\n      ]\n    },\n    {\n      heading: \"Developer Friendly\",\n      description: \"Comprehensive APIs and SDKs for seamless integration\",\n      buttons: [\n        { label: \"View API\", href: \"/api\" },\n        { label: \"See Examples\", href: \"/examples\" }\n      ]\n    }\n  ]}\n/>\n","lang":"tsx"},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"without-description","__idx":6},"children":["Without Description"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"tsx","header":{"controls":{"copy":{}}},"source":"<LinkTextDirectory\n  heading=\"Key Features\"\n  cards={featuresList}\n/>\n","lang":"tsx"},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"with-dynamic-data","__idx":7},"children":["With Dynamic Data"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"tsx","header":{"controls":{"copy":{}}},"source":"const features = [\n  {\n    heading: \"Feature One\",\n    description: \"Description for feature one\",\n    buttons: [{ label: \"Learn More\", href: \"/feature-1\" }]\n  },\n  // ... more features\n];\n\n<LinkTextDirectory\n  heading=\"Platform Features\"\n  description=\"Everything you need to build amazing applications\"\n  cards={features}\n/>\n","lang":"tsx"},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"props","__idx":8},"children":["Props"]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"linktextdirectoryprops","__idx":9},"children":["LinkTextDirectoryProps"]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"className":"md"},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Prop"},"children":["Prop"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Type"},"children":["Type"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Default"},"children":["Default"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Description"},"children":["Description"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["heading"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["string"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Required"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Section heading"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["description"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["string"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["-"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Optional description text"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["cards"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["LinkTextCardData[]"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Required"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Array of card data"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["className"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["string"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["-"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Additional CSS classes"]}]}]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"linktextcarddata","__idx":10},"children":["LinkTextCardData"]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"className":"md"},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Prop"},"children":["Prop"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Type"},"children":["Type"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Default"},"children":["Default"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Description"},"children":["Description"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["heading"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["string"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Required"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Card heading"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["description"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["string"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Required"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Card description"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["buttons"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["ButtonConfig[]"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Required"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Array of button configs (max 2)"]}]}]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"buttonconfig-from-buttongroup","__idx":11},"children":["ButtonConfig (from ButtonGroup)"]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"className":"md"},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Prop"},"children":["Prop"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Type"},"children":["Type"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Default"},"children":["Default"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Description"},"children":["Description"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["label"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["string"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Required"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Button text"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["href"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["string"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["-"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Link destination"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["onClick"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["() => void"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["-"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Click handler"]}]}]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"component-structure","__idx":12},"children":["Component Structure"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"tsx","header":{"controls":{"copy":{}}},"source":"<PageGrid className=\"bds-link-text-directory\">\n  <PageGridRow>\n    <PageGridCol className=\"bds-link-text-directory__header\" span={{ base: 12, md: 6, lg: 8 }}>\n      <h2 className=\"h-md\">{heading}</h2>\n      <p className=\"body-l\">{description}</p>\n    </PageGridCol>\n  </PageGridRow>\n\n  <PageGridRow>\n    <PageGridCol span={{ base: 12, md: 8, lg: 8 }} offset={{ lg: 4 }}>\n      <ul>\n        {cards.map((card, index) => (\n          <LinkTextCard\n            key={index}\n            index={index}\n            heading={card.heading}\n            description={card.description}\n            buttons={card.buttons}\n          />\n        ))}\n      </ul>\n    </PageGridCol>\n  </PageGridRow>\n</PageGrid>\n","lang":"tsx"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Key Design Decisions:"]}]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["PageGrid Integration"]},": Uses PageGrid system for responsive layout"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Typography Classes"]},": Uses existing ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["h-md"]}," and ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["body-l"]}," utility classes"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Flexbox Header"]},": Header uses flexbox with gap for spacing between heading and description"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Desktop Right-Alignment"]},": Cards offset by 4 columns at LG breakpoint (right-aligned)"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Semantic List"]},": Cards wrapped in ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["<ul>"]}," with each card as ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["<li>"]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"responsive-spacing","__idx":13},"children":["Responsive Spacing"]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"className":"md"},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Breakpoint"},"children":["Breakpoint"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Section Padding"},"children":["Section Padding"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Header Gap"},"children":["Header Gap"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Header Margin-Bottom"},"children":["Header Margin-Bottom"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Base (< 576px)"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["24px"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["8px"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["24px"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["MD (576px - 991px)"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["32px"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["8px"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["32px"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["LG (≥ 992px)"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["40px"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["16px"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["40px"]}]}]}]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Section Padding"]},": Top and bottom padding on the entire section"," ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Header Gap"]},": Space between heading and description (via flexbox gap)"," ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Header Margin-Bottom"]},": Space between header and cards list"]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"styling","__idx":14},"children":["Styling"]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"css-classes","__idx":15},"children":["CSS Classes"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":[".bds-link-text-directory"]}," - Main PageGrid container with section padding"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":[".bds-link-text-directory__header"]}," - Header section (flexbox column with gap)"]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"typography","__idx":16},"children":["Typography"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Heading"]},": ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["h-md"]}," class (responsive heading)"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Description"]},": ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["body-l"]}," class (large body text)"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Card content uses LinkTextCard's built-in typography"]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"grid-layout","__idx":17},"children":["Grid Layout"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Header Column"]},": ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["span={{ base: 12, md: 6, lg: 8 }}"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Cards Column"]},": ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["span={{ base: 12, md: 8, lg: 8 }}"]}," with ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["offset={{ lg: 4 }}"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Cards are right-aligned on desktop via the 4-column offset"]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"dark-mode","__idx":18},"children":["Dark Mode"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Text color changes to white in dark mode"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Applied to entire section via ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["bds-theme-mode(dark)"]}," mixin"]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"card-numbering","__idx":19},"children":["Card Numbering"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Cards are automatically numbered based on their array index:"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"typescript","header":{"controls":{"copy":{}}},"source":"cards[0] → LinkTextCard(index: 0) → displays \"01\"\ncards[1] → LinkTextCard(index: 1) → displays \"02\"\ncards[2] → LinkTextCard(index: 2) → displays \"03\"\n// ... and so on\n","lang":"typescript"},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"files","__idx":20},"children":["Files"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["LinkTextDirectory.tsx"]}," - React component"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["LinkTextDirectory.scss"]}," - SCSS styles"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["index.ts"]}," - Barrel exports"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["README.md"]}," - This file"]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"related-components","__idx":21},"children":["Related Components"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["LinkTextCard"]},": Used for each card in the list"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["ButtonGroup"]},": Used by LinkTextCard for action buttons"]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"import","__idx":22},"children":["Import"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"tsx","header":{"controls":{"copy":{}}},"source":"import { LinkTextDirectory } from 'shared/sections/LinkTextDirectory';\n// or\nimport { \n  LinkTextDirectory, \n  type LinkTextDirectoryProps,\n  type LinkTextCardData \n} from 'shared/sections/LinkTextDirectory';\n","lang":"tsx"},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"design-system","__idx":23},"children":["Design System"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Part of the Brand Design System (BDS) with ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["bds-"]}," namespace prefix."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"best-practices","__idx":24},"children":["Best Practices"]},{"$$mdtype":"Tag","name":"ol","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Consistent Card Content"]},": Try to keep similar text lengths across cards for visual balance"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Limit Cards"]},": 3-6 cards works best for readability"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Clear Descriptions"]},": Keep descriptions concise but informative"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Button Labels"]},": Use clear, action-oriented button labels"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Logical Ordering"]},": Order cards by priority or logical sequence"]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"accessibility","__idx":25},"children":["Accessibility"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Semantic HTML with proper heading hierarchy (",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["<h2>"]}," for section, ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["<h5>"]}," for cards)"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Semantic list structure: ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["<ul>"]}," containing ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["<li>"]}," elements"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Sequential tab order through cards and buttons"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["ARIA-compliant button and link elements (via ButtonGroup)"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Maintains focus order: heading → description → card 1 → card 2 → etc."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"best-practices-for-react-keys","__idx":26},"children":["Best Practices for React Keys"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["When mapping over cards, use a stable identifier instead of array index:"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"tsx","header":{"controls":{"copy":{}}},"source":"// ❌ Avoid using index as key\n{cards.map((card, index) => (\n  <LinkTextCard key={index} ... />\n))}\n\n// ✅ Better: Use a unique identifier\n{cards.map((card, index) => (\n  <LinkTextCard key={card.id || card.heading} ... />\n))}\n\n// ✅ Best: Add an id field to LinkTextCardData\ninterface LinkTextCardData {\n  id: string;  // Unique identifier\n  heading: string;\n  description: string;\n  buttons: ButtonConfig[];\n}\n\n{cards.map((card) => (\n  <LinkTextCard key={card.id} ... />\n))}\n","lang":"tsx"},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"example-with-all-features","__idx":27},"children":["Example with All Features"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"tsx","header":{"controls":{"copy":{}}},"source":"<LinkTextDirectory\n  heading=\"Why Choose XRPL\"\n  description=\"The most efficient blockchain for real-world applications\"\n  cards={[\n    {\n      heading: \"Lightning Fast\",\n      description: \"Process thousands of transactions per second with sub-3-second finality\",\n      buttons: [\n        { label: \"View Benchmarks\", href: \"/performance\" },\n        { label: \"Try Demo\", onClick: () => openDemo() }\n      ]\n    },\n    {\n      heading: \"Cost Effective\",\n      description: \"Minimal transaction fees make XRPL perfect for micro-transactions and high-volume use cases\",\n      buttons: [\n        { label: \"See Pricing\", href: \"/pricing\" }\n      ]\n    },\n    {\n      heading: \"Battle Tested\",\n      description: \"Over 10 years of continuous operation with billions of transactions processed\",\n      buttons: [\n        { label: \"Read Case Studies\", href: \"/case-studies\" },\n        { label: \"View Stats\", href: \"/statistics\" }\n      ]\n    }\n  ]}\n  className=\"my-custom-class\"\n/>\n","lang":"tsx"},"children":[]}]},"headings":[{"value":"LinkTextDirectory Component","id":"linktextdirectory-component","depth":1},{"value":"Overview","id":"overview","depth":2},{"value":"Features","id":"features","depth":2},{"value":"Layout Behavior","id":"layout-behavior","depth":2},{"value":"Usage","id":"usage","depth":2},{"value":"Basic Usage","id":"basic-usage","depth":3},{"value":"Without Description","id":"without-description","depth":3},{"value":"With Dynamic Data","id":"with-dynamic-data","depth":3},{"value":"Props","id":"props","depth":2},{"value":"LinkTextDirectoryProps","id":"linktextdirectoryprops","depth":3},{"value":"LinkTextCardData","id":"linktextcarddata","depth":3},{"value":"ButtonConfig (from ButtonGroup)","id":"buttonconfig-from-buttongroup","depth":3},{"value":"Component Structure","id":"component-structure","depth":2},{"value":"Responsive Spacing","id":"responsive-spacing","depth":2},{"value":"Styling","id":"styling","depth":2},{"value":"CSS Classes","id":"css-classes","depth":3},{"value":"Typography","id":"typography","depth":3},{"value":"Grid Layout","id":"grid-layout","depth":3},{"value":"Dark Mode","id":"dark-mode","depth":3},{"value":"Card Numbering","id":"card-numbering","depth":2},{"value":"Files","id":"files","depth":2},{"value":"Related Components","id":"related-components","depth":2},{"value":"Import","id":"import","depth":2},{"value":"Design System","id":"design-system","depth":2},{"value":"Best Practices","id":"best-practices","depth":2},{"value":"Accessibility","id":"accessibility","depth":2},{"value":"Best Practices for React Keys","id":"best-practices-for-react-keys","depth":2},{"value":"Example with All Features","id":"example-with-all-features","depth":2}],"frontmatter":{"seo":{"title":"LinkTextDirectory Component"}},"editPage":{"to":"https://github.com/XRPLF/xrpl-dev-portal/tree/master/shared/sections/LinkTextDirectory/README.md"},"lastModified":"2026-02-23T23:00:18.000Z","isTranslationFallback":true,"pagePropGetterError":{"message":"","name":""}},"slug":"/ja/shared/sections/linktextdirectory/readme","userData":{"isAuthenticated":false,"teams":["anonymous"]},"isPublic":true}