# XWUIHrLoansPage

Employee loans-and-advances page, built on `HrListPage` (a shell page extending `XWUIShellPage` via `HrPageBase`). On load it calls `hrApi.listLoans()` and renders the records in a striped, hoverable `XWUIDataGrid` with **Employee** (`employeeName`), **Type**, and **Outstanding** columns; an empty result shows a "No records found" state. Default page title is "Loans & Advances". Construct it with page `data` (`title`, `description`, `toolbar`, optional pre-loaded `rows`) and `conf_comp` carrying `hrApiOptions` plus standard page-base props (`maxWidth`, `centered`, `padding`, aside widths, `className`).

## Basic Usage

Mounts the Loans & Advances page against the sandbox HR API; with no `rows` supplied it fetches `listLoans()` and fills the Employee/Type/Outstanding grid.

```example
file: examples/BasicUsage.ts
html: examples/BasicUsage.html
title: Basic Usage
description: Constructs XWUIHrLoansPage with hrApiOptions.env 'sandbox' so listLoans() drives the Employee/Type/Outstanding data grid.
```

## Arabic Locale (RTL)

Sets `locale: 'ar'` with an Arabic `titleAr`, rendering the page right-to-left with localized heading and empty/loading copy.

```example
file: examples/ArabicLocale.ts
html: examples/ArabicLocale.html
title: Arabic Locale (RTL)
description: Passes locale 'ar' and titleAr so the Loans page renders RTL with the Arabic title.
```

## Preloaded Rows

Supplies `data.rows` so the grid renders the provided loan records immediately, bypassing the `listLoans()` fetch.

```example
file: examples/PreloadedRows.ts
html: examples/PreloadedRows.html
title: Preloaded Rows
description: Passes a data.rows array keyed by employeeName/type/outstanding to skip the API and render directly.
```

```api
```